파이썬 프로젝트를 개발하면서 종종 다른 라이브러리나 패키지에 의존하는 경우가 있습니다. 이러한 의존성을 관리하는 것은 매우 중요한 작업이며, 프로젝트의 안정성과 유지보수성에 영향을 미칩니다. Poetry는 파이썬 프로젝트의 의존성을 명확하게 추적하고 관리할 수 있는 도구입니다.

Poetry란?

Poetry는 파이썬의 의존성 관리 도구로, 프로젝트의 의존성을 명시적으로 정의하고 관리합니다. 이를 통해 프로젝트를 다른 환경으로 쉽게 이식할 수 있으며, 의존성 충돌을 방지하고 요구되는 라이브러리의 버전을 일관되게 유지할 수 있습니다. 또한 Poetry는 가상 환경과 프로젝트 빌드도 관리할 수 있습니다.

Poetry 설치

Poetry를 사용하기 위해서는 먼저 Poetry를 설치해야 합니다. 다음의 명령어를 사용하여 Poetry를 설치할 수 있습니다:

$ pip install poetry

Poetry로 프로젝트 시작하기

Poetry를 사용하여 새로운 파이썬 프로젝트를 시작하려면 다음의 명령어를 사용합니다:

$ poetry new myproject
$ cd myproject

이렇게 하면 myproject라는 이름의 새로운 디렉토리가 생성되며, 해당 디렉토리 안으로 이동합니다.

의존성 관리

Poetry는 pyproject.toml 파일을 사용하여 프로젝트의 의존성을 관리합니다. 이 파일은 프로젝트의 루트 디렉토리에 위치하며, 다음과 같은 형식으로 의존성을 정의합니다:

[tool.poetry.dependencies]
python = "^3.9"
requests = "^2.26.0"

python은 파이썬 버전을, requests는 의존하는 라이브러리를 나타냅니다. 버전은 Semantic Versioning 규칙을 따르는 문자열로 명시할 수 있습니다. Poetry는 이 정보를 사용하여 의존성을 해결하고 일관된 환경을 유지합니다.

의존성을 추가하거나 업데이트하려면 다음의 명령어를 사용합니다:

$ poetry add requests
$ poetry update requests

환경 설정 및 가상 환경 관리

Poetry는 프로젝트의 환경을 관리하기 위해 가상 환경을 사용합니다. 가상 환경을 생성하고 활성화하기 위해 다음의 명령어를 사용합니다:

$ poetry install
$ poetry shell

poetry install 명령어는 프로젝트의 의존성을 설치하고, poetry shell 명령어는 가상 환경을 활성화합니다. 가상 환경에서는 프로젝트 의존성을 사용할 수 있습니다.

프로젝트 빌드

Poetry를 사용하여 프로젝트를 빌드하려면 pyproject.toml 파일이 있는 디렉토리에서 다음의 명령어를 사용합니다:

$ poetry build

이 명령어를 실행하면 프로젝트의 소스 코드와 의존성이 포함된 배포 가능한 패키지가 생성됩니다.

결론

Poetry는 파이썬 프로젝트의 의존성을 명확하게 관리하고 추적할 수 있는 강력한 도구입니다. 의존성 충돌 문제를 방지하고 일관된 환경을 유지할 수 있으며, 프로젝트의 빌드와 배포를 간편하게 처리할 수 있습니다. 자세한 내용은 Poetry 공식 문서를 참조하시기 바랍니다.