rust_tdlib/types/
contact.rs

1use crate::errors::Result;
2use crate::types::*;
3use uuid::Uuid;
4
5/// Describes a user contact
6#[derive(Debug, Clone, Default, Serialize, Deserialize)]
7pub struct Contact {
8    #[doc(hidden)]
9    #[serde(rename(serialize = "@extra", deserialize = "@extra"))]
10    extra: Option<String>,
11    #[serde(rename(serialize = "@client_id", deserialize = "@client_id"))]
12    client_id: Option<i32>,
13    /// Phone number of the user
14
15    #[serde(default)]
16    phone_number: String,
17    /// First name of the user; 1-255 characters in length
18
19    #[serde(default)]
20    first_name: String,
21    /// Last name of the user
22
23    #[serde(default)]
24    last_name: String,
25    /// Additional data about the user in a form of vCard; 0-2048 bytes in length
26
27    #[serde(default)]
28    vcard: String,
29    /// Identifier of the user, if known; otherwise 0
30
31    #[serde(default)]
32    user_id: i64,
33}
34
35impl RObject for Contact {
36    #[doc(hidden)]
37    fn extra(&self) -> Option<&str> {
38        self.extra.as_deref()
39    }
40    #[doc(hidden)]
41    fn client_id(&self) -> Option<i32> {
42        self.client_id
43    }
44}
45
46impl Contact {
47    pub fn from_json<S: AsRef<str>>(json: S) -> Result<Self> {
48        Ok(serde_json::from_str(json.as_ref())?)
49    }
50    pub fn builder() -> ContactBuilder {
51        let mut inner = Contact::default();
52        inner.extra = Some(Uuid::new_v4().to_string());
53
54        ContactBuilder { inner }
55    }
56
57    pub fn phone_number(&self) -> &String {
58        &self.phone_number
59    }
60
61    pub fn first_name(&self) -> &String {
62        &self.first_name
63    }
64
65    pub fn last_name(&self) -> &String {
66        &self.last_name
67    }
68
69    pub fn vcard(&self) -> &String {
70        &self.vcard
71    }
72
73    pub fn user_id(&self) -> i64 {
74        self.user_id
75    }
76}
77
78#[doc(hidden)]
79pub struct ContactBuilder {
80    inner: Contact,
81}
82
83#[deprecated]
84pub type RTDContactBuilder = ContactBuilder;
85
86impl ContactBuilder {
87    pub fn build(&self) -> Contact {
88        self.inner.clone()
89    }
90
91    pub fn phone_number<T: AsRef<str>>(&mut self, phone_number: T) -> &mut Self {
92        self.inner.phone_number = phone_number.as_ref().to_string();
93        self
94    }
95
96    pub fn first_name<T: AsRef<str>>(&mut self, first_name: T) -> &mut Self {
97        self.inner.first_name = first_name.as_ref().to_string();
98        self
99    }
100
101    pub fn last_name<T: AsRef<str>>(&mut self, last_name: T) -> &mut Self {
102        self.inner.last_name = last_name.as_ref().to_string();
103        self
104    }
105
106    pub fn vcard<T: AsRef<str>>(&mut self, vcard: T) -> &mut Self {
107        self.inner.vcard = vcard.as_ref().to_string();
108        self
109    }
110
111    pub fn user_id(&mut self, user_id: i64) -> &mut Self {
112        self.inner.user_id = user_id;
113        self
114    }
115}
116
117impl AsRef<Contact> for Contact {
118    fn as_ref(&self) -> &Contact {
119        self
120    }
121}
122
123impl AsRef<Contact> for ContactBuilder {
124    fn as_ref(&self) -> &Contact {
125        &self.inner
126    }
127}
rust_tdlib/types/contact.rs

rust_tdlib/types/
contact.rs
