feat(p6): add four-package manifest contract
这个提交存在于:
父节点
56e7517508
当前提交
60a49976d1
共有 2 个文件被更改,包括 302 次插入 和 0 次删除
124
core/p6_four_package_manifest.py
普通文件
124
core/p6_four_package_manifest.py
普通文件
|
|
@ -0,0 +1,124 @@
|
|||
"""Pure validation for the P6 four-package manifest contract."""
|
||||
|
||||
import hashlib
|
||||
import json
|
||||
import re
|
||||
|
||||
|
||||
FOUR_PACKAGE_MANIFEST_SCHEMA = "ops.p6.four_package_manifest.v1"
|
||||
FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA = "ops.p6.four_package_manifest_report.v1"
|
||||
FOUR_PACKAGE_IDS = ("companion", "memory", "ops_archive", "peiban")
|
||||
|
||||
_REQUIRED_MANIFEST_FIELDS = (
|
||||
"schema",
|
||||
"package_id",
|
||||
"manifest_version",
|
||||
"package_fingerprint",
|
||||
"compatibility_fingerprint",
|
||||
)
|
||||
_MANIFEST_VERSION_PATTERN = re.compile(r"^[1-9]\d*\.[0-9]+$")
|
||||
_SHA256_PATTERN = re.compile(r"^[0-9a-f]{64}$")
|
||||
|
||||
|
||||
def _contract_payload() -> dict[str, object]:
|
||||
return {
|
||||
"schema": FOUR_PACKAGE_MANIFEST_SCHEMA,
|
||||
"report_schema": FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
"package_ids": list(FOUR_PACKAGE_IDS),
|
||||
"required_manifest_fields": list(_REQUIRED_MANIFEST_FIELDS),
|
||||
}
|
||||
|
||||
|
||||
def manifest_contract() -> dict[str, object]:
|
||||
"""Return a fresh descriptor for the value-only manifest contract."""
|
||||
descriptor = _contract_payload()
|
||||
canonical_payload = json.dumps(
|
||||
descriptor,
|
||||
ensure_ascii=True,
|
||||
sort_keys=True,
|
||||
separators=(",", ":"),
|
||||
).encode("utf-8")
|
||||
descriptor["contract_fingerprint"] = hashlib.sha256(canonical_payload).hexdigest()
|
||||
return descriptor
|
||||
|
||||
|
||||
def _unverifiable_report(reason_code: str) -> dict[str, object]:
|
||||
return {
|
||||
"schema": FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
"status": "unverifiable",
|
||||
"reason_code": reason_code,
|
||||
"expected_package_ids": list(FOUR_PACKAGE_IDS),
|
||||
}
|
||||
|
||||
|
||||
def _verified_report() -> dict[str, object]:
|
||||
return {
|
||||
"schema": FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
"status": "verified",
|
||||
"reason_code": "four_package_manifest_verified",
|
||||
"expected_package_ids": list(FOUR_PACKAGE_IDS),
|
||||
}
|
||||
|
||||
|
||||
def verify_four_package_manifests(manifests: object) -> dict[str, object]:
|
||||
"""Verify only the supplied in-memory four-package manifest values."""
|
||||
if type(manifests) is not dict:
|
||||
return _unverifiable_report("manifest_collection_not_exact_dict")
|
||||
|
||||
for package_id in manifests:
|
||||
if type(package_id) is not str or package_id not in FOUR_PACKAGE_IDS:
|
||||
return _unverifiable_report("unexpected_package_manifest")
|
||||
|
||||
for package_id in FOUR_PACKAGE_IDS:
|
||||
if package_id not in manifests:
|
||||
return _unverifiable_report("missing_package_manifest")
|
||||
|
||||
common_compatibility_fingerprint = None
|
||||
for package_id in FOUR_PACKAGE_IDS:
|
||||
package_manifest = manifests[package_id]
|
||||
if type(package_manifest) is not dict:
|
||||
return _unverifiable_report("package_manifest_not_exact_dict")
|
||||
|
||||
for field_name in package_manifest:
|
||||
if type(field_name) is not str or field_name not in _REQUIRED_MANIFEST_FIELDS:
|
||||
return _unverifiable_report("unexpected_manifest_field")
|
||||
|
||||
for field_name in _REQUIRED_MANIFEST_FIELDS:
|
||||
if field_name not in package_manifest:
|
||||
return _unverifiable_report("missing_manifest_field")
|
||||
|
||||
schema = package_manifest["schema"]
|
||||
if type(schema) is not str or schema != FOUR_PACKAGE_MANIFEST_SCHEMA:
|
||||
return _unverifiable_report("manifest_schema_mismatch")
|
||||
|
||||
declared_package_id = package_manifest["package_id"]
|
||||
if type(declared_package_id) is not str or declared_package_id != package_id:
|
||||
return _unverifiable_report("manifest_package_id_mismatch")
|
||||
|
||||
manifest_version = package_manifest["manifest_version"]
|
||||
if (
|
||||
type(manifest_version) is not str
|
||||
or _MANIFEST_VERSION_PATTERN.fullmatch(manifest_version) is None
|
||||
):
|
||||
return _unverifiable_report("manifest_version_invalid")
|
||||
|
||||
package_fingerprint = package_manifest["package_fingerprint"]
|
||||
if (
|
||||
type(package_fingerprint) is not str
|
||||
or _SHA256_PATTERN.fullmatch(package_fingerprint) is None
|
||||
):
|
||||
return _unverifiable_report("package_fingerprint_invalid")
|
||||
|
||||
compatibility_fingerprint = package_manifest["compatibility_fingerprint"]
|
||||
if (
|
||||
type(compatibility_fingerprint) is not str
|
||||
or _SHA256_PATTERN.fullmatch(compatibility_fingerprint) is None
|
||||
):
|
||||
return _unverifiable_report("compatibility_fingerprint_invalid")
|
||||
|
||||
if common_compatibility_fingerprint is None:
|
||||
common_compatibility_fingerprint = compatibility_fingerprint
|
||||
elif compatibility_fingerprint != common_compatibility_fingerprint:
|
||||
return _unverifiable_report("compatibility_fingerprint_mismatch")
|
||||
|
||||
return _verified_report()
|
||||
|
|
@ -0,0 +1,178 @@
|
|||
import hashlib
|
||||
import json
|
||||
import unittest
|
||||
|
||||
from core.p6_four_package_manifest import (
|
||||
FOUR_PACKAGE_IDS,
|
||||
FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
FOUR_PACKAGE_MANIFEST_SCHEMA,
|
||||
manifest_contract,
|
||||
verify_four_package_manifests,
|
||||
)
|
||||
|
||||
|
||||
def _synthetic_manifests() -> dict[str, dict[str, str]]:
|
||||
compatibility_fingerprint = "a" * 64
|
||||
return {
|
||||
package_id: {
|
||||
"schema": FOUR_PACKAGE_MANIFEST_SCHEMA,
|
||||
"package_id": package_id,
|
||||
"manifest_version": "1.0",
|
||||
"package_fingerprint": f"{index:064x}",
|
||||
"compatibility_fingerprint": compatibility_fingerprint,
|
||||
}
|
||||
for index, package_id in enumerate(FOUR_PACKAGE_IDS, start=1)
|
||||
}
|
||||
|
||||
|
||||
class _Poison:
|
||||
def __bool__(self) -> bool:
|
||||
raise AssertionError("truthiness must not be evaluated")
|
||||
|
||||
def __iter__(self):
|
||||
raise AssertionError("iteration must not be evaluated")
|
||||
|
||||
def __repr__(self) -> str:
|
||||
raise AssertionError("repr must not be evaluated")
|
||||
|
||||
|
||||
class _DictSubclass(dict):
|
||||
pass
|
||||
|
||||
|
||||
class FourPackageManifestTests(unittest.TestCase):
|
||||
def assert_unverifiable(self, manifests: object, reason_code: str) -> None:
|
||||
report = verify_four_package_manifests(manifests)
|
||||
self.assertEqual(type(report), dict)
|
||||
self.assertEqual(report["schema"], FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA)
|
||||
self.assertEqual(report["status"], "unverifiable")
|
||||
self.assertEqual(report["reason_code"], reason_code)
|
||||
self.assertEqual(report["expected_package_ids"], list(FOUR_PACKAGE_IDS))
|
||||
self.assertNotIn("manifests", report)
|
||||
self.assertNotIn("fingerprint", report)
|
||||
|
||||
def test_contract_descriptor_is_exact_and_canonical(self) -> None:
|
||||
descriptor = manifest_contract()
|
||||
payload = {
|
||||
"schema": FOUR_PACKAGE_MANIFEST_SCHEMA,
|
||||
"report_schema": FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
"package_ids": list(FOUR_PACKAGE_IDS),
|
||||
"required_manifest_fields": [
|
||||
"schema",
|
||||
"package_id",
|
||||
"manifest_version",
|
||||
"package_fingerprint",
|
||||
"compatibility_fingerprint",
|
||||
],
|
||||
}
|
||||
expected_fingerprint = hashlib.sha256(
|
||||
json.dumps(
|
||||
payload,
|
||||
ensure_ascii=True,
|
||||
sort_keys=True,
|
||||
separators=(",", ":"),
|
||||
).encode("utf-8")
|
||||
).hexdigest()
|
||||
self.assertEqual(
|
||||
descriptor,
|
||||
{**payload, "contract_fingerprint": expected_fingerprint},
|
||||
)
|
||||
self.assertEqual(type(descriptor), dict)
|
||||
|
||||
def test_contract_descriptors_are_fresh(self) -> None:
|
||||
first = manifest_contract()
|
||||
second = manifest_contract()
|
||||
self.assertIsNot(first, second)
|
||||
self.assertIsNot(first["package_ids"], second["package_ids"])
|
||||
first["package_ids"].append("changed")
|
||||
self.assertEqual(second["package_ids"], list(FOUR_PACKAGE_IDS))
|
||||
|
||||
def test_synthetic_consistent_manifests_verify(self) -> None:
|
||||
report = verify_four_package_manifests(_synthetic_manifests())
|
||||
self.assertEqual(
|
||||
report,
|
||||
{
|
||||
"schema": FOUR_PACKAGE_MANIFEST_REPORT_SCHEMA,
|
||||
"status": "verified",
|
||||
"reason_code": "four_package_manifest_verified",
|
||||
"expected_package_ids": list(FOUR_PACKAGE_IDS),
|
||||
},
|
||||
)
|
||||
|
||||
def test_reports_are_fresh(self) -> None:
|
||||
first = verify_four_package_manifests(_synthetic_manifests())
|
||||
second = verify_four_package_manifests(_synthetic_manifests())
|
||||
self.assertIsNot(first, second)
|
||||
self.assertIsNot(first["expected_package_ids"], second["expected_package_ids"])
|
||||
first["expected_package_ids"].append("changed")
|
||||
self.assertEqual(second["expected_package_ids"], list(FOUR_PACKAGE_IDS))
|
||||
|
||||
def test_rejects_non_exact_outer_dict(self) -> None:
|
||||
self.assert_unverifiable([], "manifest_collection_not_exact_dict")
|
||||
self.assert_unverifiable(_Poison(), "manifest_collection_not_exact_dict")
|
||||
self.assert_unverifiable(_DictSubclass(_synthetic_manifests()), "manifest_collection_not_exact_dict")
|
||||
|
||||
def test_rejects_missing_and_unexpected_package_manifests(self) -> None:
|
||||
missing = _synthetic_manifests()
|
||||
del missing["peiban"]
|
||||
self.assert_unverifiable(missing, "missing_package_manifest")
|
||||
|
||||
unexpected = _synthetic_manifests()
|
||||
unexpected["unexpected"] = unexpected["companion"].copy()
|
||||
self.assert_unverifiable(unexpected, "unexpected_package_manifest")
|
||||
|
||||
def test_rejects_non_exact_package_manifests_without_inspecting_them(self) -> None:
|
||||
manifests = _synthetic_manifests()
|
||||
manifests["companion"] = _Poison()
|
||||
self.assert_unverifiable(manifests, "package_manifest_not_exact_dict")
|
||||
|
||||
manifests = _synthetic_manifests()
|
||||
manifests["companion"] = _DictSubclass(manifests["companion"])
|
||||
self.assert_unverifiable(manifests, "package_manifest_not_exact_dict")
|
||||
|
||||
def test_rejects_missing_and_unexpected_fields(self) -> None:
|
||||
missing = _synthetic_manifests()
|
||||
del missing["companion"]["schema"]
|
||||
self.assert_unverifiable(missing, "missing_manifest_field")
|
||||
|
||||
unexpected = _synthetic_manifests()
|
||||
unexpected["companion"]["extra"] = "ignored"
|
||||
self.assert_unverifiable(unexpected, "unexpected_manifest_field")
|
||||
|
||||
def test_rejects_schema_and_package_id_mismatch(self) -> None:
|
||||
wrong_schema = _synthetic_manifests()
|
||||
wrong_schema["companion"]["schema"] = "ops.p6.other.v1"
|
||||
self.assert_unverifiable(wrong_schema, "manifest_schema_mismatch")
|
||||
|
||||
wrong_id = _synthetic_manifests()
|
||||
wrong_id["companion"]["package_id"] = "memory"
|
||||
self.assert_unverifiable(wrong_id, "manifest_package_id_mismatch")
|
||||
|
||||
def test_rejects_invalid_versions(self) -> None:
|
||||
for invalid_version in ("0.0", "1", "1.", "1.a", 1.0, _Poison()):
|
||||
with self.subTest(invalid_version=type(invalid_version).__name__):
|
||||
manifests = _synthetic_manifests()
|
||||
manifests["companion"]["manifest_version"] = invalid_version
|
||||
self.assert_unverifiable(manifests, "manifest_version_invalid")
|
||||
|
||||
def test_rejects_invalid_fingerprints_without_inspecting_poison_values(self) -> None:
|
||||
invalid_package_fingerprint = _synthetic_manifests()
|
||||
invalid_package_fingerprint["companion"]["package_fingerprint"] = "A" * 64
|
||||
self.assert_unverifiable(invalid_package_fingerprint, "package_fingerprint_invalid")
|
||||
|
||||
poison_package_fingerprint = _synthetic_manifests()
|
||||
poison_package_fingerprint["companion"]["package_fingerprint"] = _Poison()
|
||||
self.assert_unverifiable(poison_package_fingerprint, "package_fingerprint_invalid")
|
||||
|
||||
invalid_compatibility_fingerprint = _synthetic_manifests()
|
||||
invalid_compatibility_fingerprint["companion"]["compatibility_fingerprint"] = "g" * 64
|
||||
self.assert_unverifiable(invalid_compatibility_fingerprint, "compatibility_fingerprint_invalid")
|
||||
|
||||
def test_rejects_inconsistent_compatibility_fingerprints(self) -> None:
|
||||
manifests = _synthetic_manifests()
|
||||
manifests["memory"]["compatibility_fingerprint"] = "b" * 64
|
||||
self.assert_unverifiable(manifests, "compatibility_fingerprint_mismatch")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
正在加载…
添加表格
在新工单中引用