Poetry 사용법

---

• Poetry
• Poetry 설치
• Poetry 프로젝트 생성
  • 방법 1
  • 방법 2
• 패키지 관리
  • 의존성 추가
  • 의존성 제거
  • 개발용 의존성 추가
• 가상환경 활성화
• 라이브러리 설치
• Poetry 가상환경 Jupyter Kernel 생성
• 팀원과 환경 공유
• requirements.txt 로 변환

Poetry

Poetry 는 Python 프로젝트의 의존성 관리와 패키지 배포를 단순화하는 도구이다. 기존의 pip 와 virtualenv 를 대체하며, pyproject.toml 파일을 활용해 프로젝트 생성과 의존성을 선언적으로 관리한다.

Poetry 는 다음과 같은 기능을 제공한다.

• 가상환경 자동 생성 : 프로젝트 별 독립적인 환경을 자동으로 생성하여 충돌 방지
• 의존성 잠금 : poetry.lock 파일로 의존성 버전을 고정해 재현 가능한 환경 보장
• 일관된 빌드 및 배포 : 패티지 생성, 빌드, 배포까지 한 도구에서 처리 가능

Poetry 설치

pip install poetry

Poetry 프로젝트 생성

방법 1

poetry new project
cd project

• 자동으로 README.md , src/project, texts/ , pyproject.toml 을 만들어준다.

방법 2

# 원하는 폴더로 이동
poetry init

• 프로젝트 이름과, python 버전, 의존성 등을 입력하면 pyproject.toml, README.md 를 생성해준다.

패키지 관리

의존성 추가

poetry add 패키지명

의존성 제거

poetry remove 패키지명

개발용 의존성 추가

poetry add --group dev 패키지 명

• 개발용 group 인 dev 의존성이 생성된다.

가상환경 활성화

poetry shell

or

$(poetry env activate)

라이브러리 설치

poetry install

# dev 를 제외하고 싶다면
poetry install --without dev

Poetry 가상환경 Jupyter Kernel 생성

poetry run python -m ipkernel install --user --name=my_project --display-name=my_project

팀원과 환경 공유

git clone <app>
cd project
poetry install --sync

requirements.txt 로 변환

poetry export -f requirements.txt --without-hases -ouutput requirements.txt