gleam-lang / plug

🔌 A Gleam HTTP service adapter for the Plug web application interface

Gleam Plug! 🔌

A Gleam HTTP service adapter for the Plug web application interface.

Usage

Define a Gleam HTTP service

import gleam/http
import gleam/bit_builder.{BitBuilder}

pub fn service(req: http.Request(BitBuilder)) {
  http.response(200)
  |> http.prepend_resp_header("made-with", "Gleam")
  |> http.set_resp_body(req.body)
}

And then call it from an Elixir Plug application

defmodule MyPlug do
  def init(options) do
    options
  end

  def call(conn, body) do
    conn
    |> GleamPlug.call_service(body, &:my_gleam_module.service/1)
  end
end

Phoenix controllers are Plugs and so Gleam services can be called from them in the same way.

defmodule MyAppWeb.UserController do
  use MyAppWeb, :controller

  def show(conn, params) do
    conn
    |> GleamPlug.call_service(params, &:my_gleam_module.service/1)
  end
end

Installation

If available in Hex, the package can be installed by adding gleam_plug to your list of dependencies in mix.exs:

def deps do
  [
    {:gleam_plug, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/gleam_plug.