Gluegun

HTTP without footguns.

Gluegun keeps the BEAM-native Gun model visible. Open a connection. Wait for the negotiated protocol. Send the request. Then collect a typed response, or use streams when the body does not fit in memory.

use conn <- result.try(
  connection.options()
  |> connection.open(host: "example.com", port: 443),
)

use _ <- result.try(
  connection.await_up(conn, connection.Milliseconds(5000)),
)

use res <- result.try(
  client.new(request.Get, "/")
  |> client.with_timeout(timeout: connection.Milliseconds(5000))
  |> client.send(connection: conn),
)

io.println("status: " <> int.to_string(response.status(res)))
connection.close(conn)

client.send collects status, headers, body, trailers, and informational 1xx responses into one typed value. Use the lower-level request and message APIs when you must stream the response.

Recommended reading path

1. 01Send a GETOpen a connection. Wait until it is ready. Collect a typed response.
2. 02Stream bodiesUse the request and message functions when memory is limited.
3. 03Open socketsUpgrade HTTP/1.1 connections and process frames explicitly.

Select the layer that agrees with the task.

Use the high-level client when one collected response is sufficient. Use the request and message functions when streams, cancellation, HTTP/2 push, upgrades, trailers, or WebSocket frames must stay explicit.

Lifecycle map

connectionOpen Gun. Wait for protocol negotiation. Close cleanly.clientOne usual request, one collected response, visible errors.requestStreams, chunks, cancellation, flow control.messageTyped decoding for the asynchronous stream events of Gun.websocketHTTP/1.1 upgrades, reusable sockets, frames, and closes.

Before you ship

Production checklistTLS setupError handlingLimitsTroubleshooting