# -*- coding: utf-8 -*- """四段式窗口归类回归。 总览时间轴、运维页「当前时间段」、归档里的窗口快照此前各算各的, 现在统一走 agenda_contracts.window_for_minutes。 """ from __future__ import annotations import unittest from datetime import datetime, timedelta, timezone from agenda_contracts import ( WINDOW_DEFINITIONS, WINDOW_SLUGS, window_for_datetime, window_for_minutes, window_for_plan_minutes, ) TZ = timezone(timedelta(hours=8)) class WindowForMinutesTests(unittest.TestCase): def test_each_window_boundary(self): cases = [ (0, "深夜"), (5 * 60 + 59, "深夜"), (22 * 60, "深夜"), (23 * 60 + 59, "深夜"), (6 * 60, "早晨"), (11 * 60 + 59, "早晨"), (12 * 60, "下午"), (17 * 60 + 59, "下午"), (18 * 60, "晚上"), (21 * 60 + 59, "晚上"), ] for minutes, expected in cases: with self.subTest(minutes=minutes): self.assertEqual(window_for_minutes(minutes), expected) def test_cross_midnight_offset_is_normalised(self): """跨零点的段带 +1440 偏移,必须先取模再归类。""" self.assertEqual(window_for_minutes(24 * 60 + 30), "深夜") self.assertEqual(window_for_minutes(24 * 60 + 7 * 60), "早晨") def test_invalid_input_returns_empty(self): for value in (None, "", "abc", object()): self.assertEqual(window_for_minutes(value), "") def test_every_window_has_a_slug(self): for name, _start, _end in WINDOW_DEFINITIONS: self.assertIn(name, WINDOW_SLUGS) self.assertRegex(WINDOW_SLUGS[name], r"^[a-z_]+$") def test_agrees_with_window_for_datetime(self): """与既有的 datetime 版判定必须一致,否则页面和归档又会各说各的。""" for hour in range(24): for minute in (0, 30, 59): moment = datetime(2026, 7, 27, hour, minute, tzinfo=TZ) expected = window_for_datetime(moment)[0] with self.subTest(t=f"{hour:02d}:{minute:02d}"): self.assertEqual(window_for_minutes(hour * 60 + minute), expected) if __name__ == "__main__": unittest.main() class WindowForPlanMinutesTests(unittest.TestCase): """跨午夜归属:同一份计划里的两个「深夜」分属两个日程日。""" def test_early_morning_belongs_to_previous_night(self): self.assertEqual(window_for_plan_minutes("2026-07-27", 30), ("深夜", "2026-07-26")) self.assertEqual(window_for_plan_minutes("2026-07-27", 5 * 60 + 59), ("深夜", "2026-07-26")) def test_late_evening_belongs_to_the_same_day(self): self.assertEqual(window_for_plan_minutes("2026-07-27", 22 * 60), ("深夜", "2026-07-27")) self.assertEqual(window_for_plan_minutes("2026-07-27", 23 * 60), ("深夜", "2026-07-27")) def test_two_late_nights_in_one_plan_are_distinguishable(self): """时间轴上 00:30 与 23:00 都叫「深夜」,必须靠窗口日期分开。""" early = window_for_plan_minutes("2026-07-27", 30) late = window_for_plan_minutes("2026-07-27", 23 * 60) self.assertEqual(early[0], late[0]) self.assertNotEqual(early[1], late[1]) def test_daytime_windows_keep_the_plan_date(self): for minutes, expected in ((7 * 60, "早晨"), (13 * 60, "下午"), (19 * 60, "晚上")): with self.subTest(minutes=minutes): self.assertEqual(window_for_plan_minutes("2026-07-27", minutes), (expected, "2026-07-27")) def test_wrapped_minutes_resolve_to_the_next_calendar_day(self): """计划里时间回绕到次日时,_normalized_plan_item_starts 会加 +1440。""" self.assertEqual(window_for_plan_minutes("2026-07-27", 24 * 60 + 30), ("深夜", "2026-07-27")) self.assertEqual(window_for_plan_minutes("2026-07-27", 24 * 60 + 7 * 60), ("早晨", "2026-07-28")) def test_window_name_agrees_with_the_minutes_only_helper(self): for minutes in range(0, 24 * 60, 17): with self.subTest(minutes=minutes): self.assertEqual(window_for_plan_minutes("2026-07-27", minutes)[0], window_for_minutes(minutes)) def test_invalid_input_returns_empty_pair(self): self.assertEqual(window_for_plan_minutes("", 30), ("", "")) self.assertEqual(window_for_plan_minutes("not-a-date", 30), ("", "")) self.assertEqual(window_for_plan_minutes("2026-07-27", None), ("", ""))