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
use serde::Serialize;

/// Represents a [`LoginUrl`].
///
/// [`LoginUrl`]: https://core.telegram.org/bots/api#loginurl
#[derive(Debug, PartialEq, Eq, Clone, Copy, Hash, Serialize)]
#[must_use]
pub struct LoginUrl<'a> {
    url: &'a str,
    #[serde(skip_serializing_if = "Option::is_none")]
    forward_text: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    bot_username: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    request_write_access: Option<bool>,
}

impl<'a> LoginUrl<'a> {
    /// Constructs a new `LoginUrl`.
    pub const fn new(url: &'a str) -> Self {
        Self {
            url,
            forward_text: None,
            bot_username: None,
            request_write_access: None,
        }
    }

    /// Configures `forward_text`.
    pub fn forward_text(mut self, text: &'a str) -> Self {
        self.forward_text = Some(text);
        self
    }

    /// Configures `bot_username`.
    pub fn bot_username(mut self, username: &'a str) -> Self {
        self.bot_username = Some(username);
        self
    }

    /// Configures `request_write_access`.
    pub fn should_request_write_access(mut self, should_request: bool) -> Self {
        self.request_write_access = Some(should_request);
        self
    }

    #[doc(hidden)]
    #[deprecated(
        since = "0.6.6",
        note = "this method is renamed to `should_request_write_access`"
    )]
    pub fn request_write_access(self, should_request: bool) -> Self {
        self.should_request_write_access(should_request)
    }
}