파이썬 프로젝트를 개발하면서 의존성 관리와 버전 관리는 매우 중요합니다. 이를 위해 Poetry는 훌륭한 도구입니다. Poetry는 파이썬 패키지 관리자인 pip와는 조금 다른 방식으로 프로젝트 의존성을 관리하고 버전을 관리할 수 있습니다.

Poetry 설치하기

Poetry를 사용하기 위해서는 먼저 Poetry를 설치해야 합니다. Poetry를 설치하기 위해서는 다음 명령을 실행합니다.

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

또는 pip를 사용하여 설치할 수도 있습니다.

$ pip install poetry

Poetry로 프로젝트 초기화하기

Poetry를 설치한 후, 파이썬 프로젝트를 초기화할 수 있습니다. 프로젝트 디렉토리로 이동한 후 다음 명령을 실행합니다.

$ poetry init

이 명령을 실행하면 프로젝트의 기본 정보를 입력하게 됩니다. 프로젝트의 이름, 버전, 저자 등을 설정할 수 있습니다.

의존성 관리하기

Poetry는 프로젝트의 의존성을 관리하기 위해 pyproject.toml 파일을 사용합니다. 이 파일은 프로젝트 루트 디렉토리에 생성되며, 프로젝트의 의존성 및 버전 정보를 저장합니다.

의존성을 추가하기 위해서는 다음과 같은 명령을 사용합니다.

$ poetry add package_name

여기서 package_name은 프로젝트에 추가할 의존성의 패키지 이름입니다. Poetry는 의존성을 자동으로 설치하고 pyproject.toml 파일에 추가합니다.

가상환경 관리하기

Poetry를 사용하면 프로젝트를 위한 가상환경도 손쉽게 관리할 수 있습니다. 가상환경을 생성하기 위해서는 다음 명령을 사용합니다.

$ poetry shell

이 명령을 실행하면 프로젝트를 위한 독립적인 가상환경이 생성되며, 현재 쉘 세션에서 이 가상환경을 사용할 수 있습니다.

프로젝트 빌드하기

Poetry를 사용하여 프로젝트를 빌드할 수도 있습니다. 프로젝트를 빌드하기 위해서는 다음 명령을 사용합니다.

$ poetry build

이 명령을 실행하면 프로젝트를 패키지로 빌드하고, dist 디렉토리에 빌드된 패키지 파일이 생성됩니다.

버전 관리하기

Poetry를 사용하여 프로젝트의 버전을 관리할 수도 있습니다. 버전을 설정하기 위해서는 pyproject.toml 파일의 version 항목을 수정하면 됩니다.

Poetry는 프로젝트 버전을 Semantic Versioning 형식에 맞추어 관리합니다. 이를 통해 프로젝트의 버전을 명확하고 일관되게 관리할 수 있습니다.

결론

Poetry는 파이썬 프로젝트의 의존성 관리와 버전 관리를 편리하게 할 수 있는 도구입니다. Poetry를 사용하여 프로젝트를 개발하면 의존성 충돌과 버전 관리에 대한 걱정을 덜 수 있습니다. 프로젝트를 시작할 때부터 Poetry를 사용하여 의존성과 버전을 효과적으로 관리해보세요!

참고: Poetry 공식 문서