import json import tempfile import unittest from pathlib import Path from unittest.mock import ANY, patch import external_status class ExternalStatusTests(unittest.TestCase): def test_status_is_prepared_only_after_release_descriptor_verification(self): commit = "a" * 40 request = {"run_id": "302", "commit": commit, "descriptor_sha256": "b" * 64} with tempfile.TemporaryDirectory() as directory: root = Path(directory) journal = root / "recovery.json" policy = root / "policy.json" state = root / "state.json" policy.write_text("{}", encoding="utf-8") with patch.object(external_status.os, "geteuid", return_value=0), \ patch.object(external_status, "latest_main_sha", return_value=commit), \ patch.object(external_status, "runtime_compatibility_reason", return_value=None) as compatible, \ patch.object(external_status, "latest_release_request", return_value=request) as select, \ patch.object(external_status, "fetch_release", return_value=({"commit": commit, "run_id": "302"}, b"descriptor")) as verify: value = external_status.status_document( api=lambda _path: {}, checkout=root, journal=journal, policy_file=policy, state_file=state, main_lookup=lambda _path: commit, ) self.assertEqual(value["state"], "prepared") self.assertEqual(value["release"], request) compatible.assert_called_once() self.assertEqual(compatible.call_args.args, (commit,)) self.assertEqual(compatible.call_args.kwargs["checkout"], root) self.assertEqual(compatible.call_args.kwargs["policy_file"], policy) select.assert_called_once_with(current_main=commit, checkout=root, api=ANY) verify.assert_called_once() def test_status_suppresses_an_exactly_applied_release(self): commit = "a" * 40 request = {"run_id": "302", "commit": commit, "descriptor_sha256": "b" * 64} with tempfile.TemporaryDirectory() as directory: root = Path(directory) journal, policy, state = root / "journal", root / "policy.json", root / "state.json" policy.write_text("{}", encoding="utf-8") images = {name: {"configured": f"registry.test/{name}@sha256:{'c' * 64}", "image_id": "sha256:" + "d" * 64} for name in ("backend", "opensearch")} state.write_text(json.dumps({ "schema_version": 1, "commit": commit, "manifest_sha256": request["descriptor_sha256"], "current": images, "previous": images, }), encoding="utf-8") with patch.object(external_status.os, "geteuid", return_value=0), \ patch.object(external_status, "runtime_compatibility_reason", return_value=None), \ patch.object(external_status, "latest_release_request", return_value=request), \ patch.object(external_status, "fetch_release") as verify: result = external_status.status_document( api=lambda _path: {}, checkout=root, journal=journal, policy_file=policy, state_file=state, main_lookup=lambda _path: commit, ) self.assertEqual(result["reason"], "already_applied") verify.assert_not_called() def test_status_does_not_publish_prepared_tuple_if_main_advances_during_verification(self): commit = "a" * 40 request = {"run_id": "302", "commit": commit, "descriptor_sha256": "b" * 64} with tempfile.TemporaryDirectory() as directory: root = Path(directory) policy = root / "policy.json" policy.write_text("{}", encoding="utf-8") with patch.object(external_status.os, "geteuid", return_value=0), \ patch.object(external_status, "runtime_compatibility_reason", return_value=None), \ patch.object(external_status, "latest_release_request", return_value=request), \ patch.object(external_status, "fetch_release", return_value=({"commit": commit, "run_id": "302"}, b"descriptor")) as verify: mains = iter((commit, "c" * 40)) result = external_status.status_document( checkout=root, journal=root / "journal", policy_file=policy, state_file=root / "state.json", main_lookup=lambda _path: next(mains), ) self.assertEqual(result, { "schema_version": 1, "state": "not_ready", "reason": "main_advanced", "release": None, }) verify.assert_called_once() def test_status_fails_closed_for_root_guard_recovery_and_runtime_mismatch(self): with tempfile.TemporaryDirectory() as directory: root = Path(directory) journal = root / "recovery.json" policy = root / "policy.json" policy.write_text("{}", encoding="utf-8") with patch.object(external_status.os, "geteuid", return_value=1000): with self.assertRaisesRegex(ValueError, "must run as root"): external_status.status_document(checkout=root, journal=journal, policy_file=policy) with patch.object(external_status.os, "geteuid", return_value=0): journal.touch() value = external_status.status_document(checkout=root, journal=journal, policy_file=policy) self.assertEqual(value["reason"], "recovery_journal") journal.unlink() with patch.object(external_status.os, "geteuid", return_value=0), \ patch.object(external_status, "runtime_compatibility_reason", return_value="runtime_config_changed"), \ patch.object(external_status, "latest_release_request") as select: value = external_status.status_document( checkout=root, journal=journal, policy_file=policy, main_lookup=lambda _path: "a" * 40, ) self.assertEqual(value["reason"], "runtime_config_changed") select.assert_not_called() if __name__ == "__main__": unittest.main()