isomdl 0.2.0

ISO mDL implementation in Rust
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

use serde_json::Value as Json;
use std::{ops::Deref, str::FromStr};

use crate::definitions::traits::{FromJson, FromJsonError};

/// A string of up to 150 characters from ISO/IEC 8859-1 Latin alphabet 1.
///
/// Note that this struct only validates that the characters within the internal UTF-8 encoded
/// string are in the Latin 1 alphabet, and that the encoding for this data is still UTF-8.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Latin1(String);

impl Latin1 {
    pub fn as_str(&self) -> &str {
        &self.0
    }
}

#[derive(Debug, Clone, thiserror::Error)]
pub enum Error {
    #[error("contains characters that are not in the Latin1 alphabet: {0:?}")]
    NonLatin1(Vec<char>),
    #[error("contains more than 150 characters: {0}")]
    TooLong(usize),
}

impl Deref for Latin1 {
    type Target = String;

    fn deref(&self) -> &String {
        &self.0
    }
}

impl From<Latin1> for ciborium::Value {
    fn from(l: Latin1) -> ciborium::Value {
        l.0.into()
    }
}

impl FromJson for Latin1 {
    fn from_json(v: &Json) -> Result<Self, FromJsonError> {
        String::from_json(v)?
            .parse()
            .map_err(Into::into)
            .map_err(FromJsonError::Parsing)
    }
}

impl FromStr for Latin1 {
    type Err = Error;

    fn from_str(s: &str) -> Result<Latin1, Error> {
        let length = s.len();
        if length > 150 {
            return Err(Error::TooLong(length));
        }

        let non_latin: Vec<char> = s.chars().filter(|c| !is_latin(c)).collect();

        if !non_latin.is_empty() {
            return Err(Error::NonLatin1(non_latin));
        }

        Ok(Latin1(s.to_string()))
    }
}

#[inline]
fn is_lower_latin(c: &char) -> bool {
    ('\u{20}'..'\u{7F}').contains(c)
}

#[inline]
fn is_upper_latin(c: &char) -> bool {
    ('\u{A0}'..'\u{0100}').contains(c)
}

#[inline]
fn is_latin(c: &char) -> bool {
    is_lower_latin(c) || is_upper_latin(c)
}

#[cfg(test)]
mod test {
    use super::*;
    #[test]
    fn lower_latin() {
        let lower_latin_chars = vec![
            ' ', '!', '"', '#', '$', '%', '&', '\'', '(', ')', '*', '+', ',', '-', '.', '/', '0',
            '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A',
            'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R',
            'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c',
            'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
            'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~',
        ];
        assert!(lower_latin_chars.iter().all(is_lower_latin));
    }

    #[test]
    fn upper_latin() {
        #[allow(clippy::invisible_characters)]
        let upper_latin_chars = vec![
            ' ', '¡', '¢', '£', '¤', '¥', '¦', '§', '¨', '©', 'ª', '«', '¬', '\u{AD}', '®', '¯',
            '°', '±', '²', '³', '´', 'µ', '', '·', '¸', '¹', 'º', '»', '¼', '½', '¾', '¿', 'À',
            'Á', 'Â', 'Ã', 'Ä', 'Å', 'Æ', 'Ç', 'È', 'É', 'Ê', 'Ë', 'Ì', 'Í', 'Î', 'Ï', 'Ð', 'Ñ',
            'Ò', 'Ó', 'Ô', 'Õ', 'Ö', '×', 'Ø', 'Ù', 'Ú', 'Û', 'Ü', 'Ý', 'Þ', 'ß', 'à', 'á', 'â',
            'ã', 'ä', 'å', 'æ', 'ç', 'è', 'é', 'ê', 'ë', 'ì', 'í', 'î', 'ï', 'ð', 'ñ', 'ò', 'ó',
            'ô', 'õ', 'ö', '÷', 'ø', 'ù', 'ú', 'û', 'ü', 'ý', 'þ', 'ÿ',
        ];
        assert!(upper_latin_chars.iter().all(is_upper_latin));
    }
}