Repolode
Enviar
zhanymkanov

zhanymkanov/fastapi-best-practices

Boas práticas e convenções opinativas para criar aplicações FastAPI prontas para produção, com base na experiência em startups.

Ver no GitHub
Estrelas
18,217
Forks
1,329
Issues abertas
16
Último commit
há 2 meses

O que é?

Este guia reúne convenções opinativas para criar backends FastAPI em produção. Ele aborda como estruturar um monólito com vários domínios, quando usar rotas e dependências async ou sync, como organizar modelos e configurações do Pydantic e como encadear dependências para validação e reutilização.

O guia também trata de dados e ferramentas: design de consultas SQL-first, regras para migrações do Alembic, convenções de nomenclatura de banco de dados, quando usar BackgroundTasks em vez de uma fila de tarefas de verdade, como controlar a visibilidade da documentação da API e como escrever testes de integração async com httpx e overrides de dependências. A maioria das seções inclui exemplos de código.

O conteúdo é voltado a desenvolvedores Python que já conhecem FastAPI e querem orientações para manter a estrutura do projeto e evitar armadilhas comuns, como bloquear o event loop ou usar BackgroundTasks de forma inadequada. Um arquivo AGENTS.md complementar apresenta as mesmas regras em um formato legível por máquina para agentes de programação com IA.

Recursos principais

  • 01Orientações sobre a estrutura do projeto para organizar um monólito em módulos por domínio.
  • 02Explicações sobre quando rotas e dependências sync e async são executadas em um thread pool.
  • 03Padrões para encadear e armazenar em cache dependências usadas na validação de requisições.
  • 04Convenções de Pydantic, incluindo um modelo base personalizado e a separação de BaseSettings.
  • 05Orientações sobre consultas SQL-first, migrações do Alembic e nomenclatura de banco de dados.
  • 06Configuração de testes com clientes async do httpx e dependency_overrides, além do ruff para lint e formatação.

Casos de uso

  • Estruturar um monólito FastAPI em expansão, com vários domínios e módulos.
  • Integrar desenvolvedores às convenções FastAPI da equipe.
  • Revisar escolhas entre async e sync para evitar bloquear o event loop.
  • Fornecer regras FastAPI consistentes a agentes de programação com IA por meio do AGENTS.md.

Antes de usar

  • Nenhuma licença está especificada nos metadados do projeto.

Tópicos

#fastapi#python#best-practices#pydantic#sqlalchemy#async#backend-architecture

Perguntas frequentes

O que é fastapi-best-practices?
Boas práticas e convenções opinativas para criar aplicações FastAPI prontas para produção, com base na experiência em startups. Este guia reúne convenções opinativas para criar backends FastAPI em produção. Ele aborda como estruturar um monólito com vários domínios, quando usar rotas e dependências async ou sync, como organizar modelos e configurações do Pydantic e como encadear dependências para validação e reutilização.
fastapi-best-practices é gratuito? Qual é a licença?
fastapi-best-practices não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
fastapi-best-practices ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de fastapi-best-practices foi em 27 de ago. de 2026.
Para que posso usar fastapi-best-practices?
Estruturar um monólito FastAPI em expansão, com vários domínios e módulos. Integrar desenvolvedores às convenções FastAPI da equipe. Revisar escolhas entre async e sync para evitar bloquear o event loop. Fornecer regras FastAPI consistentes a agentes de programação com IA por meio do AGENTS.md.
Onde consigo fastapi-best-practices?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/zhanymkanov/fastapi-best-practices

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados