test_rules.py 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170
  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. }
  64. value.update(overrides)
  65. return value
  66. def test_rule_executor_loads_only_published_plan_by_fixed_identifiers():
  67. from app.runner.rules import RulePlanExecutor
  68. node = rule_node()
  69. adapter = Adapter()
  70. repository = Repository(published_record(node))
  71. executor = RulePlanExecutor(
  72. repository,
  73. adapters={"quality_check": adapter},
  74. )
  75. result = executor.execute(node, {"partition": "2026-07-23"})
  76. assert result["rows_rejected"] == 3
  77. assert result["rule_version_id"] == node["config"]["rule_version_id"]
  78. assert repository.calls == [
  79. {
  80. "component_binding_id": node["config"]["component_binding_id"],
  81. "rule_version_id": node["config"]["rule_version_id"],
  82. "plan_hash": PLAN_HASH,
  83. }
  84. ]
  85. assert adapter.calls[0]["parameters"] == {"partition": "2026-07-23"}
  86. @pytest.mark.parametrize(
  87. "record",
  88. [
  89. None,
  90. {"plan_status": "revoked"},
  91. {"rule_status": "deprecated"},
  92. {"plan_hash": "b" * 64},
  93. ],
  94. )
  95. def test_rule_executor_fails_closed_for_missing_revoked_or_mismatched_plan(record):
  96. from app.runner.rules import RulePlanExecutor
  97. node = rule_node()
  98. base = published_record(node)
  99. if record is not None:
  100. base.update(record)
  101. record = base
  102. executor = RulePlanExecutor(
  103. Repository(record),
  104. adapters={"quality_check": Adapter()},
  105. )
  106. with pytest.raises(NodeExecutionError):
  107. executor.execute(node, {})
  108. def test_rule_executor_rejects_inline_plan_or_unregistered_backend():
  109. from app.runner.rules import RulePlanExecutor
  110. node = rule_node()
  111. node["config"]["plan"] = {"op": "bypass"}
  112. executor = RulePlanExecutor(
  113. Repository(published_record(node)),
  114. adapters={},
  115. )
  116. with pytest.raises(NodeExecutionError):
  117. executor.execute(node, {})
  118. clean = rule_node()
  119. with pytest.raises(NodeExecutionError):
  120. RulePlanExecutor(
  121. Repository(published_record(clean, backend="generated_python")),
  122. adapters={},
  123. ).execute(clean, {})
  124. def test_mutating_rule_requires_governed_write_authorization_and_idempotency():
  125. from app.runner.rules import RulePlanExecutor
  126. node = rule_node("rule.apply")
  127. record = published_record(node, backend="sql_pushdown")
  128. executor = RulePlanExecutor(
  129. Repository(record),
  130. adapters={"sql_pushdown": Adapter()},
  131. )
  132. with pytest.raises(NodeExecutionError):
  133. executor.execute(node, {}, write_authorized=False)
  134. del node["idempotency"]
  135. with pytest.raises(NodeExecutionError):
  136. executor.execute(node, {}, write_authorized=True)