Struct CustomMessage

pub struct CustomMessage { /* private fields */ }

A builder for constructing a personal Message instance.

This can be useful for emitting a manual dispatch to the framework, but you don’t have a message in hand, or just have a fragment of its data.

Implementations

impl CustomMessage

pub fn new() -> Self

Constructs a new instance of this builder, alongside a message with dummy data. Use the methods to replace the individual bits of this message with valid data.

pub fn id(&mut self, id: MessageId) -> &mut Self

Assign the dummy message a proper ID for identification.

If not used, the default value is MessageId::new(1).

pub fn attachments( &mut self, attachments: impl IntoIterator<Item = Attachment>, ) -> &mut Self

Assign the dummy message files attached to it.

If not used, the default value is an empty vector (Vec::default()).

pub fn author(&mut self, user: User) -> &mut Self

Assign the dummy message its author.

If not used, the default value is a dummy User.

pub fn channel_id(&mut self, channel_id: ChannelId) -> &mut Self

Assign the dummy message its origin channel’s ID.

If not used, the default value is ChannelId::new(1).

pub fn content(&mut self, s: impl Into<String>) -> &mut Self

Assign the dummy message its contents.

If not used, the default value is an empty string (String::default()).

pub fn edited_timestamp<T: Into<Timestamp>>( &mut self, timestamp: T, ) -> &mut Self

Assign the dummy message the timestamp it was edited.

If not used, the default value is None (not all messages are edited).

pub fn embeds(&mut self, embeds: impl IntoIterator<Item = Embed>) -> &mut Self

Assign the dummy message embeds.

If not used, the default value is an empty vector (Vec::default()).

pub fn guild_id(&mut self, guild_id: GuildId) -> &mut Self

Assign the dummy message its origin guild’s ID.

If not used, the default value is None (not all messages are sent in guilds).

pub fn kind(&mut self, kind: MessageType) -> &mut Self

Assign the dummy message its type.

If not used, the default value is MessageType::Regular.

pub fn member(&mut self, member: PartialMember) -> &mut Self

Assign the dummy message member data pertaining to its author.

If not used, the default value is None (not all messages are sent in guilds).

pub fn mention_everyone(&mut self, mentions: bool) -> &mut Self

Assign the dummy message a flag whether it mentions everyone (@everyone).

If not used, the default value is false.

pub fn mention_roles( &mut self, roles: impl IntoIterator<Item = RoleId>, ) -> &mut Self

Assign the dummy message a list of roles it mentions.

If not used, the default value is an empty vector (Vec::default()).

pub fn mentions( &mut self, mentions: impl IntoIterator<Item = User>, ) -> &mut Self

Assign the dummy message a list of mentions.

If not used, the default value is an empty vector (Vec::default()).

pub fn pinned(&mut self, pinned: bool) -> &mut Self

Assign the dummy message a flag whether it’s been pinned.

If not used, the default value is false.

pub fn reactions( &mut self, reactions: impl IntoIterator<Item = MessageReaction>, ) -> &mut Self

Assign the dummy message a list of emojis it was reacted with.

If not used, the default value is an empty vector (Vec::default()).

pub fn timestamp<T: Into<Timestamp>>(&mut self, timestamp: T) -> &mut Self

Assign the dummy message the timestamp it was created at.

If not used, the default value is the current local time.

pub fn tts(&mut self, tts: bool) -> &mut Self

Assign the dummy message a flag whether it’ll be read by a Text-To-Speech program.

If not used, the default value is false.

pub fn webhook_id(&mut self, id: WebhookId) -> &mut Self

Assign the dummy message the webhook author’s ID.

If not used, the default value is None (not all messages are sent by webhooks).

pub fn build(self) -> Message

Consume this builder and return the constructed message.

Trait Implementations

impl Clone for CustomMessage

fn clone(&self) -> CustomMessage

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CustomMessage

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

Formats the value using the given formatter.

impl Default for CustomMessage

fn default() -> CustomMessage

Returns the “default value” for a type.