skill-fastapi-api

/skill-fastapi-api

Padrões DARE para APIs REST em Python + FastAPI + Pydantic v2 + SQLAlchemy 2.0 async. Routers, dependency injection, schemas Pydantic, OAuth2+JWT, slowapi rate limit, pytest+httpx, OpenAPI auto-gerado.

Como usar

/skill-fastapi-api                          # audita projeto FastAPI
/skill-fastapi-api scaffold users           # gera router + service + repo + schemas
/skill-fastapi-api migrate-validation       # extrai validação manual para Pydantic

Stack canônica

• Python 3.11+ com type hints obrigatórios
• FastAPI 0.115+ (async/await)
• Pydantic v2
• SQLAlchemy 2.0 async + asyncpg
• alembic (migrations)
• passlib + argon2
• python-jose ou PyJWT
• slowapi (rate limit)
• pytest + pytest-asyncio + httpx
• ruff + mypy

Estrutura

app/
├── main.py
├── core/{config.py, security.py}
├── api/{deps.py, v1/{users.py, auth.py}}
├── services/
├── repositories/
├── models/        ← SQLAlchemy ORM
├── schemas/       ← Pydantic DTOs
└── tests/

Router (Handler)

@router.post("/users", response_model=UserOut, status_code=201)
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(409, "User already exists")

Schemas (Pydantic v2)

class UserCreate(BaseModel):
    email: EmailStr
    name: str = Field(min_length=1, max_length=255)
    password: str = Field(min_length=12)

class UserOut(BaseModel):
    id: int
    email: EmailStr
    name: str
    created_at: datetime
    model_config = {"from_attributes": True}

Service

class RegisterUser:
    def __init__(self, repo: UsersRepository = Depends()):
        self.repo = repo

    async def execute(self, payload: UserCreate) -> User:
        if await self.repo.exists_by_email(payload.email):
            raise UserAlreadyExistsError()
        return await self.repo.create(
            email=payload.email,
            name=payload.name,
            password_hash=hash_password(payload.password),
        )