messagebird_async/sms/
identifier.rs

1use super::*;
2
3use serde::de::{self, Deserialize, Deserializer, Unexpected, Visitor};
4use serde::ser::{Serialize, Serializer};
5
6use std::fmt;
7use std::string::ToString;
8
9/// Unique message identifier
10///
11/// Consists 32 alphanumeric characters (may change!)
12///
13/// Generate by the MessageBird backend on posting the message.
14#[derive(Debug, Eq, PartialEq, Hash)]
15pub struct Identifier(String);
16
17impl Default for Identifier {
18    fn default() -> Self {
19        Identifier("00000000000000000000000000000000".to_string())
20    }
21}
22
23impl Identifier {
24    pub fn new(raw: String) -> Self {
25        Identifier(raw)
26    }
27    pub fn as_str(&self) -> &str {
28        self.0.as_str()
29    }
30}
31
32impl fmt::Display for Identifier {
33    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
34        write!(f, "{}", self.0)
35    }
36}
37
38impl FromStr for Identifier {
39    type Err = MessageBirdError;
40
41    fn from_str(s: &str) -> Result<Self, Self::Err> {
42        // XXX: taken from the example on the webpage
43        const VALID_LENGTH: usize = 32;
44        if s.len() != VALID_LENGTH {
45            Err(MessageBirdError::TypeError {
46                msg: format!(
47                    "unexpected id length {}, expected {}",
48                    s.len(),
49                    VALID_LENGTH
50                ),
51            })
52        } else {
53            Ok(Self::new(String::from(s)))
54        }
55    }
56}
57
58impl Serialize for Identifier {
59    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
60    where
61        S: Serializer,
62    {
63        serializer.serialize_str(self.as_str())
64    }
65}
66
67struct IdentifierVisitor;
68
69impl<'de> Visitor<'de> for IdentifierVisitor {
70    type Value = Identifier;
71
72    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
73        formatter.write_str("a valid identifier str with 32 characters")
74    }
75
76    fn visit_str<E>(self, value: &str) -> Result<Self::Value, E>
77    where
78        E: de::Error,
79    {
80        Identifier::from_str(value)
81            .map_err(|_e| de::Error::invalid_value(Unexpected::Str(value), &self))
82    }
83}
84
85impl<'de> Deserialize<'de> for Identifier {
86    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
87    where
88        D: Deserializer<'de>,
89    {
90        deserializer.deserialize_str(IdentifierVisitor)
91    }
92}
93
94#[cfg(test)]
95mod test {
96    use super::*;
97    static RAW: &str = r#"
98"01238dsfusd98ufe89hsdkncksadfkkr"
99"#;
100
101    deser_roundtrip!(identifier_deser, Identifier, RAW);
102    serde_roundtrip!(identifier_serde, Identifier, Identifier::default());
103}