myid 0.1.10

Rust client library for MyID SDK API — user identification and verification
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

use crate::error::{MyIdError, MyIdResult};
use chrono::NaiveDate;
use serde::{Deserialize, Serialize};

/// Tug'ilgan sana (`YYYY-MM-DD` formatda).
///
/// Ichki saqlashda [`NaiveDate`] ishlatiladi — string emas.
/// Bu solishtirish va hisoblash imkonini beradi.
///
/// # Format
///
/// - Kirishda: `YYYY-MM-DD` (masalan: `1990-05-15`)
/// - Kabisa yillar hisobga olinadi
///
/// # Misollar
///
/// ```
/// use myid::types::BirthDate;
///
/// let d = BirthDate::parse("1990-05-15").unwrap();
/// assert_eq!(d.to_string(), "1990-05-15");
///
/// // Kabisa yili
/// assert!(BirthDate::parse("2000-02-29").is_ok());
/// assert!(BirthDate::parse("2023-02-29").is_err());
///
/// // Noto'g'ri format
/// assert!(BirthDate::parse("15-05-1990").is_err());
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct BirthDate(NaiveDate);

impl BirthDate {
    const FORMAT: &str = "%Y-%m-%d";
    const EXPECTED_LEN: usize = 10; // "YYYY-MM-DD"

    /// String qiymatdan `BirthDate` yaratadi.
    ///
    /// # Xatolar
    ///
    /// [`MyIdError::Validation`] qaytaradi agar:
    /// - Format `YYYY-MM-DD` bo'lmasa
    /// - Sana mavjud bo'lmasa (masalan: `2023-02-30`)
    pub fn parse(value: impl AsRef<str>) -> MyIdResult<Self> {
        let raw = value.as_ref().trim();

        if raw.len() != Self::EXPECTED_LEN {
            return Err(MyIdError::validation(format!(
                "birth_date must be YYYY-MM-DD format, got: {raw}"
            )));
        }

        let date = NaiveDate::parse_from_str(raw, Self::FORMAT)
            .map_err(|_| MyIdError::validation(format!("birth_date is not a valid date: {raw}")))?;

        if date > chrono::Local::now().date_naive() {
            return Err(MyIdError::validation(format!(
                "birth_date cannot be in the future: {raw}"
            )));
        }

        Ok(Self(date))
    }

    // /// Canonical string ko'rinishini qaytaradi (`YYYY-MM-DD`).
    // // Bu metoddan foydalanuvchilarni .to_string() ga yo'naltirish kerak.
    // // Metodni deprecated qiling yoki olib tashlang:
    // #[deprecated(since = "0.2.0", note = "use `.to_string()` instead")]
    // pub fn to_formatted_string(&self) -> String {
    //     self.to_string()
    // }

    /// Ichki [`NaiveDate`] qiymatni qaytaradi.
    ///
    /// Yosh hisoblash yoki sanalar solishtirish uchun foydali.
    pub fn as_date(&self) -> NaiveDate {
        self.0
    }
}

impl std::fmt::Display for BirthDate {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.0.format(Self::FORMAT))
    }
}

impl TryFrom<String> for BirthDate {
    type Error = MyIdError;

    fn try_from(value: String) -> MyIdResult<Self> {
        Self::parse(value)
    }
}

impl From<BirthDate> for String {
    fn from(value: BirthDate) -> Self {
        value.to_string()
    }
}

impl Serialize for BirthDate {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        serializer.serialize_str(&self.to_string())
    }
}

impl<'de> Deserialize<'de> for BirthDate {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let s = String::deserialize(deserializer)?;
        Self::parse(&s).map_err(serde::de::Error::custom)
    }
}