tomcli-set - Man Page

CLI for working with TOML files. Pronounced "tom clee."

Synopsis

[tomcli-set | tomcli set] [Global Options] PATH COMMAND [Arguments]

[tomcli-set | tomcli set] ... [COMMAND] --help

Description

The tomcli-set subcommand supports modifying TOML files.

Arguments

PATH

Path to a TOML file to read. Use '-' to read from stdin. Set to ... when calling --help for a subcommand.

SELECTOR

A dot separated map to a key in the TOML mapping.
Example: 'section1.subsection.value' or '"key.with.dots".abc'

Global Options

--version

Show the version and exit.

--writer <tomli_w|tomlkit>

Library to use to write TOML files.

--reader <tomli|tomlkit>

Library to use to write TOML files. Defaults to tomlkit and falls back to tomli/tomllib if tomlkit is unavailable.

Commands

append

Add a string value to a TOML list

  tomcli-set [GLOBAL OPTIONS] PATH append [OPTIONS] SELECTOR VALUE
  tomcli-set ... append --help

del

Delete a value from a TOML file

  tomcli-set [GLOBAL OPTIONS] PATH del [OPTIONS] SELECTOR...
  tomcli-set ... del --help

true / false

Set a value in a TOML file to true or false.

  tomcli-set [GLOBAL OPTIONS] PATH [true | false] [OPTIONS] SELECTOR
  tomcli-set ... [true | false] --help

str / int / float

Set a string or integer or float value in a TOML file.

  tomcli-set [GLOBAL OPTIONS] PATH [str|int|float] [OPTIONS] SELECTOR
  tomcli-set ... [str|int|float] --help

arrays

Subcommand to modify TOML arrays. See tomcli-set-arrays(1).

lists

Alias to the arrays subcommand.

See Also

tomcli(1), tomcli-formatters(1), tomcli-get(1), tomcli-set-lists(1)

Referenced By

tomcli(1), tomcli-formatters(1), tomcli-get(1), tomcli-set-arrays(1).

2024-09-16