lang-id 0.0.20

Const lang-ids and maps are provided, mainly for i18n and l10n.
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

#![cfg_attr(__unstable_doc, feature(doc_auto_cfg, doc_notable_trait))]
#![cfg_attr(not(feature = "std"), no_std)]

/*!
This library provides a series of const lang-ids (language identifiers) which can be found in the
`consts` module. Additionally, it provides some handy maps.

## Examples

Using the result of a const fn as a value:

```
# #[cfg(feature = "consts")] {
use lang_id::LangID;

// Compile-time verified language ID
const DEFAULT_LANG: LangID = lang_id::consts::lang_id_en();
# }
```

Description-data Lookup (requires map feature)

```
# #[cfg(feature = "map")]
# {
let map = lang_id::maps::description::map();
let gsw_fr = map.get("gsw-FR");
assert_eq!(gsw_fr, Some(&"Schwiizertüütsch, Latiinisch, Frankriich"));

let zh = map.get("zh");
assert_eq!(zh, Some(&"简体中文, 中国"));

let ja = map.get("ja");
assert_eq!(ja, Some(&"日本語, 日本語の文字, 日本"));
# }
```

## Features

| Feature        | Dependencies          | Description                                                                                                    |
| -------------- | --------------------- | -------------------------------------------------------------------------------------------------------------- |
| **std**        | None                  | Enables stdlib integrations                                                                                    |
| **map**        | `phf`, `tinystr`      | Adds precomputed static maps:<br>- Perfect hash maps for O(1) lookups<br>- Compact string storage with TinyStr |
| **sys-locale** | `sys-locale`, **std** | System locale detection:<br>- Cross-platform locale querying<br>- Integration with OS settings                 |
| **match**      | None                  | Match the value or function name in consts using bytes, for example, b"en-001" => lang_id_en_001().            |
| **serde**      | `unic-langid/serde`   | Serialization/deserialization support                                                                          |
| **consts**     | None                  | Provides const language ids                                                                                    |

*/

#[cfg(feature = "consts")]
pub mod consts;

pub mod common;

mod id;
pub use id::RawID;
pub use unic_langid::LanguageIdentifier as LangID;

pub mod error {
  pub type LangidResult<T> = Result<T, LangidError>;
  pub use tinystr::ParseError as ParseStrError;
  pub use unic_langid::LanguageIdentifierError as LangidError;
}
pub use error::LangidResult as Result;

#[cfg(feature = "map")]
pub mod maps;

#[cfg(feature = "match")]
pub mod matches;

/// The sys-locale module is used to get the current system's locale and convert
/// it into LangID.
#[cfg(feature = "sys-locale")]
pub mod sys_locale;

#[cfg(feature = "nostd-sys-locale")]
pub mod nostd_sys_locale;

#[cfg(feature = "std")]
#[cfg(test)]
mod tests {
  use super::*;

  // #[test]
  // #[cfg(feature = "map")]
  // fn minimize_zh_sg() {
  //   let map = crate::maps::min::map();
  //   let sg = map["zh-Hans-SG"];
  //   assert_eq!(sg, "zh-SG");
  // }
  #[test]
  #[cfg(feature = "map")]
  fn get_const_ids() {
    let now = std::time::Instant::now();
    let map = maps::description::map();
    for (k, v) in &map {
      println!("{k} {v}")
    }
    // let id = match_id(Box::new("en-GB").as_bytes());
    // let ja = map.get("ja");
    // println!("{id:?}");
    // dbg!(id);
    println!("{:?}", now.elapsed());
    // dbg!(id);
  }

  #[test]
  #[cfg(feature = "consts")]
  fn test_get_en() {
    let default_lang = crate::consts::lang_id_en();
    dbg!(default_lang.language);
  }
}