Poetry Configuration

config 명령어나 config.toml 파일을 통해 설정할 수 있다.
설정 파일은 운영 체제에 따라 다른 위치에 저장된다.

설정 관리

  • 전역 설정: 기본적으로 Poetry는 전역 설정을 사용. 전역 설정 파일은 일반적으로 ~/.config/pypoetry/config.toml 경로에 위치.
  • 로컬 설정: 특정 프로젝트에만 적용되는 설정을 위해 --local 옵션을 사용할 수 있다. 이 경우 설정은 프로젝트 디렉토리의 poetry.toml 파일에 저장.

설정 확인 및 수정

  • 현재 설정 목록 보기: poetry config --list
  • 특정 설정 값 보기: poetry config <설정명>
  • 설정 추가/수정: poetry config <설정명> <값>
  • 설정 제거: poetry config <설정명> --unset

환경 변수 사용

환경 변수를 통해 설정을 관리할 수 있다.
환경 변수는 POETRY_ 접두사를 사용하며, 설정 이름은 대문자로 작성하고 점(.)이나 대시(-)는 밑줄(_)로 대체한다.
가상 환경 경로를 지정하려면,

1

$ export POETRY_VIRTUALENVS_PATH=/path/to/**virtualenvs**

기본 디렉토리

설정 디렉토리

  • Linux: $XDG_CONFIG_HOME/pypoetry 또는 ~/.config/pypoetry
  • Windows: %APPDATA%\pypoetry
  • macOS: ~/Library/Application Support/pypoetry

데이터 디렉토리

  • Linux: $XDG_DATA_HOME/pypoetry 또는 ~/.local/share/pypoetry
  • Windows: %APPDATA%\pypoetry
  • macOS: ~/Library/Application Support/pypoetry

캐시 디렉토리

  • Linux: $XDG_CACHE_HOME/pypoetry 또는 ~/.cache/pypoetry
  • Windows: %LOCALAPPDATA%\pypoetry
  • macOS: ~/Library/Caches/pypoetry

주요 설정 항목

주요 설정 항목

  • cache-dir: 캐시 디렉토리 경로
  • virtualenvs.create: 가상 환경 생성 여부, 기본값은 true
  • virtualenvs.in-project: 프로젝트 내 가상 환경 생성 여부
  • virtualenvs.path: 가상 환경 생성 경로
  • installer.parallel: 병렬 설치 사용 여부, 기본값은 true
  • installer.no-binary: 바이너리 배포 형식 정책 설정
  • repositories.<name>.url: 저장소 URL 설정
  • http-basic.<name>.[username|password]: 저장소 인증 정보 설정
  • pypi-token.<name>: API 토큰을 사용한 저장소 인증 설정
  • certificates.<name>.cert: 사용자 정의 인증 기관 설정
  • keyring.enabled: 시스템 키링 사용 여부

가상 환경 관련 설정

  • virtualenvs.create: 가상 환경 자동 생성 여부
  • virtualenvs.in-project: 프로젝트 내 가상 환경 생성 여부
  • virtualenvs.path: 가상 환경 생성 경로
  • virtualenvs.options.*: 가상 환경 생성 옵션 (always-copy, no-pip, no-setuptools, system-site-packages)

참고 및 출처

Poetry

Configuration | Documentation | Poetry - Python dependency management and packaging made easy