Files
clean-architecture-backend-…/scripts/tests/test_check_review_index.py
T
DongHyeonka d904d680af fix(scripts): 검사 스크립트와 smoke wrapper의 빈틈을 닫고 자기 시험을 더한다
문제:
- README 「새 서비스로 시작하기」의 이름 바꾸기 명령(`git grep -l ... -- src
  scripts`)이 루트 build.gradle·build-logic의 group, config/spotbugs 목록, registry·
  API surface 스냅숏을 놓쳐, 따라 하면 qualityCheck와 surface 검사가 실패했다.
- check-repo-layout.py의 HISTORY_PREFIXES가 없는 폴더 셋(superpowers, evidence,
  study)을 담고 docs/history·docs/design을 빠뜨렸다. 검사 스크립트 머리말에 누가
  부르는지 없었고, check-repo-layout·check-review-index·verify-httpclient-docs에
  자기 시험이 없었다. check-docs.py docstring은 「검사 여섯」(여덟),
  check-work-docs.py는 lychee를 PR workflow라 했다(main).
- run-compose-runtime-smoke.sh가 lane마다 정적 계약 전체를 다시 돌려 nightly마다
  compose config를 수백 번 렌더링했다. handoff lane의 --force-recreate가 1단계
  재시작 수를 지웠고, ps가 빈 결과면 restarts.txt가 비어 재시작 검사가 통과했다.

고친 것:
- 이름 바꾸기 명령을 그 범위로 넓히고 build-logic 자기 패키지는 그대로 둬도
  된다고 적었다.
- HISTORY_PREFIXES를 지금 기록 폴더 넷으로, 머리말에 부르는 곳, docstring 숫자·
  workflow를 고쳤다. 자기 시험 셋을 더했다(scripts/tests 통과, 옛 목록이면
  HISTORY_PREFIXES 시험이 실패한다).
- smoke는 정적 계약을 실행마다 한 번(두 모드 공통) 돌린다. 재시작 수는
  record_restarts가 단계(phase1, final)를 붙여 쌓고, 살핀 컨테이너가 없거나
  inspect·기록이 실패하면 실패한다(호출이 `|| return 1`이라 함수 안 set -e가
  꺼진다).
- verify-httpclient-docs 자기 시험은 실제 트리 대조(release workflow의 검사)를 하지
  않고 누락 탐지만 본다. scripts/tests는 PR 단계에서 돈다.

Refs: RR9-04-04, RR9-04-17, RR9-04-18, RR9-04-26, RR9-04-27
2026-11-13 06:34:33 +09:00

76 lines
2.2 KiB
Python

"""scripts/check-review-index.py의 시험. 영역 문서의 발견이 README 색인에 빠지면 실패하는지 본다.
python3 -m unittest discover -s scripts/tests
"""
from __future__ import annotations
import importlib.util
import io
import sys
import tempfile
import unittest
from contextlib import redirect_stderr, redirect_stdout
from pathlib import Path
SCRIPTS = Path(__file__).resolve().parent.parent
_spec = importlib.util.spec_from_file_location("check_review_index", SCRIPTS / "check-review-index.py")
check_review_index = importlib.util.module_from_spec(_spec)
sys.modules["check_review_index"] = check_review_index
_spec.loader.exec_module(check_review_index)
def run(review: Path) -> int:
argv = sys.argv
sys.argv = ["check-review-index.py", str(review)]
try:
with redirect_stdout(io.StringIO()), redirect_stderr(io.StringIO()):
return check_review_index.main()
finally:
sys.argv = argv
class ReviewIndexTest(unittest.TestCase):
def setUp(self) -> None:
self._directory = tempfile.TemporaryDirectory()
self.review = Path(self._directory.name)
(self.review / "01-area.md").write_text(
"# 영역\n\n### RR9-01-01 · Medium · 하나\n\n### RR9-01-02 · Low · 둘\n", encoding="utf-8"
)
def tearDown(self) -> None:
self._directory.cleanup()
def test_a_finding_missing_from_the_index_fails(self) -> None:
# given
(self.review / "README.md").write_text("| RR9-01-01 | Medium |\n", encoding="utf-8")
# when
rc = run(self.review)
# then
self.assertEqual(rc, 1)
def test_an_index_that_names_every_finding_passes(self) -> None:
# given
(self.review / "README.md").write_text(
"| RR9-01-01 | Medium |\n| RR9-01-02 | Low |\n", encoding="utf-8"
)
# when
rc = run(self.review)
# then
self.assertEqual(rc, 0)
def test_a_range_in_the_index_counts_for_every_id_inside_it(self) -> None:
# when
ids = check_review_index.indexed_ids("RR9-01-01~03, RR9-02-05·07")
# then
self.assertEqual(ids, {"RR9-01-01", "RR9-01-02", "RR9-01-03", "RR9-02-05", "RR9-02-07"})
if __name__ == "__main__":
unittest.main()