cc3166

A minimalistic Country type for working with Country Codes as defined in ISO 3166-1.

Excerpt from page:

The country codes can be represented either as a two-letter code (alpha-2) which is recommended as the general-purpose code, a three-letter code (alpha-3) which is more closely related to the country name and a three-digit numeric code (numeric-3) which can be useful if you need to avoid using Latin script.

Using optional features the crate can provide country name translations into featured language using in_<language>().

Currently provided translations (in lowercase for feature name):

• Chinese
• Finnish
• French
• Russian
• Spanish
• Swedish

Note that the underlying data is derived from open public sources only, as such data quality is not guaranteed.

Usage

Add this to your Cargo.toml:

[dependencies]
cc3166 = { version = "0.1", git = "https://github.com/procrustus/cc3166-rs" }

Example

use cc3316::Country;

let a3_str = "USA";

match Country::from_a3(a3_str) {
    Ok(code) => {
        // `Display` is implemented, displaying the Alpha-2 code.
        
        // `Debug` is implementented, diplaying the Country enum value.
        println!("{:?}", code); // "Country::US"
        // `alpha2()` returns the recommended general-purpose alpha-2 code.
        println!("  Alpha-2 code: {}", code.alpha2()); // "US"
        // `alpha3()` returns the alpha-3 code which is more closely related to 
        // the country name.
        println!("  Alpha-3 code: {}", code.alpha3()); // "USA"
        // `numeric()` returns the numeric code which can be useful if you need 
        // to avoid using Latin script.
        println!("  Numeric code: {}", code.numeric()); // 840
        // `country_data()` returns a reference to the underlying basic 
        // `CountryData` which includes the Alpha-2/-3 & numeric code.
        //
        // CountryData("US", "USA", 840) for `code`.
        println!("  Country data: {:?}", code.country_data()); 
    }
    Err(err) => panic!("Unable to parse country code `{}`: {}.", a3_str, err),
}

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.