WSL2 환경에서 Poetry 사용하기

해당 포스팅은 Poetry 공식 문서를 보고 작성하였습니다. 적확한 쓰임새는 공식문서를 보고 참고해 주세요.

1. Poetry란?

공식 문서에서는 Poetry를 다음과 같이 설명한다.

Poetry는 Python에서 종속성 관리 및 패키징을 위한 도구입니다. 그것은 당신의 프로젝트가 의존하는 라이브러리를 선언하도록 허용하고 당신을 위해 그것들을 관리(설치/업데이트)할 것입니다. Poetry는 반복 가능한 설치를 보장하는 잠금 파일을 제공하고 배포용 프로젝트를 빌드할 수 있습니다.

사실 Python 개발자들은 pip를 통해 Python의 다양한 라이브러리들을 설치할 수 있다. 그렇다면 Poetry를 굳이 쓰는 이유가 뭘까? 가장 큰 이유는 아마도 라이브러리 간의 의존성 관리를 "내"가 직접 하지 않아도 된다는 것이다. pip의 경우 pip freeze를 통해 requirements.txt라는 텍스트 파일로 패키지들의 의존성 관리를 직접 해야 한다. 만약 개발 환경에서만 쓰는 패키지들이 requirements.txt에 있거나(이를 위해 개발용 requirements.txt를 작성하는 경우도 봤지만...) 어떤 패키지를 삭제한 경우 엮여 있는 다른 패키지들 간의 의존성이 모호해지는 문제가 발생한다. 이러한 여러 가지 문제들을 Poetry를 통해 해결할 수 있는 게 가장 큰 장점인 거 같다.

2. Poetry 설치하기

2.1 설치하기

공식 문서를 보면 자세히 나온다. 나는 일단 PowerShell 환경과 WSL2 환경 둘 다 설치를 마쳤는데, WSL2 환경에서 설치하는 걸 포스팅하고자 한다. 왜냐하면 윈도우 환경에서 설치가 안 되는 파이썬 라이브러리들이 몇 개가 있기 때문에 WSL2 환경에서 통해 개발을 하는 게 편하다.

 

먼저 공식 문서에서 추천하는 설치 방법이다. 아래의 명령어를 입력하자.

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

설치를 하면 아래와 같은 내용이 콘솔에 나타난다.

2.2 환경변수 등록하기

설치를 마쳤다면 'poetry --version'을 통해 설치를 확인하라는데, 아마 안될 거다. 왜냐하면 환경변수를 등록해야 하기 때문이다. 환경변수 등록 또한 공식 문서에 나와있다.

Unix 환경에선 다음의 위치에 poetry가 설치되어 있다. $HOME/.local/bin

해당 위치를 환경변수에 등록하면 된다 다음과 같이 명령어를 입력하자

export PATH=$PATH:$HOME/.local/bin

그런 다음 다시 poetry --version 명령을 쳐보자. 다음과 같이 나온다면 성공한 거다.

2.3 프로젝트 생성하기

마지막으로 poetry를 통해 새로운 프로젝트를 만들어보자

poetry new {프로젝트 네임}

poetry new poetry-demo

위의 명령을 친다면 폴더가 생성되면서 poetry가 프로젝트를 생성해 준다. 파일 구조는 다음과 같다.

해당 프로젝트를 IDE에서 열면 된다. 

---

더 자세한 내용은 공식문서를 참고하자.