Skip to main content

vardadieniai/
lib.rs

1//! # vardadieniai
2//!
3//! Lietuvos vardadienių kalendorius: kurie vardai švenčiami pasirinktą dieną, kada švenčia
4//! konkretus vardas ir kas švenčia šiandien (Vilniaus laiku). Lithuanian name day calendar:
5//! names by date, dates by name and today's names in Europe/Vilnius time. No dependencies.
6//!
7//! The calendar for people, with today's and tomorrow's names, greetings and gift ideas:
8//! <https://dovanasuvardu.lt/vardadieniai/>
9//!
10//! ```
11//! assert!(vardadieniai::names_on(11, 9).contains(&"Teodoras"));
12//! assert!(vardadieniai::days_for("ąžuolas").iter().all(|&(m, _)| (1..=12).contains(&m)));
13//! assert_eq!(vardadieniai::format_date(11, 9), "lapkričio 9 d.");
14//! ```
15//!
16//! Code: MIT. Name day data: CC BY-SA 4.0 (source: Lithuanian Wikipedia).
17#![forbid(unsafe_code)]
18#![warn(missing_docs)]
19
20mod data;
21mod date;
22
23pub use date::{days_in_month, is_leap, vilnius_date, vilnius_today, Date};
24
25/// Online name day calendar (Lithuanian).
26pub const HOMEPAGE: &str = "https://dovanasuvardu.lt/vardadieniai/";
27
28/// Lithuanian month names in the genitive case (`sausio` … `gruodžio`).
29pub const MONTHS_LT: [&str; 12] = ["sausio", "vasario", "kovo", "balandžio", "gegužės", "birželio", "liepos", "rugpjūčio", "rugsėjo", "spalio", "lapkričio", "gruodžio"];
30
31/// Lowercases the text and removes Lithuanian diacritics (`Ąžuolas` -> `azuolas`).
32pub fn fold(text: &str) -> String {
33    text.trim()
34        .chars()
35        .flat_map(char::to_lowercase)
36        .map(|c| match c {
37            'ą' | 'à' | 'á' | 'â' | 'ä' | 'ã' | 'å' | 'ā' => 'a',
38            'č' | 'ç' | 'ć' => 'c',
39            'ę' | 'ė' | 'è' | 'é' | 'ê' | 'ë' | 'ē' => 'e',
40            'į' | 'ì' | 'í' | 'î' | 'ï' | 'ī' => 'i',
41            'š' | 'ś' => 's',
42            'ų' | 'ū' | 'ù' | 'ú' | 'û' | 'ü' => 'u',
43            'ž' | 'ź' | 'ż' => 'z',
44            'ò' | 'ó' | 'ô' | 'ö' | 'õ' | 'ō' => 'o',
45            'ñ' | 'ń' => 'n',
46            'ł' => 'l',
47            other => other,
48        })
49        .collect()
50}
51
52/// Names celebrated on the given day (`month` 1–12, `day` 1–31).
53/// Returns an empty slice for a date that is not in the calendar.
54pub fn names_on(month: u32, day: u32) -> &'static [&'static str] {
55    data::DAYS
56        .iter()
57        .find(|&&(m, d, _)| u32::from(m) == month && u32::from(d) == day)
58        .map(|&(_, _, names)| names)
59        .unwrap_or(&[])
60}
61
62/// Days `(month, day)` on which the name is celebrated. Case and diacritics are ignored,
63/// so `"azuolas"` finds `Ąžuolas`.
64pub fn days_for(name: &str) -> Vec<(u32, u32)> {
65    let wanted = fold(name);
66    data::DAYS
67        .iter()
68        .filter(|(_, _, names)| names.iter().any(|n| fold(n) == wanted))
69        .map(|&(m, d, _)| (u32::from(m), u32::from(d)))
70        .collect()
71}
72
73/// All days of a month (`1..=12`) with their names, in calendar order.
74pub fn month(month: u32) -> Vec<(u32, &'static [&'static str])> {
75    data::DAYS
76        .iter()
77        .filter(|&&(m, _, _)| u32::from(m) == month)
78        .map(|&(_, d, names)| (u32::from(d), names))
79        .collect()
80}
81
82/// Names celebrated today in Lithuania.
83pub fn today() -> &'static [&'static str] {
84    let t = vilnius_today();
85    names_on(t.month, t.day)
86}
87
88/// Names celebrated tomorrow in Lithuania.
89pub fn tomorrow() -> &'static [&'static str] {
90    let t = vilnius_today().next_day();
91    names_on(t.month, t.day)
92}
93
94/// Lithuanian date label, e.g. `format_date(11, 9)` = `"lapkričio 9 d."`.
95pub fn format_date(month: u32, day: u32) -> String {
96    match month {
97        1..=12 => format!("{} {} d.", MONTHS_LT[(month - 1) as usize], day),
98        _ => format!("{}-{}", month, day),
99    }
100}
101
102#[cfg(test)]
103mod tests {
104    use super::*;
105
106    #[test]
107    fn calendar_has_every_day() {
108        assert_eq!(data::DAYS.len(), 366);
109        for m in 1..=12 {
110            assert_eq!(month(m).len() as u32, days_in_month(2024, m));
111        }
112    }
113
114    #[test]
115    fn lookups() {
116        assert!(names_on(11, 9).contains(&"Teodoras"));
117        assert!(names_on(2, 30).is_empty());
118        assert!(days_for("TEODORAS").contains(&(11, 9)));
119        assert!(days_for("nera-tokio-vardo").is_empty());
120        assert_eq!(fold(" Ąžuolas "), "azuolas");
121        assert_eq!(format_date(1, 1), "sausio 1 d.");
122    }
123}