Struct Theme 

pub struct Theme {
    pub primary: u32,
    pub success: u32,
    pub warning: u32,
    pub error: u32,
    pub info: u32,
    pub author: Option<Branding>,
    pub footer: Option<Branding>,
}

A bot’s colors and branding, set on an App with #[app(.., theme = THEME)] and read with ctx.theme(). An App listed in another uses its own Theme, if set, and fills in the rest from the outer one; errors are rendered with the outermost App’s.

use composure::command::Theme;

const THEME: Theme = Theme::new()
    .with_primary(0xf5c2e7)
    .with_author("Composure", Some("https://example.com/icon.png"))
    .with_footer("composure-rs", None);

let saved = THEME.success("Saved");
assert_eq!(saved.color, Some(THEME.success));

Message responses (and deferred edits) of a themed App are filled in where unset: every embed gets primary, the first the author, the last the footer; top-level Containers get primary as accent color. Errors become an error-colored embed. Wrap a response in Unthemed to send it as is. Messages sent through REST are never changed: build them with the helpers.

See the Themes chapter of the guide.

Fields

primary: u32

Embeds without a semantic color, auto-filled embeds and container accents (0xRRGGBB)

success: u32

Theme::success embeds

warning: u32

Theme::warning embeds

error: u32

Theme::error embeds, and the error messages users see when a handler fails

info: u32

Theme::info embeds

author: Option<Branding>

Set on the first embed of a themed message, and on every helper’s embed

footer: Option<Branding>

Set on the last embed of a themed message, and on every helper’s embed

Implementations

impl Theme

pub const DEFAULT: Theme

Discord’s palette, no branding. What ctx.theme() returns when none is set.

pub const fn new() -> Self

Theme::DEFAULT, to customize with the builder methods

pub const fn with_primary(self, color: u32) -> Self

Sets primary: the default color of embeds and container accents

pub const fn with_success(self, color: u32) -> Self

Sets success

pub const fn with_warning(self, color: u32) -> Self

Sets warning

pub const fn with_error(self, color: u32) -> Self

Sets error, also used for handler error messages

pub const fn with_info(self, color: u32) -> Self

Sets info

pub const fn with_author( self, name: &'static str, icon_url: Option<&'static str>, ) -> Self

Author shown at the top of themed embeds

pub const fn with_footer( self, text: &'static str, icon_url: Option<&'static str>, ) -> Self

Footer shown at the bottom of themed embeds

pub fn embed(&self) -> Embed

An empty embed with the primary color and the branding

pub fn success(&self, message: impl Into<String>) -> Embed

A branded embed with message in the success color

pub fn warning(&self, message: impl Into<String>) -> Embed

A branded embed with message in the warning color

pub fn error(&self, message: impl Into<String>) -> Embed

A branded embed with message in the error color

pub fn info(&self, message: impl Into<String>) -> Embed

A branded embed with message in the info color

pub fn apply(&self, response: &mut InteractionResponse)

Fills unset colors and branding on a message response: the primary color on every embed and as accent of top-level containers, the author on the first embed, the footer on the last. Other responses and Unthemed messages are left as is.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Theme

impl Debug for Theme

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

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Theme

impl PartialEq for Theme

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Theme