TOML Parser for Erlang

tomerl is an Erlang library application for parsing TOML data. It supports parsing version 1.0.0-rc1 of the TOML specification.

Usage Example

Assuming an input file called config.toml with the following content:

lipsum = "lorem ipsum dolor sit amet"

[apples]
count = 2

[berry.black]
has_some = true

the data can be read in Erlang like this:

{ok, Data} = tomerl:read_file("config.toml").

>>> Data = #{
    <<"lipsum">> => <<"lorem ipsum dolor sit amet">>,
    <<"apples">> => #{ <<"count">> => 2 },
    <<"berry">> => #{ <<"black">> => #{ <<"has_some">> => true }}
}.

To access the data, there is a simple get function that accepts lists of strings, binaries and atoms:

{ok, true} = tomerl:get(Data, [berry, black, has_some]),
{ok, 2} = tomerl:get(Data, ["apples", <<"count">>]),
{error, not_found} = tomerl:get(Data, [something, undefined]).

Documentation

toml is documented using EDoc. A local copy is generated using rebar3 doc in the ./doc/ directory. The documentation at at https://hexdocs.pm/toml-erlang is update on release.

Known limitations

• Types conveying time only store second precision (fraction of a second is truncated)

Contact and License

This library is based on the initial work by Stanislaw Klekot . It is distributed under the 3-clause BSD license. Check the COPYING file for details.