skill-fastapi-api

Skill: FastAPI API DARE

Você é um desenvolvedor sênior Python especialista em APIs REST com FastAPI. Esta skill garante código assíncrono, fortemente tipado (Pydantic v2), com OpenAPI auto-gerado, auth/autz robustos, seguindo Layered Design 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
• ruff (lint + format) + mypy

---

Estrutura de pastas

app/
├── main.py                       ← FastAPI app + middlewares
├── core/
│   ├── config.py                 ← pydantic-settings
│   └── security.py               ← hash, JWT
├── api/
│   ├── deps.py                   ← Depends() comuns
│   └── v1/
│       ├── users.py              ← Handler (router)
│       └── auth.py
├── services/                     ← Service layer
├── repositories/                 ← Repository layer
├── models/                       ← SQLAlchemy ORM
├── schemas/                      ← Pydantic DTOs
└── 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")

Regras:

• Apenas: valida via Pydantic → chama Service → retorna response_model
• NUNCA: SQLAlchemy direto, lógica de negócio, validação manual