위키득계정 ↗
기술

Twine

Twine기술
주요 역할
Python 배포 파일 업로드
대상 저장소
PyPI와 기타 패키지 저장소
입력
이미 생성한 배포 파일
추가 검사
긴 설명의 렌더링 확인
Twine은 이미 생성한 Python 배포 파일을 PyPI 등의 패키지 저장소에 업로드하는 도구다. 빌드 시스템과 업로드를 분리해 소스 배포본과 wheel을 준비하고 확인한 뒤 게시하는 흐름을 지원한다.

빌드와 업로드 분리

패키지 파일을 만드는 작업과 저장소에 공개하는 작업을 한 명령에 묶으면 실제 게시할 파일을 미리 확인하기 어렵다. Twine은 이미 생성한 산출물을 업로드하므로 빌드에 사용한 시스템과 관계없이 게시 단계를 수행할 수 있다. 업로드를 위해 setup.py를 실행할 필요도 없다.

같은 파일을 확인한 뒤 게시

먼저 배포 파일을 만든 뒤 테스트 저장소 등에 업로드하고 게시 결과를 확인하는 흐름을 구성할 수 있다. 파일을 다시 빌드하는 대신 검토한 산출물을 게시 대상으로 삼는다는 점이 핵심이다. 전송에는 검증된 HTTPS 연결을 사용한다.

설명 확인과 저장소 설정

검사 명령은 배포 파일의 긴 설명이 PyPI에서 올바르게 렌더링될지 확인한다. 이 검사는 패키지 코드의 기능 테스트와는 다르다. 저장소 구성은 .pypirc 설정이나 명령행과 환경 변수로 지정할 수 있으며 실제 업로드 대상은 선택한 설정에 따라 달라진다.

관련 문서

Python Build / Hatch Python / Poetry / PDM Python / Semantic-release