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
188
189
190
|
use std::fmt;
use super::utils::{into_map, into_string, remove};
use super::{
CurrentUser,
FriendSourceFlags,
GuildContainer,
GuildId,
GuildInfo,
Mention,
RoleId,
UserSettings,
User,
};
use ::client::rest::GuildPagination;
use ::internal::prelude::*;
use ::utils::decode_array;
#[cfg(feature = "methods")]
use serde_json::builder::ObjectBuilder;
#[cfg(feature = "methods")]
use super::Message;
#[cfg(feature = "methods")]
use time::Timespec;
#[cfg(feature = "methods")]
use ::client::rest;
#[cfg(feature = "cache")]
use ::client::CACHE;
impl CurrentUser {
/// Returns the formatted URL of the user's icon, if one exists.
pub fn avatar_url(&self) -> Option<String> {
self.avatar.as_ref().map(|av|
format!(cdn!("/avatars/{}/{}.jpg"), self.id, av))
}
/// Gets a list of guilds that the current user is in.
pub fn guilds(&self) -> Result<Vec<GuildInfo>> {
rest::get_guilds(GuildPagination::After(GuildId(0)), 100)
}
}
impl User {
/// Returns the formatted URL of the user's icon, if one exists.
pub fn avatar_url(&self) -> Option<String> {
self.avatar.as_ref().map(|av|
format!(cdn!("/avatars/{}/{}.jpg"), self.id, av))
}
/// Retrieves the time that this user was created at.
#[cfg(feature = "methods")]
#[inline]
pub fn created_at(&self) -> Timespec {
self.id.created_at()
}
/// This is an alias of [direct_message].
///
/// [direct_message]: #method.direct_message
#[cfg(feature="methods")]
pub fn dm(&self, content: &str) -> Result<Message> {
self.direct_message(content)
}
/// Send a direct message to a user. This will create or retrieve the
/// PrivateChannel over REST if one is not already in the cache, and then
/// send a message to it.
#[cfg(feature="methods")]
pub fn direct_message(&self, content: &str)
-> Result<Message> {
let private_channel_id = feature_cache! {{
let finding = CACHE.read()
.unwrap()
.private_channels
.values()
.find(|ch| ch.recipient.id == self.id)
.map(|ch| ch.id);
if let Some(finding) = finding {
finding
} else {
let map = ObjectBuilder::new()
.insert("recipient_id", self.id.0)
.build();
try!(rest::create_private_channel(map)).id
}
} else {
let map = ObjectBuilder::new()
.insert("recipient_id", self.id.0)
.build();
try!(rest::create_private_channel(map)).id
}};
let map = ObjectBuilder::new()
.insert("content", content)
.insert("nonce", "")
.insert("tts", false)
.build();
rest::send_message(private_channel_id.0, map)
}
/// Check if a user has a [`Role`]. This will retrieve the
/// [`Guild`] from the [`Cache`] if it is available, and then check if that
/// guild has the given [`Role`].
///
/// If the [`Guild`] is not present, then the guild will be retrieved from
/// the API and the cache will be updated with it.
///
/// If there are issues with requesting the API, then `false` will be
/// returned.
///
/// Three forms of data may be passed in to the guild parameter: either a
/// [`Guild`] itself, a [`GuildId`], or a `u64`.
///
/// # Examples
///
/// Check if a guild has a [`Role`] by Id:
///
/// ```rust,ignore
/// // Assumes a 'guild' and `role_id` have already been bound
/// context.message.author.has_role(guild, role_id);
/// ```
///
/// [`Guild`]: struct.Guild.html
/// [`GuildId`]: struct.GuildId.html
/// [`Role`]: struct.Role.html
/// [`Cache`]: ../ext/cache/struct.Cache.html
pub fn has_role<G, R>(&self, guild: G, role: R) -> bool
where G: Into<GuildContainer>, R: Into<RoleId> {
let role_id = role.into();
match guild.into() {
GuildContainer::Guild(guild) => {
guild.roles.get(&role_id).is_some()
},
GuildContainer::Id(guild_id) => {
feature_cache! {{
let cache = CACHE.read().unwrap();
cache.get_role(guild_id, role_id).is_some()
} else {
true
}}
},
}
}
/// Return a [`Mention`] which will ping this user.
///
/// [`Mention`]: struct.Mention.html
pub fn mention(&self) -> Mention {
self.id.mention()
}
}
impl fmt::Display for User {
/// Formats a string which will mention the user.
// This is in the format of: `<@USER_ID>`
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
fmt::Display::fmt(&self.id.mention(), f)
}
}
impl UserSettings {
#[doc(hidden)]
pub fn decode(value: Value) -> Result<Option<UserSettings>> {
let mut map = try!(into_map(value));
if map.is_empty() {
return Ok(None);
}
Ok(UserSettings {
convert_emoticons: req!(try!(remove(&mut map, "convert_emoticons")).as_bool()),
enable_tts_command: req!(try!(remove(&mut map, "enable_tts_command")).as_bool()),
friend_source_flags: try!(remove(&mut map, "friend_source_flags").and_then(FriendSourceFlags::decode)),
inline_attachment_media: req!(try!(remove(&mut map, "inline_attachment_media")).as_bool()),
inline_embed_media: req!(try!(remove(&mut map, "inline_embed_media")).as_bool()),
locale: try!(remove(&mut map, "locale").and_then(into_string)),
message_display_compact: req!(try!(remove(&mut map, "message_display_compact")).as_bool()),
render_embeds: req!(try!(remove(&mut map, "render_embeds")).as_bool()),
restricted_guilds: try!(remove(&mut map, "restricted_guilds").and_then(|v| decode_array(v, GuildId::decode))),
show_current_game: req!(try!(remove(&mut map, "show_current_game")).as_bool()),
theme: try!(remove(&mut map, "theme").and_then(into_string)),
}).map(Some)
}
}
|