test folder와 import boundary를 설계한다

오늘의 질문

src·tests layout, package installation, pytest import mode와 rootdir를 통제해 local·CI에서 같은 module을 test한다. 이 판단을 생략하면 통과한 test와 많은 log가 있어도 결함을 놓치거나 잘못된 수정을 승인할 수 있습니다.

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

01 · 가볍게 시작하기

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

눈으로만 보고 답 하나를 떠올려 보세요src-layout Python library의 release pipeline에서 test folder와 import boundary를 설계한다 계약을 적용한다.synthetic td24 fixture · secret 없는 고정 입력 · exact Python 3.14.6

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

02 · 그림으로 보기

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

01관찰src layout · import mode · rootdir · installed package
02추론test가 source checkout 우연한 path가 아니라 배포 대상 package import boundary를 통과해야 한다. 동명 test module과 package namespace는 collection·import collision을 만들 수 있어 layout과 import mode를 명시한다. `sys.path` 임시 조작은 packaging defect를 숨길 수 있으므로 install·config 계약을 먼저 고친다.
03검증test folder와 import boundary를 설계한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다. repo root module을 우연히 import한다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다. local·clean install·CI가 동일 배포 package와 node manifest를 사용을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

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

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

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

그림에서 찾을 쉬운 규칙

01test가 source checkout 우연한 path가 아니라 배포 대상 package import boundary를 통과해야 한다.
02동명 test module과 package namespace는 collection·import collision을 만들 수 있어 layout과 import mode를 명시한다.
03`sys.path` 임시 조작은 packaging defect를 숨길 수 있으므로 install·config 계약을 먼저 고친다.

03 · 같이 풀어보기

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

src-layout Python library의 release pipeline에서 test folder와 import boundary를 설계한다 계약을 적용한다.

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

04 · 이제 내가 해볼 차례

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

src·tests layout, package installation, pytest import mode와 rootdir를 통제해 local·CI에서 같은 module을 test한다.

test folder와 import boundary를 설계한다의 예상 결과·관찰 결과·판정 oracle을 실행 전에 분리해 기록한다.
repo root module을 우연히 import한다.에서 최초 불일치 지점과 근본 원인을 재현 가능한 evidence로 국소화한다.
local·clean install·CI가 동일 배포 package와 node manifest를 사용을 정상·경계·실패 fixture에 적용하고 false green·false red가 없는지 검증한다.

05 · 자주 헷갈리는 지점

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

01tests 폴더가 있으면 자동으로 배포되는 package를 test한다.

한 번 더 생각해 볼 질문test folder와 import boundary를 설계한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요test가 source checkout 우연한 path가 아니라 배포 대상 package import boundary를 통과해야 한다.

02local에서 import되면 CI와 wheel에서도 같은 module을 import한다.

한 번 더 생각해 볼 질문test folder와 import boundary를 설계한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요동명 test module과 package namespace는 collection·import collision을 만들 수 있어 layout과 import mode를 명시한다.

03`sys.path.insert` 한 줄이 packaging 문제의 안전한 해결책이다.

한 번 더 생각해 볼 질문test folder와 import boundary를 설계한다의 최소 fixture에서 이 주장을 깨는 관찰값과 판정 근거를 각각 한 줄로 쓰세요.

이렇게 고쳐 생각해요`sys.path` 임시 조작은 packaging defect를 숨길 수 있으므로 install·config 계약을 먼저 고친다.

06 · 더 궁금할 때만 보기

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

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

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

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

GitHub · 2026년 7월 28일에 확인했어요Building and testing Python

setup-python, version matrix, dependency install, pytest·coverage, result artifact를 포함한 CI workflow