A TOML parser library for hica. Full implementation of TOML v1.1.0 — 129 tests across 9 test files.

hica add toml
hica fetch

This records the dependency in hica.hml and downloads the package.

import "toml"

Everything in the TOML v1.1.0 spec:

• Keys: bare, quoted (basic & literal), dotted, empty quoted
• Strings: basic, literal, multi-line (both kinds), all escape sequences (\n, \t, \r, \\, \", \b, \f, \e), unicode escapes (\xHH, \uHHHH, \UHHHHHHHH), line ending backslash
• Numbers: integers (decimal, hex, octal, binary, underscores), floats (fractional, exponent, underscores), special values (inf, nan)
• Booleans: true, false
• Date-times: offset date-time, local date-time, local date, local time, fractional seconds, space delimiter, seconds omitted
• Tables: standard, nested, implicit super-table creation, dotted keys inside tables, out-of-order super-table definition
• Inline tables: basic, nested, dotted keys, trailing comma (v1.1.0), multi-line (v1.1.0), self-containment enforcement
• Arrays: basic, mixed-type, multi-line, trailing commas, nested, comments inside
• Array of tables: basic, nested, sub-tables under array elements, conflict detection
• Comments: full-line, inline, control character rejection
• Whitespace: CRLF and LF newlines, tab as whitespace
• Error handling: line numbers in error messages, duplicate key/table rejection, unterminated string/array/table detection

pub type Toml {
  TStr(value: string),
  TInt(value: int),
  TFloat(value: float),
  TBool(value: bool),
  TDatetime(value: string),
  TArray(items: list<Toml>),
  TTable(entries: list<(string, Toml)>)
}

toml_parse(input: string) : result<Toml, string>

Returns Ok(TTable(...)) on success or Err("line N: message") on failure.

toml_get(t: Toml, key: string) : maybe<Toml>
toml_str(t: Toml, key: string) : string
toml_int(t: Toml, key: string) : int
toml_float(t: Toml, key: string) : float
toml_bool(t: Toml, key: string) : bool
toml_list(t: Toml, key: string) : list<Toml>
toml_table(t: Toml, key: string) : list<(string, Toml)>

let doc = toml_ok(toml_parse(input))

// Chain with |> or dot notation
doc.at("server").at("port").as_int
doc.at("database").at("ports").nth(0).as_int

// Available: toml_ok, at, nth, as_str, as_int, as_float, as_bool, as_list, as_table, as_datetime

str_or(maybe_toml, "default")
int_or(maybe_toml, 0)
float_or(maybe_toml, 0.0)
bool_or(maybe_toml, false)

has_key(t: Toml, key: string) : bool
keys(t: Toml) : list<string>
toml_length(t: Toml) : int

toml_show(t: Toml) : string    // Compact single-line
toml_pretty(t: Toml) : string  // Pretty-printed

See the examples/ directory for runnable programs:

• basic_parsing.hc: Read a TOML file and extract values
• read_config.hc: Read a config file and list top-level keys

Run an example:

hica run examples/basic_parsing.hc

# Run all tests
for f in tests/test_*.hc; do hica test "$f"; done

# Run a single test file
hica test tests/test_basics.hc

MIT