| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230 |
- """Offline contracts for the thin Italy final-submit adapter."""
- import json
- import unittest
- from types import SimpleNamespace
- from unittest.mock import Mock
- from plugins import ita_plugin as final
- from plugins.ita_plugin import (
- FINAL_ACCEPTED_LABEL,
- FINAL_FAILED_LABEL,
- FINAL_PATH,
- NATIVE_FINAL_SCRIPT,
- _final_packet_accepted,
- _submit_final_once,
- )
- from test.ita.test_ita_calendar_book import FakePage, SERVICE, select
- from test.ita import test_ita_calendar_book_flow as flow
- def target():
- """Small synthetic target retained for debug-tool fixtures."""
- page = FakePage()
- approval = select(page)
- return SimpleNamespace(
- applicant="applicant@example.test",
- tab_id="applicant-tab",
- routing_key="slot.fixture.it.tourist",
- runtime_service=SERVICE,
- approval=approval,
- )
- def final_packet(booking_target=None, *, error="", destination="/Reservation"):
- booking_target = booking_target or target()
- slot = booking_target.approval.candidate
- return SimpleNamespace(
- url="https://prenotami.esteri.it" + FINAL_PATH,
- method="POST",
- tab_id=booking_target.tab_id,
- is_failed=False,
- request=SimpleNamespace(postData={
- "idCalendarioGiornaliero": slot.daily_calendar_id,
- "selectedDay": slot.day.isoformat(),
- "selectedHour": f"{slot.time_label}\n({slot.slots_free})",
- }),
- response=SimpleNamespace(
- status=200,
- url="https://prenotami.esteri.it" + FINAL_PATH,
- raw_body=json.dumps({"errorMessage": error, "url": destination}),
- ),
- )
- class Listener:
- def __init__(self, page):
- self.page = page
- self.packet = None
- self.started = self.stopped = 0
- def start(self, target_path, method):
- self.started += 1
- if target_path != FINAL_PATH or method != "POST":
- raise AssertionError("unexpected listener contract")
- def wait(self, timeout):
- return self.packet
- def stop(self):
- self.stopped += 1
- class NativePage(FakePage):
- def __init__(self, booking_target=None):
- super().__init__()
- booking_target = booking_target or target()
- self.tab_id = booking_target.tab_id
- self.active = True
- self.final_clicks = 0
- self.final_packet = final_packet(booking_target)
- self.listen = Listener(self)
- def run_js(self, script, *args):
- if script == NATIVE_FINAL_SCRIPT:
- self.final_clicks += 1
- self.listen.packet = self.final_packet
- return {"clicked": True}
- return super().run_js(script, *args)
- class PacketAcceptanceTests(unittest.TestCase):
- def setUp(self):
- self.target = target()
- self.packet = final_packet(self.target)
- def accepted(self):
- return _final_packet_accepted(
- self.packet, self.target.approval, self.target.tab_id)
- def test_exact_native_post_and_explicit_site_success_are_accepted(self):
- self.assertTrue(self.accepted())
- self.packet.request.postData = (
- "idCalendarioGiornaliero=80001001&"
- "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29"
- )
- self.assertTrue(self.accepted())
- def test_site_error_is_an_ordinary_rejection(self):
- self.packet.response.raw_body = json.dumps(
- {"errorMessage": "slot unavailable", "url": "/BookingCalendar"})
- self.assertFalse(self.accepted())
- def test_request_identity_must_match_current_selection(self):
- mutations = (
- ("url", "https://prenotami.esteri.it/Other"),
- ("method", "GET"),
- ("tab_id", "other-tab"),
- ("is_failed", True),
- )
- for field, value in mutations:
- with self.subTest(field=field):
- packet = final_packet(self.target)
- setattr(packet, field, value)
- self.assertFalse(_final_packet_accepted(
- packet, self.target.approval, self.target.tab_id))
- def test_body_requires_exact_unique_fields_and_current_runtime_id(self):
- bodies = (
- {},
- {"idCalendarioGiornaliero": "80001001", "selectedDay": "2026-10-13"},
- {"idCalendarioGiornaliero": "wrong", "selectedDay": "2026-10-13",
- "selectedHour": "10:05 - 11:05\n(1)"},
- "idCalendarioGiornaliero=80001001&idCalendarioGiornaliero=80001001&"
- "selectedDay=2026-10-13&selectedHour=10%3A05+-+11%3A05%0A%281%29",
- )
- for body in bodies:
- with self.subTest(body=body):
- packet = final_packet(self.target)
- packet.request.postData = body
- self.assertFalse(_final_packet_accepted(
- packet, self.target.approval, self.target.tab_id))
- def test_response_must_be_bounded_same_origin_explicit_json_success(self):
- values = (
- (500, '{"errorMessage":"","url":"/Reservation"}'),
- (200, "not-json"),
- (200, '{"url":"/Reservation"}'),
- (200, '{"errorMessage":null,"url":"/Reservation"}'),
- (200, '{"errorMessage":"","url":"https://attacker.test"}'),
- )
- for status, raw in values:
- with self.subTest(status=status, raw=raw):
- packet = final_packet(self.target)
- packet.response.status = status
- packet.response.raw_body = raw
- self.assertFalse(_final_packet_accepted(
- packet, self.target.approval, self.target.tab_id))
- class SubmitOnceTests(unittest.TestCase):
- def setUp(self):
- bootstrap = target()
- self.page = NativePage(bootstrap)
- self.plugin, self.route, _ = flow.prepared_plugin(
- self.page, routing_key=bootstrap.routing_key)
- self.plugin._log = Mock()
- self.approval = bootstrap.approval
- def test_success_uses_one_native_click_and_standard_result(self):
- result = _submit_final_once(self.plugin, self.route, self.approval)
- self.assertTrue(result.success)
- self.assertEqual(result.label, FINAL_ACCEPTED_LABEL)
- self.assertEqual(result.account, "applicant@example.test")
- self.assertEqual(result.book_date, "2026-10-13")
- self.assertEqual(result.book_time, "10:05 - 11:05")
- self.assertEqual(self.page.final_clicks, 1)
- self.assertEqual((self.page.listen.started, self.page.listen.stopped), (1, 1))
- self.assertIsNotNone(self.plugin._prepared_calendar)
- def test_site_rejection_returns_false_and_discards_attempt_context(self):
- self.page.final_packet.response.raw_body = json.dumps(
- {"errorMessage": "slot unavailable", "url": "/BookingCalendar"})
- result = _submit_final_once(self.plugin, self.route, self.approval)
- self.assertFalse(result.success)
- self.assertEqual(result.label, FINAL_FAILED_LABEL)
- self.assertEqual(self.page.final_clicks, 1)
- self.assertIsNone(self.plugin._prepared_calendar)
- def test_timeout_or_mismatched_packet_is_false_not_unknown_pause(self):
- for mode in ("timeout", "wrong-day"):
- with self.subTest(mode=mode):
- self.setUp()
- if mode == "timeout":
- self.page.final_packet = None
- else:
- self.page.final_packet.request.postData["selectedDay"] = "2026-10-14"
- result = _submit_final_once(self.plugin, self.route, self.approval)
- self.assertFalse(result.success)
- self.assertEqual(self.page.final_clicks, 1)
- self.assertIsNone(self.plugin._prepared_calendar)
- def test_changed_applicant_or_selection_never_clicks(self):
- self.plugin.config.account.username = "other@example.test"
- result = _submit_final_once(self.plugin, self.route, self.approval)
- self.assertFalse(result.success)
- self.assertEqual(self.page.final_clicks, 0)
- self.assertIsNone(self.plugin._prepared_calendar)
- def test_second_call_without_fresh_preparation_never_clicks_again(self):
- self.page.final_packet = None
- self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success)
- self.assertFalse(_submit_final_once(self.plugin, self.route, self.approval).success)
- self.assertEqual(self.page.final_clicks, 1)
- class SourceContractTests(unittest.TestCase):
- def test_old_unknown_and_receipt_state_machine_is_not_in_runtime(self):
- for name in (
- "FinalOutcomeUnknown", "FinalBookingAttempt", "NativeFinalSubmitter",
- "SubmissionSignal", "ReservationSnapshot", "ReservationState",
- ):
- self.assertFalse(hasattr(final, name), name)
- def test_query_and_selection_do_not_call_final_adapter(self):
- self.assertNotIn("coordinate:ita-native-final-once", final.CALENDAR_GUARD_SCRIPT)
- self.assertIn("coordinate:ita-native-final-once", NATIVE_FINAL_SCRIPT)
- if __name__ == "__main__":
- unittest.main()
|