from __future__ import annotations import json import tempfile import unittest from pathlib import Path from shutil import copy2 from core.software_contracts import ( DEFAULT_CAPABILITIES, CONTRACT_ROOT, _ContractRegistry, get_contract, node_supports_request, version_at_least, ) def _request(plot_type: str) -> dict: roles = {"input": "sample", "x": "x", "y": "y"} if plot_type in {"contour", "surface_3d", "ternary", "heatmap"}: roles["z"] = "z" return { "schema_version": 2, "inputs": [{ "key": "sample", "artifact_id": "f4186347-65cc-4f07-9c26-bf11992beef8", }], "operation": {"plot": {"type": plot_type, "series": [roles]}}, "outputs": [{"key": "figure_png", "type": "figure", "format": "png"}], } class SoftwareContractTests(unittest.TestCase): def test_origin_contract_drives_schema_outputs_and_summary(self) -> None: contract = get_contract("origin.plot@v2") request = _request("line") normalized, digest = contract.normalize_request(request) self.assertEqual(normalized, request) self.assertEqual(len(digest), 64) self.assertEqual(contract.output_namespace, "origin") self.assertEqual( set(contract.expected_outputs(request)), {"figure_png", "plot_spec", "provenance"}, ) self.assertEqual(DEFAULT_CAPABILITIES, ("origin.plot@v2",)) def test_adapter_version_and_features_gate_additive_requests(self) -> None: contract = get_contract("origin.plot@v2") legacy_runtime = { "available_slots": 1, "origin": {"health": "ready", "adapter_version": "0.3.0"}, } self.assertFalse(node_supports_request(contract, _request("line"), legacy_runtime)) self.assertFalse(node_supports_request(contract, _request("heatmap"), legacy_runtime)) current_runtime = { "capability_runtime": { "origin.plot@v2": { "health": "ready", "available_slots": 1, "adapter_version": "0.5.0", "features": ["line", "heatmap"], } } } self.assertTrue(node_supports_request(contract, _request("heatmap"), current_runtime)) self.assertFalse(node_supports_request(contract, _request("bar"), current_runtime)) def test_semantic_version_comparison_is_numeric(self) -> None: self.assertTrue(version_at_least("0.10.0", "0.4.0")) self.assertFalse(version_at_least("0.3.9", "0.4.0")) def test_registry_hot_reloads_and_retains_last_valid_snapshot(self) -> None: with tempfile.TemporaryDirectory() as temporary: root = Path(temporary) target = root / "origin.plot.v2.json" copy2(CONTRACT_ROOT / target.name, target) registry = _ContractRegistry(root) original = registry.contracts()["origin.plot@v2"] value = json.loads(target.read_text(encoding="utf-8")) value["display_name"] = "OriginPro hot reload" target.write_text(json.dumps(value), encoding="utf-8") refreshed = registry.contracts()["origin.plot@v2"] self.assertEqual(refreshed.display_name, "OriginPro hot reload") target.write_text("{invalid", encoding="utf-8") with self.assertLogs("core.software_contracts", level="ERROR"): retained = registry.contracts()["origin.plot@v2"] self.assertEqual(retained.display_name, "OriginPro hot reload") self.assertNotEqual(original.display_name, retained.display_name) if __name__ == "__main__": unittest.main()