1use crate::macros::string_newtype;
2
3string_newtype! {
4 pub struct Passport;
9 error = PassportError;
10 expecting = "a passport number: 2 latin letters followed by 7 digits";
11}
12
13impl Passport {
14 pub const SERIES_LEN: usize = 2;
16 pub const NUMBER_LEN: usize = 7;
18 pub const LEN: usize = Self::SERIES_LEN + Self::NUMBER_LEN;
20
21 fn normalize(s: &mut String) {
22 if s.bytes().any(|b| b.is_ascii_whitespace()) {
24 s.retain(|c| !c.is_ascii_whitespace());
25 }
26 s.make_ascii_uppercase();
27 }
28
29 fn validate(s: &str) -> Result<(), PassportError> {
30 if !s.is_ascii() {
32 return Err(PassportError::Format);
33 }
34 if s.len() != Self::LEN {
35 return Err(PassportError::Length);
36 }
37 let (series, number) = s.split_at(Self::SERIES_LEN);
38 if !series.bytes().all(|b| b.is_ascii_uppercase())
39 || !number.bytes().all(|b| b.is_ascii_digit())
40 {
41 return Err(PassportError::Format);
42 }
43 Ok(())
44 }
45
46 #[inline]
48 #[must_use]
49 pub fn series(&self) -> &str {
50 &self.0[..Self::SERIES_LEN]
51 }
52
53 #[inline]
55 #[must_use]
56 pub fn number(&self) -> &str {
57 &self.0[Self::SERIES_LEN..]
58 }
59}
60
61#[derive(Debug, Clone, Copy, PartialEq, Eq, thiserror::Error)]
63#[non_exhaustive]
64pub enum PassportError {
65 #[error("passport length is invalid, expected {} characters", Passport::LEN)]
67 Length,
68 #[error("passport format is invalid, expected 2 letters followed by 7 digits")]
70 Format,
71}
72
73#[cfg(test)]
74mod tests {
75 use super::*;
76
77 #[test]
78 fn parse_normalizes() {
79 assert_eq!(
80 Passport::parse(" aa 1234567 ").unwrap().as_str(),
81 "AA1234567"
82 );
83 assert_eq!(Passport::parse("ab1234567").unwrap().series(), "AB");
84 }
85
86 #[test]
87 fn try_from_string_reuses_buffer() {
88 let s = String::from(" aa1234567 ");
89 let cap = s.capacity();
90 let p = Passport::try_from(s).unwrap();
91 assert_eq!(p.as_str(), "AA1234567");
92 assert_eq!(p.into_inner().capacity(), cap); }
94
95 #[test]
96 fn errors_are_precise() {
97 assert_eq!(Passport::parse("AA123"), Err(PassportError::Length));
98 assert_eq!(Passport::parse("AA12345678"), Err(PassportError::Length));
99 assert_eq!(Passport::parse("A11234567"), Err(PassportError::Format));
100 assert_eq!(
101 Passport::parse("a\u{00C4}234567"),
102 Err(PassportError::Format)
103 );
104 assert_eq!(Passport::parse("АА1234567"), Err(PassportError::Format));
105 }
106
107 #[test]
108 fn borrow_str_lookup_works() {
109 let mut map = std::collections::HashMap::new();
110 map.insert(Passport::parse("AA1234567").unwrap(), 1);
111 assert_eq!(map.get("AA1234567"), Some(&1));
112 }
113}