money2 1.4.0

For storing and asynchronously converting between (a subset of) ISO-4217 currencies
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

mod display;
mod from_str;
mod try_from;

use std::{collections::HashMap, sync::OnceLock};

#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};
use strum::{EnumCount, EnumIter, IntoEnumIterator, IntoStaticStr};
use unicase::UniCase;

/// [ISO-4217][iso] currency codes which are reported by the [European Central Bank][ecb] for
/// exchange.
///
/// [ecb]: https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/
/// [iso]: https://www.iso.org/iso-4217-currency-codes.html
#[cfg_attr(feature = "serde", derive(Deserialize, Serialize), serde(rename_all = "UPPERCASE"))]
#[derive(
	Copy,
	Clone,
	Debug,
	Default,
	EnumCount,
	EnumIter,
	Eq,
	Hash,
	IntoStaticStr,
	Ord,
	PartialEq,
	PartialOrd,
)]
#[strum(serialize_all = "UPPERCASE")]
pub enum Currency
{
	/// The Australian dollar.
	Aud,

	/// The Bulgarian lev.
	Bgn,

	/// The Brazilian real
	Brl,

	/// The Canadian dollar.
	Cad,

	/// The Swiss franc.
	Chf,

	/// The Chinese yuan.
	Cny,

	/// The Czech koruna.
	Czk,

	/// The Danish krone.
	Dkk,

	/// The Euro.
	#[default]
	Eur,

	/// The British pound.
	Gbp,

	/// The Hong Kong dollar.
	Hkd,

	/// The Hungarian forint.
	Huf,

	/// The Indonesian rupiah.
	Idr,

	/// The Israeli shekel.
	Ils,

	/// The Indian rupee.
	Inr,

	/// The Icelandic krona.
	Isk,

	/// The Japanese yen.
	Jpy,

	/// The South Korean won.
	Krw,

	/// The Mexican peso.
	Mxn,

	/// The Malaysian ringgit.
	Myr,

	/// The Norwegian krone.
	Nok,

	/// The New Zeland dollar.
	Nzd,

	/// The Philippine peso.
	Php,

	/// The Polish zloty.
	Pln,

	/// The Romanian leu.
	Ron,

	/// The Russian rouble.
	Rub,

	/// The Swedish krona.
	Sek,

	/// The Singapore dollar.
	Sgd,

	/// The Thai baht.
	Thb,

	/// The Turkish lira.
	Try,

	/// The US dollar.
	Usd,

	/// The South African rand.
	Zar,
}

impl Currency
{
	/// Attempts to convert a given string into a concrete [`Currency`], returning [`Some`] if the
	/// operation succeeds, or [`None`] if not.
	pub(crate) fn reverse_lookup(s: &str) -> Option<Self>
	{
		static CELL: OnceLock<HashMap<UniCase<&'static str>, Currency>> = OnceLock::new();
		CELL.get_or_init(|| {
			Self::iter().map(|currency| (UniCase::new(currency.into()), currency)).collect()
		})
		.get(&s.into())
		.copied()
	}
}