acalejos

acalejos

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:

  • Merquery Smart Cell that provides an interactive way to work with HTTP requests, akin to Postman
  • A mix task – mix merquery.generate – which introspects on your router and generates Merquery smart 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 with Merquery
  • Livebook routes instant deploy - Have a mix task (e.g. mix merquery.deploy) to automatically
    deploy the generated livebook from mix 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!

Showing Posts 1 to 7

jonatanklosko

jonatanklosko

Creator of Livebook

@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

krasenyp

Please, don’t say CRUD/REST. They’re not equivalent. Quite the opposite, actually.

linusdm

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

acalejos OP

@krasenyp

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 :slight_smile:

@jonatanklosko

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 : )

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.

@linusdm

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.

acalejos

acalejos OP

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

acalejos

acalejos OP

Big update added support for request bodies, the last major missing component.

  • Supports x-wwww-form-urlencoded bodies
  • Supports Raw field to put custom payloads with support for syntax highlighting and prettification. Also supports custom Elixir code for the body.
  • Import and export cURL command supports new body payloads
  • Other UI bug fixes and improvements

Demos:
https://x.com/ac_alejos/status/1801811605123928566
https://x.com/ac_alejos/status/1801819740370878739

acalejos

acalejos OP

Added support for passthrough options and made a new, more comprehensive demo showcasing many of the newer features:

GitHub API Demo

— All posts loaded —

Where Next? Top

Trending in Announcing Top

achempion
Hi, I would like to tell about my initiative to further maintain and develop Waffle project which is the fork of Arc library. The progre...
New
mudasobwa
I fully migrated to my own harness from Anthropic/Gemini and I think it’s time to share it. Welcome DSH, the DeepSeek Harness, fully writ...
New
kip
Localize is the next generation localisation library for Elixir. Think of it as ex_cldr version 3.0. The first version will be released ...
New
jimsynz
Beam Bots (or just BB for short) is a framework for building fault-tolerant robotics applications in Elixir using familiar OTP patterns. ...
New
mcass19
ExRatatui lets you cook up rich terminal UIs in Elixir, powered by Rust’s ratatui via Rustler NIFs. Build interactive terminal applicatio...
New
danschultzer
I’ve moved the strategies out of PowAssent and created a multi-provider framework for Elixir. This way the strategies can be used in any ...
New
gtcode
Aloha gang, There’s a new class of AI model out from TypeSafe. Jev is their flagship model. You can learn about it here: ...
New

Other Trending Topics Top

dominicletz
Hey there, I haven’t seen a list of useful Elixir specific skills for the popular AI tools yet so I’m starting one here with my first. ...
New
raa-ziq
Hi everyone :waving_hand: I wanted to share something I’ve been building — NowBlind, a random chat app designed to help people discover ...
New
KristerV
Hey. Is there anyone here who creates agents in their apps? Not talking about using agents, but creating them. I’m finding it pretty diff...
New
OndrejValenta
(I just needed to vent somewhere and LinkedIn is full of hope, or hype, I’m not sure which exactly) AI dream has many faces, but general...
New
webofbits
With AI doing more of the implementation work, I’ve been wondering how much coding I should deliberately keep doing myself. My main conc...
#ai
New
AstonJ
With advancements in AI gathering pace and set to increasingly accelerate, perhaps it’s worth having an annual thread on the topic - feel...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews