파이썬 프로젝트 패키지 관리와 의존성 관리, Poetry란?

 

📝 Poetry란?

Poetry는 파이썬 프로젝트의 패키지 관리와 의존성 관리, 그리고 패키지 배포까지 통합적으로 지원하는 도구입니다.
기존의 pip, virtualenv, setuptools, requirements.txt 등 여러 도구를 한데 통합한 올인원 솔루션이라 생각하시면 됩니다.

---

📦 주요 기능

기능 설명

의존성 관리	pyproject.toml 파일을 통해 직관적으로 의존성 추가 및 잠금(lock) 가능
가상환경 자동 관리	프로젝트마다 자동으로 가상환경 생성 및 관리
패키징 간편화	간단한 명령어로 패키지 생성 및 배포 준비 가능
일관성 있는 환경 구성	poetry.lock 파일로 팀 간 환경 차이 최소화
버전 관리 지원	패키지의 버전 명세를 ^, ~ 등으로 유연하게 조절 가능

---

🛠️ Poetry 설치

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

설치 후 아래 명령어로 정상 설치 확인:

poetry --version

---

⚙️ 기본 사용법

1. 새 프로젝트 생성

poetry new my_project

2. 기존 프로젝트에 Poetry 초기화

poetry init

3. 의존성 추가

poetry add requests

4. 개발용 의존성 추가

poetry add --dev black

5. 가상환경 진입

poetry shell

6. 가상환경에서 명령 실행

poetry run python main.py

---

✅ Poetry의 장점 요약

• 복잡한 환경 설정 없이 한 줄 명령어로 통합 관리
• requirements.txt 없이도 안정적인 의존성 관리
• 프로젝트별 독립된 가상환경 자동 관리
• 최신 파이썬 표준인 PEP 518, 517 기반으로 설계

---

원하시면 간단한 실습 예제나 형성평가 문제도 함께 제공드릴 수 있어요. 어떤 방식으로 학습을 이어가고 싶으신가요? 😊