15 releases

0.3.2 May 24, 2021
0.2.2 Feb 12, 2016
0.2.0 Oct 17, 2015
0.1.0 Jul 11, 2015
0.0.2 Mar 30, 2015

#2 in Internationalization (i18n)

Download history 260254/week @ 2024-07-17 261356/week @ 2024-07-24 254915/week @ 2024-07-31 288682/week @ 2024-08-07 273658/week @ 2024-08-14 284775/week @ 2024-08-21 264519/week @ 2024-08-28 313459/week @ 2024-09-04 301404/week @ 2024-09-11 296696/week @ 2024-09-18 328361/week @ 2024-09-25 339472/week @ 2024-10-02 341004/week @ 2024-10-09 364829/week @ 2024-10-16 377330/week @ 2024-10-23 352839/week @ 2024-10-30

1,506,052 downloads per month
Used in 2,793 crates (52 directly)

MIT/Apache

495KB
12K SLoC

rust-language-tags

Build Status MIT licensed Documentation

Language tags can be used identify human languages, scripts e.g. Latin script, countries and other regions.

Language tags are defined in BCP47, an introduction is "Language tags in HTML and XML" by the W3C. They are commonly used in HTML and HTTP Content-Language and Accept-Language header fields.

This package currently supports parsing (fully conformant parser), formatting and comparing language tags.

Examples

Create a simple language tag representing the French language as spoken in Belgium and print it:

use language_tags::LanguageTag;
let langtag = LanguageTag::parse("fr-BE").unwrap();
assert_eq!(format!("{}", langtag), "fr-BE");

Parse a tag representing a special type of English specified by private agreement:

use language_tags::LanguageTag;
use std::iter::FromIterator;
let langtag: LanguageTag = "en-x-twain".parse().unwrap();
assert_eq!(langtag.primary_language(), "en");
assert_eq!(Vec::from_iter(langtag.private_use_subtags()), vec!["twain"]);

You can check for equality, but more often you should test if two tags match. In this example we check if the resource in German language is suitable for a user from Austria. While people speaking Austrian German normally understand standard German the opposite is not always true. So the resource can be presented to the user but if the resource was in de-AT and a user asked for a representation in de the request should be rejected.

use language_tags::LanguageTag;
let mut langtag_server = LanguageTag::parse("de-AT").unwrap();
let mut langtag_user = LanguageTag::parse("de").unwrap();
assert!(langtag_user.matches(&langtag_server));

If you only want to validate and normalize the formatting of language tags or you are working with RDF consider using the oxilangtag crate. It is much more lightweight as it doesn't contain a language tag database and has a very similar interface to this crate.

Dependencies

~160KB