unic-locale 0.3.0

API for managing Unicode Locale Identifiers
Documentation

unic-locale Build Status Coverage Status

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 std::convert::TryFrom;

use unic_locale::{Locale, ExtensionType};

let loc = Locale::try_from("en-US-u-hc-h12")
    .expect("Parsing.failed");

assert_eq!(loc.get_language(), "en");
assert_eq!(loc.get_script(), None);
assert_eq!(loc.get_region(), Some("US"));

loc.set_extension(ExtensionType::Unicode, "ca", "buddhist")
    .expect("Setting extension failed.");

assert_eq!(&loc.to_string(), "en-US-u-ca-buddhist-hc-h12");

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.