Skip to main content

uz_types/
passport.rs

1use crate::macros::string_newtype;
2
3string_newtype! {
4    /// O'zbekiston pasport / ID-karta seriyasi va raqami (`AA1234567`).
5    ///
6    /// Normalizatsiya: trim, ichki bo'sh joylar olib tashlanadi (`AA 1234567`),
7    /// harflar KATTA qilinadi. Faqat **format** tekshiriladi.
8    pub struct Passport;
9    error = PassportError;
10    expecting = "a passport number: 2 latin letters followed by 7 digits";
11}
12
13impl Passport {
14    /// Seriya uzunligi (harflar soni).
15    pub const SERIES_LEN: usize = 2;
16    /// Raqam uzunligi.
17    pub const NUMBER_LEN: usize = 7;
18    /// Umumiy uzunlik.
19    pub const LEN: usize = Self::SERIES_LEN + Self::NUMBER_LEN;
20
21    fn normalize(s: &mut String) {
22        // `retain` char-by-char yuradi — faqat kerak bo'lganda (ichki bo'sh joy bor bo'lsa).
23        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        // `is_ascii` split_at dan OLDIN: ko'p baytli belgi chegarasida panic bo'lmasligi uchun.
31        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    /// Seriya (`AA`).
47    #[inline]
48    #[must_use]
49    pub fn series(&self) -> &str {
50        &self.0[..Self::SERIES_LEN]
51    }
52
53    /// Raqam (`1234567`).
54    #[inline]
55    #[must_use]
56    pub fn number(&self) -> &str {
57        &self.0[Self::SERIES_LEN..]
58    }
59}
60
61/// `Passport` validatsiya xatolari.
62#[derive(Debug, Clone, Copy, PartialEq, Eq, thiserror::Error)]
63#[non_exhaustive]
64pub enum PassportError {
65    /// Uzunlik 9 belgi emas.
66    #[error("passport length is invalid, expected {} characters", Passport::LEN)]
67    Length,
68    /// 2 lotin harfi + 7 raqam emas.
69    #[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); // allocation yo'q
93    }
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}