rust-tdlib 0.4.3

TDlib (Telegram Database library) client
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

use crate::errors::Result;
use crate::types::*;
use uuid::Uuid;

/// An object of this type can be returned on every function call, in case of an error
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct Error {
    #[doc(hidden)]
    #[serde(rename(serialize = "@extra", deserialize = "@extra"))]
    extra: Option<String>,
    #[serde(rename(serialize = "@client_id", deserialize = "@client_id"))]
    client_id: Option<i32>,
    /// Error code; subject to future changes. If the error code is 406, the error message must not be processed in any way and must not be displayed to the user

    #[serde(default)]
    code: i32,
    /// Error message; subject to future changes

    #[serde(default)]
    message: String,
}

impl RObject for Error {
    #[doc(hidden)]
    fn extra(&self) -> Option<&str> {
        self.extra.as_deref()
    }
    #[doc(hidden)]
    fn client_id(&self) -> Option<i32> {
        self.client_id
    }
}

impl Error {
    pub fn from_json<S: AsRef<str>>(json: S) -> Result<Self> {
        Ok(serde_json::from_str(json.as_ref())?)
    }
    pub fn builder() -> ErrorBuilder {
        let mut inner = Error::default();
        inner.extra = Some(Uuid::new_v4().to_string());

        ErrorBuilder { inner }
    }

    pub fn code(&self) -> i32 {
        self.code
    }

    pub fn message(&self) -> &String {
        &self.message
    }
}

#[doc(hidden)]
pub struct ErrorBuilder {
    inner: Error,
}

#[deprecated]
pub type RTDErrorBuilder = ErrorBuilder;

impl ErrorBuilder {
    pub fn build(&self) -> Error {
        self.inner.clone()
    }

    pub fn code(&mut self, code: i32) -> &mut Self {
        self.inner.code = code;
        self
    }

    pub fn message<T: AsRef<str>>(&mut self, message: T) -> &mut Self {
        self.inner.message = message.as_ref().to_string();
        self
    }
}

impl AsRef<Error> for Error {
    fn as_ref(&self) -> &Error {
        self
    }
}

impl AsRef<Error> for ErrorBuilder {
    fn as_ref(&self) -> &Error {
        &self.inner
    }
}