Poetry Usage

프로젝트 설정

  • poetry new 프로젝트명으로 새 프로젝트 생성
  • pyproject.toml 파일이 프로젝트와 의존성 관리의 중심
  • Python 버전 지정은 지원하려는 버전을 명시하는 것

의존성 지정

  • pyproject.toml의 [tool.poetry.dependencies] 섹션에 의존성 명시
  • poetry add 패키지명으로 의존성 추가 가능

가상 환경 사용

  • Poetry는 기본적으로 가상 환경을 생성하고 관리
  • poetry run으로 가상 환경 내에서 명령 실행
  • poetry shell로 가상 환경 활성화

버전 제약 조건

  • 예: ^2.1은 2.1.0 이상 3.0.0 미만 버전 허용

의존성 설치

  • poetry install로 의존성 설치
  • poetry.lock 파일이 없으면 생성, 있으면 해당 버전으로 설치
  • poetry.lock 파일은 버전 관리에 포함하는 것이 좋음

의존성 업데이트

  • poetry update로 최신 버전으로 업데이트

운영 모드

  • 기본 패키지 모드와 비패키지 모드 존재
  • 비패키지 모드는 의존성 관리만을 위한 모드

기존 프로젝트 초기화

  • poetry init으로 기존 프로젝트에 Poetry 설정 추가 가능

참고 및 출처

Poetry

Basic usage | Documentation | Poetry - Python dependency management and packaging made easy