balls 0.5.4

Git-native task tracker for parallel agent workflows
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

use super::*;

#[test]
fn the_epoch_renders_as_the_start_of_1970() {
    assert_eq!(iso8601(0), "1970-01-01T00:00:00Z");
}

#[test]
fn a_known_timestamp_renders_its_civil_date() {
    // 1748357520 = 2025-05-27T14:52:00Z (the §3 example timestamp).
    assert_eq!(iso8601(1_748_357_520), "2025-05-27T14:52:00Z");
}

#[test]
fn the_time_of_day_splits_into_hms() {
    // One hour, two minutes, three seconds past the epoch.
    assert_eq!(iso8601(3723), "1970-01-01T01:02:03Z");
    // The last second of a day.
    assert_eq!(iso8601(86_399), "1970-01-01T23:59:59Z");
}

#[test]
fn a_leap_day_is_rendered() {
    // 2024-02-29T00:00:00Z = 19782 days * 86400.
    assert_eq!(iso8601(19_782 * 86_400), "2024-02-29T00:00:00Z");
}

#[test]
fn a_pre_epoch_timestamp_floors_to_its_true_civil_date() {
    // -1 second is the last second of 1969, not a negative wrap.
    assert_eq!(iso8601(-1), "1969-12-31T23:59:59Z");
    // A full day before the epoch.
    assert_eq!(iso8601(-86_400), "1969-12-31T00:00:00Z");
}

#[test]
fn a_far_future_year_renders_four_digits() {
    // 2100 is NOT a leap year (divisible by 100, not 400) — exercises the
    // century rule in civil_from_days.
    assert_eq!(iso8601(4_107_542_400), "2100-03-01T00:00:00Z");
}

#[test]
fn start_of_day_is_the_exact_inverse_of_iso8601_at_midnight() {
    // Round-trips the day-start second back from its rendered date.
    for date in ["1970-01-01", "2024-02-29", "2026-01-01", "2100-03-01"] {
        let secs = start_of_day(date).unwrap();
        assert_eq!(secs % 86_400, 0); // a day boundary
        assert_eq!(&iso8601(secs)[..10], date); // same calendar date
    }
}

#[test]
fn start_of_day_handles_a_pre_epoch_date() {
    assert_eq!(start_of_day("1969-12-31"), Some(-86_400));
}

#[test]
fn start_of_day_rejects_malformed_dates() {
    for bad in [
        "2026-01",       // too few fields
        "2026-01-01-01", // too many fields
        "2026-13-01",    // month out of range
        "2026-00-01",    // month zero
        "2026-01-32",    // day out of range
        "2026-01-00",    // day zero
        "not-a-date",    // unparseable
        "2026-1x-01",    // unparseable month
    ] {
        assert!(start_of_day(bad).is_none(), "expected {bad:?} rejected");
    }
}