telers 1.0.0-beta.2

An asynchronous framework for Telegram Bot API written in Rust
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169

use serde::{Deserialize, Serialize};
/// This object represents a chat.
/// Currently, it can be one of
/// - [`crate::types::ChatChannel`]
/// - [`crate::types::ChatGroup`]
/// - [`crate::types::ChatPrivate`]
/// - [`crate::types::ChatSupergroup`]
/// # Documentation
/// <https://core.telegram.org/bots/api#chat>
#[derive(Clone, Debug, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum Chat {
    Private(crate::types::ChatPrivate),
    Group(crate::types::ChatGroup),
    Supergroup(crate::types::ChatSupergroup),
    Channel(crate::types::ChatChannel),
}
impl Chat {
    /// Helper method for field `first_name`.
    ///
    /// First name of the other party in a private chat
    #[must_use]
    pub fn first_name(&self) -> Option<&str> {
        match self {
            Self::Private(val) => val.first_name.as_deref(),
            _ => None,
        }
    }

    /// Helper method for field `id`.
    ///
    /// Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.
    #[must_use]
    pub fn id(&self) -> i64 {
        match self {
            Self::Private(val) => val.id,
            Self::Group(val) => val.id,
            Self::Supergroup(val) => val.id,
            Self::Channel(val) => val.id,
        }
    }

    /// Helper method for field `is_direct_messages`.
    ///
    /// `true`, if the chat is the direct messages chat of a channel
    #[must_use]
    pub fn is_direct_messages(&self) -> Option<bool> {
        match self {
            Self::Private(val) => val.is_direct_messages,
            Self::Group(val) => val.is_direct_messages,
            Self::Supergroup(val) => val.is_direct_messages,
            Self::Channel(val) => val.is_direct_messages,
        }
    }

    /// Helper method for field `is_forum`.
    ///
    /// `true`, if the supergroup chat is a forum (has topics enabled)
    #[must_use]
    pub fn is_forum(&self) -> Option<bool> {
        match self {
            Self::Supergroup(val) => val.is_forum,
            _ => None,
        }
    }

    /// Helper method for field `last_name`.
    ///
    /// Last name of the other party in a private chat
    #[must_use]
    pub fn last_name(&self) -> Option<&str> {
        match self {
            Self::Private(val) => val.last_name.as_deref(),
            _ => None,
        }
    }

    /// Helper method for field `title`.
    ///
    /// Title, for supergroups, channels and group chats
    #[must_use]
    pub fn title(&self) -> Option<&str> {
        match self {
            Self::Supergroup(val) => val.title.as_deref(),
            Self::Channel(val) => val.title.as_deref(),
            _ => None,
        }
    }

    /// Helper method for field `username`.
    ///
    /// Username, for private chats, supergroups and channels if available
    #[must_use]
    pub fn username(&self) -> Option<&str> {
        match self {
            Self::Private(val) => val.username.as_deref(),
            Self::Supergroup(val) => val.username.as_deref(),
            Self::Channel(val) => val.username.as_deref(),
            Self::Group(_) => None,
        }
    }
}
impl From<crate::types::ChatPrivate> for Chat {
    fn from(val: crate::types::ChatPrivate) -> Self {
        Self::Private(val)
    }
}
impl TryFrom<Chat> for crate::types::ChatPrivate {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: Chat) -> Result<Self, Self::Error> {
        if let Chat::Private(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(stringify!(Chat), stringify!(ChatPrivate)))
        }
    }
}
impl From<crate::types::ChatGroup> for Chat {
    fn from(val: crate::types::ChatGroup) -> Self {
        Self::Group(val)
    }
}
impl TryFrom<Chat> for crate::types::ChatGroup {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: Chat) -> Result<Self, Self::Error> {
        if let Chat::Group(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(stringify!(Chat), stringify!(ChatGroup)))
        }
    }
}
impl From<crate::types::ChatSupergroup> for Chat {
    fn from(val: crate::types::ChatSupergroup) -> Self {
        Self::Supergroup(val)
    }
}
impl TryFrom<Chat> for crate::types::ChatSupergroup {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: Chat) -> Result<Self, Self::Error> {
        if let Chat::Supergroup(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(
                stringify!(Chat),
                stringify!(ChatSupergroup),
            ))
        }
    }
}
impl From<crate::types::ChatChannel> for Chat {
    fn from(val: crate::types::ChatChannel) -> Self {
        Self::Channel(val)
    }
}
impl TryFrom<Chat> for crate::types::ChatChannel {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: Chat) -> Result<Self, Self::Error> {
        if let Chat::Channel(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(stringify!(Chat), stringify!(ChatChannel)))
        }
    }
}