<aside>

</aside>

챕터 소개 🚀

자, 이제 이론은 충분히 배웠으니 직접 우리 손으로 Poetry 프로젝트를 만들어 볼 시간이에요! ✨ 이번 시간에는 poetry new 명령어를 사용해서 표준적인 파이썬 프로젝트 구조를 순식간에 만드는 방법을 배울 겁니다. 그리고 왜 요즘 파이썬 개발자들이 'src 레이아웃'이라는 구조를 선호하는지도 함께 알아볼게요.

챕터 목표 🎯

• poetry new와 poetry init 명령어의 차이점을 이해합니다.
• src 레이아웃이 무엇이며, 왜 권장되는 구조인지 설명할 수 있습니다.
• 프로젝트 내부에 가상환경을 생성하도록 Poetry 설정을 변경할 수 있습니다.
• 생성된 프로젝트 구조에 맞춰 간단한 FastAPI 앱 코드를 배치할 수 있습니다.

이번 챕터에서 사용되는 전체 코드 및 프로젝트 구조 📂

poetry new todo_api 명령어를 실행하면 아래와 같은 구조가 자동으로 만들어집니다. 우리는 src/todo_api/main.py 파일만 추가로 생성해 줄 거예요.

todo_api/
├── pyproject.toml
├── README.md
├── src/
│   └── todo_api/
│       ├── __init__.py
│       └── main.py  <-- 우리가 추가할 파일!
└── tests/
    └── __init__.py

src/todo_api/main.py

from fastapi import FastAPI

# FastAPI 애플리케이션 인스턴스를 생성합니다.
app = FastAPI()

# 루트 경로("/")로 GET 요청이 오면 이 함수를 실행합니다.
@app.get("/")
def read_root():
    return {"message": "Hello, Todo API!"}

강의 내용 📖

프로젝트 시작하기: new vs init

Poetry로 프로젝트를 시작하는 방법은 두 가지가 있어요: new와 init.

• poetry new <프로젝트_이름>: 추천! 👍 프로젝트 폴더부터 기본 파일 구조(pyproject.toml, src 폴더 등)까지 한 번에 자동으로 만들어줍니다. 처음 프로젝트를 시작할 때 가장 편리한 방법이에요. (Poetry)