15 releases (8 breaking)

new 0.9.3 Dec 5, 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

#5 in Internationalization (i18n)

Download history 22024/week @ 2023-08-16 25535/week @ 2023-08-23 22871/week @ 2023-08-30 23334/week @ 2023-09-06 24401/week @ 2023-09-13 27229/week @ 2023-09-20 26191/week @ 2023-09-27 26092/week @ 2023-10-04 27227/week @ 2023-10-11 27120/week @ 2023-10-18 25514/week @ 2023-10-25 29117/week @ 2023-11-01 31358/week @ 2023-11-08 27751/week @ 2023-11-15 24790/week @ 2023-11-22 21315/week @ 2023-11-29

109,891 downloads per month
Used in 190 crates (71 directly)

MIT/Apache

605KB
12K SLoC

unic-langid Build Status Coverage Status

unic-langid is an API for managing Unicode Language 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_langid::LanguageIdentifier;

let loc: LanguageIdentifier = "en-US".parse().expect("Parsing failed.");

assert_eq!(loc.language(), "en");
assert_eq!(loc.script(), None);
assert_eq!(loc.region(), Some("US"));

loc.set_script(Some("latn"));

assert_eq!(&loc.to_string(), "en-Latn-US");
use unic_langid::LanguageIdentifier;

let langid = LanguageIdentifier::from_parts(
    Some("en"),
    None,
    None,
    Some(&["nedis", "macos"])
).expect("Parsing failed.");

assert_eq!(&langid.to_string(), "en-macos-nedis")

Macros

unic-langid can be also compiled with features = ["macros"] which enables langid! macro:

use unic_langid::langid;

// The `const` assignment will currently work only
// if the langid doesn't contain any variants.
const EN_US: LanguageIdentifier = langid!("en-US");

fn main() {
    let de_at = langid!("de-AT");

    assert_eq!(&de_at.to_string(), "de-AT")
    assert_eq!(&EN_US.to_string(), "en-US")
}

The macro allows for compile-time parsing and validation of literal language identifiers.

Status

The crate is mostly complete on the well-formed level. The next batch of work will go into API maturity.

Get Involved

unic-langid 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–1MB
~22K SLoC