use core::time::Duration;
use jiff::Timestamp;
use super::{Calendar, FIELDS};
fn at(text: &str) -> Timestamp {
text.parse().expect("an instant")
}
fn walk(calendar: &Calendar, from: &str, count: usize) -> Vec<String> {
let mut at = at(from);
let mut fired = Vec::with_capacity(count);
for _ in 0..count {
let Some(next) = calendar.next_after(at) else {
break;
};
fired.push(next.strftime("%Y-%m-%dT%H:%M:%S%:z").to_string());
at = next.timestamp();
}
fired
}
#[test]
fn the_dialect_is_the_classic_five_fields() {
assert_eq!(FIELDS, 5);
assert!(Calendar::parse("0 3 * * *").is_ok());
assert!(Calendar::parse("*/15 * * * *").is_ok());
let refusal = Calendar::parse("0 3 * * * Asia/Shanghai").expect_err("six fields");
assert!(
refusal.to_string().contains("classic 5 fields"),
"{refusal}"
);
let refusal = Calendar::parse("0 3 * *").expect_err("four fields");
assert!(refusal.to_string().contains("has 4"), "{refusal}");
}
#[test]
fn garbage_carries_the_offending_field() {
let refusal = Calendar::parse("99 3 * * *").expect_err("a minute past 59");
assert!(refusal.to_string().contains("99"), "{refusal}");
}
#[test]
fn a_zone_is_read_by_name() {
let calendar = Calendar::parse_in("0 3 * * *", "America/New_York").expect("a real zone");
assert_eq!(calendar.expression(), "0 3 * * *");
assert!(Calendar::parse_in("0 3 * * *", "Not/AZone").is_err());
}
#[test]
fn a_daily_schedule_is_due_inside_a_day() {
let calendar = Calendar::parse_in("0 3 * * *", "Etc/UTC").expect("a daily schedule");
let wait = calendar
.until_next()
.expect("a daily schedule is always due again");
assert!(wait <= Duration::from_secs(24 * 60 * 60), "{wait:?}");
}
#[test]
fn dom_and_dow_are_the_classic_or() {
let calendar = Calendar::parse_in("0 3 1 * MON", "Etc/UTC").expect("a dom/dow schedule");
assert_eq!(
walk(&calendar, "2026-03-01T00:00:00Z", 4),
[
"2026-03-01T03:00:00+00:00",
"2026-03-02T03:00:00+00:00",
"2026-03-09T03:00:00+00:00",
"2026-03-16T03:00:00+00:00",
]
);
}
#[test]
fn a_gap_day_fires_once_at_the_gaps_end() {
let calendar = Calendar::parse_in("30 2 * * *", "America/New_York").expect("a daily schedule");
assert_eq!(
walk(&calendar, "2026-03-06T12:00:00Z", 4),
[
"2026-03-07T02:30:00-05:00",
"2026-03-08T03:00:00-04:00",
"2026-03-09T02:30:00-04:00",
"2026-03-10T02:30:00-04:00",
]
);
}
#[test]
fn a_whole_gap_collapses_to_one_firing() {
let calendar = Calendar::parse_in("*/20 2 * * *", "America/New_York").expect("a gap schedule");
assert_eq!(
walk(&calendar, "2026-03-08T06:00:00Z", 4),
[
"2026-03-08T03:00:00-04:00",
"2026-03-09T02:00:00-04:00",
"2026-03-09T02:20:00-04:00",
"2026-03-09T02:40:00-04:00",
]
);
}
#[test]
fn a_fold_fires_once_at_the_first_occurrence() {
let calendar = Calendar::parse_in("30 1 * * *", "America/New_York").expect("a daily schedule");
assert_eq!(
walk(&calendar, "2026-10-30T12:00:00Z", 4),
[
"2026-10-31T01:30:00-04:00",
"2026-11-01T01:30:00-04:00",
"2026-11-02T01:30:00-05:00",
"2026-11-03T01:30:00-05:00",
]
);
}
#[test]
fn a_repeated_hour_costs_its_second_pass() {
let calendar = Calendar::parse_in("*/15 1 * * *", "America/New_York").expect("a fold schedule");
assert_eq!(
walk(&calendar, "2026-11-01T04:00:00Z", 5),
[
"2026-11-01T01:00:00-04:00",
"2026-11-01T01:15:00-04:00",
"2026-11-01T01:30:00-04:00",
"2026-11-01T01:45:00-04:00",
"2026-11-02T01:00:00-05:00",
]
);
}
#[test]
fn a_day_that_never_comes_is_never() {
let calendar = Calendar::parse_in("0 0 30 2 *", "Etc/UTC").expect("a legal expression");
assert!(calendar.until_next().is_none());
let leap = Calendar::parse_in("0 0 29 2 *", "Etc/UTC").expect("a leap-day schedule");
assert_eq!(
walk(&leap, "2026-03-01T00:00:00Z", 1),
["2028-02-29T00:00:00+00:00"]
);
}
#[test]
fn a_refusal_quotes_the_expression_under_a_caret() {
let refusal = Calendar::parse_in("99 3 * * *", "Etc/UTC").expect_err("a minute past 59");
let refusal = refusal.to_string();
assert!(refusal.contains("minute"), "{refusal}");
assert!(refusal.contains("99 3 * * *"), "{refusal}");
assert!(refusal.contains('^'), "{refusal}");
let marked = refusal.lines().next_back().expect("a caret line");
assert_eq!(marked.trim_end(), " ^^", "{refusal}");
}
#[test]
fn the_two_halves_render_one_caret() {
let refusal = Calendar::parse_in("0 3 * * MONDAY", "Etc/UTC").expect_err("not a day name");
let rendered = refusal.to_string();
let mut lines = rendered.lines();
let sentence = lines.next().expect("a sentence");
assert!(sentence.contains("day of week"), "{rendered}");
assert_eq!(lines.next(), Some(" 0 3 * * MONDAY"), "{rendered}");
let marked = lines.next().expect("a caret line");
assert!(marked.starts_with(" "), "{rendered}");
assert!(marked.trim_start().starts_with('^'), "{rendered}");
assert_eq!(lines.next(), None, "the rendering is three lines");
}