test_ita_calendar_query.py 7.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. import json
  2. import unittest
  3. from unittest.mock import Mock, patch
  4. from plugins.ita_plugin import (
  5. CalendarGateError,
  6. CalendarNextMonthUnavailableError,
  7. CalendarProbeResult,
  8. scan_until_first_available_month,
  9. )
  10. from plugins.ita_plugin import parse_calendar_availability
  11. def double_json(items):
  12. return json.dumps(json.dumps(items))
  13. def probe(year, month, capacities):
  14. items = [
  15. {
  16. "DateLibere": f"{day:02d}/{month:02d}/{year:04d} 00:00:00",
  17. "SlotLiberi": slots_free,
  18. "SlotRimanenti": slots_remaining,
  19. }
  20. for day, slots_free, slots_remaining in capacities
  21. ]
  22. return CalendarProbeResult(
  23. days=parse_calendar_availability(double_json(items)),
  24. selected_day=f"01/{month:02d}/{year:04d}",
  25. )
  26. class CalendarProductionScanTests(unittest.TestCase):
  27. def test_rejects_dates_outside_the_requested_month(self):
  28. october_days = parse_calendar_availability(
  29. double_json(
  30. [
  31. {
  32. "DateLibere": "01/10/2026 00:00:00",
  33. "SlotLiberi": 1,
  34. "SlotRimanenti": 0,
  35. }
  36. ]
  37. )
  38. )
  39. with self.assertRaisesRegex(
  40. CalendarGateError,
  41. "escaped the requested month",
  42. ):
  43. CalendarProbeResult(
  44. days=october_days,
  45. selected_day="01/09/2026",
  46. )
  47. def test_stops_on_the_initial_positive_month(self):
  48. august = probe(2026, 8, [(20, 2, 1), (12, 1, 0)])
  49. with patch(
  50. "plugins.ita_plugin.capture_initial_probe",
  51. return_value=august,
  52. ) as initial, patch(
  53. "plugins.ita_plugin.capture_next_probe"
  54. ) as next_probe:
  55. result = scan_until_first_available_month(
  56. Mock(),
  57. lookahead_months=12,
  58. month_click_interval_seconds=0,
  59. )
  60. initial.assert_called_once()
  61. next_probe.assert_not_called()
  62. self.assertEqual(result.stop_reason, "first_available_month")
  63. self.assertEqual(result.scanned_months, 1)
  64. self.assertEqual(
  65. result.earliest_available_date.isoformat(),
  66. "2026-08-12",
  67. )
  68. def test_scans_sequentially_then_stops_at_the_first_positive_month(self):
  69. august = probe(2026, 8, [(31, 0, -1)])
  70. september = probe(2026, 9, [(30, 0, -1)])
  71. october = probe(
  72. 2026,
  73. 10,
  74. [(20, 8, 7), (12, 1, 0), (1, 0, -1)],
  75. )
  76. november = probe(2026, 11, [(2, 10, 9)])
  77. log = Mock()
  78. with patch(
  79. "plugins.ita_plugin.capture_initial_probe",
  80. return_value=august,
  81. ), patch(
  82. "plugins.ita_plugin.capture_next_probe",
  83. side_effect=[september, october, november],
  84. ) as next_probe:
  85. result = scan_until_first_available_month(
  86. Mock(),
  87. lookahead_months=12,
  88. log=log,
  89. month_click_interval_seconds=0,
  90. )
  91. self.assertEqual(next_probe.call_count, 2)
  92. self.assertEqual(result.stop_reason, "first_available_month")
  93. self.assertEqual(result.scanned_months, 3)
  94. self.assertEqual(
  95. result.earliest_available_date.isoformat(),
  96. "2026-10-12",
  97. )
  98. self.assertEqual(
  99. [item.day.isoformat() for item in result.available_days],
  100. ["2026-10-12", "2026-10-20"],
  101. )
  102. self.assertEqual(log.call_count, 3)
  103. def test_returns_none_only_after_the_complete_horizon(self):
  104. months = [
  105. probe(2026, month, [(1, 0, -1)])
  106. for month in (8, 9, 10)
  107. ]
  108. with patch(
  109. "plugins.ita_plugin.capture_initial_probe",
  110. return_value=months[0],
  111. ), patch(
  112. "plugins.ita_plugin.capture_next_probe",
  113. side_effect=months[1:],
  114. ) as next_probe:
  115. result = scan_until_first_available_month(
  116. Mock(),
  117. lookahead_months=3,
  118. month_click_interval_seconds=0,
  119. )
  120. self.assertEqual(next_probe.call_count, 2)
  121. self.assertEqual(result.stop_reason, "horizon_exhausted")
  122. self.assertEqual(result.scanned_months, 3)
  123. self.assertIsNone(result.earliest_available_date)
  124. self.assertEqual(result.available_days, ())
  125. def test_accepts_an_exact_cross_year_transition(self):
  126. december = probe(2026, 12, [(1, 0, -1)])
  127. january = probe(2027, 1, [(4, 1, 0)])
  128. with patch(
  129. "plugins.ita_plugin.capture_initial_probe",
  130. return_value=december,
  131. ), patch(
  132. "plugins.ita_plugin.capture_next_probe",
  133. return_value=january,
  134. ):
  135. result = scan_until_first_available_month(
  136. Mock(),
  137. lookahead_months=2,
  138. month_click_interval_seconds=0,
  139. )
  140. self.assertEqual(
  141. result.earliest_available_date.isoformat(),
  142. "2027-01-04",
  143. )
  144. def test_rejects_a_skipped_month_instead_of_publishing_a_signal(self):
  145. august = probe(2026, 8, [(1, 0, -1)])
  146. october = probe(2026, 10, [(1, 1, 0)])
  147. with patch(
  148. "plugins.ita_plugin.capture_initial_probe",
  149. return_value=august,
  150. ), patch(
  151. "plugins.ita_plugin.capture_next_probe",
  152. return_value=october,
  153. ):
  154. with self.assertRaisesRegex(
  155. CalendarGateError,
  156. "exactly one month",
  157. ):
  158. scan_until_first_available_month(
  159. Mock(),
  160. lookahead_months=2,
  161. month_click_interval_seconds=0,
  162. )
  163. def test_incomplete_native_navigation_is_not_misreported_as_no_slots(self):
  164. august = probe(2026, 8, [(1, 0, -1)])
  165. with patch(
  166. "plugins.ita_plugin.capture_initial_probe",
  167. return_value=august,
  168. ), patch(
  169. "plugins.ita_plugin.capture_next_probe",
  170. side_effect=CalendarNextMonthUnavailableError("bounded"),
  171. ):
  172. with self.assertRaisesRegex(
  173. CalendarGateError,
  174. "before the configured horizon",
  175. ):
  176. scan_until_first_available_month(
  177. Mock(),
  178. lookahead_months=2,
  179. month_click_interval_seconds=0,
  180. )
  181. def test_rejects_invalid_scan_bounds(self):
  182. for value in (True, 0, 121):
  183. with self.subTest(value=value):
  184. with self.assertRaisesRegex(
  185. CalendarGateError,
  186. "lookahead_months",
  187. ):
  188. scan_until_first_available_month(
  189. Mock(),
  190. lookahead_months=value,
  191. month_click_interval_seconds=0,
  192. )
  193. if __name__ == "__main__":
  194. unittest.main()