jetblack-tomlutils 1.0.0

Utilities for working with toml files

jetblack-tomlutils

Some utilities for working with toml files.

Usage

Install with pip:

$ pip install jetblack-tomlutils

toml2json

To convert toml to JSON:

usage:
    tom2json [<input> [<output]]

    input/output: either a path or '-' for stdin/stdout

examples:
    $ toml2json < pyproject.toml > pyproject.json
    $ toml2json pyproject.toml > pyproject.json
    $ toml2json pyproject.toml - > pyproject.json
    $ toml2json pyproject.toml pyproject.json
    $ cat pyproject.toml | toml2json
    $ cat pyproject.toml | toml2json -

json2toml

To convert JSON to toml:

usage:
    json2toml [<input> [<output]]

    input/output: either a path or '-' for stdin/stdout

examples:
    $ json2toml < pyproject.json
    $ json2toml pyproject.json
    $ cat pyproject.toml | json2toml
    $ cat pyproject.toml | json2toml -

jsonget

To query JSON

You can query JSON using a JSON Pointer

usage:
    jsonget <json-pointer> [<input> [<output>]]

    json-pointer: a valid JSON Pointer path
    input/output: either a path or '-' for stdin/stdout

examples:
    $ toml2json pyproject.toml | jsonget /tool/poetry/version

jsonset

To update JSON

You can update JSON using a JSON Pointer and a value

usage:
    jsonset <json-pointer> <json-value> [<input> [<output>]]

    json-pointer: a valid JSON Pointer path
    json-value: a value that can be parsed as JSON.
    input/output: either a path or '-' for stdin/stdout


examples:
    $ toml2json pyproject.toml | jsonset /tool/poetry/version '"1.2.3"'

Acknowledgements

This project is a trivial wrapper around the following projects:

• qtoml - a toml parser
• jsonpointer - a JSON pointer package