[파이썬 훈련] #003 Python 가상환경 Poetry 설정 및 사용법

안녕하세요 여러분, 데잇입니다. 파이썬 버전과 의존성을 관리하기 위한 다양한 가상환경이 있습니다.
여기서는 가장 강력하다고 POETRY의 설정과 사용에 대하여 간단히 알아봅니다!

POETRY 사용법

설치

curl -ssl https://install.python-poetry.org/ | python3

세팅

• 설치를 완료하고 나면 등장하는 안내 메세지에 따라 PATH에 명령어를 추가합니다.
• 탭 완성(tab completion) 활성화하기
  • Bash쉘: poetry help completions
  • Oh-My-Zsh쉘: 다음 명령어를 통해 ./zshrc의 plugins에 poetry를 추가합니다.

# Zsh (Oh-My-Zsh)
mkdir $ZSH/plugins/poetry 
poetry completions zsh > $ZSH/plugins/poetry/_poetry

환경 생성하기 with GITHUBㄹ

프로젝트 관리

프로젝트란?

• 프로젝트: 특정 폴더(디렉토리)와 그 안에 포함된 파일들, 특히 소스 코드, 설정 파일(pyproject.toml), 그리고 그 프로젝트의 종속성을 관리하는 다른 파일들(poetry.lock)을 의미함. 즉, 프로젝트 폴더는 해당 프로젝트와 관련된 모든 자원을 포함하고 있는 폴더임. 따라서 "프로젝트"는 특정 폴더와 그 안에 있는 관련 파일 및 설정의 전체적인 집합을 의미.
• 특징
  1. 구성 파일: 각 프로젝트는 pyproject.toml 파일을 가지고 있으며, 이 파일은 프로젝트의 메타데이터, 종속성, 빌드 시스템 설정 등을 정의
  2. 독립된 환경: 프로젝트마다 독립된 가상 환경을 가질 수 있습니다. 이는 프로젝트별로 서로 다른 종속성과 Python 버전을 격리
  3. 종속성 관리: poetry.lock 파일은 프로젝트의 정확한 종속성을 기록하여, 다른 환경에서도 동일한 종속성을 재생성

명령어

• poetry 명령어를 사용할 때 유의사항
  • 현재 작업 중인 디렉토리가 해당 프로젝트의 루트 디렉토리로 간주
  • 해당 디렉토리 내에서 poetry 명령어를 실행하면, poetry는 해당 디렉토리의 pyproject.toml 파일을 찾아 프로젝트 설정을 읽고 종속성 관리
• 프로젝트 셋업
  • 기존 폴더가 없는 경우: poetry new <프로젝트명>
  • 기존 폴더가 있는 경우: poetry init
• 프로젝트 실행: poetry shell
• 프로젝트 종료: exit
• 프로젝트 설정변경
  • poetry config --list
  • poetry config [options] [setting-key] [setting-value]
• 프로젝트 확인
  • poetry env list
• 프로젝트 삭제: poetry env remove <프로젝트명> or rm -rf .venv

패키지 관리

• 패키지 추가: poetry add <라이브러리 명> → poetry.lock 파일 업데이트 & pyproject.toml에 의존성 추가 & 패키지 설치
• 패키지 설치
  • poetry install → poetry.lock이 있다면 해당 파일을 사용하고 없다면 pyproject.toml 읽어서 의존성 패키지 조건 내 최신버전 설치 및 poetry.lock생성
  • poetry update →poetry.lock 삭제 후 poetry install
• 패키지 목록 확인: poetry show --tree
• 패키지 삭제: poetry remove pandas

참고자료

자세한 정보는 공식 사이트 및 타 블로그들을 참고하여 봅시다!