Poetry는 Python 프로젝트의 의존성 관리와 가상 환경 관리를 통합적으로 제공하는 도구이다. 이 절에서는 Ubuntu 환경에서 Poetry를 설치하는 방법을 설명하겠다. Poetry 설치는 간단한 명령어를 통해 진행되며, 설치 후에는 프로젝트 초기화, 의존성 관리 등을 바로 사용할 수 있게 된다.

Poetry 설치 전 준비 사항

Ubuntu에서 Poetry를 설치하기 전에 Python이 이미 설치되어 있는지 확인해야 한다. Poetry는 Python 3.7 이상에서 작동하므로, 시스템에 적절한 Python 버전이 설치되어 있어야 한다.

먼저, 터미널을 열고 아래 명령어를 사용하여 Python 버전을 확인하라.

python3 --version

만약 Python이 설치되어 있지 않거나 버전이 낮다면, 최신 버전의 Python을 설치해야 한다. Python 3.x 버전 설치는 다음 명령어를 통해 가능한다.

sudo apt update
sudo apt install python3

Python이 설치되면, pip 패키지 관리자가 설치되어 있어야 한다. pip는 Python 패키지를 설치하고 관리하는 도구로, Poetry 설치에 필수적이다.

sudo apt install python3-pip

설치된 pip의 버전도 확인해 주세요.

pip3 --version

이제 Poetry를 설치할 준비가 완료되었다.

Poetry 설치 명령어

Poetry는 공식 설치 스크립트를 제공하여 간편하게 설치할 수 있다. 아래 명령어를 사용하여 Poetry를 설치하라.

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

이 명령어는 Poetry 설치 스크립트를 다운로드하여 실행한다. 설치가 완료되면 Poetry가 기본적으로 설치된 위치는 ~/.local/bin/poetry이다.

설치 후에는 Poetry가 시스템에서 인식되도록 환경 변수를 설정할 필요가 있다. 터미널에서 아래 명령어를 입력하여 Poetry의 설치 경로를 PATH 환경 변수에 추가한다.

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

이 명령어는 현재 세션에서만 유효하므로, 지속적으로 사용할 수 있도록 하기 위해서는 이 설정을 쉘 설정 파일에 추가하는 것이 좋다. 일반적으로 사용하는 쉘에 따라 설정 파일이 다르다.

• Bash를 사용하는 경우:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

• Zsh를 사용하는 경우:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

설정 파일을 수정한 후, 적용하기 위해 쉘을 다시 로드하거나 아래 명령어로 설정을 적용한다.

source ~/.bashrc   # Bash를 사용하는 경우
source ~/.zshrc    # Zsh를 사용하는 경우

Poetry 설치 확인

Poetry 설치가 완료되면 아래 명령어를 입력하여 설치가 제대로 되었는지 확인한다.

poetry --version

이 명령어를 실행하면 Poetry의 버전 정보가 출력된다. 버전 정보가 제대로 출력되면 설치가 완료된 것이다.