earth 0.0.2

The alternative library of libearth, the shared common library for various Earth Reader apps.
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use std::fmt;
use std::io;

use html::ForHtml;
use sanitizer::escape;

use parser::base::{DecodeResult, XmlElement};
use schema::{FromSchemaReader, Mergeable};


/// Identify the agent used to generate a feed, for debugging and other
/// purposes.  It's corresponds to ``atom:generator`` element of
/// :rfc:`4287#section-4.2.4` (section 4.2.4).
#[derive(Default, PartialEq, Eq)]
pub struct Generator {
    /// A URI that represents something relavent to the agent.
    pub uri: Option<String>,
    /// The version of the generating agent.
    pub version: Option<String>,
    /// The human-readable name for the generating agent.
    pub value: String,
}

impl fmt::Display for Generator {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        try!(write!(f, "{}", self.value));
        if let Some(ref version) = self.version {
            try!(write!(f, " {}", version));
        }
        Ok(())
    }
}

impl<'a> fmt::Display for ForHtml<'a, Generator> {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        if let Some(ref uri) = self.uri {
            try!(write!(f, "<a href=\"{}\">", escape(&uri, false)));
        }
        try!(write!(f, "{}", escape(&self.value, false)));
        if let Some(ref version) = self.version {
            try!(write!(f, " {}", version));
        }
        if let Some(_) = self.uri {
            try!(write!(f, "</a>"));
        }
        Ok(())
    }
}

impl FromSchemaReader for Generator {
    fn read_from<B: io::BufRead>(&mut self, element: XmlElement<B>)
                                 -> DecodeResult<()>
    {
        self.uri = element.get_attr("uri").ok().map(|v| v.to_string()); // TODO
        self.version = element.get_attr("version").ok().map(|v| v.to_string());
        self.value = try!(element.read_whole_text());
        Ok(())
    }
}

impl Mergeable for Generator { }


#[cfg(test)]
mod test {
    use super::Generator;

    use html::ToHtml;

    #[test]
    fn test_generator_str() {
        assert_eq!(Generator { value: "Earth Reader".to_string(),
                               uri: None, version: None }.to_string(),
                   "Earth Reader");
        assert_eq!(
            Generator {
                value: "Earth Reader".to_string(),
                uri: Some("http://earthreader.github.io/".to_string()),
                version: None
            }.to_string(),
            "Earth Reader");
        assert_eq!(Generator { value: "Earth Reader".to_string(),
                               version: Some("1.0".to_string()),
                               uri: None }.to_string(),
                   "Earth Reader 1.0");
        assert_eq!(
            Generator {
                value: "Earth Reader".to_string(),
                version: Some("1.0".to_string()),
                uri: Some("http://earthreader.github.io/".to_string())
            }.to_string(),
            "Earth Reader 1.0");
    }

    #[test]
    fn test_generator_html() {
        assert_html!(Generator { value: "Earth Reader".to_string(),
                                 uri: None, version: None },
                     "Earth Reader");
        assert_html!(Generator { value: "<escape test>".to_string(),
                                 uri: None, version: None },
                     "&lt;escape test&gt;");
        assert_html!(
            Generator {
                value: "Earth Reader".to_string(),
                uri: Some("http://earthreader.github.io/".to_string()),
                version: None,
            },
            "<a href=\"http://earthreader.github.io/\">Earth Reader</a>");
        assert_html!(Generator { value: "Earth Reader".to_string(),
                                 version: Some("1.0".to_string()),
                                 uri: None },
                     "Earth Reader 1.0");
        assert_html!(
            Generator {
                value: "Earth Reader".to_string(),
                version: Some("1.0".to_string()),
                uri: Some("http://earthreader.github.io/".to_string())
            },
            "<a href=\"http://earthreader.github.io/\">Earth Reader 1.0</a>");
    }
}