🛁 Bath

Bath is a generic resource pool for Gleam. It can be used to manage a pool of any value, such as database connections, file handles, or other resources.

Installation

gleam add bath

Usage

The recommended way to start a Bath pool is with the supervised function. You can use this to include the Bath pool in your application’s supervision tree.

import bath
import fake_db
import gleam/otp/static_supervisor as supervisor

pub fn main() {
  // Create a name to interact with the pool once it's started under the
  // static supervisor.
  let pool_name = process.new_name("bath_pool")

  // Define a pool of 10 connections to some fictional database, and create a child
  // spec to allow it to be supervised.
  let bath_child_spec =
    bath.new(fn() { fake_db.get_conn() })
    |> bath.size(10)
    |> bath.name(pool_name)
    |> bath.supervised(1000)

  // Start the pool under a supervisor
  let assert Ok(_started) =
    supervisor.new(supervisor.OneForOne)
    |> supervisor.add(bath_child_spec)
    |> supervisor.start

  // Receive the pool handle now that it's started
  let pool = process.named_subject(pool_name)

  // Use the pool. Shown here in a block to use `use`.
  let assert Ok("Hello!") = {
    use conn <- bath.apply(pool, 1000)

    // Do stuff with the connection...

    // Return the connection to the pool, returning "Hello!" to the caller.
    bath.keep()
    |> bath.returning("Hello!")
  }

  // Do more stuff...
}

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

Development

If you’ve found any bugs, please open an issue on GitHub.

The code is reasonably well tested and documented, but PRs to improve either are always welcome.

gleam test  # Run the tests