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
use crate::twitch::{
parse_badges, parse_badges_iter, parse_emotes, Badge, BadgeKind, Color, Emotes,
};
use crate::{irc::*, MaybeOwned, MaybeOwnedIndex, Validator};
/// Message sent by another user to your user (a 'DM')
#[derive(Clone, PartialEq)]
pub struct Whisper<'a> {
raw: MaybeOwned<'a>,
tags: TagIndices,
name: MaybeOwnedIndex,
data: MaybeOwnedIndex,
}
impl<'a> Whisper<'a> {
raw!();
tags!();
str_field!(
/// User who sent this messages
name
);
str_field!(
/// Data that the user provided
data
);
/// The color of the user who sent this message, if set
pub fn color(&self) -> Option<Color> {
self.tags().get_parsed("color")
}
/// Returns the display name of the user, if set.
///
/// Users can changed the casing and encoding of their names, if they choose
/// to.
///
/// By default, their display name is not set. If the user **foo** changes
/// their display name to **FOO** then this'll return that **FOO**.
///
/// Otherwise it'll return `None`.
pub fn display_name(&'a self) -> Option<&'a str> {
self.tags().get("display-name")
}
/// Badges attached to this message
pub fn badges(&'a self) -> Vec<Badge<'a>> {
self.tags()
.get("badges")
.map(parse_badges)
.unwrap_or_default()
}
/// Emotes attached to this message
pub fn emotes(&self) -> Vec<Emotes> {
self.tags()
.get("emotes")
.map(parse_emotes)
.unwrap_or_default()
}
/// Whether the user sending this message was a staff member
pub fn is_staff(&self) -> bool {
self.contains_badge(BadgeKind::Staff)
}
/// Whether the user sending this message had turbo
pub fn is_turbo(&self) -> bool {
self.contains_badge(BadgeKind::Turbo)
}
/// Whether the user sending this message was a global moderator
pub fn is_global_moderator(&self) -> bool {
self.contains_badge(BadgeKind::GlobalMod)
}
/// The timestamp of when this message was received by Twitch
pub fn tmi_sent_ts(&self) -> Option<u64> {
self.tags().get_parsed("tmi-sent-ts")
}
/// The id of the user who sent this message
pub fn user_id(&self) -> Option<u64> {
self.tags().get_parsed("user-id")
}
fn contains_badge(&self, badge: BadgeKind<'_>) -> bool {
self.tags()
.get("badges")
.into_iter()
.flat_map(parse_badges_iter)
.any(|x| x.kind == badge)
}
}
impl<'a> FromIrcMessage<'a> for Whisper<'a> {
type Error = MessageError;
fn from_irc(msg: IrcMessage<'a>) -> Result<Self, Self::Error> {
msg.expect_command(IrcMessage::WHISPER)?;
// :sender WHISPER target :data
// we're the target, so ignore it
let this = Self {
name: msg.expect_nick()?,
data: msg.expect_data_index()?,
tags: msg.parse_tags(),
raw: msg.raw,
};
Ok(this)
}
into_inner_raw!();
}
into_owned!(Whisper {
raw,
tags,
name,
data,
});
impl_custom_debug!(Whisper {
raw,
tags,
name,
data,
});
serde_struct!(Whisper {
raw,
tags,
name,
data,
});
#[cfg(test)]
mod tests {
use super::*;
#[test]
#[cfg(feature = "serde")]
fn whisper_serde() {
let input = ":test!user@host WHISPER museun :this is a test\r\n";
crate::serde::round_trip_json::<Whisper>(input);
crate::serde::round_trip_rmp::<Whisper>(input);
}
#[test]
fn whisper() {
let input = ":test!user@host WHISPER museun :this is a test\r\n";
for msg in parse(input).map(|s| s.unwrap()) {
let msg = Whisper::from_irc(msg).unwrap();
assert_eq!(msg.name(), "test");
assert_eq!(msg.data(), "this is a test");
}
}
}