abbreviation-trait 0.3.0

This crate provides the Abbreviation and TryFromAbbreviation traits, common in the north-america, europe, south-america, etc crates
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

pub trait Abbreviation {
    fn abbreviation(&self) -> &'static str;
}

/// A trait for parsing an entity (typically) from a country code abbreviation.
/// This can be ISO 3166 Alpha-2 (e.g. "US") or Alpha-3 (e.g. "USA"), or any
/// other recognized short code as needed.
pub trait TryFromAbbreviation: Sized {
    /// The associated error type returned upon failure.
    type Error;

    /// Attempt to convert an abbreviation into `Self`.
    fn try_from_abbreviation(abbr: &str) -> Result<Self, Self::Error>;
}

#[derive(Debug)]
pub enum TryFromAbbreviationError {
    /// The given abbreviation is not recognized in this region.
    InvalidAbbreviation,
}