빌드 성공 이후의 검사
배포 파일이 생성됐더라도 필요한 파일만 올바른 위치에 담겼는지는 별개다. Check-wheel-contents는 wheel 내부를 검사해 일반적인 구성 실수를 알려준다. 패키지를 실제로 실행하는 테스트와 달리 배포 파일에 무엇이 들어 있는지에 초점을 둔다.
흔한 구성 오류 찾기
컴파일된 Python 바이트코드와 중복된 파일, 라이브러리 최상위의 부적절한 파일 등을 검사한다. 모듈이 가져올 수 없는 경로에 놓인 경우나 흔한 디렉터리 이름이 최상위에 포함된 경우도 진단 대상이다. 의도한 구성이 예외라면 검사 기준과 프로젝트 구조를 함께 확인해야 한다.
기대하는 패키지 내용 정의
검사할 wheel이나 wheel을 찾을 디렉터리를 지정할 수 있다. 원하는 최상위 이름과 패키지 트리를 설정하거나 검사 항목을 선택하고 제외할 수도 있다. 실패한 검사와 관련 파일을 출력하고 종료 상태로 결과를 전달하므로 업로드 전 자동 검사 과정에 연결할 수 있다.
관련 문서
Python Build / Twine / Setuptools / Flit / Cibuildwheel