Command-line tool to parse, validate, and format TOML files

toml

cli

formatter

validator

moon add conglinyizhi/toml-cli@0.3.3

Download zip

Author

conglinyizhi

Version

0.3.3

License

Apache-2.0

Repository

github.com/conglinyizhi/toml-mbt

Last updated

5 hours ago

Downloads

Dependencies

conglinyizhi/toml0.1.0
moonbitlang/x0.4.41

README

#toml_cli

A jq-style command-line tool to parse, query, validate, and format TOML, built on conglinyizhi/toml.

Every command reads from a file argument when given, and from standard input otherwise, so it composes in pipelines:

cat config.toml | toml_cli get .server.host
echo 'a = 1' | toml_cli check

#Run without installing

The prebuilt binary can be run directly from mooncakes.io (as a WASM skill) — it is fetched and cached on first use:

moon runwasm conglinyizhi/toml-cli --help
moon runwasm conglinyizhi/toml-cli check config.toml
moon runwasm conglinyizhi/toml-cli format config.toml
moon runwasm conglinyizhi/toml-cli get .server.host config.toml

#Usage

toml [file]           Parse TOML and print normalized TOML (default: stdin)
toml format [file]    Parse TOML and print normalized TOML
toml check [file]     Validate TOML without printing parsed output
toml tojson [file]    Parse TOML and print it as JSON
toml get <path> [file]  Print the value at a dotted path

get path syntax: . or empty for the whole document, .server.host for nested keys, .ports[0] for array indices. Strings are printed raw (no quotes); tables and arrays are printed in TOML form.

Exit codes: 0 on success, 1 on read/parse failure or a missing path, 2 on usage errors.

tojson maps tables to objects and arrays to arrays; datetimes become their TOML string form, integers keep their exact 64-bit decimal representation, and non-finite floats become the strings "nan"/"inf"/"-inf".

#Run from source

moon runwasm .                          # in this directory (wasm)
moon run --target native . -- --help    # native build

#
PathSeg

source

type PathSeg

#
exit

source

fn exit(code : Int) -> Unit

Exit the program with the given code.

#
get_args

source

fn get_args() -> Array[String]

Command-line arguments.

#
get_path

source

fn get_path(root : @conglinyizhi/toml.TomlValue
TomlValue, path : String) -> @conglinyizhi/toml.TomlValue
TomlValue?

Look up path inside root; None when any segment is missing.

#
read_source_file

source

fn read_source_file(path : String) -> String?

Read a file as UTF-8 text; None (with an error printed) on failure.

#
read_stdin

source

fn read_stdin() -> String

Read all of stdin as a UTF-8 string.

#
render

source

fn render(value : @conglinyizhi/toml.TomlValue
TomlValue) -> String

Render a value for get output: strings are printed raw (no quotes), everything else uses the TOML serializer.

Source Files

Site source Report issue Packages Build queue Skills Statistics

toml-cli

#toml_cli

#Run without installing

#Usage

#Run from source

#PathSeg

#exit

#get_args

#get_path

#read_source_file

#read_stdin

#render

Source Files

#
PathSeg

#
exit

#
get_args

#
get_path

#
read_source_file

#
read_stdin

#
render