Gleam Gun

Gleam bindings to gun, the Erlang HTTP/1.1, HTTP/2 and Websocket client.

Fork of nerf that adds connection options.

Currently this library is very basic and only supports a portion of the websocket API, and TLS is not verified! Hopefully in future a better websocket client written in Gleam can replace this one.

Usage

This package can be added to your Gleam project like so.

gleam add gleam_gun

Then use it in your Gleam application.

import gleam_gun/websocket
import gleam/erlang
import gleam/erlang/atom

pub fn main() {
 // Set connection options
 let conn_opts = [
   websocket.Transport(atom.create_from_string("tls")),
   websocket.TransportOpts([websocket.Verify(atom.create_from_string("verify_none"))]),
 ]
 // Connect
 assert Ok(conn) = websocket.connect("example.com", "/ws", 8080, [], conn_opts)

 // Send some messages
 websocket.send(conn, "Hello")
 websocket.send(conn, "World")

 // Receive some messages
 let assert Ok(Text("Hello")) = websocket.receive(conn, 500)
 let assert Ok(Text("World")) = websocket.receive(conn, 500)

 // Close the connection
 websocket.close(conn)
}

Testing this library

podman run --rm --detach -p 8080:8080 --name echo jmalloc/echo-server
gleam test