← index

TOMLabstract

inherits Object

Parse and generate TOML, the config-file format.

The same value mapping as JSON (table → Map, array → List, plus the scalars), with TOML's two format constraints enforced: the top level must be a table (a Map), and TOML has no null, so a nil anywhere in the value errors on generate:.

TOML.parse:'x = 1'               "* -> #{'x': 1}
TOML.generate:#{'port': 8080}    "* -> 'port = 8080\n'

Class methods

generate:

Generate the TOML document for a Map (nested Maps become tables). The top-level value must be a Map, and no nil may appear anywhere — TOML has no null; either throws a ValueError.

TOML.generate:#{'server': #{'host': 'localhost' 'port': 8080}}
"* -> '[server]\nhost = "localhost"\nport = 8080\n'

native

parse:String

Parse a TOML document into Quoin values — always a Map at the top level, with tables as nested Maps. Malformed input throws a ParseError.

TOML.parse:'[server]\nhost = "localhost"'     "* -> #{'server': #{'host': 'localhost'}}

native