Skip to content

NEWS

0.10.1 - 2025-07-31

Fixes

  • Fix validation of --reader, --writer, and --pattern options. This addresses a regression introduced in v0.10.0 while adding compatibility for click 8.2.

0.10.0 - 2025-06-06

Added

  • toml: treat tomli as a separate entity from tomllib. This allows using tomli instead of tomllib from the stdlib on newer Python versions to take advantage of the mypyc speedups in tomli.
  • Support Python 3.14

Fixed

  • cli: fix compatibility with click 8.2

0.9.0 - 2025-03-02

Added

  • set: add top-level replace command based on arrays replace that operates on a single string key instead of an array of strings
  • set: add --required flag to [arrays] replace and arrays delitem subcommands
  • set: add regex_fullmatch, regex_partial, and regex_search pattern types to [arrays] replace and arrays delitem

0.8.0 - 2024-09-16

Added

  • arrays delitem: add --key flag to access arrays of tables (see https://todo.sr.ht/~gotmax23/tomcli/9 and man tomcli-set-arrays for more details!).
  • packaging: declare support for Python 3.13

Changed

  • all: parsing of SELECTORs is now more strict. Keys must be quoted if they contain characters that are not allowed as TOML keys without quotes. For example, tomcli-get foo.toml "multiple words", given that foo.toml contains "multiple words" = 1234, used to return 1234 but now errors. Use tomcli-get foo.toml "'multiple words'" instead. Trailing quotes are now handled properly, as well.
  • lists: the lists subcommand has been renamed to arrays, to align with the TOML standard's name for that data type. lists will perpetually remain an alias to the arrays command; backwards compatibility is important to the tomcli project.

Fixed

  • doc: use proper unicode dashes in manpages

0.7.0 - 2024-05-06

Added

  • cli set del: allow removing multiple keys in one invocation
  • formatters: add -F newline-keys and -F newline-values

Removed

  • Remove support for Python 3.8

0.6.0 - 2024-03-28

Added

  • cli main: add command description
  • cli set: allow passing multiple values to the append command
  • cli: support python -m tomcli
  • doc: add manpages
  • doc: add mkdocs configuration

Fixed

  • cli set: remove unnecessary resilient_parsing conditional
  • cli get: properly handle FormatterError exceptions

0.5.0 - 2023-12-14

Added

  • README.md: add usage examples
  • tomcli.spec: add smoke tests
  • tomcli.spec: add minimal py3_test_envvars def for EPEL 9

Changed

  • build: use flit_core instead of hatchling as build backend
  • cli: use click instead of typer as CLI framework

Fixed

  • cli: allow accessing keys containing dots

0.4.0 - 2023-12-02

Added

  • cli set: add true subcommand
  • cli set: add false subcommand
  • cli: add --version argument
  • cli: add parent tomcli command with set and get subcommands
  • cli get: add -F / --formatter arg to customize output
  • cli: add tomcli-formatters / tomcli formatters command to list available get formatters

0.3.0 - 2023-09-07

Added

  • cli set: add lists delitem subcommand

Fixed

  • Fully drop support for Python 3.7. Support for 3.7 was officially removed in the previous release, but the metadata was not updated correctly.

0.2.0 - 2023-09-01

Added

  • add py.typed file
  • declare support for Python 3.12
  • cli set: add missing help messages
  • cli set: add lists replace and lists str commands

Fixed

  • cli: improve error handling

Removed

  • drop support for Python 3.7

0.1.2 - 2023-05-20

Fixed

  • tomcli-set: fix typo in error message
  • tomcli-set: fix recursive dictionary creation

0.1.1 - 2023-05-03

Added

  • tomcli.spec: add gnupg2 BuildRequires
  • tomcli.spec: add missing extras subpackages
  • tomcli.spec: include NEWS.md

Fixed

  • tomcli-get: fix broken toml backend fallback
  • fix pronunciation description in packaging metadata and README

0.1.0 - 2023-04-14

Added

  • cli: add tomcli-set subcommand
  • packaging: add RPM specfile
  • packaging: wire up automated copr builds.
  • packaging: include shell completions in the RPM specfile
  • internal: cleanup and increase tomlkit compat. Dev builds are available at gotmax23/tomcli-dev and releases at gotmax23/tomcli.

0.0.0 - 2023-04-13

Initial release of tomcli, a CLI tool for working with TOML files. Pronounced "tohm-clee." Currently, tomcli only provides tomcli-get command but more are planned!