파이썬 프로젝트를 관리하다 보면 패키지의 이름과 버전을 설정하고 의존성을 관리하는 일이 중요합니다. 이를 위해 Poetry를 사용할 수 있습니다. Poetry는 파이썬 패키지 관리 도구로, 편리한 인터페이스를 제공하면서 의존성을 자동으로 처리해 줍니다.
1. Poetry 설치하기
Poetry를 사용하기 위해서는 먼저 Poetry를 설치해야 합니다. 아래의 명령어를 사용하여 Poetry를 설치할 수 있습니다.
$ pip install poetry
2. 프로젝트 생성하기
Poetry로 새로운 프로젝트를 생성하기 위해서는 다음의 명령어를 실행합니다.
$ poetry new myproject
위 명령어를 실행하면 myproject라는 이름의 새로운 디렉토리가 생성되며, 해당 디렉토리로 이동합니다.
3. 패키지 정보 설정하기
패키지의 이름과 버전 정보를 Poetry에서 자동으로 가져오기 위해서는 pyproject.toml 파일을 수정해야 합니다. 이 파일은 프로젝트의 메타데이터와 의존성 정보를 가지고 있습니다.
아래는 pyproject.toml 파일의 예시입니다.
[tool.poetry]
name = "myproject"
version = "0.1.0"
[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
[tool.poetry.dependencies]
python = "^3.8"
requests = "^2.26.0"
위의 예시에서는 패키지의 이름을 “myproject”로, 버전을 “0.1.0”으로 설정하고 있습니다. 또한 의존성으로 “python”과 “requests” 패키지를 사용하고 있습니다.
4. 의존성 자동으로 가져오기
의존성을 설정한 후, Poetry를 사용하여 해당 의존성을 자동으로 가져올 수 있습니다. 아래의 명령어를 실행합니다.
$ poetry install
위 명령어를 실행하면 Poetry는 pyproject.toml 파일에 명시된 의존성을 검색하고, 필요한 패키지를 자동으로 다운로드하여 설치합니다.
5. 패키지 실행 및 관리
Poetry를 사용하여 패키지를 관리하면 여러 가지 작업을 편리하게 수행할 수 있습니다. 예를 들어, 패키지를 실행하려면 아래의 명령어를 사용합니다.
$ poetry run python main.py
또는 패키지의 가상 환경을 활성화하여 직접 실행할 수도 있습니다.
$ poetry shell
또한, 새로운 의존성을 추가하려면 pyproject.toml 파일을 수정하고, 다시 poetry install 명령어를 실행하여 업데이트할 수 있습니다.
6. 참고 자료
- Poetry 공식 문서: https://python-poetry.org/docs/
- GitHub 저장소: https://github.com/python-poetry/poetry
Poetry를 사용하여 파이썬 패키지의 이름과 버전을 설정하고 이를 통해 필요한 의존성을 자동으로 가져오는 방법에 대해 알아보았습니다. Poetry는 프로젝트 관리를 훨씬 편리하게 해주는 도구이므로, 실제 프로젝트에서 적극적으로 활용해 보시기 바랍니다.