json-gettext 4.0.0

A library for getting text from JSON usually for internationalization.
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

use std::fmt::{self, Display, Formatter, Write};
use std::str::FromStr;

use crate::unic_langid::subtags::{Language, Region};
use crate::unic_langid::{LanguageIdentifier, LanguageIdentifierError};

#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
pub struct Key(pub Language, pub Option<Region>);

impl Display for Key {
    #[inline]
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), fmt::Error> {
        f.write_str(self.0.as_str())?;

        if let Some(region) = self.1 {
            f.write_char('_')?;
            f.write_str(region.as_str())?;
        }

        Ok(())
    }
}

impl FromStr for Key {
    type Err = LanguageIdentifierError;

    #[inline]
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let langid = LanguageIdentifier::from_str(s)?;

        let language = langid.language;
        let region = langid.region;

        Ok(Key(language, region))
    }
}

/**
Create a literal key.

```rust
#[macro_use] extern crate json_gettext;

use std::str::FromStr;

use json_gettext::unic_langid::subtags::{Language, Region};
use json_gettext::Key;

let key = key!("en_US");

assert_eq!(Key(Language::from_str("en").unwrap(), Some(Region::from_str("US").unwrap())), key);
```
*/
#[macro_export]
macro_rules! key {
    ($key:expr) => {{
        let langid = $crate::unic_langid::langid!($key);

        $crate::Key(langid.language, langid.region)
    }};
}