94 lines
3.3 KiB
Python
94 lines
3.3 KiB
Python
"""task-166 HTTP 客户端契约盘点测试。
|
|
|
|
对应 plan 10 任务 166 的 8 条用例：
|
|
1. test_contract_table_all_clients 全客户端覆盖
|
|
2. test_timeouts_listed 超时现状
|
|
3. test_retry_listed 重试现状
|
|
4. test_idempotency_listed 幂等性标注
|
|
5. test_jdk_limits_noted 平台限制
|
|
6. test_doc_committed 文档存在
|
|
7. test_no_code_change 零代码变更
|
|
8. test_repeatable 可复查
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import subprocess
|
|
import unittest
|
|
|
|
from http_client_audit import (
|
|
REPO_ROOT,
|
|
extract_client_sites,
|
|
extract_timeout_configs,
|
|
scan,
|
|
)
|
|
|
|
DOC_PATH = REPO_ROOT / "docs" / "http-client-contract-audit.md"
|
|
|
|
|
|
class HttpClientAuditTest(unittest.TestCase):
|
|
def test_contract_table_all_clients(self):
|
|
configs = extract_timeout_configs()
|
|
self.assertGreaterEqual(len(configs), 4, "超时/重试配置字段必须齐全")
|
|
classes = {c["config_class"] for c in configs}
|
|
self.assertTrue(
|
|
any("Transient" in name or "Storage" in name for name in classes),
|
|
"存储客户端配置存在",
|
|
)
|
|
self.assertTrue(
|
|
any("SimilarAsin" in name or "ImageVideo" in name for name in classes),
|
|
"LLM/图片客户端配置存在",
|
|
)
|
|
|
|
def test_timeouts_listed(self):
|
|
fields = {c["field"] for c in extract_timeout_configs()}
|
|
self.assertTrue(any("connectTimeout" in f for f in fields), "connect 超时缺失")
|
|
self.assertTrue(any("readTimeout" in f for f in fields), "read 超时缺失")
|
|
self.assertTrue(any("writeTimeout" in f for f in fields), "write 超时缺失")
|
|
self.assertTrue(any("callTimeout" in f for f in fields), "call 超时缺失")
|
|
|
|
def test_retry_listed(self):
|
|
fields = {c["field"] for c in extract_timeout_configs()}
|
|
self.assertTrue(any("Retry" in f for f in fields), "重试配置缺失")
|
|
|
|
def test_idempotency_listed(self):
|
|
sites = extract_client_sites()
|
|
self.assertGreater(len(sites), 0, "客户端配置调用点必须记录")
|
|
|
|
def test_jdk_limits_noted(self):
|
|
sites = extract_client_sites()
|
|
self.assertTrue(
|
|
any(
|
|
"HttpClient" in s["snippet"] or "newBuilder" in s["snippet"]
|
|
for s in sites
|
|
),
|
|
"JDK HttpClient 使用点必须记录",
|
|
)
|
|
|
|
def test_doc_committed(self):
|
|
self.assertTrue(DOC_PATH.is_file(), f"契约表文档缺失: {DOC_PATH}")
|
|
text = DOC_PATH.read_text(encoding="utf-8")
|
|
self.assertIn("超时", text)
|
|
self.assertIn("重试", text)
|
|
self.assertIn("幂等", text)
|
|
|
|
def test_no_code_change(self):
|
|
changed = subprocess.run(
|
|
["git", "diff", "--name-only", "HEAD", "--", "backend-java/src"],
|
|
cwd=REPO_ROOT,
|
|
capture_output=True,
|
|
text=True,
|
|
check=True,
|
|
).stdout.strip()
|
|
self.assertEqual(changed, "", f"生产代码被改动: {changed}")
|
|
|
|
def test_repeatable(self):
|
|
first = json.dumps(scan().to_dict(), sort_keys=True)
|
|
second = json.dumps(scan().to_dict(), sort_keys=True)
|
|
self.assertEqual(first, second, "盘点可复查")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|