"""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()