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
104

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

/// Name of a locality
#[derive(Debug, Clone)]
pub struct LocalityName {
    /// Name of the locality
    pub name: String,
    /// Type of the locality, if any
    pub locality_type: Option<String>,
    /// Associated code for the locality, if any
    pub code: Option<String>,
}

impl LocalityName {
    /// Creates a new `LocalityName` with the given name and no type or code.
    pub fn new(name: impl Into<String>) -> Self {
        LocalityName {
            name: name.into(),
            locality_type: None,
            code: None,
        }
    }

    /// Sets the type of the locality and returns the modified `LocalityName`.
    pub fn with_type(mut self, locality_type: impl Into<String>) -> Self {
        self.locality_type = Some(locality_type.into());
        self
    }

    /// Sets the code of the locality and returns the modified `LocalityName`.
    pub fn with_code(mut self, code: impl Into<String>) -> Self {
        self.code = Some(code.into());
        self
    }
}

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

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

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

    fn read_eml(elem: &mut EMLElementReader<'_, '_>) -> Result<Self, EMLError> {
        Ok(LocalityName {
            name: elem.text_without_children()?,
            locality_type: elem.attribute_value("Type")?.map(|s| s.into_owned()),
            code: elem.attribute_value("Code")?.map(|s| s.into_owned()),
        })
    }

    fn write_eml(&self, writer: EMLElementWriter) -> Result<(), EMLError> {
        let mut writer = writer;
        if let Some(ref locality_type) = self.locality_type {
            writer = writer.attr("Type", locality_type)?;
        }
        if let Some(ref code) = self.code {
            writer = writer.attr("Code", code)?;
        }
        writer.text(&self.name)?.finish()
    }
}

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

    #[test]
    fn test_locality_name_construction() {
        let loc = LocalityName::new("Amsterdam")
            .with_type("City")
            .with_code("AMS");
        assert_eq!(loc.name, "Amsterdam");
        assert_eq!(loc.locality_type.as_deref(), Some("City"));
        assert_eq!(loc.code.as_deref(), Some("AMS"));
    }

    #[test]
    fn test_locality_name_parsing() {
        let xml = test_xml_fragment(
            r#"<xal:LocalityName xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" Type="City" Code="AMS">Amsterdam</xal:LocalityName>"#,
        );
        let loc = LocalityName::parse_eml(&xml, EMLParsingMode::Strict).unwrap();
        assert_eq!(loc.name, "Amsterdam");
        assert_eq!(loc.locality_type.as_deref(), Some("City"));
        assert_eq!(loc.code.as_deref(), Some("AMS"));

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