eml-nl 0.5.0

Parse, manipulate and emit EML_NL documents
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
100
101
102
103

use std::borrow::Cow;

use crate::{
    EMLError, NS_XAL,
    io::{EMLElement, EMLElementReader, EMLElementWriter, QualifiedName},
};

/// Country name code information.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct CountryNameCode {
    /// The country name code value.
    pub value: String,
    /// The Scheme attribute, if present.
    pub scheme: Option<String>,
    /// The Code attribute, if present.
    pub code: Option<String>,
}

impl CountryNameCode {
    /// Create a new CountryNameCode.
    pub fn new(value: impl Into<String>) -> Self {
        CountryNameCode {
            value: value.into(),
            scheme: None,
            code: None,
        }
    }

    /// Set the Scheme attribute.
    pub fn with_scheme(mut self, scheme: impl Into<String>) -> Self {
        self.scheme = Some(scheme.into());
        self
    }

    /// Set the Code attribute.
    pub fn with_code(mut self, code: impl Into<String>) -> Self {
        self.code = Some(code.into());
        self
    }
}

impl From<String> for CountryNameCode {
    fn from(value: String) -> Self {
        CountryNameCode::new(value)
    }
}

impl From<&str> for CountryNameCode {
    fn from(value: &str) -> Self {
        CountryNameCode::new(value)
    }
}

impl EMLElement for CountryNameCode {
    const EML_NAME: QualifiedName<'_, '_> =
        QualifiedName::from_static("CountryNameCode", Some(NS_XAL));

    fn read_eml(elem: &mut EMLElementReader<'_, '_>) -> Result<Self, EMLError> {
        Ok(CountryNameCode {
            value: elem.text_without_children()?,
            scheme: elem.attribute_value("Scheme")?.map(Cow::into_owned),
            code: elem.attribute_value("Code")?.map(Cow::into_owned),
        })
    }

    fn write_eml(&self, writer: EMLElementWriter) -> Result<(), EMLError> {
        writer
            .attr_opt("Scheme", self.scheme.as_ref())?
            .attr_opt("Code", self.code.as_ref())?
            .text(self.value.as_ref())?
            .finish()
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::io::{EMLParsingMode, EMLRead, test_write_eml_element, test_xml_fragment};

    #[test]
    fn test_country_name_code_construction() {
        let cnc = CountryNameCode::new("Netherlands")
            .with_scheme("ISO3166")
            .with_code("NL");
        assert_eq!(cnc.value, "Netherlands");
        assert_eq!(cnc.scheme.as_deref(), Some("ISO3166"));
        assert_eq!(cnc.code.as_deref(), Some("NL"));
    }

    #[test]
    fn test_country_name_code_parsing() {
        let xml = test_xml_fragment(
            r#"<xal:CountryNameCode xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Scheme="ISO3166" Code="NL">Netherlands</xal:CountryNameCode>"#,
        );
        let cnc = CountryNameCode::parse_eml(&xml, EMLParsingMode::Strict).unwrap();
        assert_eq!(cnc.value, "Netherlands");
        assert_eq!(cnc.scheme.as_deref(), Some("ISO3166"));
        assert_eq!(cnc.code.as_deref(), Some("NL"));

        let xml_output = test_write_eml_element(&cnc, &[NS_XAL]).unwrap();
        assert_eq!(xml_output, xml);
    }
}