카테고리
게시일
Jan 4, 2026
Poetry가 뭐죠?
파이썬의 프로젝트 의존성 관리 및 패키징 툴
요약 : python판 npm
pyproject.toml 이라는 packages.json 비슷한 걸 만들어서 이 프로젝트에 필요한 패키지, 즉 의존성 패키지를 관리한다.초간단 CLI 명령어
poetry new 프로젝트명새 프로젝트 생성,pyproject.toml도 이걸로 생성
poetry add 패키지명프로젝트에 패키지 추가.pyproject.toml에 기록 후 패키지install
poetry remove 패키지명프로젝트에 패키지 제거.pyproject.toml에도 적용됨
poetry install프로젝트 의존성 패키지 설치. 즉pyproject.toml을 실행
poetry run 명령어로 프로그램 실행 (프로젝트 패키지 미설치 시poetry install을 한번 해줘야 함)
poetry를 활용한 docker 배포
- poetry는 docker image 런타임에는 설치조차 하지 않는다. (npm run마냥 poetry run 같은건 하지 않는다)
- dockerfile Build Stage
- pip install poetry
- poetry에서 requirments.txt 생성 (poetry export)
- dockerfile Runtime Stage
- pip install로 requirements.txt 의존성 패키지 설치
- 명령줄로 프로그램(서버) 실행
poetry의 한계
packages.json 은 script 를 지정해 마치 makefile 처럼 사전 지정된 cli script를 돌릴 수 있다.poetry 에서는 poetry run 에서 cli entrypoint를 지정할 수 있다.