panda 0.2.1

An async Rust library for Discord
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use crate::{
    error::Result,
    http::HttpClient,
    models::{guild::GuildMember, user::User},
};

use super::Embed;

use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
/// Represents a message sent in a channel within Discord.
pub struct Message {
    id: String,
    channel_id: String,
    guild_id: Option<String>,
    author: User,
    member: Option<GuildMember>,
    content: String,
    timestamp: String,
    edited_timestamp: Option<String>,
    tts: bool,
    mention_everyone: bool,
    mentions: Vec<User>,
    mention_roles: Vec<String>,
    // mentions_channels: Vec<ChannelMention>,
    // attatchments: Vec<Attachtment>,
    #[serde(default)]
    embed: Vec<Embed>,
    // reactions: Vec<Reactions>
    nonce: Option<String>,
    pinned: bool,
    webhook_id: Option<String>,
    #[serde(rename = "type")]
    kind: Option<u64>, // TODO: Use const enum
    // activity: MessageActivity,
    // application: MessageApplication,
    // message_reference: MessageReference
    flags: Option<u64>,
}

impl Message {
    /// Returns the message id
    pub fn id(&self) -> &str {
        &self.id
    }

    /// Returns the id of the channel the message was sent
    pub fn channel_id(&self) -> &str {
        &self.channel_id
    }

    /// Returns the id of the guild the message was sent in,
    pub fn guild_id(&self) -> Option<&str> {
        self.guild_id.as_ref().map(|s| s.as_str())
    }

    /// Returns the author of this message
    pub fn author(&self) -> &User {
        &self.author
    }

    /// Returns the guild member properties for this message's author
    pub fn member(&self) -> Option<&GuildMember> {
        self.member.as_ref()
    }

    /// Returns the contents of the message
    pub fn content(&self) -> &str {
        &self.content
    }

    /// Returns when this message was sent in ISO8601 timestamp
    pub fn timestamp(&self) -> &str {
        &self.timestamp
    }

    /// Returns when this message was edited (None if never) in ISO8601 timestamp
    pub fn edited_timestamp(&self) -> Option<&str> {
        self.edited_timestamp.as_ref().map(|v| v.as_str())
    }

    /// Returns whether this was a TTS message
    pub fn tts(&self) -> bool {
        self.tts
    }

    /// Returns whether this message mentions everyone
    pub fn mention_everyone(&self) -> bool {
        self.mention_everyone
    }

    /// Returns the users specifically mentioned in the message
    pub fn mentions(&self) -> &[User] {
        &self.mentions
    }

    /// Returns the roles specifically mentioned in this message
    pub fn mention_roles(&self) -> &[String] {
        &self.mention_roles
    }

    // pub fn mentions_channels(&self) -> &[ChannelMention] {
    //  &self.mentions_channels
    // }

    // pub fn attatchments(&self) -> &[Attachtment] {
    //  &self.attatchments
    // }

    pub fn embed(&self) -> &[Embed] {
        &self.embed
    }

    // pub fn reactions(&self) -> &[Reactions] {
    //  &self.reactions
    // }

    pub fn nonce(&self) -> Option<&str> {
        self.nonce.as_ref().map(|s| s.as_str())
    }

    pub fn pinned(&self) -> bool {
        self.pinned
    }

    pub fn webhook_id(&self) -> Option<&str> {
        self.webhook_id.as_ref().map(|v| v.as_str())
    }

    pub fn kind(&self) -> Option<u64> {
        self.kind
    }

    // activity: MessageActivity,
    // application: MessageApplication,
    // message_reference: MessageReference
    pub fn flags(&self) -> Option<u64> {
        self.flags
    }

    // HTTP

    pub async fn send_message(&self, http: &HttpClient, content: impl AsRef<str>) -> Result<Message> {
        http.send_message(self.channel_id(), content).await
    }

    pub async fn send_embed(&self, http: &HttpClient, embed: super::Embed) -> Result<Message> {
        http.send_embed(self.channel_id(), embed).await
    }
}