locode 0.2.0

Standardized country and city codes
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

macro_rules! mapping {
    ($($city_code:ident $country:ident => $city:expr, $time_zone:expr;)+) => {
        #[derive(Debug, Clone, Copy)]
        /// IATA city codes mapping.
        pub enum City {
            $(
                $city_code,
            )+
        }

        impl City {
            /// Returns a slice of all IATA city codes.
            pub const fn all() -> &'static [Self] {
                &[
                    $(
                        Self::$city_code,
                    )+
                ]
            }

            #[cfg(feature = "feat-iata-city-from-code")]
            /// Returns the IATA code from the city code.
            pub fn from_code(code: &str) -> Option<Self> {
                use std::sync::OnceLock;
                use std::collections::HashMap;

                static MAPPING: OnceLock<HashMap<&'static str, City, foldhash::fast::RandomState>> = OnceLock::new();

                MAPPING.get_or_init(|| {
                        City::all()
                            .iter()
                            .map(|city| (city.code(), *city))
                            .collect()
                    })
                    .get(code)
                    .copied()
            }

            /// Returns the IATA code.
            pub const fn code(self) -> &'static str {
                use City::*;

                match self {
                    $(
                        $city_code => stringify!($city_code),
                    )+
                }
            }

            #[cfg(feature = "feat-iata-city-time-zone")]
            /// Returns the time zone.
            pub const fn time_zone(self) -> &'static str {
                use City::*;

                match self {
                    $(
                        $city_code => $time_zone,
                    )+
                }
            }

            #[cfg(feature = "feat-iata-city-country")]
            /// Returns the country.
            pub const fn country(self) -> &'static str {
                use City::*;

                match self {
                    $(
                        $city_code => stringify!($country),
                    )+
                }
            }

            #[cfg(feature = "feat-iata-city-name")]
            /// Returns the city name.
            pub const fn name(self) -> Option<&'static str> {
                use City::*;

                match self {
                    $(
                        $city_code => $city,
                    )+
                }
            }
        }
    }
}