Skip to content

Latest commit

 

History

History
67 lines (50 loc) · 1.79 KB

README.md

File metadata and controls

67 lines (50 loc) · 1.79 KB

ISO 639 language codes

Build Status · Documentation

Introduction

When dealing with different language inputs and APIs, different standards are used to identify a language. Converting between these in an automated way can be tedious. This crate provides an enum which supports conversion from 639-1 and 639-3 and also into these formats, as well as into English names or autonyms (local names).

This crate contains the ISO 639 table in statically embedded tables. This increases binary size, but allows for very efficient look-up if performance matters. If size is a concern, both and the English names and local names can be enabled or disabled individually.

This crate is licensed under the Apache 2.0 license, please see LICENSE.md for the details.

Usage

Cargo.toml:

[dependencies]
isolang = "1.0"

Example

use isolang::Language;

assert_eq!(Language::from_639_1("de").unwrap().to_name(), "German");
assert_eq!(Language::from_639_3("spa").unwrap().to_639_1(), Some("es"));
// undefined language (ISO code und)
assert_eq!(Language::default(), Language::Und);

Serde support

This crate also supports serializing the Language enum. To enable this please add the following lines to your Cargo.toml (instead of the above code):

[dependencies.isolang]
features = ["serde_serialize"]
version = "1.0"

Diesel support

This crate also has experimental support for diesel. You can use the Language enum in Queryable and Insertable structs. To enable this please add the following lines to your Cargo.toml.

[dependencies.isolang]
features = ["diesel_sql"]
version = "1.0"