Response Diff、Contract 與 SLA

三層次的檢查,讓你不必手寫一條一條 assertion 也能抓回歸。

diff_payloads

兩個 JSON-like payload 的結構化 diff。

from je_api_testka import diff_payloads

diff = diff_payloads({"a": 1, "b": 2}, {"a": 1, "b": 3})
diff.changed   # {'b': (2, 3)}
diff.added     # {}
diff.removed   # {}
diff.is_empty  # False

加 ignore_paths 跳過會變動的欄位:

diff_payloads(left, right, ignore_paths=["timestamp", "request_id"])

OpenAPI contract drift

from je_api_testka import diff_openapi_specs

drift = diff_openapi_specs(prev_spec, current_spec)
drift.added_paths
drift.removed_paths
drift.added_operations
drift.removed_operations
drift.schema_changes  # 以 'METHOD /path' 為 key

要直接出 markdown changelog:

from je_api_testka.spec import openapi_changelog

print(openapi_changelog(prev_spec, current_spec))

回應時間 SLA

ResponseSLA 帶 max_ms 與 p95_ms 兩個門檻;``assert_sla`` 走過 records,超過就丟 APIAssertException。

from je_api_testka.diff.sla_check import ResponseSLA, assert_sla

sla = ResponseSLA(max_ms=2000, p95_ms=1500)
assert_sla(records, sla)

Executor 命令

AT_diff_payloads
AT_diff_openapi_specs
AT_assert_sla
AT_openapi_changelog