holidays-ru 0.2.0

A library for determining working days, weekends, and holidays in Russia.
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

use crate::raw_date::RawDate;
use crate::{DayFlags, Resolved, official, predict_mod};

mod sealed {
    pub trait Sealed {}
}

/// Федеральный производственный календарь РФ.
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Hash)]
pub struct Federal;

impl Calendar for Federal {
    const IS_COMPLETE: bool = true;

    #[inline]
    fn flags_ymd(year: i32, month: u8, day: u8) -> Option<Resolved<DayFlags>> {
        RawDate::from_ymd(year, month, day).map(federal_flags_raw)
    }
}

impl sealed::Sealed for Federal {}

/// Типизированный источник календарных данных.
///
/// Реализации этого trait предоставляются крейтом. Пользователь выбирает
/// календарь через marker-тип, например [`Federal`] или [`regions::Tatarstan`].
pub trait Calendar: sealed::Sealed {
    /// `true`, если календарь содержит полную информацию о рабочих и нерабочих днях.
    const IS_COMPLETE: bool;

    /// Возвращает [`DayFlags`] для даты, заданной годом, месяцем и днём.
    fn flags_ymd(year: i32, month: u8, day: u8) -> Option<Resolved<DayFlags>>;
}

/// Типизированный источник региональных overlay-данных.
///
/// Такой календарь содержит только региональные исключения и должен
/// объединяться с [`Federal`] для получения полного производственного
/// календаря. Для этого используйте [`crate::flags_with_region_ymd`] или,
/// при включённой фиче `chrono` либо `time`, `crate::flags_with_region`.
pub trait RegionalCalendar: Calendar {}

#[inline]
pub(crate) fn federal_flags_raw(date: RawDate) -> Resolved<DayFlags> {
    if let Some(flags) = official::flags(date) {
        Resolved::Fact(flags)
    } else {
        Resolved::Predict(predict_mod::flags(date))
    }
}

macro_rules! region_marker {
    ($name:ident, $module:ident, $doc:literal) => {
        #[doc = $doc]
        #[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Hash)]
        pub struct $name;

        impl super::sealed::Sealed for $name {}

        impl super::Calendar for $name {
            const IS_COMPLETE: bool = false;

            #[inline]
            fn flags_ymd(
                year: i32,
                month: u8,
                day: u8,
            ) -> Option<crate::Resolved<crate::DayFlags>> {
                let date = crate::raw_date::RawDate::from_ymd(year, month, day)?;
                Some(crate::data::regional::$module::flags(date))
            }
        }

        impl super::RegionalCalendar for $name {}
    };
}

/// Marker-типы региональных overlay-календарей.
pub mod regions {
    region_marker!(Adygea, adygea, "Республика Адыгея.");
    region_marker!(AltaiRepublic, altai_republic, "Республика Алтай.");
    region_marker!(Bashkortostan, bashkortostan, "Республика Башкортостан.");
    region_marker!(Buryatia, buryatia, "Республика Бурятия.");
    region_marker!(Dagestan, dagestan, "Республика Дагестан.");
    region_marker!(Ingushetia, ingushetia, "Республика Ингушетия.");
    region_marker!(
        KabardinoBalkaria,
        kabardino_balkaria,
        "Кабардино-Балкарская Республика."
    );
    region_marker!(Kalmykia, kalmykia, "Республика Калмыкия.");
    region_marker!(
        KarachayCherkessia,
        karachay_cherkessia,
        "Карачаево-Черкесская Республика."
    );
    region_marker!(Crimea, crimea, "Республика Крым.");
    region_marker!(Mordovia, mordovia, "Республика Мордовия.");
    region_marker!(
        NorthOssetiaAlania,
        north_ossetia_alania,
        "Республика Северная Осетия - Алания."
    );
    region_marker!(Tatarstan, tatarstan, "Республика Татарстан.");
    region_marker!(Tuva, tuva, "Республика Тыва.");
    region_marker!(Chechnya, chechnya, "Чеченская Республика.");
    region_marker!(Chuvashia, chuvashia, "Чувашская Республика - Чувашия.");
    region_marker!(ZabaykalskyKrai, zabaykalsky_krai, "Забайкальский край.");
    region_marker!(KrasnodarKrai, krasnodar_krai, "Краснодарский край.");
    region_marker!(StavropolKrai, stavropol_krai, "Ставропольский край.");
    region_marker!(BelgorodOblast, belgorod_oblast, "Белгородская область.");
    region_marker!(BryanskOblast, bryansk_oblast, "Брянская область.");
    region_marker!(IrkutskOblast, irkutsk_oblast, "Иркутская область.");
    region_marker!(OmskOblast, omsk_oblast, "Омская область.");
    region_marker!(PenzaOblast, penza_oblast, "Пензенская область.");
    region_marker!(SaratovOblast, saratov_oblast, "Саратовская область.");
}