Skip to content
README.rst 2.15 KiB
Newer Older
nimrod's avatar
nimrod committed
YAML tool
#########

nimrod's avatar
nimrod committed
.. image:: https://git.shore.co.il/nimrod/yamltool/badges/main/pipeline.svg
    :target: https://git.shore.co.il/nimrod/yamltool/-/commits/main
    :alt: pipeline status

nimrod's avatar
nimrod committed
YAML tool, a clone of the json.tool Python module for YAML.

This tool provides a simple command line interface to validate and pretty-print
YAML documents while trying to preserve as much as possible from the original
documents (like comments and anchors).

nimrod's avatar
nimrod committed
Usage
-----

.. code:: shell

    usage: yt [-h] [-i] [files ...]
nimrod's avatar
nimrod committed

    YAML tool, a clone of the json.tool Python module for YAML.
nimrod's avatar
nimrod committed

    This tool provides a simple command line interface to validate and pretty-print
    YAML documents while trying to preserve as much as possible from the original
    documents (like comments and anchors).
nimrod's avatar
nimrod committed

    positional arguments:
      files           a YAML file to be validated or pretty-printed
nimrod's avatar
nimrod committed

    optional arguments:
      -h, --help      show this help message and exit
      -i, --in-place  Perform the pretty-print in place, overwriting the existing files.

    When enabling --in-place, all files are processed as input files.
    When --in-place is not enabled and there are more then 2 files
    passed, the last files is considered as the output file. If you
    wish to pretty-print multiple files and output to standard out,
    specify the last file as "-" .
    Please note that specifying multiple input files will concatenate
    them, resulting in a single file that has multiple documents.
nimrod's avatar
nimrod committed

nimrod's avatar
nimrod committed
pre-commit hook
---------------

nimrod's avatar
nimrod committed
YAML tool can be used as a `pre-commit <https://pre-commit.com/>`_ hook by
nimrod's avatar
nimrod committed
adding the following to your :code:`.pre-commit-config.yaml` file:

.. code:: yaml

    ---
    repos:
      - repo: https://git.shore.co.il/nimrod/yamltool.git
nimrod's avatar
nimrod committed
        rev: 0.1.2
nimrod's avatar
nimrod committed
        hooks:
          - id: yamltool

nimrod's avatar
nimrod committed
License
-------

This software is licensed under the MIT license (see the :code:`LICENSE.txt`
file).

Author
------

Nimrod Adar, `contact me <nimrod@shore.co.il>`_ or visit my `website
<https://www.shore.co.il/>`_. Patches are welcome via `git send-email
<http://git-scm.com/book/en/v2/Git-Commands-Email>`_. The repository is located
at: https://git.shore.co.il/nimrod/.