You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
NOTE: River is a work in progress and should be considered extremely beta.
River is a general-purpose HTTP client with eventual hopes of full HTTP/2 support (along with support for HTTP/1.1). It is built from the ground up with three major goals:
be simple and straightforward to use, in the vein of HTTPoison
be awesome, in the same way that Go's http library (which has built-in, transparent support for HTTP/2) is awesome.
Installation
Add River to your list of dependencies in mix.exs:
defdepsdo[{:river,"~> 0.0.6"}]end
Ensure River is started before your application:
defapplicationdo[applications: [:river]]end
Caveats
Currently, River only knows how to make HTTP/2 requests to https:// endpoints. Soon, I'll add the ability to make a request via the Upgrade header so that requests to https:// endpoints will work as well.
River doesn't currently speak HTTP/1.x. Once I finish up basic HTTP/2 support, HTTP1.x is next on the roadmap. The goal when using River in your project is that you should not need to know whether the underlying connection is using HTTP/2 or HTTP/1.x.
River is as beta as it gets, and under active development with no promises of anything being backwards compatible 😬 (until we hit v1.0, of course)
