"""cron 解析与下次触发计算测试。""" from __future__ import annotations from datetime import datetime import pytest from bot042.flows.cron import CronError, parse_cron def _next(expr: str, after: datetime) -> datetime | None: return parse_cron(expr).next_after(after) def test_star_step() -> None: assert _next("*/15 * * * *", datetime(2026, 11, 6, 10, 7)) == datetime(2026, 11, 6, 10, 15) assert _next("*/15 * * * *", datetime(2026, 11, 6, 10, 15)) == datetime(2026, 11, 6, 10, 30) def test_daily_time() -> None: assert _next("0 9 * * *", datetime(2026, 11, 6, 10, 0)) == datetime(2026, 11, 7, 9, 0) assert _next("0 9 * * *", datetime(2026, 11, 6, 8, 0)) == datetime(2026, 11, 6, 9, 0) def test_dow_names() -> None: # 2026-11-06 是周五;当天 8:30 已过,下一次工作日 8:30 是周一 2026-11-09 assert _next("30 8 * * MON-FRI", datetime(2026, 11, 6, 9, 0)) == datetime(2026, 11, 9, 8, 30) def test_dom_dow_or_semantics() -> None: # 日与周同时受限时按“或”:最近的是周一 2026-11-16,而非 12-01 assert _next("0 0 1 * 1", datetime(2026, 11, 15, 0, 0)) == datetime(2026, 11, 16, 0, 0) # 只约束周:2026-11-30 是周一,严格晚于它的是 2026-12-07 assert _next("0 0 * * 1", datetime(2026, 11, 30, 0, 0)) == datetime(2026, 12, 7, 0, 0) def test_dow_seven_is_sunday() -> None: assert _next("0 0 * * 7", datetime(2026, 11, 6)) == datetime(2026, 11, 8) assert _next("0 0 * * 0", datetime(2026, 11, 6)) == datetime(2026, 11, 8) def test_leap_day() -> None: assert _next("0 0 29 2 *", datetime(2026, 3, 1)) == datetime(2028, 2, 29) def test_impossible_returns_none() -> None: assert _next("0 0 30 2 *", datetime(2026, 1, 1)) is None def test_yearly() -> None: assert _next("0 0 1 1 *", datetime(2026, 11, 6)) == datetime(2027, 1, 1) def test_range_with_step() -> None: assert _next("0-30/10 12 * * *", datetime(2026, 11, 6, 12, 0)) == datetime(2026, 11, 6, 12, 10) def test_full_range_counts_as_star() -> None: """`0-6`、`*/1`、`1-31` 语义等价于 `*`,不应触发 DOM/DOW 的 OR 规则。""" after = datetime(2026, 11, 15, 12, 0) assert _next("0 0 1 * 0-6", after) == datetime(2026, 12, 1) assert _next("0 0 1 * */1", after) == datetime(2026, 12, 1) assert _next("0 0 1-31 * 1", after) == datetime(2026, 11, 16) # 周受限 → 仍是"或" def test_invalid_expressions() -> None: with pytest.raises(CronError): parse_cron("* * * *") with pytest.raises(CronError): parse_cron("61 * * * *") with pytest.raises(CronError): parse_cron("* * * * 8") with pytest.raises(CronError): parse_cron("*/0 * * * *") with pytest.raises(CronError): parse_cron("b-x * * * *") with pytest.raises(CronError): parse_cron("1-0 * * * *")