Poetry 종속성 관리: 현대적인 Python 패키지 관리

다재다능하고 널리 사용되는 프로그래밍 언어인 Python은 방대한 라이브러리 및 패키지 생태계를 기반으로 발전합니다. 이러한 종속성을 효과적으로 관리하는 것은 프로젝트 성공에 매우 중요하며, 바로 이 지점에서 Poetry와 같은 도구가 등장합니다. 이 블로그 게시물은 현대적인 Python 종속성 관리 및 패키징 도구인 Poetry를 심층적으로 탐구하며, 그 기능, 이점, 그리고 전 세계 개발자들을 위해 Python 개발을 어떻게 단순화하는지 살펴봅니다.

Python 종속성 관리의 과제

Poetry에 뛰어들기 전에, 전통적인 Python 종속성 관리의 과제를 이해하는 것이 중요합니다. 역사적으로 개발자들은 패키지 설치를 위해 pip에, 프로젝트 종속성 목록화를 위해 requirements.txt 파일에 의존하는 경우가 많았습니다. 그러나 이 접근 방식은 다음과 같은 어려움을 자주 초래했습니다:

• 종속성 충돌: 서로 다른 패키지가 동일한 종속성의 다른 버전을 요구하는 경우가 많습니다. 이러한 충돌을 수동으로 관리하는 것은 지루하고 오류가 발생하기 쉬워 "종속성 지옥"과 같은 문제로 이어질 수 있습니다.
• 재현성 문제: 다른 기기 및 개발 단계에서 일관된 환경을 생성하는 것은 어려울 수 있습니다. virtualenv와 같은 도구가 도움이 되었지만, 여전히 수동 관리가 필요했습니다.
• 패키징 및 배포 복잡성: Python 패키지를 PyPI(Python Package Index)에 패키징하고 배포하는 것은 전통적으로 setup.py 또는 setup.cfg 파일 설정 등 여러 수동 단계를 포함했습니다.
• 버전 관리의 어려움: 패키지 버전을 정확하게 추적하고 관리하는 것은 복잡할 수 있으며, 잠재적인 호환성 문제로 이어질 수 있습니다.

이러한 과제들은 Poetry가 해결하는 Python 종속성 관리에 대한 더욱 견고하고 간소화된 접근 방식의 필요성을 강조합니다.

Poetry 소개: 현대적인 해결책

Poetry는 이러한 과제에 대한 포괄적인 해결책을 제공하는 종속성 관리 도구입니다. 종속성 해결, 가상 환경 관리, 패키지 빌드/배포를 모두 하나의 간소화된 워크플로우로 처리합니다. 주요 기능은 다음과 같습니다:

• 선언적 종속성 관리: Poetry는 pyproject.toml 파일(PEP 518에 의해 표준화됨)을 사용하여 프로젝트 종속성 및 메타데이터를 선언합니다. 이 파일은 모든 프로젝트 관련 정보에 대한 단일 진실 공급원 역할을 합니다.
• 종속성 해결: Poetry의 종속성 해결기는 종속성과 그 하위 종속성의 최적 버전을 효율적으로 결정하여 호환성을 보장합니다.
• 가상 환경 관리: Poetry는 각 프로젝트에 대한 가상 환경을 자동으로 관리하여 종속성을 격리하고 충돌을 방지합니다.
• 패키징 및 배포: Poetry는 Python 패키지를 PyPI 또는 기타 패키지 저장소에 빌드하고 배포하는 과정을 간소화합니다.
• 잠금 파일: Poetry는 설치된 모든 종속성의 정확한 버전을 명시적으로 나열하는 poetry.lock 파일을 생성합니다. 이 파일은 다른 환경 간의 재현성을 보장하고 예기치 않은 버전 업데이트를 방지합니다.
• 간소화된 명령어: Poetry는 종속성 관리, 테스트 실행 및 패키지 빌드를 위한 직관적인 명령어를 갖춘 사용자 친화적인 명령줄 인터페이스(CLI)를 제공합니다.

Poetry 시작하기

Poetry 설치는 간단합니다. Python 패키지 설치 도구인 pip를 사용할 수 있습니다. 관리자 권한이 필요하거나 시스템 패키지와의 충돌을 방지하기 위해 Poetry를 사용자 환경에 설치하는 것이 일반적으로 권장됩니다.

pip install poetry

설치 후, Poetry 버전 확인을 통해 올바르게 설치되었는지 확인하십시오:

poetry --version

이 명령어는 설치된 Poetry 버전을 출력하여 정상 작동함을 확인시켜 줍니다. 출력은 다음과 같을 수 있습니다:

Poetry (version 1.7.0)

새 프로젝트 생성

Poetry를 사용하여 새 Python 프로젝트를 생성하려면, 원하는 디렉토리로 이동하여 다음 명령어를 실행하십시오:

poetry new my-project

이 명령어는 my-project라는 새 디렉토리를 생성하고, pyproject.toml 파일, poetry.lock 파일, 그리고 프로젝트의 기본 디렉토리 구조(예: 소스 코드를 포함하는 src 디렉토리, 또는 패키지를 포함하는 my_project 디렉토리)를 가진 새 Python 프로젝트를 초기화합니다. 패키지 이름으로 명명되지 않은 프로젝트의 경우, Poetry는 src 디렉토리를 자동으로 생성하지 않고, 프로젝트와 동일한 이름을 가진 패키지를 생성합니다. pyproject.toml 파일에는 프로젝트 이름, 버전 및 Python 버전 제약 조건과 같은 기본 프로젝트 정보가 포함됩니다.

종속성 추가

Poetry를 사용하면 종속성 추가가 간단합니다. package-name을 설치하려는 패키지 이름으로 바꿔 다음 명령어를 사용하십시오:

poetry add package-name

예를 들어, 인기 있는 requests 라이브러리를 설치하려면 다음을 실행하십시오:

poetry add requests

Poetry는 종속성을 자동으로 해결하고, 프로젝트의 가상 환경 내에 패키지를 설치하며, pyproject.toml 및 poetry.lock 파일을 업데이트합니다.

종속성 설치

pyproject.toml 파일에 정의된 모든 종속성을 설치하려면, 프로젝트 디렉토리로 이동하여 다음을 실행하십시오:

poetry install

이 명령어는 pyproject.toml에 나열된 모든 종속성을 설치하고 poetry.lock 파일을 생성하거나 업데이트합니다.

가상 환경 내에서 명령어 실행

프로젝트의 가상 환경 내에서 명령어를 실행하려면 poetry run 명령어를 사용하십시오. 예를 들어:

poetry run python my_script.py

이 명령어는 프로젝트의 가상 환경 내에서 Python 스크립트(my_script.py)를 실행하여, 설치된 종속성에 접근할 수 있도록 보장합니다.

Poetry 프로젝트의 주요 파일

Poetry 프로젝트의 주요 파일을 이해하는 것은 효과적인 관리를 위해 중요합니다:

• pyproject.toml: 이 파일은 Poetry 프로젝트의 핵심입니다. 프로젝트 메타데이터(이름, 버전, 저자, 설명 등)와 종속성 및 그 버전 목록을 포함합니다. 이 파일은 TOML(Tom's Obvious, Minimal Language) 형식을 사용합니다.
• poetry.lock: 이 파일은 잠금 파일 역할을 합니다. 설치된 모든 종속성과 그 하위 종속성의 정확한 버전을 나열합니다. 잠금 파일은 프로젝트에 참여하는 모든 개발자 또는 프로젝트를 실행하는 머신이 동일한 종속성 버전을 사용하도록 보장하여 모든 환경에서 프로젝트를 일관되고 재현 가능하게 만듭니다.
• 가상 환경 디렉토리: Poetry는 각 프로젝트에 대한 가상 환경을 생성하고 관리하며, 일반적으로 프로젝트 디렉토리 내의 .venv(기본값이며, 구성 가능)에 위치합니다. 이 디렉토리는 프로젝트 종속성을 시스템 전체 Python 설치와 격리합니다.

Poetry를 이용한 종속성 관리: 실용적인 예제

Poetry를 사용하여 종속성을 관리하는 방법을 설명하기 위해 몇 가지 실용적인 예제를 살펴보겠습니다.

특정 버전의 패키지 추가

특정 버전의 패키지를 지정하려면 poetry add 명령어에 버전 제약 조건을 포함하십시오. 예를 들어, requests 라이브러리 버전 2.2.1을 설치하려면 다음을 사용하십시오:

poetry add requests==2.2.1

이 명령어는 지정된 정확한 버전을 설치하고 pyproject.toml 및 poetry.lock을 모두 업데이트합니다.

개발 또는 테스트용 패키지 추가

Poetry를 사용하면 pytest와 같은 테스트 프레임워크나 flake8과 같은 린터처럼 개발 또는 테스트 중에만 필요한 종속성을 지정할 수 있습니다. 개발 종속성으로 패키지를 추가하려면 --group 플래그를 사용하십시오:

poetry add pytest --group dev

이 명령어는 pytest를 개발 환경에만 포함하며, 프로젝트를 배포할 때 패키징되지 않습니다. 테스트, 문서 등과 같이 다양한 개발 또는 테스트 요구사항에 따라 다른 그룹을 사용할 수 있습니다.

예를 들어, 테스트를 위한 종속성이 필요한 경우 "test" 그룹에 추가할 수 있습니다:

poetry add pytest --group test

poetry add coverage --group test

그런 다음, 테스트를 실행할 때 먼저 가상 환경을 활성화하고, 다른 Python 프로젝트에서와 마찬가지로 필요에 따라 테스트를 실행합니다. 이는 종종 CI/CD 파이프라인이나 테스트 절차와 같은 스크립트에서 처리됩니다.

종속성 업데이트

종속성을 최신 호환 버전으로 업데이트하려면 다음을 실행하십시오:

poetry update

이 명령어는 종속성을 해결하고 pyproject.toml 및 poetry.lock을 업데이트합니다.

또는 특정 패키지를 업데이트할 수 있습니다:

poetry update requests

종속성 제거

패키지를 제거하려면 poetry remove 명령어 뒤에 패키지 이름을 사용하십시오:

poetry remove requests

이 명령어는 프로젝트에서 패키지를 제거하고 pyproject.toml 및 poetry.lock 파일을 업데이트합니다.

Poetry로 Python 패키지 빌드 및 배포

Poetry는 Python 패키지를 빌드하고 배포하는 과정을 간소화합니다. 관련 단계는 다음과 같습니다:

패키지 빌드

패키지를 빌드하려면 다음 명령어를 사용하십시오:

poetry build

이 명령어는 dist 디렉토리에 배포 가능한 아카이브(.tar.gz 파일 및 .whl 파일)를 생성합니다. 이 파일들은 패키지의 소스 코드와 메타데이터를 포함하며 배포 준비가 완료됩니다.

PyPI에 패키지 배포

PyPI에 배포하기 전에, PyPI 자격 증명(사용자 이름 및 비밀번호)을 등록하고 설정해야 합니다. 그런 다음 다음을 실행하십시오:

poetry publish

Poetry는 PyPI 사용자 이름과 비밀번호를 요청한 다음, 패키지를 PyPI에 업로드합니다. PyPI API 토큰을 설정해야 할 수도 있습니다.

또는 프로젝트를 비공개 패키지 서버와 같은 사용자 지정 저장소에 배포할 수 있습니다. --repository 옵션으로 저장소를 지정할 수 있습니다:

poetry publish --repository my-private-repo

Poetry 사용의 이점

Poetry는 Python 개발자에게 수많은 이점을 제공합니다:

• 간소화된 종속성 관리: Poetry는 종속성 해결, 버전 관리, 가상 환경 관리를 단순화합니다.
• 재현성: poetry.lock 파일은 모든 개발자와 환경이 정확히 동일한 패키지 버전을 사용하도록 보장하여 배포의 신뢰성을 높입니다.
• 사용 편의성: CLI는 직관적이며 Python 패키지 관리가 처음인 개발자도 쉽게 배울 수 있습니다.
• 간소화된 패키징 및 배포: Poetry는 PyPI에 패키지를 빌드하고 배포하는 과정을 단순화합니다.
• 향상된 프로젝트 구조: Poetry는 모범 사례를 장려하는 잘 정의된 프로젝트 구조를 촉진합니다.
• 종속성 격리: Poetry의 가상 환경 처리는 시스템 패키지 및 다른 프로젝트와의 충돌을 방지합니다.
• 단일 진실 공급원: pyproject.toml 파일은 프로젝트, 메타데이터 및 종속성을 구성하는 단일 장소 역할을 합니다.
• 종속성 지옥 감소: Poetry는 종속성 충돌을 자동으로 해결하여 종속성 관리를 더 쉽게 만듭니다.

전 세계적 영향 및 채택

Poetry의 사용자 친화적인 디자인과 강력한 기능 세트는 전 세계 Python 개발자들 사이에서 인기가 높아지는 데 기여했습니다. 크고 작은 많은 Python 개발자들에게 표준 도구가 되었습니다. 패키지를 쉽게 관리하고 배포하는 기능은 다음을 포함하되 이에 국한되지 않는 다양한 지역의 개발자들에게 이점을 제공합니다:

• 북미: 미국, 캐나다, 멕시코의 기업과 오픈소스 개발자들이 모든 규모의 프로젝트에 Poetry를 채택했습니다.
• 유럽: 유럽 연합, 영국 및 기타 유럽 국가의 개발자들이 종속성 관리 및 Python 패키지 빌드를 위해 Poetry를 사용합니다.
• 아시아: 인도에서 일본, 그리고 동남아시아 전역에 걸쳐 기업, 정부 기관 및 개별 개발자들이 Poetry를 사용하여 종속성을 효과적으로 관리하고 있습니다.
• 남미: 브라질, 아르헨티나, 콜롬비아와 같은 국가의 개발자들이 Poetry를 수용하고 있습니다.
• 아프리카: 아프리카 국가의 점점 더 많은 개발자들이 Poetry를 사용하고 있으며, 이는 Poetry의 전 세계적인 확장을 더욱 증명합니다.
• 호주 및 뉴질랜드: 호주 및 뉴질랜드의 Python 개발자들도 Poetry가 워크플로우를 간소화하는 능력으로부터 이점을 얻고 있습니다.

다양한 대륙에 걸친 Poetry의 채택은 그 다용성, 사용 편의성, 그리고 Python 개발의 일반적인 문제를 해결하는 능력을 반영합니다. 이러한 전 세계적 채택은 재현성, 간소화된 프로젝트 설정, 효율적인 종속성 관리에 대한 필요성에 의해 주도됩니다.

Poetry 사용을 위한 모범 사례 및 팁

Poetry의 이점을 극대화하려면 다음 모범 사례를 고려하십시오:

• pyproject.toml 및 poetry.lock 커밋: 환경 간 일관성을 보장하기 위해 항상 pyproject.toml 및 poetry.lock 파일을 버전 관리 시스템(예: Git)에 커밋하십시오.
• 가상 환경 사용: 프로젝트 종속성을 격리하기 위해 항상 Poetry 관리 가상 환경 내에서 작업하십시오.
• 정기적인 종속성 업데이트: poetry update를 주기적으로 실행하여 종속성을 최신 상태로 유지하고, 변경 사항에 주의하십시오.
• 철저한 테스트: 호환성을 보장하기 위해 종속성을 업데이트한 후 프로젝트를 철저히 테스트하십시오.
• 버전 제약 조건 지정: 설치를 허용할 패키지 버전을 제어하기 위해 pyproject.toml 파일에 적절한 버전 제약 조건을 사용하십시오.
• 종속성 그룹 이해: 개발/테스트에 필요한 종속성과 런타임 환경에 필요한 종속성을 분리하기 위해 종속성 그룹(예: dev, test)을 활용하십시오.
• Poetry 명령어 활용: 워크플로우를 간소화하기 위해 Poetry 명령어(예: poetry add, poetry remove, poetry run, poetry build, poetry publish)의 전체 범위를 숙지하십시오.
• 시맨틱 버저닝(SemVer) 사용: 종속성 관리를 돕고 프로젝트 내에서 좋은 관행을 장려하기 위해 SemVer(시맨틱 버저닝) 지침을 따르십시오.
• 보안 취약점 확인: 특히 공개적으로 사용 가능하거나 민감한 데이터와 함께 작동하는 프로젝트의 경우, 종속성의 보안 취약점을 확인하는 도구 또는 관행을 통합하는 것을 고려하십시오.

다른 Python 종속성 관리자와의 비교

pip과 virtualenv는 Python 개발의 기본 도구이지만, Poetry는 종속성 관리 및 패키징에 상당한 이점을 제공합니다. 다음은 비교입니다:

기능	Poetry	pip + virtualenv
종속성 해결	예 (고급 해결기)	아니요 (수동 관리 필요)
가상 환경 관리	자동	수동 (virtualenv를 통해)
종속성 선언	pyproject.toml	requirements.txt (덜 구조화됨)
잠금 파일	예 (poetry.lock)	아니요 (수동 생성 필요)
패키징 및 배포	통합됨	수동 (setup.py 등을 통해)
사용 편의성	높음 (직관적인 CLI)	중간 (더 많은 수동 단계)

Pip 및 virtualenv와 비교하여, Poetry는 특히 대규모 프로젝트에 대해 훨씬 더 통합되고 간소화된 개발 경험을 제공하며, 프로젝트 종속성에 대한 단일 진실 공급원을 제공합니다. Pip이 기본 패키지 관리자인 반면, Poetry의 종속성 관리 및 패키징 기능은 완벽한 솔루션을 제공합니다.

결론: Poetry로 현대적인 Python 개발을 수용하세요

Poetry는 프로젝트 설정, 종속성 해결 및 패키지 빌드를 단순화하는 포괄적이고 사용자 친화적인 도구를 제공함으로써 Python 종속성 관리에 혁명을 일으켰습니다. 전 세계 Python 개발자들의 채택은 워크플로우 간소화, 일관성 보장 및 전반적인 개발 경험 개선에 있어 그 가치를 입증합니다. Poetry를 수용함으로써 Python 프로젝트를 향상시키고 현대적인 Python 개발 혁명에 동참할 수 있습니다.

노련한 Python 개발자이든 이제 막 여정을 시작하는 개발자이든, Poetry를 워크플로우에 통합하면 생산성을 크게 향상시키고, 종속성 관련 문제를 줄이며, 더욱 견고하고 재현 가능한 Python 프로젝트를 만들 수 있습니다. Python 생태계가 계속 발전함에 따라 Poetry와 같은 도구는 전 세계적으로 효율적이고 신뢰할 수 있는 소프트웨어 개발 관행을 지원하는 데 중요한 역할을 할 것입니다.

Python 프로젝트에 Poetry를 통합하고 현대적인 Python 종속성 관리의 이점을 경험해 보십시오.