14 releases (8 breaking)
0.9.4 | Dec 13, 2023 |
---|---|
0.9.1 | Oct 19, 2022 |
0.9.0 | May 6, 2020 |
0.8.0 | Jan 28, 2020 |
0.4.1 | Jul 29, 2019 |
#358 in Internationalization (i18n)
593 downloads per month
Used in 5 crates
(3 directly)
645KB
12K
SLoC
unic-locale
unic-locale
is an API for managing Unicode Locale Identifiers.
The crate provides a way to create a struct from a string, manipulate its fields, canonicalize it, and serialize into a string.
Usage
use unic_locale::{Locale, ExtensionType};
let loc: Locale = "en-US-u-hc-h12".parse()
.expect("Parsing.failed");
assert_eq!(loc.language(), "en");
assert_eq!(loc.script(), None);
assert_eq!(loc.region(), Some("US"));
loc.extensions.unicode.set_keyword("ca", "buddhist")
.expect("Setting extension failed.");
let val = loc.extensions.unicode.keyword("ca")
.expect("Getting extension value failed.")
.collect::<Vec<_>>();
assert_eq!(val, vec!["buddhist"]);
assert_eq!(&loc.to_string(), "en-US-u-ca-buddhist-hc-h12");
Macros
unic-locale
can be also compiled with features = ["macros"]
which enables locale!
macro:
use unic_locale::locale;
let loc = locale!("en-US-u-hc-h24");
assert_eq!(&loc.to_string(), "en-US-u-hc-h24")
The macro allows for compile-time parsing and validation of literal locale identifiers.
Status
The crate is providing fundamental blocks, but is very basic.
In particular, the supported extensions list is very limited and the ergonomics of manipulating them should be improved.
Get Involved
unic-locale
is open-source, licensed under the Apache License, Version 2.0. We
encourage everyone to take a look at our code and we'll listen to your
feedback.
Dependencies
~0.4–0.8MB
~20K SLoC