celes 3.0.0

Rust crate for handling ISO 3166-1 and optionally ISO 3166-2. Each country has a three digit code, two letter code, three letter code, full state name, short English aliases, and optional subdivision data.
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
89
90
91
92
93
94
95
96
97
98
99

//! Serialization round trips, behind the `serde` feature.
#![cfg(feature = "serde")]

use celes::Country;
use serde::{Deserialize, Serialize};
use std::error::Error;

#[derive(Debug, Deserialize, Eq, PartialEq, Serialize)]
struct CountryDocument {
    country: Country,
}

#[test]
fn every_country_round_trips_as_json() -> Result<(), serde_json::Error> {
    for c in Country::countries() {
        let json = serde_json::to_string(c)?;
        let res: Country = serde_json::from_str(&json)?;
        assert_eq!(res, *c);
    }

    assert!(serde_json::from_str::<Country>("42").is_err());
    assert!(serde_json::from_str::<Country>("\"ZZ\"").is_err());

    Ok(())
}

#[test]
fn serialization_formats_round_trip() -> Result<(), Box<dyn Error>> {
    let expected = CountryDocument {
        country: Country::the_united_states_of_america(),
    };

    let json = serde_json::to_string(&expected)?;
    let json_value = serde_json::from_str(&json)?;
    assert_eq!(expected, json_value);

    let postcard = postcard::to_allocvec(&expected)?;
    let postcard_value = postcard::from_bytes(&postcard)?;
    assert_eq!(expected, postcard_value);

    let cbor = serde_cbor_2::to_vec(&expected)?;
    let cbor_value = serde_cbor_2::from_slice(&cbor)?;
    assert_eq!(expected, cbor_value);

    let toml = toml::to_string(&expected)?;
    let toml_value = toml::from_str(&toml)?;
    assert_eq!(expected, toml_value);

    let yaml = yaml_serde::to_string(&expected)?;
    let yaml_value = yaml_serde::from_str(&yaml)?;
    assert_eq!(expected, yaml_value);

    Ok(())
}

#[cfg(feature = "subdivisions")]
mod subdivisions {
    use celes::Subdivision;
    use serde::{Deserialize, Serialize};
    use std::{error::Error, str::FromStr};

    #[derive(Debug, Deserialize, Eq, PartialEq, Serialize)]
    struct SubdivisionDocument {
        subdivision: Subdivision,
    }

    #[test]
    fn serialization_formats_round_trip() -> Result<(), Box<dyn Error>> {
        let expected = SubdivisionDocument {
            subdivision: Subdivision::from_str("US-CA")?,
        };

        let json = serde_json::to_string(&expected)?;
        assert_eq!(json, r#"{"subdivision":"US-CA"}"#);
        let json_value = serde_json::from_str(&json)?;
        assert_eq!(expected, json_value);

        let postcard = postcard::to_allocvec(&expected)?;
        let postcard_value = postcard::from_bytes(&postcard)?;
        assert_eq!(expected, postcard_value);

        let cbor = serde_cbor_2::to_vec(&expected)?;
        let cbor_value = serde_cbor_2::from_slice(&cbor)?;
        assert_eq!(expected, cbor_value);

        let toml = toml::to_string(&expected)?;
        let toml_value = toml::from_str(&toml)?;
        assert_eq!(expected, toml_value);

        let yaml = yaml_serde::to_string(&expected)?;
        let yaml_value = yaml_serde::from_str(&yaml)?;
        assert_eq!(expected, yaml_value);

        assert!(serde_json::from_str::<Subdivision>("42").is_err());
        assert!(serde_json::from_str::<Subdivision>("\"US-ZZ\"").is_err());

        Ok(())
    }
}