build로 빌드하기
wheel과 sdist 만들기
build로 빌드하기은(는) CoddyKit의 무료 Python Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Python Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
빌드의 의미
소스 코드를 pip로 설치할 수 있는 배포 산출물로 변환해야 합니다. 이를 위한 최신 도구는 build이며, python -m build로 실행합니다.
이 도구는 소스 배포본과 휠이라는 두 종류의 파일을 생성합니다.
sdist와 휠 비교
산출물 유형은 두 가지입니다.
- sdist (.tar.gz)는 소스 압축 파일이며, pip가 설치할 때 빌드합니다
- 휠 (.whl)은 미리 빌드된 압축 파일이며, pip가 압축을 풀기만 합니다
휠은 더 빠르게 설치되므로 우선적으로 사용됩니다. sdist는 대체 수단이자 정식 소스입니다.
빌드 도구 설치하기
pip install build를 사용해 한 번 설치합니다. 이 도구는 얇은 프런트엔드로, pyproject.toml을 읽고 격리된 환경을 설정한 다음 빌드 백엔드를 호출해 산출물을 생성합니다.
백엔드를 직접 호출하지 않아도 됩니다. build가 전체 과정을 조정합니다.
빌드 실행하기
프로젝트 루트에서 python -m build를 실행합니다. 기본적으로 sdist와 휠을 모두 만들고, 새 dist/ 디렉터리에 저장합니다.
하나만 빌드하려면 --wheel 또는 --sdist를 사용합니다.
args = []
targets = []
if '--sdist' in args:
targets.append('sdist')
if '--wheel' in args:
targets.append('wheel')
if not targets:
targets = ['sdist', 'wheel']
print('Will build:', targets)휠 파일 이름
휠 이름에는 메타데이터가 인코딩됩니다. mytool-0.1.0-py3-none-any.whl은 이름이 mytool이고 버전이 0.1.0이며, 파이썬 3용이고 ABI 요구 사항이 없으며 모든 플랫폼에서 사용할 수 있다는 뜻입니다. 순수 파이썬 패키지는 py3-none-any를 사용합니다.
name = 'mytool'
version = '0.1.0'
wheel = name + '-' + version + '-py3-none-any.whl'
print(wheel)
print('Parts:', wheel[:-4].split('-'))빌드 격리
기본적으로 build는 새 가상 환경을 만들고, [build-system]의 requires에 지정된 항목을 설치한 다음 그 환경에서 빌드합니다. 따라서 현재 환경에 우연히 설치된 패키지에 빌드가 실수로 의존하지 않도록 보장합니다.
dist 폴더 살펴보기
빌드가 끝나면 dist/에 산출물이 들어 있습니다. 업로드하기 전에 이 폴더를 나열하면 무엇이 생성되었는지 확인할 수 있습니다. 이는 일반적인 디렉터리 목록 확인입니다.
dist = ['mytool-0.1.0.tar.gz', 'mytool-0.1.0-py3-none-any.whl']
for f in dist:
kind = 'sdist' if f.endswith('.tar.gz') else 'wheel'
print(kind.ljust(6), f)휠 확인하기
휠은 ZIP 압축 파일일 뿐입니다. 압축을 풀어 모듈과 데이터 파일이 포함되어 있고 중요한 항목이 빠지지 않았는지 확인할 수 있습니다. 여기에서 파일이 누락되었다면 설치한 후에도 누락됩니다.
깨끗한 빌드
build/ 또는 dist/에 오래된 파일이 남아 있으면 결과가 혼란스러울 수 있습니다. 릴리스 빌드 전에 이 디렉터리를 삭제하여 현재 소스가 생성하는 내용만 정확히 배포하세요.
stale_dirs = ['build', 'dist', 'mytool.egg-info']
for d in stale_dirs:
print('Remove before clean build:', d)재현 가능한 빌드
같은 소스라면 항상 같은 산출물을 빌드해야 합니다. [build-system] requires에서 빌드 백엔드 버전을 고정하고, 현재 실행 환경에서 값을 가져오지 않도록 하세요. 재현 가능하다는 것은 팀원이나 지속적 통합 서버에서도 동일한 결과를 얻는다는 뜻입니다.
깨끗한 빌드와 결합하면 내 컴퓨터에서만 작동하는 문제를 없앨 수 있습니다.
지속적 통합에서 빌드하기
대부분의 프로젝트는 개인 컴퓨터가 아니라 지속적 통합 서버에서 빌드합니다. 지속적 통합 작업은 코드를 가져오고 python -m build를 실행한 다음 산출물을 저장합니다. 따라서 매번 알려지고 깨끗한 상태에서 릴리스가 생성됩니다.
로컬에서 실행하는 것과 정확히 같은 명령이 지속적 통합 환경에서도 실행됩니다.
빠른 확인
빌드 지식을 테스트해 보세요.
요약
산출물을 빌드하는 방법을 배웠습니다.
pip install build를 실행한 다음python -m build를 실행합니다dist/에 sdist (.tar.gz)와 휠 (.whl)을 생성합니다[build-system]의 requires를 사용해 격리된 환경에서 빌드합니다- 릴리스 전에 휠을 확인하고 깨끗한 빌드를 수행합니다
자주 묻는 질문
“build로 빌드하기” 강의는 무료인가요?
네 — “build로 빌드하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Python Academy 강의 전체를 잠금 해제할 수 있습니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“build로 빌드하기”에서 뭘 배우나요?
wheel과 sdist 만들기 브라우저에서 직접 실행하는 실습 코드로 Python Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Python Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Python Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“build로 빌드하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Python Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Python Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.