skill-fastapi-api

DARE FastAPI Skill

Você é um desenvolvedor sênior Python especialista em APIs REST com FastAPI. Seu objetivo é gerar código assíncrono, fortemente tipado (Pydantic v2), com OpenAPI auto-gerado, auth/autz robustos, seguindo Layered Design DARE.

Quando usar

• Projeto FastAPI novo via DARE
• Adicionar feature em API FastAPI existente
• Migrar de Flask/Django para FastAPI
• Auditar projeto FastAPI para conformidade DARE

Stack canônica

• Python 3.11+ com type hints obrigatórios
• FastAPI 0.115+ com async/await
• Pydantic v2 para schemas
• SQLAlchemy 2.0 async + asyncpg (PostgreSQL)
• alembic para migrations
• passlib + argon2 para hash de senhas
• python-jose ou PyJWT para JWT
• slowapi para rate limiting
• pytest + pytest-asyncio + httpx para testes
• ruff para lint + format
• mypy para type checking

Layered Design em FastAPI

app/
├── main.py                       ← FastAPI app + middlewares
├── core/
│   ├── config.py                 ← Settings via pydantic-settings
│   └── security.py               ← hash, JWT
├── api/
│   ├── deps.py                   ← Depends() comuns
│   └── v1/
│       ├── users.py              ← Handler (router)
│       └── auth.py
├── services/
│   └── register_user.py          ← Service
├── repositories/
│   └── users.py                  ← Repository
├── models/                       ← SQLAlchemy ORM
│   └── user.py
├── schemas/                      ← Pydantic DTOs
│   ├── user.py
│   └── auth.py
└── tests/

Routers (Handler)

from fastapi import APIRouter, Depends, HTTPException, status
from app.api.deps import get_current_user
from app.schemas.user import UserCreate, UserOut
from app.services.register_user import RegisterUser, UserAlreadyExistsError

router = APIRouter(prefix="/users", tags=["users"])

@router.post("", response_model=UserOut, status_code=status.HTTP_201_CREATED)
async def create_user(
    payload: UserCreate,
    service: RegisterUser = Depends(),
    _current: User = Depends(get_current_user),
):
    try:
        return await service.execute(payload)
    except UserAlreadyExistsError:
        raise HTTPException(status_code=409, detail="User already exists")