작은 패키지의 배포 구성
Python 코드가 하나의 파일이거나 하위 모듈을 포함한 패키지 디렉터리일 때 배포 준비를 도와준다. 한 번에 하나의 가져오기 가능한 모듈이나 패키지를 다루는 구조다. 패키지 안의 하위 패키지와 데이터 파일도 배포 내용에 포함할 수 있다.
설정 파일에 담는 정보
초기화 명령으로 pyproject.toml을 만들고 빌드 시스템과 프로젝트 정보를 설정한다. 문서 문자열의 요약과 버전 정보를 활용하는 흐름을 제공하며 명령행 스크립트 같은 추가 메타데이터도 정의할 수 있다. 빌드 도구의 동작과 프로젝트의 실제 내용은 이 설정을 통해 연결된다.
빌드와 게시의 흐름
배포 파일을 만들고 PyPI에 게시하거나 개발용으로 로컬 설치하는 기능을 제공한다. 게시된 패키지는 일반적인 Python 패키지처럼 설치할 수 있다. 패키징 설정을 단순하게 구성하는 데 초점을 두지만 결과 파일에 필요한 내용이 들어 있는지와 실제 설치 후 동작하는지는 별도로 확인해야 한다.
관련 문서
Setuptools / Python Build / Twine / Hatch Python / Poetry