import json import unittest from unittest.mock import Mock, patch from plugins.ita_plugin import ( CalendarGateError, CalendarNextMonthUnavailableError, CalendarProbeResult, scan_until_first_available_month, ) from plugins.ita_plugin import parse_calendar_availability def double_json(items): return json.dumps(json.dumps(items)) def probe(year, month, capacities): items = [ { "DateLibere": f"{day:02d}/{month:02d}/{year:04d} 00:00:00", "SlotLiberi": slots_free, "SlotRimanenti": slots_remaining, } for day, slots_free, slots_remaining in capacities ] return CalendarProbeResult( days=parse_calendar_availability(double_json(items)), selected_day=f"01/{month:02d}/{year:04d}", ) class CalendarProductionScanTests(unittest.TestCase): def test_rejects_dates_outside_the_requested_month(self): october_days = parse_calendar_availability( double_json( [ { "DateLibere": "01/10/2026 00:00:00", "SlotLiberi": 1, "SlotRimanenti": 0, } ] ) ) with self.assertRaisesRegex( CalendarGateError, "escaped the requested month", ): CalendarProbeResult( days=october_days, selected_day="01/09/2026", ) def test_stops_on_the_initial_positive_month(self): august = probe(2026, 8, [(20, 2, 1), (12, 1, 0)]) with patch( "plugins.ita_plugin.capture_initial_probe", return_value=august, ) as initial, patch( "plugins.ita_plugin.capture_next_probe" ) as next_probe: result = scan_until_first_available_month( Mock(), lookahead_months=12, month_click_interval_seconds=0, ) initial.assert_called_once() next_probe.assert_not_called() self.assertEqual(result.stop_reason, "first_available_month") self.assertEqual(result.scanned_months, 1) self.assertEqual( result.earliest_available_date.isoformat(), "2026-08-12", ) def test_scans_sequentially_then_stops_at_the_first_positive_month(self): august = probe(2026, 8, [(31, 0, -1)]) september = probe(2026, 9, [(30, 0, -1)]) october = probe( 2026, 10, [(20, 8, 7), (12, 1, 0), (1, 0, -1)], ) november = probe(2026, 11, [(2, 10, 9)]) log = Mock() with patch( "plugins.ita_plugin.capture_initial_probe", return_value=august, ), patch( "plugins.ita_plugin.capture_next_probe", side_effect=[september, october, november], ) as next_probe: result = scan_until_first_available_month( Mock(), lookahead_months=12, log=log, month_click_interval_seconds=0, ) self.assertEqual(next_probe.call_count, 2) self.assertEqual(result.stop_reason, "first_available_month") self.assertEqual(result.scanned_months, 3) self.assertEqual( result.earliest_available_date.isoformat(), "2026-10-12", ) self.assertEqual( [item.day.isoformat() for item in result.available_days], ["2026-10-12", "2026-10-20"], ) self.assertEqual(log.call_count, 3) def test_returns_none_only_after_the_complete_horizon(self): months = [ probe(2026, month, [(1, 0, -1)]) for month in (8, 9, 10) ] with patch( "plugins.ita_plugin.capture_initial_probe", return_value=months[0], ), patch( "plugins.ita_plugin.capture_next_probe", side_effect=months[1:], ) as next_probe: result = scan_until_first_available_month( Mock(), lookahead_months=3, month_click_interval_seconds=0, ) self.assertEqual(next_probe.call_count, 2) self.assertEqual(result.stop_reason, "horizon_exhausted") self.assertEqual(result.scanned_months, 3) self.assertIsNone(result.earliest_available_date) self.assertEqual(result.available_days, ()) def test_accepts_an_exact_cross_year_transition(self): december = probe(2026, 12, [(1, 0, -1)]) january = probe(2027, 1, [(4, 1, 0)]) with patch( "plugins.ita_plugin.capture_initial_probe", return_value=december, ), patch( "plugins.ita_plugin.capture_next_probe", return_value=january, ): result = scan_until_first_available_month( Mock(), lookahead_months=2, month_click_interval_seconds=0, ) self.assertEqual( result.earliest_available_date.isoformat(), "2027-01-04", ) def test_rejects_a_skipped_month_instead_of_publishing_a_signal(self): august = probe(2026, 8, [(1, 0, -1)]) october = probe(2026, 10, [(1, 1, 0)]) with patch( "plugins.ita_plugin.capture_initial_probe", return_value=august, ), patch( "plugins.ita_plugin.capture_next_probe", return_value=october, ): with self.assertRaisesRegex( CalendarGateError, "exactly one month", ): scan_until_first_available_month( Mock(), lookahead_months=2, month_click_interval_seconds=0, ) def test_incomplete_native_navigation_is_not_misreported_as_no_slots(self): august = probe(2026, 8, [(1, 0, -1)]) with patch( "plugins.ita_plugin.capture_initial_probe", return_value=august, ), patch( "plugins.ita_plugin.capture_next_probe", side_effect=CalendarNextMonthUnavailableError("bounded"), ): with self.assertRaisesRegex( CalendarGateError, "before the configured horizon", ): scan_until_first_available_month( Mock(), lookahead_months=2, month_click_interval_seconds=0, ) def test_rejects_invalid_scan_bounds(self): for value in (True, 0, 121): with self.subTest(value=value): with self.assertRaisesRegex( CalendarGateError, "lookahead_months", ): scan_until_first_available_month( Mock(), lookahead_months=value, month_click_interval_seconds=0, ) if __name__ == "__main__": unittest.main()