pytest discovery와 실행 범위를 통제한다

오늘의 질문

pytest 9.0의 file·class·function naming discovery와 node id·collection 결과를 확인해 의도한 test만 실행되도록 한다. 이 판단을 생략하면 통과한 test와 많은 log가 있어도 결함을 놓치거나 잘못된 수정을 승인할 수 있습니다.

아직 답을 몰라도 괜찮아요. 아래 작은 예시를 보고 먼저 예상해 보세요.

01 · 가볍게 시작하기

정답을 보기 전에 먼저 골라볼까요?

눈으로만 보고 답 하나를 떠올려 보세요multi-package repository의 test entrypoint에서 pytest discovery와 실행 범위를 통제한다 계약을 적용한다.synthetic td17 fixture · secret 없는 고정 입력 · exact Python 3.14.6

1
먼저 골라보기
틀려도 괜찮아요. 지금 생각한 답 하나를 정해요.
2
그림으로 확인하기
움직이는 순서와 달라지는 곳만 천천히 찾아요.
3
내 말로 다시 말하기
한 문장으로 말해 보면 내가 이해한 곳을 확인할 수 있어요.

02 · 그림으로 보기

그림이 움직이는 순서를 직접 확인해요

01관찰pytest · discovery · collection · node id
02추론pytest는 naming convention과 configuration에 따라 test module·class·function을 collect하므로 0 tests는 성공 증거가 아니다. `--collect-only`와 node id로 collection 범위를 실행 전에 확인할 수 있다. rootdir·config·working directory·testpaths가 달라지면 동일 command text도 다른 suite를 수집할 수 있다.
03검증pytest discovery와 실행 범위를 통제한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다. `check_total`로 함수 이름을 짓는다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다. 의도한 node id set과 collection count가 config별로 정확히 일치을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

pytest discovery와 실행 범위를 통제한다에서 숨은 입력·상태·제어 흐름·oracle·관측 증거를 한 화면에서 대조한다.pytest discovery와 실행 범위를 통제한다의 baseline, injected defect, first divergence, assertion/log/trace evidence와 sealed regression을 연결한 terminal현재 화면: 정적 요약 지도 · 읽는 방법: fixture와 단계 탭을 선택하면 expected·actual·evidence가 동기화되고 최종 단계에서만 판정과 수정 근거를 공개한다. · 모션 축소 설계: 자동 이동 없이 선택 상태를 즉시 표시하고 번호·문자 label·선 종류·도형으로 색상 외 의미를 중복 제공한다.

처음 보는 말도 책 읽듯 풀어봐요

이 수업은 쉬운 뜻과 생활 예를 아직 함께 준비하지 못했어요. 설명 없는 정확한 이름은 먼저 보여 주지 않을게요.

그림에서 찾을 쉬운 규칙

01pytest는 naming convention과 configuration에 따라 test module·class·function을 collect하므로 0 tests는 성공 증거가 아니다.
02`--collect-only`와 node id로 collection 범위를 실행 전에 확인할 수 있다.
03rootdir·config·working directory·testpaths가 달라지면 동일 command text도 다른 suite를 수집할 수 있다.

03 · 같이 풀어보기

한 단계씩 따라가면 어렵지 않아요

multi-package repository의 test entrypoint에서 pytest discovery와 실행 범위를 통제한다 계약을 적용한다.

함께 볼 작은 예시synthetic td17 fixture · secret 없는 고정 입력 · exact Python 3.14.6

04 · 이제 내가 해볼 차례

여기까지 오면 이런 일을 할 수 있어요

pytest 9.0의 file·class·function naming discovery와 node id·collection 결과를 확인해 의도한 test만 실행되도록 한다.

pytest discovery와 실행 범위를 통제한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다.
`check_total`로 함수 이름을 짓는다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다.
의도한 node id set과 collection count가 config별로 정확히 일치을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

05 · 자주 헷갈리는 지점

틀린 답도 이유를 알면 다음에는 맞힐 수 있어요

01pytest exit code가 0이면 모든 test가 실행된 것이다.

한 번 더 생각해 볼 질문pytest discovery와 실행 범위를 통제한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요pytest는 naming convention과 configuration에 따라 test module·class·function을 collect하므로 0 tests는 성공 증거가 아니다.

02파일 안 함수에 assert가 있으면 이름과 무관하게 자동 수집된다.

한 번 더 생각해 볼 질문pytest discovery와 실행 범위를 통제한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요`--collect-only`와 node id로 collection 범위를 실행 전에 확인할 수 있다.

03어느 directory에서 실행해도 같은 config와 suite가 선택된다.

한 번 더 생각해 볼 질문pytest discovery와 실행 범위를 통제한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요rootdir·config·working directory·testpaths가 달라지면 동일 command text도 다른 suite를 수집할 수 있다.

06 · 더 궁금할 때만 보기

선생님과 검토자를 위한 믿을 만한 원문

원문과 어디까지 참고했는지 펼쳐 보기처음 배우는 동안에는 열지 않아도 괜찮아요.

pytest development team · 공개 문서를 확인했어요pytest 9.0 documentation

discovery, assertion introspection, parametrization, markers, raises, warning·capture·debugging과 import 경계

Python Institute · 2026년 7월 28일에 확인했어요PCAT-31-0x Exam Syllabus

2.3 AAA, 4.1~4.8 unit-testing foundations, 5.1~5.7 advanced unit-testing techniques, 6.1~6.2 TDD의 선택적 objective

Harvard University CS50 · 2026년 7월 28일에 확인했어요CS50P Week 5 · Unit Tests

assert·AssertionError·pytest와 testable function 분리의 공개 학습 경로

Exercism · 2026년 7월 28일에 확인했어요Testing on the Python track

pytest 실행, marker, failure output, -x·--ff·--pdb workflow의 공개 practice. 표시 예시 version은 product pin이 아님