"""调度器测试:窗口语义、三类触发器与 EventBus 事件触发。""" from __future__ import annotations import asyncio from datetime import datetime, timedelta import pytest from bot042.flows.bus import EventBus from bot042.flows.scheduler import ( CN_TZ, CronTrigger, Fire, IntervalTrigger, OnceTrigger, Schedule, Scheduler, ) NOW = datetime(2026, 11, 6, 10, 0, tzinfo=CN_TZ) # 周五 def test_once_inside_and_outside_window() -> None: s = Schedule( name="once-in", trigger=OnceTrigger(at=datetime(2026, 11, 6, 12, 0)), start_time=datetime(2026, 11, 6, 9, 0), end_time=datetime(2026, 11, 6, 18, 0), ) assert s.next_fire_after(NOW) == datetime(2026, 11, 6, 12, 0, tzinfo=CN_TZ) # 早于 start_time 的 once 永不触发(即使 after 早于 at) s2 = Schedule( name="once-before-start", trigger=OnceTrigger(at=datetime(2026, 11, 6, 8, 0)), start_time=datetime(2026, 11, 6, 9, 0), ) assert s2.next_fire_after(datetime(2026, 11, 6, 7, 0, tzinfo=CN_TZ)) is None # 晚于 end_time 的 once 不触发 s3 = Schedule( name="once-after-end", trigger=OnceTrigger(at=datetime(2026, 11, 6, 20, 0)), end_time=datetime(2026, 11, 6, 18, 0), ) assert s3.next_fire_after(NOW) is None # 已过触发时刻不再触发 s4 = Schedule(name="once-past", trigger=OnceTrigger(at=datetime(2026, 11, 6, 9, 30))) assert s4.next_fire_after(NOW) is None def test_cron_respects_window() -> None: s = Schedule( name="cron1", trigger=CronTrigger(expr="0 9 * * *"), start_time=datetime(2026, 11, 6, 10, 0), end_time=datetime(2026, 11, 7, 9, 30), ) assert s.next_fire_after(NOW) == datetime(2026, 11, 7, 9, 0, tzinfo=CN_TZ) # after 早于 start_time 时抬升:首次触发即 start_time 当刻的匹配 s2 = Schedule( name="cron2", trigger=CronTrigger(expr="0 9 * * *"), start_time=datetime(2026, 11, 7, 9, 0), ) assert s2.next_fire_after(NOW) == datetime(2026, 11, 7, 9, 0, tzinfo=CN_TZ) # end_time 截止后无触发 s3 = Schedule( name="cron3", trigger=CronTrigger(expr="0 9 * * *"), end_time=datetime(2026, 11, 6, 23, 0), ) assert s3.next_fire_after(NOW) is None def test_interval_aligned_to_start() -> None: s = Schedule( name="iv", trigger=IntervalTrigger(every=timedelta(minutes=15)), start_time=datetime(2026, 11, 6, 9, 0), ) assert s.next_fire_after(datetime(2026, 11, 6, 10, 7, tzinfo=CN_TZ)) == datetime( 2026, 11, 6, 10, 15, tzinfo=CN_TZ ) # 无 start_time 时从 after 起算 s2 = Schedule(name="iv2", trigger=IntervalTrigger(every=timedelta(minutes=15))) assert s2.next_fire_after(NOW) == datetime(2026, 11, 6, 10, 15, tzinfo=CN_TZ) def test_interval_grid_anchored_to_first_anchor() -> None: """调度器固化 anchor 后,间隔不随每次重算漂移。""" s = Schedule(name="iv3", trigger=IntervalTrigger(every=timedelta(seconds=10))) anchor = datetime(2026, 11, 6, 10, 0, 0, tzinfo=CN_TZ) first = s.next_fire_after(datetime(2026, 11, 6, 10, 0, 0, 300000, tzinfo=CN_TZ), anchor=anchor) # 触发开销 0.3s 后再算下一次,仍落在同一网格上 assert first == datetime(2026, 11, 6, 10, 0, 10, tzinfo=CN_TZ) second = s.next_fire_after(first + timedelta(seconds=0.3), anchor=anchor) assert second == datetime(2026, 11, 6, 10, 0, 20, tzinfo=CN_TZ) assert (second - first).total_seconds() == 10.0 def test_schedule_event_name() -> None: s = Schedule(name="daily.1", trigger=OnceTrigger(at=NOW)) assert s.event == "schedule.daily.1" def test_schedule_validation() -> None: with pytest.raises(ValueError): Schedule(name="bad name!", trigger=OnceTrigger(at=NOW)) with pytest.raises(ValueError): Schedule( name="window", trigger=OnceTrigger(at=NOW), start_time=datetime(2026, 11, 6, 18, 0), end_time=datetime(2026, 11, 6, 9, 0), ) with pytest.raises(ValueError): IntervalTrigger(every=timedelta(0)) sched = Scheduler(EventBus()) sched.add(Schedule(name="dup", trigger=OnceTrigger(at=NOW))) with pytest.raises(ValueError): sched.add(Schedule(name="dup", trigger=OnceTrigger(at=NOW))) def test_scheduler_fires_events_and_stops() -> None: async def main() -> None: bus = EventBus() fired: list[Fire] = [] seen: list[str] = [] async def on_fire(fire: Fire) -> None: fired.append(fire) async def on_named(fire: Fire) -> None: seen.append(fire.name) bus.on("schedule.fired", on_fire) bus.on("schedule.tick", on_named) sched = Scheduler(bus) sched.add(Schedule(name="tick", trigger=IntervalTrigger(every=timedelta(milliseconds=30)))) async with sched: await asyncio.sleep(0.25) await bus.wait_for_complete() assert len(fired) >= 2 assert seen == ["tick"] * len(fired) assert all(f.scheduled_time.tzinfo is not None for f in fired) # stop 后不再触发 count = len(fired) await asyncio.sleep(0.1) assert len(fired) == count asyncio.run(main()) def test_once_fires_exactly_once() -> None: async def main() -> None: bus = EventBus() count = 0 async def on_fire(fire: Fire) -> None: nonlocal count count += 1 bus.on("schedule.fired", on_fire) sched = Scheduler(bus) sched.add( Schedule( name="one", trigger=OnceTrigger(at=datetime.now(CN_TZ) + timedelta(milliseconds=40)), ) ) async with sched: await asyncio.sleep(0.3) await bus.wait_for_complete() assert count == 1 asyncio.run(main())