acalejos
Merquery - Interactive HTTP Toolkit Inspired by Postman
I’m excited to share Merquery, a new library I’m working on to bring interactive HTTP tooling to Elixir.
This project started off as a way to practice making Livebook Smart Cells, where I wanted to implement a Postman-Styled Smart Cell. As I made progress I realized that there’s a lot of potential in this tool for tighter integration with Elixir.
Merquery currently consists of 2 components:
MerquerySmart Cell that provides an interactive way to work with HTTP requests, akin to Postman- A
mixtask –mix merquery.generate– which introspects on your router and generatesMerquerysmart cells pre-filled with the information relevant to each route.
Merquery takes advantage of the Livebook ecosystem to have built in support for serialization and secret storage, so you can save queries for later usage and use keys from your Livebook Hub token vault.
It also can be used to generate source code just as all Smart Cells do. You can use Merquery as a learning tool to learn how to use Elixir HTTP clients.
The library is currently in its infancy, but below are some ideas I have going forward.
These are just some ideas for features I currently have, but are subject to change:
- Finish basic REST operations support
- Registering custom plugins
- Improve
mix merquery.generate- Allow customized parameters for routes, etc.
- Add Table of Contents at Top
- Migrate to TailwindCSS and distinctive design palette
- Req plugin discoverability - Host a location where Req plugins can be submitted for others to
discover for use withMerquery - Livebook routes instant deploy - Have a mix task (e.g.
mix merquery.deploy) to automatically
deploy the generated livebook frommix merquery.generate - Support other HTTP clients and their unique features (HTTPoison, Tesla, etc. )
- Move Vue to Composition API and breakout components to SPCs
Any feedback is much appreciated!
Most Liked
acalejos
I’ve added some more features to this as well as fixed several bugs. Currently still just on GitHub Main
Highlights:
- Import / export support with cURL thanks to the new CurlReq library
- Automatically add plugins to the setup cell rather than requiring you to copy / paste
- Variable input type so now you can param / header value to the value of an existing bound variable
Demos:
https://x.com/ac_alejos/status/1798180009300926797
https://x.com/ac_alejos/status/1798199529285779929
https://x.com/ac_alejos/status/1798920380704510460
jonatanklosko
@acalejos cool stuff!
Move Vue to Composition API and breakout components to SPCs
FTR we’ve recently started using an actual bundler setup in Kino and moved towards React for smart cells, with Tailwind. There is a @livebook/kino-bundler package that encapsulates the basic setup (including Livebook Tailwind config). You can see kino Remote execution cell or kino_bumblebee Task cell for examples. Still, the idea is that you can use whatever setup and framework you prefer, I am mentioning this just for completeness : )
krasenyp
Please, don’t say CRUD/REST. They’re not equivalent. Quite the opposite, actually.
linusdm
Awesome! A programmable postman. Very cool.
Having a mix task to side-load Livebook in any mix project would be useful. Maybe that could be solved generically, and not specifically for Merquery. I have projects that have some livemd files useful during development. Although Livebook desktop is super easy to set up, it would be even smoother to have a mix taks you could fire up, with a specific livebook loaded by default. Just thinking out loud here…
acalejos
Please, don’t say CRUD/REST. They’re not equivalent. Quite the opposite, actually.
Good point, not sure why I put CRUD. Probably typing too fast. Removed mention of it in the post 
FTR we’ve recently started using an actual bundler setup in Kino and moved towards React for smart cells, with Tailwind. There is a
@livebook/kino-bundlerpackage that encapsulates the basic setup (including Livebook Tailwind config). You can seekinoRemote execution cell orkino_bumblebeeTask cell for examples. Still, the idea is that you can use whatever setup and framework you prefer, I am mentioning this just for completeness : )
Thanks for the suggestion and all of the great work on Livebook! I already wanted to move to Tailwind and clean up the JS side, so I think that would be a good move. Looking at the repos you mentioned, it seems much cleaner.
Having a mix task to side-load Livebook in any mix project would be useful. Maybe that could be solved generically, and not specifically for Merquery. I have projects that have some livemd files useful during development. Although Livebook desktop is super easy to set up, it would be even smoother to have a mix taks you could fire up, with a specific livebook loaded by default. Just thinking out loud here…
Yeah that sounds like a more generic use case. Perhaps it would involve starting up a Remote Execution Cell
Awesome! A programmable postman. Very cool.
Glad you like it! Yeah, I think Req plugins offer an easy entry point for customizing it, and plan on leaning into them with this project.
Popular in Libraries
Other popular topics
Latest Phoenix Threads
Latest Livebook Threads
Latest on Elixir Forum
Sponsor Spotlight
The deployment platform built for Elixir: PaaS ease, VPS control.
Categories:
Sub Categories:
Forums
Our Sponsors
Build Elixir applications with speed and confidence.
Supporting innovation across the BEAM ecosystem.
We build reliable cloud platforms for business-critical systems.
Catch errors, track performance, monitor hosts and more.
Practical resources that improve the lives of professional developers.
Enabling companies to succeed by building software people love.
The deployment platform built for Elixir: PaaS ease, VPS control.
Courses that'll move you from confusion to "Aha, now I get it!"