Skip to content

chore: 테스트 docstring 의 가변 카운트·스테이지 마커 정리#6

Merged
DanMeon merged 1 commit into
mainfrom
chore/docstring-meta-cleanup
Apr 28, 2026
Merged

chore: 테스트 docstring 의 가변 카운트·스테이지 마커 정리#6
DanMeon merged 1 commit into
mainfrom
chore/docstring-meta-cleanup

Conversation

@DanMeon
Copy link
Copy Markdown
Owner

@DanMeon DanMeon commented Apr 28, 2026

Summary

  • tests/test_cli.py 의 "5 skipped 카운트 중 1" / "1 카운트" docstring·주석 제거
  • tests/test_langchain_loader_ir.py 의 "exactly 29 테스트 유지" 제거 — 다른 파일 카운트가 본 파일에 박혀 invisible coupling
  • tests/test_ir_schema_export.py 의 "S3 신규 5" 매직 넘버 제거

코드 동작 변화 없음 — docstring/comment only.

Why

다른 파일·CI 잡에 의존하는 카운트가 docstring 에 박혀 있어, 카운트가 바뀔 때마다 모든 사본을 동기화해야 하는 안티패턴. 실제로 v0.3.0 막판 `test_async.py` de-gating 으로 skip count 가 5→4 로 바뀌면서 `test_cli.py` docstring 의 5 정정이 누락됐음.

CLAUDE.md 글로벌 원칙과도 충돌:

Don't reference the current task, fix, or callers... since those belong in the PR description and rot as the codebase evolves.

SSOT (`ci.yml` test-without-extras 잡, 각 테스트 파일 자체) 만 두고 docstring 은 의도만 적도록 단일화.

Related Issues

없음 — 코드 리뷰 중 발견.

Test plan

  • `uv run pytest tests/test_cli.py tests/test_langchain_loader_ir.py tests/test_ir_schema_export.py -v` → 50 passed
  • autolint hook (`ruff format`/`ruff check`/`pyright`) 통과
  • CI green

다른 파일·CI 잡에 의존하는 카운트가 docstring 에 박혀 있어 변경 시
stale 되는 안티패턴 정정 (실제로 v0.3.0 막판 5→4 정정 누락 발생).
- test_cli.py 의 "5 skipped 카운트 중 1" / "1 카운트" 제거 — gated 파일
  카운트 검증은 ci.yml test-without-extras 잡이 SSOT
- test_langchain_loader_ir.py 의 "exactly 29 테스트 유지" 제거 — 다른
  파일의 카운트가 본 파일 docstring 에 박혀 invisible coupling 발생
- test_ir_schema_export.py 의 "S3 신규 5" 매직 넘버 제거

코드 동작 변화 없음 — docstring/comment only.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@DanMeon DanMeon merged commit cfa63dc into main Apr 28, 2026
13 checks passed
@DanMeon DanMeon deleted the chore/docstring-meta-cleanup branch April 28, 2026 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant