quillmark-core 0.92.1

Core types and functionality for Quillmark
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

use std::sync::LazyLock;

use time::format_description::well_known::Rfc3339;
use time::format_description::{self, FormatItem};
use time::{Date, OffsetDateTime, PrimitiveDateTime};

static DATE_FMT: LazyLock<Vec<FormatItem<'static>>> =
    LazyLock::new(|| format_description::parse("[year]-[month]-[day]").expect("valid format"));

// Local (no-offset) forms tried in order — most-specific first so that a
// string like "…T12:00:00.5" does not partially match the plain HMS variant.
static LOCAL_FMTS: LazyLock<[Vec<FormatItem<'static>>; 6]> = LazyLock::new(|| {
    [
        format_description::parse("[year]-[month]-[day]T[hour]:[minute]:[second].[subsecond]")
            .expect("valid format"),
        format_description::parse("[year]-[month]-[day]T[hour]:[minute]:[second]")
            .expect("valid format"),
        format_description::parse("[year]-[month]-[day]T[hour]:[minute]").expect("valid format"),
        format_description::parse("[year]-[month]-[day] [hour]:[minute]:[second].[subsecond]")
            .expect("valid format"),
        format_description::parse("[year]-[month]-[day] [hour]:[minute]:[second]")
            .expect("valid format"),
        format_description::parse("[year]-[month]-[day] [hour]:[minute]").expect("valid format"),
    ]
});

/// Returns `true` when `s` is a valid datetime string.
///
/// Accepted forms:
/// - Bare date:        `YYYY-MM-DD`
/// - Local datetime:   `YYYY-MM-DD[T ]hh:mm[:ss[.s+]]`
/// - UTC / offset:     RFC 3339 — `YYYY-MM-DDThh:mm:ss[.s+](Z|±HH:MM)`
///
/// Parsing is delegated to the `time` crate, which enforces zero-padded
/// components and calendar validity (Feb 30 is rejected). Timezone offsets
/// require the T separator and seconds (RFC 3339 form).
pub(crate) fn is_valid_datetime(s: &str) -> bool {
    if OffsetDateTime::parse(s, &Rfc3339).is_ok() {
        return true;
    }
    for fmt in LOCAL_FMTS.iter() {
        if PrimitiveDateTime::parse(s, fmt).is_ok() {
            return true;
        }
    }
    Date::parse(s, &*DATE_FMT).is_ok()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn valid_datetimes() {
        for s in [
            // bare date
            "2026-06-01",
            // local datetime — T separator
            "2026-06-01T12:00:00",
            "2026-06-01T12:00",
            "2026-06-01T12:00:00.5",
            "2026-06-01T12:00:00.123",
            // local datetime — space separator
            "2026-06-01 12:00:00",
            "2026-06-01 12:00",
            "2026-06-01 12:00:00.5",
            // RFC 3339 — UTC
            "2026-06-01T12:00:00Z",
            // RFC 3339 — offsets
            "2026-06-01T12:00:00+05:30",
            "2026-06-01T12:00:00-05:00",
            "2026-06-01T12:00:00+00:00",
            // RFC 3339 — fractional seconds
            "2026-06-01T12:00:00.5Z",
            "2026-06-01T12:00:00.123+05:30",
        ] {
            assert!(is_valid_datetime(s), "expected valid: {s}");
        }
    }

    #[test]
    fn invalid_datetimes() {
        for s in [
            "",
            "2026",
            "2026-06",
            "not-a-date",
            "13-04-2026",
            "2026-06-01T",
            "2026-06-01T12",
            "2026-06-01T12:",
            "2026-06-01T12:0",      // single-digit minute
            "2026-06-01T12:00:00 ", // trailing space
            "2026-06-01T12:00:00+",
            "2026-06-01T12:00:00X",
            "2026-13-01", // month out of range
            "2026-02-30", // calendar-invalid date (Feb 30)
            "2026-6-1",   // single-digit month/day (not zero-padded)
        ] {
            assert!(!is_valid_datetime(s), "expected invalid: {s}");
        }
    }
}