https://github.com/ninenines/gun

HTTP/1.1, HTTP/2, Websocket client (and more) for Erlang/OTP.
https://github.com/ninenines/gun

cowboy erlang functional high-performance http http-client http2 http2-client https production-ready rest web websocket websocket-client websockets

Last synced: 2 days ago
JSON representation

HTTP/1.1, HTTP/2, Websocket client (and more) for Erlang/OTP.

• Host: GitHub
• URL: https://github.com/ninenines/gun
• Owner: ninenines
• License: isc
• Created: 2013-08-21T17:57:12.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-07-10T13:37:04.000Z (5 months ago)
• Last Synced: 2024-10-29T15:11:54.720Z (about 1 month ago)
• Topics: cowboy, erlang, functional, high-performance, http, http-client, http2, http2-client, https, production-ready, rest, web, websocket, websocket-client, websockets
• Language: Erlang
• Homepage:
• Size: 1.81 MB
• Stars: 901
• Watchers: 47
• Forks: 231
• Open Issues: 35
• Metadata Files:
  • Readme: README.asciidoc
  • License: LICENSE

Awesome Lists containing this project

• freaking_awesome_elixir - Erlang - HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP. (HTTP)
• fucking-awesome-elixir - gun - HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP. (HTTP)
• awesome-erlang - gun - Erlang HTTP client with support for HTTP/1.1, SPDY and Websocket. (HTTP)
• awesome-elixir - gun - HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP. (HTTP)
• awesome-erlang - Gun - An HTTP/1.1, HTTP/2, and WebSocket client for Erlang/OTP. (Libraries / Concurrency)
• awesome-erlang - Gun - An HTTP/1.1, HTTP/2, and WebSocket client for Erlang/OTP. (Libraries / Concurrency)

README

        
= Gun

Gun is an Erlang HTTP client with support for HTTP/1.1,

HTTP/2, Websocket and more.

== Goals

Gun aims to provide an *easy to use* client compatible with

HTTP/1.1, HTTP/2 and Websocket. Gun can connect through any

combination of Socks and HTTP proxies.

Gun is *always connected*. It will maintain a permanent

connection to the server, reopening it as soon as the server

closes it, saving time for the requests that come in.

All connections are *supervised* automatically, allowing

developers to focus on writing their code without worrying.

== Sponsors

Gun was previously sponsored by

http://leo-project.net/leofs/[LeoFS Cloud Storage],

https://sameroom.io/[Sameroom],

and https://pleroma.social/[Pleroma].

== Online documentation

* https://ninenines.eu/docs/en/gun/2.1/guide[User guide]

* https://ninenines.eu/docs/en/gun/2.1/manual[Function reference]

== Offline documentation

* While still online, run `make docs`

* User guide available in `doc/` in PDF and HTML formats

* Function reference man pages available in `doc/man3/` and `doc/man7/`

* Run `make install-docs` to install man pages on your system

* Full documentation in Asciidoc available in `doc/src/`

== Getting help

* https://discord.gg/x25nNq2fFE[Discord server]

* https://github.com/ninenines/gun/issues[Issues tracker]

* https://ninenines.eu/services/[Commercial Support]