tomcli

(gotmax23/tomcli)

(gotmax23/tomcli-dev)

用于处理TOML文件的命令行界面。发音为“tom clee”。

链接

• tomcli docsite
• tomcli 项目中心
• tomcli git.sr.ht 仓库
• tomcli 跟踪器
• tomcli 邮件列表 (~gotmax/tomcli@lists.sr.ht)

示例

tomcli-get

查询TOML文件

打印TOML表格

$ tomcli-get pyproject.toml build-system
[build-system]
requires = ["flit_core >=3.2,<4"]
build-backend = "flit_core.buildapi"

获取一个以换行符分隔的字符串列表

$ tomcli-get pyproject.toml --formatter newline-list project.dependencies
click
importlib_metadata; python_version<'3.11'

列出所有可用于与tomcli-get -F或tomcli-get --formatter一起使用的格式化程序

$ tomcli-formatters
default
        Use the `toml` formatter if the object is a Mapping and fall back to
        `string`.

json
        Return the JSON representation of the object

newline-keys
        Return a newline-separated list of Mapping keys

newline-list
        Return a newline separated list

newline-values
        Return a newline-separated list of Mapping values

string
        Print the Python str() representation of the object

toml
        Return the TOML mapping of the object

tomcli-set

修改TOML文件

删除TOML值

$ tomcli-set pyproject.toml del 'project.dependencies'

将值设置为true或false

$ tomcli-set pyproject.toml true 'tool.mypy.check_untyped_defs'
$ tomcli-set pyproject.toml false 'tool.mypy.check_untyped_defs'

设置一个浮点数或整数值

$ tomcli-set pyproject.toml float 'tool.coverage.run.fail_under' '90.0'
$ tomcli-set pyproject.toml int 'tool.coverage.run.fail_under' '90'

设置一个字符串值

$ tomcli-set pyproject.toml str 'project.readme' 'README.rst'

tomcli-get 数组

修改TOML文件中的数组

删除所有与Python正则表达式匹配的值

注意: 正则表达式必须匹配整个字符串

$ tomcli-set pyproject.toml arrays delitem \
    'project.classifiers' 'Programming Language :: Python.*'

删除所有与fnmatch风格模式匹配的值

$ tomcli-set pyproject.toml arrays delitem --type fnmatch \
    'project.optional-dependencies.dev' '*cov*'

替换所有与Python正则表达式匹配的值

注意: 正则表达式必须匹配整个字符串

$ tomcli-set pyproject.toml arrays replace \
    'project.optional-dependencies.test' '(.+)==(.+)' '\1>=\2'

创建一个字符串列表

## Create the new file
$ touch plays.toml
## Automatically creates the "Romeo and Juliet" table
$ tomcli-set plays.toml arrays str \
    '"Romeo and Juliet".characters' 'Romeo' 'Juliet' 'Mercuitio' 'Nurse'

贡献

查看 CONTRIBUTING.md。

许可证

本仓库遵循

SPDX-License-Identifer: MIT