-
Notifications
You must be signed in to change notification settings - Fork 559
/
execute_webhook.rs
187 lines (174 loc) · 5.59 KB
/
execute_webhook.rs
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
use serde_json::Value;
use std::default::Default;
use utils::VecMap;
/// A builder to create the inner content of a [`Webhook`]'s execution.
///
/// This is a structured way of cleanly creating the inner execution payload,
/// to reduce potential argument counts.
///
/// Refer to the documentation for [`execute_webhook`] on restrictions with
/// execution payloads and its fields.
///
/// # Examples
///
/// Creating two embeds, and then sending them as part of the delivery
/// payload of [`Webhook::execute`]:
///
/// ```rust,no_run
/// use serenity::http;
/// use serenity::model::channel::Embed;
/// use serenity::utils::Colour;
///
/// let id = 245037420704169985;
/// let token = "ig5AO-wdVWpCBtUUMxmgsWryqgsW3DChbKYOINftJ4DCrUbnkedoYZD0VOH1QLr-S3sV";
///
/// let webhook = http::get_webhook_with_token(id, token)
/// .expect("valid webhook");
///
/// let website = Embed::fake(|e| e
/// .title("The Rust Language Website")
/// .description("Rust is a systems programming language.")
/// .colour(Colour::from_rgb(222, 165, 132)));
///
/// let resources = Embed::fake(|e| e
/// .title("Rust Resources")
/// .description("A few resources to help with learning Rust")
/// .colour(0xDEA584)
/// .field("The Rust Book", "A comprehensive resource for Rust.", false)
/// .field("Rust by Example", "A collection of Rust examples", false));
///
/// let _ = webhook.execute(false, |w| w
/// .content("Here's some information on Rust:")
/// .embeds(vec![website, resources]));
/// ```
///
/// [`Webhook`]: ../model/webhook/struct.Webhook.html
/// [`Webhook::execute`]: ../model/webhook/struct.Webhook.html#method.execute
/// [`execute_webhook`]: ../http/fn.execute_webhook.html
#[derive(Clone, Debug)]
pub struct ExecuteWebhook(pub VecMap<&'static str, Value>);
impl ExecuteWebhook {
/// Override the default avatar of the webhook with an image URL.
///
/// # Examples
///
/// Overriding the default avatar:
///
/// ```rust,no_run
/// # use serenity::http;
/// #
/// # let webhook = http::get_webhook_with_token(0, "").unwrap();
/// #
/// let avatar_url = "https://i.imgur.com/KTs6whd.jpg";
///
/// let _ = webhook.execute(false, |w| w
/// .avatar_url(avatar_url)
/// .content("Here's a webhook"));
/// ```
pub fn avatar_url(mut self, avatar_url: &str) -> Self {
self.0.insert("avatar_url", Value::String(avatar_url.to_string()));
self
}
/// Set the content of the message.
///
/// Note that when setting at least one embed via [`embeds`], this may be
/// omitted.
///
/// # Examples
///
/// Sending a webhook with a content of `"foo"`:
///
/// ```rust,no_run
/// # use serenity::client::rest;
/// #
/// # let webhook = rest::get_webhook_with_token(0, "").unwrap();
/// #
/// if let Err(why) = webhook.execute(false, |w| w.content("foo")) {
/// println!("Err sending webhook: {:?}", why);
/// }
/// ```
///
/// [`embeds`]: #method.embeds
pub fn content(mut self, content: &str) -> Self {
self.0.insert("content", Value::String(content.to_string()));
self
}
/// Set the embeds associated with the message.
///
/// This should be used in combination with [`Embed::fake`], creating one
/// or more fake embeds to send to the API.
///
/// # Examples
///
/// Refer to the [struct-level documentation] for an example on how to use
/// embeds.
///
/// [`Embed::fake`]: ../model/channel/struct.Embed.html#method.fake
/// [`Webhook::execute`]: ../model/webhook/struct.Webhook.html#method.execute
/// [struct-level documentation]: #examples
pub fn embeds(mut self, embeds: Vec<Value>) -> Self {
self.0.insert("embeds", Value::Array(embeds));
self
}
/// Whether the message is a text-to-speech message.
///
/// # Examples
///
/// Sending a webhook with text-to-speech enabled:
///
/// ```rust,no_run
/// # use serenity::client::rest;
/// #
/// # let webhook = rest::get_webhook_with_token(0, "").unwrap();
/// #
/// if let Err(why) = webhook.execute(false, |w| w.content("hello").tts(true)) {
/// println!("Err sending webhook: {:?}", why);
/// }
/// ```
pub fn tts(mut self, tts: bool) -> Self {
self.0.insert("tts", Value::Bool(tts));
self
}
/// Override the default username of the webhook.
///
/// # Examples
///
/// Overriuding the username to `"hakase"`:
///
/// ```rust,no_run
/// # use serenity::client::rest;
/// #
/// # let webhook = rest::get_webhook_with_token(0, "").unwrap();
/// #
/// if let Err(why) = webhook.execute(false, |w| w.content("hello").username("hakase")) {
/// println!("Err sending webhook: {:?}", why);
/// }
/// ```
pub fn username(mut self, username: &str) -> Self {
self.0.insert("username", Value::String(username.to_string()));
self
}
}
impl Default for ExecuteWebhook {
/// Returns a default set of values for a [`Webhook`] execution.
///
/// The only default value is [`tts`] being set to `false`.
///
/// # Examples
///
/// Creating an `ExecuteWebhook` builder:
///
/// ```rust
/// use serenity::builder::ExecuteWebhook;
///
/// let executer = ExecuteWebhook::default();
/// ```
///
/// [`Webhook`]: ../model/webhook/struct.Webhook.html
/// [`tts`]: #method.tts
fn default() -> ExecuteWebhook {
let mut map = VecMap::new();
map.insert("tts", Value::Bool(false));
ExecuteWebhook(map)
}
}