kutil 0.0.6

Kutil utilities collection
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

use super::super::super::std::{collections::*, foster::*};

use {
    http::header::*,
    std::{convert::*, fmt, str::*},
};

//
// Language
//

/// Language tag value in HTTP headers.
///
/// See [IETF RFC 5646 section 2.1](https://datatracker.ietf.org/doc/html/rfc5646#section-2.1).
///
/// Stored as a sequence of subtags.
///
/// Note that even though ISO recommends cased representations, they are case-insensitive in HTTP.
/// Thus we convert all subtags to lowercase for comparison efficiency.
#[derive(Clone, Debug)]
pub struct Language(pub FosterImmutableStringVector);

delegate_newtype_of_foster_immutable_string_vector!(Language);

impl Language {
    /// Parse list.
    pub fn parse_list(representation: &str) -> Option<FastHashSet<Self>> {
        let languages: FastHashSet<_> = representation.split(",").map(|language| language.trim().into()).collect();
        if !languages.is_empty() { Some(languages) } else { None }
    }
}

impl From<Language> for HeaderValue {
    fn from(language: Language) -> Self {
        HeaderValue::from_str(&language.to_string()).expect("language in HTTP header")
    }
}

impl From<&str> for Language {
    fn from(representation: &str) -> Self {
        Self::new_owned(representation.split("-").map(|subtag| subtag.to_lowercase().into()).collect())
    }
}

impl FromStr for Language {
    type Err = Infallible;

    fn from_str(representation: &str) -> Result<Self, Self::Err> {
        Ok(representation.into())
    }
}

impl fmt::Display for Language {
    fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
        match &self.0 {
            Foster::Owned(subtags) => fmt::Display::fmt(&subtags.join("-"), formatter),
            Foster::Fostered(subtags) => fmt::Display::fmt(&subtags.join("-"), formatter),
        }
    }
}