#country-code #country #iso-3166 #localization

jurisdiction

A lightweight API-friendly abstraction for the jurisdiction in the world, and their accompanying static information pertaining to that jurisdiction. Information available includes: * ISO 3166 country codes * UN M49 Region classifications

2 releases

0.1.1 Apr 27, 2020
0.1.0 Apr 6, 2020

#120 in Internationalization (i18n)

Download history 5696/week @ 2023-12-06 6092/week @ 2023-12-13 3000/week @ 2023-12-20 2344/week @ 2023-12-27 7217/week @ 2024-01-03 5605/week @ 2024-01-10 5289/week @ 2024-01-17 6426/week @ 2024-01-24 7260/week @ 2024-01-31 7143/week @ 2024-02-07 6293/week @ 2024-02-14 5768/week @ 2024-02-21 6914/week @ 2024-02-28 7049/week @ 2024-03-06 4755/week @ 2024-03-13 3537/week @ 2024-03-20

23,404 downloads per month

MIT license

34KB
603 lines

Jurisdiction

Lightweight static Jurisdiction information.

This crate provides interfaces to work with jurisdictions for areas around the world. Information about a jurisdiction includes

  • ISO 3166 Alpha2 and Alpha3 character codes.
  • ISO 3166 numeric country code.
  • UN M49 region classifications.

The Jurisdiction object is a lightweight object, the size of a pointer, suitable for transfer in API surfaces throughout an ecosystem. Serialization on API boundaries may choose to employ any of the standardized classification formats.

Example

use anyhow::{Result, anyhow, format_err};
use jurisdiction::{Jurisdiction, Alpha2, Alpha3};
use jurisdiction::region::{Region, SubRegion};
use std::str::FromStr;

fn supported_jurisdiction(alpha: &str) -> Result<Jurisdiction> {
    let jurisdiction = Jurisdiction::from_str(alpha)?;
    match jurisdiction.alpha2() {
        Alpha2::NO | Alpha2::SE | Alpha2::DK => Ok(jurisdiction),
        _ => Err(format_err!("only scandinavian countries are supported")),
    }
}

fn main() {
    let jurisdiction = supported_jurisdiction("NO").expect("unsupported");

    assert_eq!(jurisdiction, Alpha2::NO);
    assert_eq!(jurisdiction.alpha2(), Alpha2::NO);
    assert_eq!(jurisdiction.alpha2().to_string(), "NO");

    assert_eq!(jurisdiction, Alpha3::NOR);
    assert_eq!(jurisdiction.alpha3(), Alpha3::NOR);
    assert_eq!(jurisdiction.alpha3().to_string(), "NOR");

    assert_eq!(jurisdiction.country_code(), 578);

    assert_eq!(jurisdiction.region(), Region::Europe);
    assert_eq!(jurisdiction.sub_region(), SubRegion::NorthernEurope);
}

See docs.rs for more extensive API documentation and examples.

Dependencies

~0.6–1.3MB
~28K SLoC