ftracker_identifiers/isin/
serde.rs

1//! `Serialize`/`Deserialize` for [`Isin`], gated behind the `serde` feature.
2//!
3//! `Isin` (de)serializes as its canonical 12-character string (e.g. `"US0378331005"`), so it
4//! round-trips as a plain identifier in JSON/config files. Deserializing always re-runs full
5//! validation; an untrusted payload can never produce an invalid `Isin`.
6
7use ::serde::de::{self, Visitor};
8use ::serde::{Deserialize, Deserializer, Serialize, Serializer};
9use core::fmt;
10
11use super::Isin;
12
13impl Serialize for Isin {
14    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
15    where
16        S: Serializer,
17    {
18        serializer.serialize_str(self.as_str())
19    }
20}
21
22struct IsinVisitor;
23
24impl<'de> Visitor<'de> for IsinVisitor {
25    type Value = Isin;
26
27    fn expecting(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
28        f.write_str("a 12-character ISIN (ISO 6166), e.g. US0378331005")
29    }
30
31    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
32    where
33        E: de::Error,
34    {
35        Isin::parse(v).map_err(de::Error::custom)
36    }
37}
38
39impl<'de> Deserialize<'de> for Isin {
40    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
41    where
42        D: Deserializer<'de>,
43    {
44        deserializer.deserialize_str(IsinVisitor)
45    }
46}
47
48#[cfg(test)]
49mod tests {
50    use super::super::Isin;
51
52    #[test]
53    fn round_trips_through_json() {
54        let isin = Isin::parse("US0378331005").unwrap();
55        let json = serde_json::to_string(&isin).unwrap();
56        assert_eq!(json, "\"US0378331005\"");
57        let back: Isin = serde_json::from_str(&json).unwrap();
58        assert_eq!(isin, back);
59    }
60
61    #[test]
62    fn rejects_invalid_json_string() {
63        let err = serde_json::from_str::<Isin>("\"not-an-isin\"").unwrap_err();
64        assert!(err.to_string().contains("ISIN"));
65    }
66}
ftracker_identifiers/isin/serde.rs

ftracker_identifiers/isin/
serde.rs
