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

use serde::{Deserialize, Serialize};
/// This object describes the bot's menu button in a private chat. It should be one of
/// - [`crate::types::MenuButtonCommands`]
/// - [`crate::types::MenuButtonWebApp`]
/// - [`crate::types::MenuButtonDefault`]
///
/// If a menu button other than [`crate::types::MenuButtonDefault`] is set for a private chat, then it is applied in the chat. Otherwise the default menu button is applied. By default, the menu button opens the list of bot commands.
/// # Documentation
/// <https://core.telegram.org/bots/api#menubutton>
#[derive(Clone, Debug, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum MenuButton {
    Commands(crate::types::MenuButtonCommands),
    WebApp(crate::types::MenuButtonWebApp),
    Default(crate::types::MenuButtonDefault),
}
impl MenuButton {
    /// Helper method for field `text`.
    ///
    /// Text on the button
    #[must_use]
    pub fn text(&self) -> Option<&str> {
        match self {
            Self::WebApp(val) => Some(val.text.as_ref()),
            _ => None,
        }
    }

    /// Helper method for field `web_app`.
    ///
    /// Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Alternatively, a t.me link to a Web App of the bot can be specified in the object instead of the Web App's URL, in which case the Web App will be opened as if the user pressed the link.
    #[must_use]
    pub fn web_app(&self) -> Option<&crate::types::WebAppInfo> {
        match self {
            Self::WebApp(val) => Some(&val.web_app),
            _ => None,
        }
    }

    /// Helper method for nested field `url`.
    #[must_use]
    pub fn url(&self) -> Option<&str> {
        match self {
            Self::WebApp(val) => {
                let inner = &val.web_app;
                Some(inner.url.as_ref())
            }
            _ => None,
        }
    }
}
impl From<crate::types::MenuButtonCommands> for MenuButton {
    fn from(val: crate::types::MenuButtonCommands) -> Self {
        Self::Commands(val)
    }
}
impl TryFrom<MenuButton> for crate::types::MenuButtonCommands {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: MenuButton) -> Result<Self, Self::Error> {
        if let MenuButton::Commands(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(
                stringify!(MenuButton),
                stringify!(MenuButtonCommands),
            ))
        }
    }
}
impl From<crate::types::MenuButtonWebApp> for MenuButton {
    fn from(val: crate::types::MenuButtonWebApp) -> Self {
        Self::WebApp(val)
    }
}
impl TryFrom<MenuButton> for crate::types::MenuButtonWebApp {
    type Error = crate::errors::ConvertToTypeError;

    fn try_from(val: MenuButton) -> Result<Self, Self::Error> {
        if let MenuButton::WebApp(inner) = val {
            Ok(inner)
        } else {
            Err(Self::Error::new(
                stringify!(MenuButton),
                stringify!(MenuButtonWebApp),
            ))
        }
    }
}
impl From<crate::types::MenuButtonDefault> for MenuButton {
    fn from(val: crate::types::MenuButtonDefault) -> Self {
        Self::Default(val)
    }
}
impl TryFrom<MenuButton> for crate::types::MenuButtonDefault {
    type Error = crate::errors::ConvertToTypeError;

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