glemini

A Gleam library for building Gemini servers.

Usage

Add glemini to your project:

gleam add glemini

Create self-signed server certificates:

openssl req -x509 -nodes -newkey rsa:4096 -keyout certs/cert.key -out certs/cert.crt -sha256 -days 365

Create the gemini server with a request handler:

import gleam/erlang/process
import gleam/io
import glemini.{
  add_handler, add_ssl, gemtext_response, new_config, not_found_response, start,
}
import glemini/gemtext.{heading1, text}

pub fn main() {
  io.println("Starting server!")

  let config =
    new_config()
    |> add_ssl(certfile: "certs/cert.crt", keyfile: "certs/cert.key")
    |> add_handler(fn(request) {
      case request.path {
        "/" ->
          [
            heading1("Welcome to Glemini!"),
            text("This is a simple gemini server library"),
          ]
          |> gemtext_response()
        _ -> not_found_response()
      }
    })

  let assert Ok(_) = start(config)

  io.println("Server running!")
  process.sleep_forever()
}

Further documentation can be found at https://hexdocs.pm/glemini.

Development

gleam run   # Run the project
gleam test  # Run the tests
gleam shell # Run an Erlang shell