GoFastAPI: a experiência do FastAPI, agora no ecossistema Go!
Ei Galera! Depois de muito pensar sobre a migração de Dev Python para Dev Go, sentindo falta da tão amada estrutura FastApi, descidi que a melhor maneira seria tendo uma ferramenta equivalente ao que eu já trabalhava em Python, para isso, estou criando o GoFastApi e conto com sua curiosidade!
E se pudéssemos unir a simplicidade e a produtividade de desenvolvimento do FastAPI (Python) com o desempenho, a concorrência e a eficiência do Go (Golang)?
Essa foi a ideia que deu origem ao GoFastAPI: um projeto que estou desenvolvendo com o objetivo de oferecer uma experiência de desenvolvimento inspirada no FastAPI, aproveitando os recursos nativos e a eficiência do ecossistema Go.
Repositório: https://github.com/Romario-Francisco-Soares/GoFastApi
Página: https://romario-francisco-soares.github.io/GoFastApi/
🚀 O que é o GoFastAPI?
O GoFastAPI é uma biblioteca para construção de APIs HTTP em Go, desenvolvida sobre o net/http e o runtime nativo da linguagem.
A proposta é reduzir a complexidade do desenvolvimento de APIs sem abrir mão da eficiência, da flexibilidade e do controle que Go proporciona.
A inspiração vem do FastAPI, um framework Python conhecido pela produtividade, organização e facilidade na construção de APIs.
A ideia não é simplesmente reproduzir sua sintaxe, mas trazer conceitos semelhantes para uma implementação idiomática em Go.
⚡ O que já temos?
O projeto já conta com diversos recursos para o desenvolvimento de aplicações HTTP:
- Roteamento HTTP: suporte a GET, POST, PUT, PATCH, DELETE e outros métodos.
- Contexto de requisição: acesso simplificado a parâmetros, query strings, headers, cookies e corpo das requisições.
- Injeção de dependências (DI): Singleton, Request e Transient.
- Middlewares: CORS, GZIP, Recovery, Timeout, Request ID, controle de concorrência e outros.
- Respostas HTTP: JSON, HTML, texto, arquivos, redirecionamentos e streams.
- Autenticação: API Key, HTTP Basic e HTTP Bearer.
- Sessões criptografadas: utilização de AES-GCM.
- OpenAPI 3.1: geração de documentação com Swagger UI e ReDoc.
- WebSocket: suporte a comunicação bidirecional.
- Background Tasks: execução de tarefas após o envio da resposta.
- Health Checks: endpoints de Liveness e Readiness.
- CLI integrada: comandos para execução, inspeção de rotas, documentação e saúde da aplicação.
Também existem testes de concorrência, testes de integração, fuzz testing e microbenchmarks.
📊 E quanto ao desempenho?
Uma das principais motivações do projeto é explorar até onde podemos chegar utilizando Go sem abrir mão de uma API de alto nível.
Realizei testes comparativos entre três abordagens:
- Go puro (
net/http); - GoFastAPI;
- FastAPI com Python e Uvicorn.
Em um cenário de benchmark HTTP controlado, os resultados de pico por núcleo foram:
| Implementação | Requisições/s |
|---|---|
| Go puro | 63.210 |
| GoFastAPI | 54.272 |
| FastAPI (Python) | 17.015 |
Nesse cenário específico, o GoFastAPI alcançou aproximadamente:
- Alto desempenho do Go puro;
- 3,2 vezes o throughput do FastAPI Python.
Os testes foram realizados em ambiente Linux, com 2 vCPUs efetivas e 4 GiB de RAM, utilizando HTTP/1.1 com Keep-Alive e um endpoint GET com resposta JSON pequena.
É importante destacar que esses números representam um cenário específico de benchmark, sem banco de dados, TLS, DI ou middlewares adicionais. Não representam uma garantia de desempenho para qualquer aplicação ou carga de trabalho.
O objetivo é continuar investigando e melhorando esses resultados.
🧠 Por que desenvolver algo assim?
Go já oferece ferramentas excelentes para construir servidores HTTP. Entretanto, quando trabalhamos com aplicações maiores, muitas vezes precisamos desenvolver estruturas adicionais para organizar rotas, gerenciar dependências, padronizar respostas e documentar endpoints.
Frameworks como FastAPI demonstram como uma boa abstração pode melhorar significativamente a experiência do desenvolvedor.
O GoFastAPI nasceu justamente dessa reflexão:
Será que podemos ter uma experiência de desenvolvimento semelhante à do FastAPI, aproveitando a eficiência e as características nativas do Go?
Essa é a proposta que estou buscando construir.
🔧 O projeto está em desenvolvimento!
Quero deixar claro que o GoFastAPI ainda está em desenvolvimento.
Já existem funcionalidades implementadas e testadas, mas ainda há diferenças em relação à paridade completa com FastAPI/Uvicorn.
Alguns recursos estão parcialmente implementados e outros ainda fazem parte dos próximos passos do projeto.
Prefiro apresentar o estado real da biblioteca, com suas