[Poetry] Poetry 사용법

Poetry는 Python 프로젝트의 종속성 관리 및 패키지 관리 도구로, Python 환경을 설정하고 프로젝트를 관리하는 데 사용됩니다. Poetry를 사용하여 Python 프로젝트를 시작하려면 다음 단계를 따를 수 있습니다:

1. Poetry 설치:

Poetry를 설치하려면 다음 pip 명령을 실행합니다.

pip install poetry

2. 새로운 Python 프로젝트 생성:

새로운 Python 프로젝트를 시작하려면 새로운 디렉토리를 만들고 해당 디렉토리로 이동한 다음 poetry new 명령을 사용합니다. 예를 들어:

mkdir my-python-project
cd my-python-project
poetry new .

이렇게 하면 새로운 Poetry 프로젝트가 생성됩니다.

"bash: poetry: command not found" 오류는 Poetry 도구가 시스템에서 찾을 수 없을 때 발생합니다. 이 문제를 해결하려면 Poetry를 정확하게 설치하고 경로를 설정해야 합니다.

Poetry 경로 설정:
Poetry를 정상적으로 설치했더라도 poetry 명령을 실행하려면 시스템의 PATH 환경 변수에 Poetry의 실행 경로가 포함되어야 합니다. 시스템 환경 변수 PATH에 Poetry의 바이너리 디렉토리를 추가하려면 다음 단계를 따르십시오:

Poetry의 바이너리 디렉토리를 찾습니다. 일반적으로 $HOME/.local/bin에 설치됩니다.

그런 다음, 셸의 환경 설정 파일 (예: ~/.bashrc, ~/.bash_profile, ~/.zshrc)을 열고 다음 줄을 추가합니다. 바이너리 디렉토리 경로를 수정하여 실제 설치 경로에 맞게 설정하십시오.

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

환경 설정 파일을 저장하고 닫은 후, 다음 명령을 사용하여 변경 사항을 활성화합니다.

source ~/.bashrc  # 또는 ~/.bash_profile 또는 ~/.zshrc 등

이제 poetry 명령을 사용할 수 있어야 합니다.

3. 종속성 정의:

프로젝트의 종속성을 pyproject.toml 파일에 정의합니다. 종속성을 추가하려면 poetry add 명령을 사용합니다. 예를 들어, requests 패키지를 추가하려면 다음 명령을 실행합니다.

poetry add requests

4. 가상 환경 생성:

Poetry는 각 프로젝트에 대한 가상 환경을 생성합니다. 가상 환경을 만들려면 다음 명령을 실행합니다.

poetry install

이렇게 하면 프로젝트 종속성이 설치된 가상 환경이 생성됩니다.

Poetry를 사용하여 새로운 Python 가상 환경을 생성한 후에 해당 가상 환경에 들어가려면 다음 단계를 따를 수 있습니다:

먼저, Poetry를 사용하여 새로운 가상 환경을 생성합니다. 이미 생성한 경우, 이 단계를 건너뛸 수 있습니다. 새 가상 환경을 생성하려면 다음 명령을 사용합니다:

poetry env use python3

이 명령은 Python 3을 사용하는 새로운 Poetry 가상 환경을 생성하고 활성화합니다.

가상 환경에 들어가기:
가상 환경을 생성하고 활성화했다면, 해당 가상 환경으로 들어가려면 poetry shell 명령을 사용합니다:

poetry shell

이 명령을 실행하면 현재 가상 환경 내의 셸로 전환됩니다. 가상 환경에서 Python 및 관련 패키지를 사용할 수 있게 됩니다.

가상 환경에서 작업을 마친 후, exit 명령을 사용하면 가상 환경에서 빠져나올 수 있습니다.

 

 

5. Python 프로젝트 실행:

Poetry로 관리되는 프로젝트를 실행하려면 poetry run 명령을 사용합니다. 예를 들어, 프로젝트의 스크립트를 실행하려면 다음과 같이 사용합니다.

poetry run python my_script.py