test_rules.py 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. from __future__ import annotations
  2. import copy
  3. import hashlib
  4. import json
  5. import pytest
  6. from app.core.common.identifiers import new_governance_uid
  7. from app.runner.nodes import NodeExecutionError
  8. PLAN = {"op": "not_null", "column": "mobile"}
  9. PLAN_HASH = hashlib.sha256(
  10. json.dumps(
  11. PLAN,
  12. sort_keys=True,
  13. separators=(",", ":"),
  14. ensure_ascii=False,
  15. ).encode("utf-8")
  16. ).hexdigest()
  17. def rule_node(node_type="quality.check"):
  18. node = {
  19. "id": "customer_mobile",
  20. "type": node_type,
  21. "purpose": "read" if node_type == "quality.check" else "write",
  22. "config": {
  23. "component_binding_id": new_governance_uid(),
  24. "rule_version_id": new_governance_uid(),
  25. "execution_plan_hash": PLAN_HASH,
  26. },
  27. }
  28. if node_type == "rule.apply":
  29. node["idempotency"] = {
  30. "strategy": "upsert",
  31. "key": "customer_id",
  32. }
  33. return node
  34. class Repository:
  35. def __init__(self, record=None):
  36. self.record = record
  37. self.calls = []
  38. def load(self, **kwargs):
  39. self.calls.append(kwargs)
  40. return copy.deepcopy(self.record)
  41. class Adapter:
  42. def __init__(self):
  43. self.calls = []
  44. def execute(self, *, plan, node, parameters, write_authorized):
  45. self.calls.append(
  46. {
  47. "plan": plan,
  48. "node": node,
  49. "parameters": parameters,
  50. "write_authorized": write_authorized,
  51. }
  52. )
  53. return {"rows_rejected": 3}
  54. def published_record(node, **overrides):
  55. value = {
  56. "component_binding_id": node["config"]["component_binding_id"],
  57. "rule_version_id": node["config"]["rule_version_id"],
  58. "backend": "quality_check",
  59. "plan": PLAN,
  60. "plan_hash": PLAN_HASH,
  61. "plan_status": "published",
  62. "rule_status": "published",
  63. "publication_audit_trusted": True,
  64. "logical_evidence_trusted": True,
  65. "physical_evidence_trusted": True,
  66. "component_kind": node["type"],
  67. "binding_idempotency": node.get("idempotency"),
  68. }
  69. value.update(overrides)
  70. return value
  71. def test_rule_executor_loads_only_published_plan_by_fixed_identifiers():
  72. from app.runner.rules import RulePlanExecutor
  73. node = rule_node()
  74. adapter = Adapter()
  75. repository = Repository(published_record(node))
  76. executor = RulePlanExecutor(
  77. repository,
  78. adapters={"quality_check": adapter},
  79. )
  80. result = executor.execute(node, {"partition": "2026-07-23"})
  81. assert result["rows_rejected"] == 3
  82. assert result["rule_version_id"] == node["config"]["rule_version_id"]
  83. assert repository.calls == [
  84. {
  85. "component_binding_id": node["config"]["component_binding_id"],
  86. "rule_version_id": node["config"]["rule_version_id"],
  87. "plan_hash": PLAN_HASH,
  88. }
  89. ]
  90. assert adapter.calls[0]["parameters"] == {"partition": "2026-07-23"}
  91. @pytest.mark.parametrize(
  92. "record",
  93. [
  94. None,
  95. {"plan_status": "compiled"},
  96. {"plan_status": "tested"},
  97. {"plan_status": "revoked"},
  98. {"rule_status": "deprecated"},
  99. {"plan_hash": "b" * 64},
  100. {"publication_audit_trusted": False},
  101. {"logical_evidence_trusted": False},
  102. {"physical_evidence_trusted": False},
  103. ],
  104. )
  105. def test_rule_executor_fails_closed_for_missing_revoked_or_mismatched_plan(record):
  106. from app.runner.rules import RulePlanExecutor
  107. node = rule_node()
  108. base = published_record(node)
  109. if record is not None:
  110. base.update(record)
  111. record = base
  112. executor = RulePlanExecutor(
  113. Repository(record),
  114. adapters={"quality_check": Adapter()},
  115. )
  116. with pytest.raises(NodeExecutionError):
  117. executor.execute(node, {})
  118. def test_rule_executor_rejects_inline_plan_or_unregistered_backend():
  119. from app.runner.rules import RulePlanExecutor
  120. node = rule_node()
  121. node["config"]["plan"] = {"op": "bypass"}
  122. executor = RulePlanExecutor(
  123. Repository(published_record(node)),
  124. adapters={},
  125. )
  126. with pytest.raises(NodeExecutionError):
  127. executor.execute(node, {})
  128. clean = rule_node()
  129. with pytest.raises(NodeExecutionError):
  130. RulePlanExecutor(
  131. Repository(published_record(clean, backend="generated_python")),
  132. adapters={},
  133. ).execute(clean, {})
  134. def test_mutating_rule_requires_governed_write_authorization_and_idempotency():
  135. from app.runner.rules import RulePlanExecutor
  136. node = rule_node("rule.apply")
  137. record = published_record(node, backend="sql_pushdown")
  138. executor = RulePlanExecutor(
  139. Repository(record),
  140. adapters={"sql_pushdown": Adapter()},
  141. )
  142. with pytest.raises(NodeExecutionError):
  143. executor.execute(node, {}, write_authorized=False)
  144. del node["idempotency"]
  145. with pytest.raises(NodeExecutionError):
  146. executor.execute(node, {}, write_authorized=True)