Chapter 1-2 Poetry 설치 가이드

⚙️ Poetry 설치 가이드

1️⃣ Poetry 설치 전 주의사항

• Anaconda가 설치되어 있다면 삭제하거나 비활성화한 상태에서 설치할 것.
  • (Anaconda 가상환경이 활성화된 상태에서는 충돌 가능성 있음)
• pyenv 역시 비활성화 혹은 삭제 후 설치할 것.
• Homebrew로 설치하지 말 것.
  • 공식 설치 방식과 설정값이 다를 수 있어 권장하지 않음.

---

2️⃣ Poetry 소개 및 장점

🔗 공식 홈페이지: https://python-poetry.org/

• pip freeze 없이 자동으로 의존성 관리 (poetry.lock 생성)
• PEP 518 기반의 pyproject.toml로 프로젝트 통합 관리
  • 참고: PEP 518 문서
  • 예: black, isort, mypy, ruff, coverage, pytest 등의 설정을 한 곳에 관리
  • build.gradle처럼 의존성도 dev, prod로 나눌 수 있음
    • 📦 개발용: black, pytest
    • 🚀 배포용: fastapi, uvicorn
• pip보다 더 똑똑한 의존성 해결 알고리즘 제공 (참고 링크)

---

3️⃣ Poetry 설치 방법

📌 Python 버전 확인

python --version  # 예: Python 3.13

💻 macOS

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

 

🪟 Windows PowerShell

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - --version 1.8.5

---

🔁 설치 확인 & Recap

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

poetry --version

• Poetry를 통해 향후 프로젝트의 의존성을 명확하게 관리 가능.

 

---

🏗️ Project Init with PyCharm

✅ PyCharm에서 Poetry 프로젝트 시작하기

1. PyCharm Professional 실행
2. "New Project" 클릭 → Python 선택
3. "Poetry" 환경 선택 후 Python Interpreter 설정 (예: Python 3.13)
4. 프로젝트 경로 설정 및 Create 클릭

🔧 pyproject.toml 초기화

poetry init  # pyproject.toml 생성 마법사 실행

• 프로젝트 이름, 버전, 설명 등 입력
• 종속성(예: fastapi, requests 등)을 직접 입력하거나 스킵 가능

또는 빠르게 생성하려면:

poetry init --no-interaction

📦 종속성 추가 예시

poetry add fastapi uvicorn
poetry add --group dev black pytest

이제 프로젝트 디렉토리에 pyproject.toml과 poetry.lock 파일이 생기며, 명확한 버전 관리와 의존성 추적이 가능해집니다.

---

다음 단계에서는 Poetry 기반 프로젝트의 실행, 테스트, 배포 전략까지 이어서 다룰 예정입니다.