처음이어도 괜찮아요 · 그림부터 시작해요
pyproject.toml을 package 계약으로 만든다
build backend·project metadata·requires-python·dependency·optional group·entry point를 pyproject.toml의 단일 versioned contract로 관리한다. 이를 생략하면 README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다. 상황에서도 데모는 보일 수 있지만 제품·검증·운영 책임을 방어할 수 없습니다.
아직 답을 몰라도 괜찮아요. 아래 작은 예시를 보고 먼저 예상해 보세요.01 · 가볍게 시작하기
정답을 보기 전에 먼저 골라볼까요?
cp13 frozen synthetic fixture · fixed clock/UTC · outbound deny · secret-like sentinel · one independent mutant- 1먼저 골라보기
틀려도 괜찮아요. 지금 생각한 답 하나를 정해요.
- 2그림으로 확인하기
움직이는 순서와 달라지는 곳만 천천히 찾아요.
- 3내 말로 다시 말하기
한 문장으로 말해 보면 내가 이해한 곳을 확인할 수 있어요.
02 · 그림으로 보기
그림이 움직이는 순서를 직접 확인해요
- 01관찰pyproject.toml · build backend · project metadata · requires-python
- 02추론build backend·project metadata·requires-python·dependency·optional group·entry point를 pyproject.toml의 단일 versioned contract로 관리한다. validated pyproject sections·metadata diff·requires-python gate·build backend receipt는 README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다.를 포함한 정상·경계·실패 실행에서 독립적으로 다시 계산할 수 있어야 한다. pyproject.toml을 package 계약으로 만든다은 AI-off 기준선을 먼저 봉인하고 AI 제안 diff를 검토한 뒤, AI가 보지 못한 mutant로 재검증하고 사람이 승인·수정·거절한다. source tree가 아닌 installable Python automation package 배포로 전이할 때 구현보다 contract·effect boundary·evidence owner·residual risk를 먼저 보존한다.
- 03검증pyproject.toml을 package 계약으로 만든다의 contract·owner·normal/boundary/failure outcome을 AI 없이 먼저 고정한다. README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다.를 frozen synthetic fixture로 재현하고 최초 divergence와 expected verdict를 설명한다. AI 제안은 baseline과 diff로만 검토하고 독립 mutant에서 필수 metadata와 runtime/test group 및 entry point 불일치를 검사하는 pyproject auditor를 구현한다.을 다시 실행한다. validated pyproject sections·metadata diff·requires-python gate·build backend receipt와 사람의 accept·refactor·reject 판정 및 residual risk를 함께 제출한다.
처음 보는 말도 책 읽듯 풀어봐요
이 수업은 쉬운 뜻과 생활 예를 아직 함께 준비하지 못했어요. 설명 없는 정확한 이름은 먼저 보여 주지 않을게요.
그림에서 찾을 쉬운 규칙
- 01build backend·project metadata·requires-python·dependency·optional group·entry point를 pyproject.toml의 단일 versioned contract로 관리한다.
- 02validated pyproject sections·metadata diff·requires-python gate·build backend receipt는 README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다.를 포함한 정상·경계·실패 실행에서 독립적으로 다시 계산할 수 있어야 한다.
- 03pyproject.toml을 package 계약으로 만든다은 AI-off 기준선을 먼저 봉인하고 AI 제안 diff를 검토한 뒤, AI가 보지 못한 mutant로 재검증하고 사람이 승인·수정·거절한다.
- 04source tree가 아닌 installable Python automation package 배포로 전이할 때 구현보다 contract·effect boundary·evidence owner·residual risk를 먼저 보존한다.
03 · 같이 풀어보기
한 단계씩 따라가면 어렵지 않아요
source tree가 아닌 installable Python automation package 배포의 축소된 product slice에서 pyproject.toml을 package 계약으로 만든다 release 판단을 수행한다.
cp13 frozen synthetic fixture · fixed clock/UTC · outbound deny · secret-like sentinel · one independent mutant04 · 이제 내가 해볼 차례
여기까지 오면 이런 일을 할 수 있어요
필수 metadata와 runtime/test group 및 entry point 불일치를 검사하는 pyproject auditor를 구현한다.을 수행하고 validated pyproject sections·metadata diff·requires-python gate·build backend receipt로 build backend·project metadata·requires-python·dependency·optional group·entry point를 pyproject.toml의 단일 versioned contract로 관리한다.을 독립 검증한다.
- pyproject.toml을 package 계약으로 만든다의 contract·owner·normal/boundary/failure outcome을 AI 없이 먼저 고정한다.
- README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다.를 frozen synthetic fixture로 재현하고 최초 divergence와 expected verdict를 설명한다.
- AI 제안은 baseline과 diff로만 검토하고 독립 mutant에서 필수 metadata와 runtime/test group 및 entry point 불일치를 검사하는 pyproject auditor를 구현한다.을 다시 실행한다.
- validated pyproject sections·metadata diff·requires-python gate·build backend receipt와 사람의 accept·refactor·reject 판정 및 residual risk를 함께 제출한다.
05 · 자주 헷갈리는 지점
틀린 답도 이유를 알면 다음에는 맞힐 수 있어요
01pyproject.toml이 존재하면 package metadata는 자동으로 완전하다.
한 번 더 생각해 볼 질문cp13 pyproject.toml을 package 계약으로 만든다에서 이 주장을 깨는 최소 반례와 관찰 가능한 판정값을 쓰세요.
이렇게 고쳐 생각해요build backend·project metadata·requires-python·dependency·optional group·entry point를 pyproject.toml의 단일 versioned contract로 관리한다.
02requires-python은 문서일 뿐 installer와 CI gate에는 영향이 없다.
한 번 더 생각해 볼 질문cp13 pyproject.toml을 package 계약으로 만든다에서 이 주장을 깨는 최소 반례와 관찰 가능한 판정값을 쓰세요.
이렇게 고쳐 생각해요README·requirements·setup script·CI에 서로 다른 version과 dependency가 흩어져 설치 결과가 환경마다 달라진다.는 성공 출력과 별도로 재현하고 최초 위반 지점에서 차단해야 한다.
03AI가 추가한 dependency는 import가 되면 version 근거가 없어도 된다.
한 번 더 생각해 볼 질문cp13 pyproject.toml을 package 계약으로 만든다에서 이 주장을 깨는 최소 반례와 관찰 가능한 판정값을 쓰세요.
이렇게 고쳐 생각해요validated pyproject sections·metadata diff·requires-python gate·build backend receipt와 독립 mutant·human verdict가 함께 있어야 승인 범위를 설명할 수 있다.
06 · 더 궁금할 때만 보기
선생님과 검토자를 위한 믿을 만한 원문
원문과 어디까지 참고했는지 펼쳐 보기처음 배우는 동안에는 열지 않아도 괜찮아요.
배포 metadata에 포함되지 않는 test·docs·lint 등 내부 개발 dependency group 계약
M12 언어 runtime 기준과 source artifact의 Sigstore·SPDX SBOM. free-threaded build는 선택이고 JIT는 실험 기능이므로 기본 GIL·JIT-off gate 결과와 혼용하지 않는다.
[build-system]·[project]·metadata·requires-python·dependency·entry point를 하나의 versioned package contract로 연결한다.