fmt

Type-safe (string) formatting for Gleam.

Heavily inspired by “Type-safe functional formatted IO” by Oleg Kiselyov.

Usage

The following code would print out Movie: Inside Out; Rating: 5; Price: $24.99:

import fmt
import gleam/io

// This will print out "Movie: Inside Out; Rating: 5; Price: $24.99"
pub fn main() {
  fmt.lit("Movie: ")
  |> fmt.cat(fmt.string())
  |> fmt.cat(fmt.lit("; Rating: "))
  |> fmt.cat(fmt.int())
  |> fmt.cat(fmt.lit("; Price: $"))
  |> fmt.cat(fmt.float())
  |> fmt.sprintf3("Inside Out", 5, 24.99)
  |> io.println
}

In this example,

lit is used to specify literal string values.
string is used to specify a String placeholder.
int is used to specify an Int placeholder.
float is used to specify a Float placeholder.
cat is used to concatenate the formatting specifications.
sprintf3 is used to generate the string from the given specification.

For more details and examples, see the documentation and the tests.

Type Safety

It is type-safe: the compiler will ensure that you have set everything up correctly, both in terms of the number of expected arguments and their types.

Check out this example:

pub fn will_fail() {
  fmt.lit("Name: ")
  |> fmt.cat(fmt.string())
  |> fmt.cat(fmt.lit("; Age: "))
  |> fmt.cat(fmt.int())
  |> fmt.sprintf2("Juan", "Carlos")
}

If you were to check this with gleam check, you would get an error something like this:

error: Type mismatch
   ┌─ ./fmt/test/fmt_test.gleam:82:27
   │
82 │   |> fmt.sprintf2("Juan", "Carlos")
   │                           ^^^^^^^^

Expected type:

    Int

Found type:

    String

License

Licensed under the Apache License, Version 2.0 or the MIT license, at your option. This program may not be copied, modified, or distributed except according to those terms.