[python] poetry 가상환경 세팅

타입

개발

태그

python

상태

Published

생성일

2022/05/16 04:29

최종 편집 일시

2023/02/24 11:35

2 more properties

poetry 란?

패키징/의존성 관리 + 가상환경 관리를 해주는 툴입니다.

비슷한 것은 pipenv 가 있는데 둘 다 써본 결과 큰 차이는 없지만 poetry 가 좀 더 가벼운 느낌이 듭니다.

왜 사용하는가?

의존성관리

js 를 주로 써온 저에게 파이썬의 의존성 관리는 상당히 빈약하다고 느꼈습니다.

특히 requirements.txt 를 수동으로 관리해줘야 하기 때문에 협업 시 문제가 생길 여지가 좀 있습니다.

의존성 관리툴을 사용하면 설치한 패키지 의존성을 관리해주기 때문에 이를 해결해줄 수 있습니다.

가상환경

파이썬의 내장 venv 를 사용하면 되긴하지만 매 프로젝트마다 세팅하기가 은근히 귀찮습니다.

poetry 를 쓰면 커맨드 한 줄로 세팅이 가능해서 더 간단합니다.

오픈소스의 경우 버전마다 설치방식이 달라질 수 있으므로 설치방법은 제 포스팅을 너무 믿지 마시고 반드시 공식 documetation 을 보고 설치하도록 합시다!

( macOS 환경 poetry 1.1.13 버전 (2022/05/16) 기준으로 설치한 글입니다.)

Introduction

Introduction Poetry is a tool for dependency management and packaging in Python. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you. System requirements Poetry requires Python 2.7 or 3.5+. It is multi-platform and the goal is to make it work equally well on Windows, Linux and OSX.

https://python-poetry.org/docs/

설치

macOS / linux

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -
Bash
복사

설치 확인

터미널 다시 시작 후 명령어 poetry --version

버전 업데이트

poetry self update
Bash
복사

poetry 프로젝트 세팅

poetry init
Bash
복사

npm 의 npm init 과 비슷하게 프로젝트를 생성하는 명령어 입니다.

npm init 을 하게되면 package.json 이 생기듯이,

poetry init 을 하게 되면 pyproject.toml 이라는 파일이 생성됩니다.

프로젝트의 메타정보와 라이브러리 의존성을 관리해주는 파일입니다.

poetry 가상환경

poetry shell
Bash
복사

해당 디렉토리에서 가상환경이 생성되고 activate 됩니다.

poetry init 으로 프로젝트를 생성한 후에만 가상환경을 생성가능합니다.

가상환경을 종료시키고 싶다면 exit 이나 deactivate 명령어를 사용합니다.

poetry 에서 지원하는 가상환경에 관한 더 많은 명령어와 기능들은 아래 공식문서를 참고해보세요

Managing environments

Managing environments Poetry makes project environment isolation one of its core features. What this means is that it will always work isolated from your global Python installation. To achieve this, it will first check if it's currently running inside a virtual environment. If it is, it will use it directly without creating a new one.

https://python-poetry.org/docs/managing-environments/#deleting-the-environments

패키지 설치

install 이 아니라 add 명령어로 설치합니다.

개발용 패키지일때는 --dev 명령어를 붙혀줍니다.

poetry add 패키지명 

poetry add --dev 패키지명 # 개발용 패키지
Bash
복사

pyproject.toml 을 확인해보면 위에서 설치한 requests 패키지가 추가돼있습니다.

requirements.txt 는 패키지 설치 시 자동으로 추가가 안 되기 때문에 수동으로 해줘야하는데

앞으로는 매번 pip freeze > requirements.txt 를 할 필요가 없습니다.