🚀 FastAPI + uv 로 Todo App API 만들기 (가장 깔끔한 방법!)

Source: Dev.to

Introduction

번개처럼 빠른 API를 Python 패키징 혼란 없이 만들고 싶으신가요?
이 가이드에서는 FastAPI와 uv를 사용해 Todo API를 만들 것입니다. uv는 가상 환경을 자동으로 관리하고, 의존성 해결을 처리하며, 여러분의 작업을 방해하지 않는 차세대 Python 패키지 매니저입니다.

What is uv?

uv는 pip과 virtualenv를 대체하는 현대적인 Python 패키지 매니저로, 다음을 제공합니다:

• 🚀 초고속 의존성 설치
• 📦 자동 가상 환경 생성
• 🧼 requirements.txt 없이 깔끔한 프로젝트 설정

Rust로 구현되어 빠르고 재현 가능한 Python 워크플로에 최적화되어 있습니다—API, CLI 도구, 데이터 앱에 안성맞춤입니다.

Project Setup

mkdir fastapi-todo && cd fastapi-todo
uv init --app
uv add fastapi --extra standard

Define the data model (models.py)

# models.py
from pydantic import BaseModel

class Todo(BaseModel):
    id: int
    title: str
    completed: bool = False

Build the FastAPI application (main.py)

# main.py
from fastapi import FastAPI, HTTPException
from models import Todo

app = FastAPI()
todos: list[Todo] = []

@app.get("/")
def home():
    return {"message": "Welcome to the FastAPI Todo App"}

@app.get("/todos")
def list_todos():
    return todos

@app.post("/todos", status_code=201)
def add_todo(todo: Todo):
    if any(t.id == todo.id for t in todos):
        raise HTTPException(status_code=400, detail="Todo with this ID already exists.")
    todos.append(todo)
    return todo

@app.put("/todos/{todo_id}")
def update(todo_id: int, updated: Todo):
    for i, t in enumerate(todos):
        if t.id == todo_id:
            todos[i] = updated
            return updated
    raise HTTPException(status_code=404, detail="Todo not found")

@app.delete("/todos/{todo_id}")
def delete(todo_id: int):
    global todos
    todos = [t for t in todos if t.id != todo_id]
    return {"message": "Todo deleted"}

Run the application

uv run fastapi dev

서버는 http://127.0.0.1:8000에서 시작됩니다.
Explore the interactive API docs at .