It builds on Mint to offer one-off requests, connection pooling, and a generally friendlier interface than playing telephone with a TCP socket. :) Play around and let me know how it goes!
I like that Mint keeps dependencies to a minimum. I wanted to use the Gun client in the past, but couldn’t because Gun and Cowboy would depend on different versions of Cowlib (this is less of a problem now that Cowboy 2 is well supported in Phoenix). Instead I used HTTPoison, but the way it wraps Hackney makes it a bit annoying to understand and debug, and the pooling can cause problem.
Mint looks lower level, but with a clean, well-documented API which should be a great building block in the future. Congrats Eric and Andrea!
It took me a while to figure out whether this is an HTTP client library or a server library. Turns out it is the former. Nice! I like that it's in-process. I wish more Elixir libraries would default to such a design.
(EDIT: I had accidentally written "latter" instead of "former" above, causing a bunch of people to correct me, thanks for that)
I've noticed that the distinction between server and client is much less apparent in HTTP2 libraries than it was in HTTP1 libraries. It doesn't seem like Mint follows this philosophy, but many HTTP2 libraries (even ones that also support HTTP1) are both server and client libraries.
Presumably this is because HTTP2 is sort of two protocol layers stuck together—a session layer and an application layer—and at the session layer, HTTP2 just has identical "peers" rather than any concept of client/server. (Theoretically either side of an HTTP2 connection could open a session to the other side and send a message! It's just the semantics of the HTTP-mimicking application layer that stop this. If you read the RFC, all the session stuff—frames et al—are specified in terms of "peers", and it's only when the spec starts talking about HTTP request-response that we see "clients" and "servers" mentioned.)
Since implementing the session layer is most of the work of implementing an HTTP2 client/server, and the session layer is just about "peers", once you've implemented it for a client (or server), you can reuse it to implement a server (or client) mostly "for free."
While I have qualms about the name since this is like the 20th Mint I've heard of now, I'm incredibly excited as to what this has to offer. The control over the underlying process is key to creating beautifully asynchronous applications, and it gives me a lot of node-got vibes in terms of how easy it is to use.
And thank god, HTTPS support built in... it never ceases to amaze me why some HTTP libs don't have TLS as a given.
TLS is a layer 4 protocol feature which can be used for other libraries such as database clients. Most languages split the TLS implementation to more easily reuse that code.
I'm liking the trend of designing runtime-behaviour agnostic libraries in Elixir. We get such powerful runtime capabilities with OTP, but indulged in the wrong context our cool OTP processes can be imposing assumptions onto our users.
I'd like to see some kind of generic HTTP contract or REST-API client builder library next so we can have swappable HTTP adapters (e.g. Mint/Hackney). I don't want to depend on a library like HTTPoison or Tesla directly when making a client, instead just generic Request/Response structs or protocols. That way an internal project can use a single HTTP adapter across all REST integrations rather than whatever the library author chose to use.
Requests made with HTTPoison are passed to the library’s own connection pool whereas requests made with Mint are handled in the same process. While HTTPoison is great for most use cases, Mint is a promising solution for anyone who has specific control flow requirements.
I’m interested in this for some of the uglier API integrations I maintain where an ordered chain of requests must be made with no guarantee of delivery and responses that involve a considerable amount of in-memory processing (large XML bodies to be exact). Having control over my process architecture is preferable to leaving it up to the HTTP library’s connection pool in these cases.
The main thing is a processless architecture that lets you easily build architectures that are fine-tailored for your use case. You might build a process that holds many connection structs, or a use the connections directly in say a GenStage producer/consumer, or things like those. The idea is that you now have the building blocks to build whatever fits your thing :)
With Gun it is also possible to create a specialized process structure albeit with more heavyweight processes behind each connection. Mint provides lightweight (possibly more efficient?) abstraction to achieve similar results. Thanks Eric and Andrea!
I wish a solid HTTP client and JSON library was a part of the std lib. I feel like all of my apps have HTTPotion, HTTPoison, Poison, and Jason as dependencies.
this library was renamed from xhttp to mint and new name is much more refreshing :)
I'm excited to try out this library (or something built on top of it)! In my day to day work I use hackney, it's an awesome lib, but sometimes I struggle with documentation.
A lightweight serverside Elixir framework like this is exactly what I was looking for earlier this week. Phoenix is really clunky in my opinion and pretty foreign (Ruby/Rails-like) coming from a lightweight Flask/Express/Go background.
Ouch, this is not a server library but a client! We updated the title of the blog post since it wasn't clear, not sure if we can update it here as well :\ Sorry for the confusion!
Phoenix is just some additional libraries around Plug. The reason it’s so popular is that there’s almost no performance hit compared to using raw plug unlike a lot of other frameworks.
looking at the library, one of the exciting things (for me) is the existence of stream_request_body. AFAICT there isn't an obvious way to do this in any of the other libraries.
People are the worst at naming products. Why call it Mint when there is already an insanely popular Mint.com financial software. It makes Googling/searching for product relevancy near impossible. It's like try to search for Firefox on Android vs Firefox on a desktop information.
No it doesn't. All you have to do is search <language> <package> and you get relevant results. Look through your library list, it's pretty common for the names to only make sense in context.
It's in the context of Elixir, so search for "mint elixir" and I'm sure it'll be quite discoverable - or searching for "mint" on an Elixir contextualized site.
GitHub - ericmj/mint: Functional HTTP client for Elixir with support for ...
https://github.com/ericmj/mint
Functional HTTP client for Elixir with support for HTTP/1 and HTTP/2 - ericmj/mint.
For me opening up Microsoft Edge which I never use for anything not testing related and hence Google does not know me on that browser and does not guess I want programming stuff Mint Elixir came up #5.
For me on Google, "mint elixir" has the GitHub repo as the first result, then a bunch of links for "How to install Elixir on Linux Mint". DDG gives a software company called "Elixir Mint" as the first result, followed by links to drink recipes, and the GitHub repo is down near the bottom.
For Elixir devs who want a higher-level interface to Mint, check out Mojito: https://hexdocs.pm/mojito/Mojito.html https://github.com/appcues/mojito
It builds on Mint to offer one-off requests, connection pooling, and a generally friendlier interface than playing telephone with a TCP socket. :) Play around and let me know how it goes!