conogram 0.2.19

An async wrapper for Telegram Bot API
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

use std::{
    future::{Future, IntoFuture},
    pin::Pin,
};

use serde::Serialize;

use crate::{
    api::API,
    entities::{
        inline_query_result::InlineQueryResult,
        inline_query_results_button::InlineQueryResultsButton,
    },
    errors::ConogramError,
    impl_into_future,
    request::RequestT,
    utils::deserialize_utils::is_false,
};

#[derive(Debug, Clone, Serialize)]
pub struct AnswerInlineQueryParams {
    pub inline_query_id: String,
    pub results: Vec<InlineQueryResult>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cache_time: Option<i64>,
    #[serde(default, skip_serializing_if = "is_false")]
    pub is_personal: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub next_offset: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub button: Option<InlineQueryResultsButton>,
}

impl_into_future!(AnswerInlineQueryRequest<'a>);

///Use this method to send answers to an inline query. On success, *True* is returned.  
///No more than **50** results per query are allowed.
#[derive(Clone)]
pub struct AnswerInlineQueryRequest<'a> {
    api: &'a API,
    params: AnswerInlineQueryParams,
}

impl<'a> RequestT for AnswerInlineQueryRequest<'a> {
    type ParamsType = AnswerInlineQueryParams;
    type ReturnType = bool;
    fn get_name() -> &'static str {
        "answerInlineQuery"
    }
    fn get_api_ref(&self) -> &API {
        self.api
    }
    fn get_params_ref(&self) -> &Self::ParamsType {
        &self.params
    }
    fn is_multipart() -> bool {
        false
    }
}
impl<'a> AnswerInlineQueryRequest<'a> {
    pub fn new(
        api: &'a API,
        inline_query_id: impl Into<String>,
        results: impl IntoIterator<Item = impl Into<InlineQueryResult>>,
    ) -> Self {
        Self {
            api,
            params: AnswerInlineQueryParams {
                inline_query_id: inline_query_id.into(),
                results: results.into_iter().map(Into::into).collect(),
                cache_time: Option::default(),
                is_personal: bool::default(),
                next_offset: Option::default(),
                button: Option::default(),
            },
        }
    }

    ///Unique identifier for the answered query
    #[must_use]
    pub fn inline_query_id(mut self, inline_query_id: impl Into<String>) -> Self {
        self.params.inline_query_id = inline_query_id.into();
        self
    }

    ///A JSON-serialized array of results for the inline query
    #[must_use]
    pub fn results(
        mut self,
        results: impl IntoIterator<Item = impl Into<InlineQueryResult>>,
    ) -> Self {
        self.params.results = results.into_iter().map(Into::into).collect();
        self
    }

    ///The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300.
    #[must_use]
    pub fn cache_time(mut self, cache_time: impl Into<i64>) -> Self {
        self.params.cache_time = Some(cache_time.into());
        self
    }

    ///Pass *True* if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query.
    #[must_use]
    pub fn is_personal(mut self, is_personal: impl Into<bool>) -> Self {
        self.params.is_personal = is_personal.into();
        self
    }

    ///Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes.
    #[must_use]
    pub fn next_offset(mut self, next_offset: impl Into<String>) -> Self {
        self.params.next_offset = Some(next_offset.into());
        self
    }

    ///A JSON-serialized object describing a button to be shown above inline query results
    #[must_use]
    pub fn button(mut self, button: impl Into<InlineQueryResultsButton>) -> Self {
        self.params.button = Some(button.into());
        self
    }
}

impl API {
    ///Use this method to send answers to an inline query. On success, *True* is returned.  
    ///No more than **50** results per query are allowed.
    pub fn answer_inline_query(
        &self,
        inline_query_id: impl Into<String>,
        results: impl IntoIterator<Item = impl Into<InlineQueryResult>>,
    ) -> AnswerInlineQueryRequest {
        AnswerInlineQueryRequest::new(self, inline_query_id, results)
    }
}

// Divider: all content below this line will be preserved after code regen