DEV Community

Jackson Pires for Vídeos de Ti

Posted on

🇧🇷 Apresentando Rails HTTP Lab: teste rotas Rails diretamente dentro da sua aplicação

Quem trabalha com Ruby on Rails sabe que testar endpoints HTTP faz parte da rotina de desenvolvimento.

Na maioria das vezes usamos ferramentas como Postman, Insomnia, curl ou até scripts temporários apenas para validar requests, headers, payloads e responses.

Mas durante o desenvolvimento eu comecei a me perguntar:

E se fosse possível testar as rotas da própria aplicação Rails diretamente de dentro dela?

Foi dessa ideia que nasceu o Rails HTTP Lab.

Rails HTTP Lab

O que é o Rails HTTP Lab?

rails-http-lab é uma Rails Engine que adiciona uma interface integrada à sua aplicação para testar requisições HTTP contra as próprias rotas da aplicação.

Pense nele como um cliente HTTP leve, mas focado no seu ambiente Rails.

Com ele você pode experimentar endpoints sem precisar alternar constantemente entre editor, terminal, navegador e ferramentas externas de API.

Funcionalidades

Atualmente a gem oferece:

  • Suporte aos principais verbos HTTP
  • Envio de parâmetros e payloads
  • Visualização das responses diretamente no navegador
  • Rails Engine mountável
  • Integração natural com o fluxo de desenvolvimento Rails
  • Configuração simples

Instalação

Adicione a gem ao seu Gemfile:

gem "rails-http-lab"
Enter fullscreen mode Exit fullscreen mode

Depois instale:

bundle install
Enter fullscreen mode Exit fullscreen mode

Agora basta iniciar o servidor Rails e acessar:

/rails/http-lab
Enter fullscreen mode Exit fullscreen mode

Pronto. Você já pode começar a testar suas rotas.

Por que criar isso?

Eu queria algo mais integrado à experiência de desenvolvimento com Rails.

Ferramentas externas de API são excelentes, mas às vezes você só precisa de uma forma rápida de:

  • testar um endpoint
  • ajustar parâmetros
  • inspecionar responses
  • validar o comportamento do controller

…sem sair do contexto da própria aplicação.

O Rails HTTP Lab surgiu justamente para reduzir esse atrito.

Open Source e feedback são bem-vindos

O projeto é open source e ainda está evoluindo.

Se a ideia parece interessante, você tem sugestões ou quer contribuir, confira o repositório:

👉 https://github.com/jacksonpires/rails-http-lab

Issues, PRs, feedbacks e ideias são muito bem-vindos.

Happy coding 🚀

Agradecimento especial a Vini (https://github.com/viniwenz) e Karine (https://github.com/karinevieira) que me ajudaram nos testes!

Top comments (0)