dyncord 0.13.6

A high-level, ergonomic, batteries-included Discord bot library for Rust. WIP.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! A wrapper around sending messages.

use twilight_model::channel::Message;
use twilight_model::channel::message::Embed;
use twilight_model::id::Id;
use twilight_model::id::marker::{ChannelMarker, MessageMarker};

use crate::aliases::DiscordClient;
use crate::utils::DynFuture;
use crate::wrappers::TwilightError;

/// A builder for sending a message.
pub struct MessageCreate {
    /// The HTTP client to use for sending the message.
    client: DiscordClient,

    /// The ID of the channel to send the message to.
    channel_id: Id<ChannelMarker>,

    /// The content of the message to send.
    content: String,

    /// The ID of the message to reply to, if any.
    replying_to: Option<Id<MessageMarker>>,

    /// The embeds to include in the message.
    embeds: Vec<Embed>,
}

impl MessageCreate {
    pub(crate) fn new(
        client: DiscordClient,
        channel_id: Id<ChannelMarker>,
        content: impl Into<String>,
    ) -> Self {
        Self {
            client,
            channel_id,
            content: content.into(),
            replying_to: None,
            embeds: Vec::new(),
        }
    }

    /// Sets the message to reply to.
    ///
    /// Arguments:
    /// * `message_id` - The ID of the message to reply to.
    ///
    /// Returns:
    /// [`MessageCreate`] - The message builder with the reply set.
    pub fn reply(mut self, message_id: Id<MessageMarker>) -> Self {
        self.replying_to = Some(message_id);
        self
    }

    /// Adds an embed to the message.
    ///
    /// Arguments:
    /// * `embed` - The embed to add to the message.
    ///
    /// Returns:
    /// [`MessageCreate`] - The message builder with the embed added.
    pub fn embed(mut self, embed: impl Into<Embed>) -> Self {
        self.embeds.push(embed.into());
        self
    }

    /// Sends the message to the specified channel.
    ///
    /// Returns:
    /// * `Ok(Message)` - The message that was sent.
    /// * `Err(SendingError)` - An error that occurred while sending the message.
    async fn send(self) -> Result<Message, TwilightError> {
        let mut builder = self
            .client
            .create_message(self.channel_id)
            .embeds(&self.embeds)
            .content(&self.content);

        if let Some(reply) = self.replying_to {
            builder = builder.reply(reply);
        }

        Ok(builder.await?.model().await?)
    }
}

impl IntoFuture for MessageCreate {
    type Output = Result<Message, TwilightError>;
    type IntoFuture = DynFuture<'static, Self::Output>;

    fn into_future(self) -> Self::IntoFuture {
        Box::pin(self.send())
    }
}