This module provides support for formatting of large or complex strings beyond the scope of fmt::. A template is compiled using compile, then executed with execute to print formatted text to an io::handle.

The template format is a string with variables substituted using "$". Variable names consist of alphanumeric ASCII characters (i.e. for which ascii::isalnum returns true) or underscores ('_'). A literal "$" may be printed by using it twice: "$$". Variables may also be used with braces, i.e. ${variable}, so that they can be placed immediately next to alphanumeric characters; such variables may include non-alphanumeric characters other than '{' and '}'.

const src = "Hello, $user! Your balance is $$$balance.\n";
const template = template::compile(src)!;
defer template::finish(&template);
template::execute(&template, os::stdout,
	("user", "ddevault"),
	("balance", 1000),
)!; // "Hello, ddevault! Your balance is $1000.

type param = (str, fmt::formattable);

// Undocumented types:
type instruction = (literal | variable);
type literal = str;
type template = []instruction;
type variable = str;

type invalid = !void;

fn compile(input: str) (template | invalid | nomem);
fn execute(tmpl: *template, out: io::handle, params: param...) (size | io::error);
fn finish(tmpl: *template) void;
fn strerror(err: invalid) str;

type param = (str, fmt::formattable);

type instruction = (literal | variable);

type literal = str;

type template = []instruction;

type variable = str;

type invalid = !void;

fn compile(input: str) (template | invalid | nomem);

fn execute(tmpl: *template, out: io::handle, params: param...) (size | io::error);

fn finish(tmpl: *template) void;

fn strerror(err: invalid) str;