직접 만든 코드를 PyPI에 올려 다른 사람이 pip install로 쓰게 만드는 게 「패키지 발행」입니다.

옛날엔 setup.py가 표준이었지만 지금은 pyproject.toml(PEP 621)이 모던 표준.

최소 구조.

mypackage/ 폴더 안에 __init__.py, 그 옆에 pyproject.toml.

pyproject.toml에 [project] name = "mypackage", version = "0.1.0", description = "...", authors = [...], dependencies = ["requests"].

이게 전부.

빌드 시스템.

[build-system] requires = ["hatchling"], build-backend = "hatchling.build".

hatchling 외에 setuptools·flit·pdm·poetry-core 다 가능.

작은 프로젝트는 hatchling이 깔끔.

빌드와 발행.

pip install build twine.

python -m build — dist/ 안에 .whl과 .tar.gz 생성.

twine upload dist/* — PyPI에 업로드(API 토큰 필요).

버저닝.

0.1.0(major.minor.patch).

호환 안 되는 변경 시 major 증가, 기능 추가 minor, 버그 수정 patch.

한 번 발행한 버전은 재업로드 불가능 — 잘못 올리면 0.1.1로 새 버전.

처음 발행은 0.0.1 또는 0.1.0부터.

한 줄 요약

pyproject.toml(PEP 621)이 모던 패키지 표준.

빌드는 hatchling·setuptools, build로 빌드, twine으로 PyPI 업로드.

한 번 발행한 버전은 재업로드 불가.

더 알아볼 것

- setup.py에서 마이그레이션

- semantic versioning

- __init__.py와 패키지 구조