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
|
use serde_json::Value;
use std::collections::BTreeMap;
use std::default::Default;
/// A builder to specify the contents of an [`http::create_message`] request,
/// primarily meant for use through [`Context::send_message`].
///
/// `content` is the only required field.
///
/// Note that if you only need to send the content of a message, without
/// specifying other fields, then [`Context::say`] may be a more preferable
/// option.
///
/// # Examples
///
/// Sending a message with a content of `test` and applying text-to-speech:
///
/// ```rust,ignore
/// // assuming you are in a context
/// context.send_message(message.channel_id, |m|
/// .content("test")
/// .tts(true));
/// ```
///
/// [`Context::say`]: ../../client/struct.Context.html#method.say
/// [`Context::send_message`]: ../../client/struct.Context.html#method.send_message
/// [`http::create_message`]: ../../client/http/fn.create_message.html
pub struct CreateMessage(pub BTreeMap<String, Value>);
impl CreateMessage {
/// Set the content of the message.
///
/// **Note**: Message contents must be under 2000 unicode code points.
pub fn content(mut self, content: &str) -> Self {
self.0.insert("content".to_owned(), Value::String(content.to_owned()));
CreateMessage(self.0)
}
/// Set the nonce. This is used for validation of a sent message. You most
/// likely don't need to worry about this.
///
/// Defaults to empty.
pub fn nonce(mut self, nonce: &str) -> Self {
self.0.insert("nonce".to_owned(), Value::String(nonce.to_owned()));
CreateMessage(self.0)
}
/// Set whether the message is text-to-speech.
///
/// Think carefully before setting this to `true`.
///
/// Defaults to `false`.
pub fn tts(mut self, tts: bool) -> Self {
self.0.insert("tts".to_owned(), Value::Bool(tts));
CreateMessage(self.0)
}
}
impl Default for CreateMessage {
/// Creates a map for sending a [`Message`], setting `tts` to `false` by
/// default.
fn default() -> CreateMessage {
let mut map = BTreeMap::default();
map.insert("tts".to_owned(), Value::Bool(false));
CreateMessage(map)
}
}
|