rust-tg-bot-raw 1.0.0-rc.1

Pure Telegram Bot API types and methods for Rust -- a faithful port of python-telegram-bot's core layer
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

use super::{push_opt, push_opt_str, Bot, ChatId, Result};
use crate::request::request_parameter::RequestParameter;
use crate::types::{gifts, message_entity, owned_gift};

#[allow(dead_code)]
impl Bot {
    // ======================================================================
    // Gifts
    // ======================================================================

    /// Use this method to get the list of gifts that can be sent by the bot to users.
    ///
    /// Calls the Telegram `getAvailableGifts` API method.
    pub async fn get_available_gifts_raw(&self) -> Result<gifts::Gifts> {
        self.do_post("getAvailableGifts", Vec::new()).await
    }

    /// Use this method to send a gift to a user or channel chat.
    ///
    /// Calls the Telegram `sendGift` API method.
    pub async fn send_gift_raw(
        &self,
        gift_id: &str,
        user_id: Option<i64>,
        chat_id: Option<ChatId>,
        text: Option<&str>,
        text_parse_mode: Option<&str>,
        text_entities: Option<Vec<message_entity::MessageEntity>>,
        pay_for_upgrade: Option<bool>,
    ) -> Result<bool> {
        let mut params = vec![RequestParameter::new(
            "gift_id",
            serde_json::Value::String(gift_id.to_owned()),
        )];
        push_opt(&mut params, "user_id", &user_id)?;
        push_opt(&mut params, "chat_id", &chat_id)?;
        push_opt_str(&mut params, "text", text);
        push_opt_str(&mut params, "text_parse_mode", text_parse_mode);
        push_opt(&mut params, "text_entities", &text_entities)?;
        push_opt(&mut params, "pay_for_upgrade", &pay_for_upgrade)?;
        self.do_post("sendGift", params).await
    }

    /// Use this method to gift a Telegram Premium subscription to a user.
    ///
    /// Calls the Telegram `giftPremiumSubscription` API method.
    pub async fn gift_premium_subscription_raw(
        &self,
        user_id: i64,
        month_count: i64,
        star_count: i64,
        text: Option<&str>,
        text_parse_mode: Option<&str>,
        text_entities: Option<Vec<message_entity::MessageEntity>>,
    ) -> Result<bool> {
        let mut params = vec![
            RequestParameter::new("user_id", serde_json::to_value(user_id)?),
            RequestParameter::new("month_count", serde_json::to_value(month_count)?),
            RequestParameter::new("star_count", serde_json::to_value(star_count)?),
        ];
        push_opt_str(&mut params, "text", text);
        push_opt_str(&mut params, "text_parse_mode", text_parse_mode);
        push_opt(&mut params, "text_entities", &text_entities)?;
        self.do_post("giftPremiumSubscription", params).await
    }

    /// Use this method to get the list of gifts received by a user.
    ///
    /// Calls the Telegram `getUserGifts` API method.
    pub async fn get_user_gifts_raw(
        &self,
        user_id: i64,
        exclude_unlimited: Option<bool>,
        exclude_limited_upgradable: Option<bool>,
        exclude_limited_non_upgradable: Option<bool>,
        exclude_from_blockchain: Option<bool>,
        exclude_unique: Option<bool>,
        sort_by_price: Option<bool>,
        offset: Option<&str>,
        limit: Option<i64>,
    ) -> Result<owned_gift::OwnedGifts> {
        let mut params = vec![RequestParameter::new(
            "user_id",
            serde_json::to_value(user_id)?,
        )];
        push_opt(&mut params, "exclude_unlimited", &exclude_unlimited)?;
        push_opt(
            &mut params,
            "exclude_limited_upgradable",
            &exclude_limited_upgradable,
        )?;
        push_opt(
            &mut params,
            "exclude_limited_non_upgradable",
            &exclude_limited_non_upgradable,
        )?;
        push_opt(
            &mut params,
            "exclude_from_blockchain",
            &exclude_from_blockchain,
        )?;
        push_opt(&mut params, "exclude_unique", &exclude_unique)?;
        push_opt(&mut params, "sort_by_price", &sort_by_price)?;
        push_opt_str(&mut params, "offset", offset);
        push_opt(&mut params, "limit", &limit)?;
        self.do_post("getUserGifts", params).await
    }

    /// Use this method to get the list of gifts received by a chat.
    ///
    /// Calls the Telegram `getChatGifts` API method.
    pub async fn get_chat_gifts_raw(
        &self,
        chat_id: ChatId,
        exclude_unsaved: Option<bool>,
        exclude_saved: Option<bool>,
        exclude_unlimited: Option<bool>,
        exclude_limited_upgradable: Option<bool>,
        exclude_limited_non_upgradable: Option<bool>,
        exclude_from_blockchain: Option<bool>,
        exclude_unique: Option<bool>,
        sort_by_price: Option<bool>,
        offset: Option<&str>,
        limit: Option<i64>,
    ) -> Result<owned_gift::OwnedGifts> {
        let mut params = vec![RequestParameter::new(
            "chat_id",
            serde_json::to_value(&chat_id)?,
        )];
        push_opt(&mut params, "exclude_unsaved", &exclude_unsaved)?;
        push_opt(&mut params, "exclude_saved", &exclude_saved)?;
        push_opt(&mut params, "exclude_unlimited", &exclude_unlimited)?;
        push_opt(
            &mut params,
            "exclude_limited_upgradable",
            &exclude_limited_upgradable,
        )?;
        push_opt(
            &mut params,
            "exclude_limited_non_upgradable",
            &exclude_limited_non_upgradable,
        )?;
        push_opt(
            &mut params,
            "exclude_from_blockchain",
            &exclude_from_blockchain,
        )?;
        push_opt(&mut params, "exclude_unique", &exclude_unique)?;
        push_opt(&mut params, "sort_by_price", &sort_by_price)?;
        push_opt_str(&mut params, "offset", offset);
        push_opt(&mut params, "limit", &limit)?;
        self.do_post("getChatGifts", params).await
    }
}