[python] Poetry를 사용하여 파이썬 프로젝트의 소스 코드 관리를 통해 여러 개발자와의 협업을 용이하게 할 수 있습니다.

04 Dec 2023

python

소개

Poetry는 파이썬 프로젝트의 소스 코드 관리 및 의존성 관리를 용이하게 하는 도구입니다. Poetry를 사용하면 프로젝트를 여러 개발자와 협업할 때 코드 관리와 패키지 의존성 문제를 효과적으로 해결할 수 있습니다.

Poetry의 장점

가상 환경 관리: Poetry는 Python 가상 환경을 손쉽게 생성하고 관리할 수 있습니다. 프로젝트마다 독립된 가상 환경을 사용하여 의존성 충돌을 방지하고 프로젝트의 격리를 유지할 수 있습니다.
의존성 관리: Poetry는 프로젝트의 의존성을 관리하는데 특화되어 있습니다. pyproject.toml 파일을 통해 의존성을 명시하고 자동으로 관리해 주기 때문에 의존성 버전 충돌 문제를 줄일 수 있습니다.
배포 관리: Poetry는 프로젝트의 배포를 쉽게 관리할 수 있도록 도와줍니다. 패키지 버전을 관리하고, 패키지를 빌드하고, PyPi에 업로드하는 등의 작업을 Poetry 명령어를 통해 간편하게 수행할 수 있습니다.
문서화: Poetry는 프로젝트의 문서화를 용이하게 해 줍니다. 프로젝트에 포함된 패키지의 문서화를 자동으로 생성하고 관리할 수 있습니다.

Poetry 사용하기

Poetry 설치하기: Poetry를 사용하기 위해서는 먼저 Poetry를 설치해야 합니다. 다음 명령어를 사용하여 Poetry를 설치할 수 있습니다.
```
$ pip install poetry
```
프로젝트 초기화하기: Poetry를 사용하여 프로젝트를 관리하기 위해서는 프로젝트를 초기화해야 합니다. 아래의 명령어를 사용하여 프로젝트를 초기화할 수 있습니다.
```
$ poetry init
```
의존성 추가하기: 프로젝트의 의존성을 추가하려면 pyproject.toml 파일을 수정해야 합니다. 다음은 requests 패키지를 의존성으로 추가하는 예시입니다.
```
[tool.poetry.dependencies]
python = "^3.9"
requests = "^2.25.1"
```
가상 환경 생성하기: Poetry를 사용하여 가상 환경을 생성할 수 있습니다. 아래의 명령어를 사용하여 가상 환경을 생성합니다.
```
$ poetry install
```
가상 환경 활성화하기: 가상 환경을 활성화하여 프로젝트를 실행하려면 다음 명령어를 실행합니다.
```
$ poetry shell
```
패키지 배포하기: Poetry를 사용하여 프로젝트의 패키지를 배포할 수 있습니다. 다음 명령어를 사용하여 패키지를 빌드하고 PyPi에 업로드합니다.
```
$ poetry build
$ poetry publish
```

마무리

Poetry는 파이썬 프로젝트의 소스 코드 관리 및 의존성 관리를 효율적으로 수행할 수 있는 도구입니다. 협업 환경에서 여러 개발자가 작업하는 경우에도 의존성 충돌과 관련된 문제를 최소화하고, 배포 과정을 간편하게 관리할 수 있습니다. 이제 Poetry를 사용하여 프로젝트의 관리를 시작해보세요!

참고: Poetry 공식 문서