You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
152 lines
3.6 KiB
ReStructuredText
152 lines
3.6 KiB
ReStructuredText
| |GitHub Badge| |PyPi version Badge| |Python version Badge| |License Badge|
|
|
| |CI status Badge| |Coverage Badge| |Docs Badge|
|
|
|
|
|
|
yamllint
|
|
========
|
|
|
|
A linter for YAML files.
|
|
|
|
yamllint does not only check for syntax validity, but for weirdnesses like key
|
|
repetition and cosmetic problems such as lines length, trailing spaces,
|
|
indentation, etc.
|
|
|
|
Written in Python (compatible with Python 3 only).
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
https://yamllint.readthedocs.io/
|
|
|
|
Overview
|
|
--------
|
|
|
|
Screenshot
|
|
^^^^^^^^^^
|
|
|
|
.. image:: docs/screenshot.png
|
|
:alt: yamllint screenshot
|
|
|
|
Installation
|
|
^^^^^^^^^^^^
|
|
|
|
Using pip, the Python package manager:
|
|
|
|
.. code:: bash
|
|
|
|
pip install --user yamllint
|
|
|
|
yamllint is also packaged for all major operating systems, see installation
|
|
examples (``dnf``, ``apt-get``...) `in the documentation
|
|
<https://yamllint.readthedocs.io/en/stable/quickstart.html>`_.
|
|
|
|
Usage
|
|
^^^^^
|
|
|
|
.. code:: bash
|
|
|
|
# Lint one or more files
|
|
yamllint my_file.yml my_other_file.yaml ...
|
|
|
|
.. code:: bash
|
|
|
|
# Lint all YAML files in a directory
|
|
yamllint .
|
|
|
|
.. code:: bash
|
|
|
|
# Use a pre-defined lint configuration
|
|
yamllint -d relaxed file.yaml
|
|
|
|
# Use a custom lint configuration
|
|
yamllint -c /path/to/myconfig file-to-lint.yaml
|
|
|
|
.. code:: bash
|
|
|
|
# Output a parsable format (for syntax checking in editors like Vim, emacs...)
|
|
yamllint -f parsable file.yaml
|
|
|
|
`Read more in the complete documentation! <https://yamllint.readthedocs.io/>`__
|
|
|
|
Features
|
|
^^^^^^^^
|
|
|
|
Here is a yamllint configuration file example:
|
|
|
|
.. code:: yaml
|
|
|
|
extends: default
|
|
|
|
rules:
|
|
# 80 chars should be enough, but don't fail if a line is longer
|
|
line-length:
|
|
max: 80
|
|
level: warning
|
|
|
|
# don't bother me with this rule
|
|
indentation: disable
|
|
|
|
Within a YAML file, special comments can be used to disable checks for a single
|
|
line:
|
|
|
|
.. code:: yaml
|
|
|
|
This line is waaaaaaaaaay too long # yamllint disable-line
|
|
|
|
or for a whole block:
|
|
|
|
.. code:: yaml
|
|
|
|
# yamllint disable rule:colons
|
|
- Lorem : ipsum
|
|
dolor : sit amet,
|
|
consectetur : adipiscing elit
|
|
# yamllint enable
|
|
|
|
Specific files can be ignored (totally or for some rules only) using a
|
|
``.gitignore``-style pattern:
|
|
|
|
.. code:: yaml
|
|
|
|
# For all rules
|
|
ignore: |
|
|
*.dont-lint-me.yaml
|
|
/bin/
|
|
!/bin/*.lint-me-anyway.yaml
|
|
|
|
rules:
|
|
key-duplicates:
|
|
ignore: |
|
|
generated
|
|
*.template.yaml
|
|
trailing-spaces:
|
|
ignore: |
|
|
*.ignore-trailing-spaces.yaml
|
|
/ascii-art/*
|
|
|
|
`Read more in the complete documentation! <https://yamllint.readthedocs.io/>`__
|
|
|
|
|
|
.. |GitHub Badge| image:: https://badges.aleen42.com/src/github.svg
|
|
:target: https://github.com/adrienverge/yamllint
|
|
:alt: Github Repository
|
|
.. |PyPi version Badge| image:: https://img.shields.io/pypi/v/yamllint
|
|
:target: https://pypi.org/project/yamllint/
|
|
:alt: PyPI package version
|
|
.. |Python version Badge| image:: https://img.shields.io/pypi/pyversions/yamllint
|
|
:target: https://pypi.org/project/yamllint/
|
|
:alt: supported Python versions
|
|
.. |License Badge| image:: https://img.shields.io/pypi/l/yamllint?color=blue
|
|
:target: LICENSE
|
|
:alt: License
|
|
|
|
.. |CI status Badge| image:: https://travis-ci.org/adrienverge/yamllint.svg?branch=master
|
|
:target: https://travis-ci.org/adrienverge/yamllint
|
|
:alt: CI tests status
|
|
.. |Coverage Badge| image:: https://coveralls.io/repos/github/adrienverge/yamllint/badge.svg?branch=master
|
|
:target: https://coveralls.io/github/adrienverge/yamllint?branch=master
|
|
:alt: Code coverage status
|
|
.. |Docs Badge| image:: https://readthedocs.org/projects/yamllint/badge/?version=latest
|
|
:target: https://yamllint.readthedocs.io/en/latest/
|
|
:alt: Documentation status
|