mist

A (hopefully) nice, basic gleam web server

Installation

This package can be added to your Gleam project:

gleam add mist

and its documentation can be found at https://hexdocs.pm/mist.

Examples

See the examples/ folder for the full sample(s).

HTTP Hello World

pub fn ok(_msg: HandlerMessage, sock: Socket) -> actor.Next(Socket) {
  assert Ok(resp) =
    "hello, world!"
    |> bit_string.from_string
    |> http_response(200, _)
    |> bit_string.to_string

  resp
  |> charlist.from_string
  |> send(sock, _)

  actor.Stop(process.Normal)
}

Full HTTP echo handler

pub fn handler(req: Request(BitString)) -> Response(BitString) {
  response.new(200)
  |> response.set_body(req.body)
}
pub fn main() {
  assert Ok(socket) = mist.listen(8000, [])
  try _ = mist.start_acceptor_pool(socket, make_handler(handler), 10)

  Ok(erlang.sleep_forever())
}

Notes

This is still very rough. There are no tests, and as noted above you can’t just send where you implement it.

In some not-very-scientific benchmarking, it seemed to do roughly as well as ThousandIsland. I am just using that as a reference point, certainly not trying to draw any comparisons any time soon!