Struct serenity::builder::EditGuild

pub struct EditGuild(pub HashMap<&'static str, Value>);

A builder to optionally edit certain fields of a Guild. This is meant for usage with Guild::edit.

Note: Editing a guild requires that the current user have the Manage Guild permission.

Methods

impl EditGuild

pub fn afk_channel<C: Into<ChannelId>>(
    &mut self,
    channel: Option<C>
) -> &mut Self

Set the "AFK voice channel" that users are to move to if they have been AFK for an amount of time, configurable by afk_timeout.

The given channel must be either some valid voice channel, or None to not set an AFK channel. The library does not check if a channel is valid.

pub fn afk_timeout(&mut self, timeout: u64) -> &mut Self

Set the amount of time a user is to be moved to the AFK channel - configured via afk_channel - after being AFK.

pub fn icon(&mut self, icon: Option<&str>) -> &mut Self

Set the icon of the guild. Pass None to remove the icon.

Examples

Using the utility function - utils::read_image - to read an image from the cwd and encode it in base64 to send to Discord.

use serenity::utils;

// assuming a `guild` has already been bound

let base64_icon = utils::read_image("./guild_icon.png")?;

guild.edit(&http, |mut g| {
    g.icon(Some(&base64_icon))
})?;

pub fn name<S: ToString>(&mut self, name: S) -> &mut Self

Set the name of the guild.

Note: Must be between (and including) 2-100 chracters.

pub fn owner<U: Into<UserId>>(&mut self, user_id: U) -> &mut Self

Transfers the ownership of the guild to another user by Id.

Note: The current user must be the owner of the guild.

pub fn region(&mut self, region: Region) -> &mut Self

Set the voice region of the server.

Examples

Setting the region to Region::UsWest:

use serenity::model::guild::Region;

// assuming a `guild` has already been bound

guild.edit(&http, |g| {
    g.region(Region::UsWest)
})?;

pub fn splash(&mut self, splash: Option<&str>) -> &mut Self

Set the splash image of the guild on the invitation page.

Requires that the guild have the INVITE_SPLASH feature enabled. You can check this through a guild's features list.

pub fn verification_level<V>(&mut self, verification_level: V) -> &mut Self where
    V: Into<VerificationLevel>, 

Set the verification level of the guild. This can restrict what a user must have prior to being able to send messages in a guild.

Refer to the documentation for VerificationLevel for more information on each variant.

Examples

Setting the verification level to High:

use serenity::model::guild::VerificationLevel;

// assuming a `guild` has already been bound

let edit = guild.edit(&http, |g| {
    g.verification_level(VerificationLevel::High)
});

if let Err(why) = edit {
    println!("Error setting verification level: {:?}", why);
}

// additionally, you may pass in just an integer of the verification
// level

let edit = guild.edit(&http, |g| {
    g.verification_level(3)
});

if let Err(why) = edit {
    println!("Error setting verification level: {:?}", why);
}

Trait Implementations

impl Clone for EditGuild

fn clone(&self) -> EditGuild

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EditGuild

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for EditGuild

fn default() -> EditGuild

Returns the "default value" for a type.