A linter for YAML files.
Go to file
Adrien Vergé dbbecb5875 Refactor project layout to import yamllint alone
Currently importing yamllint recursively imports its submodules, which
finally requires having pyyaml installed. This is a problem when you
just want to import APP_VERSION from yamllint. For instance, setup.py
imports yamllint to know the version, but doesn't know yet that pyyaml
is to be installed, because it is stated in setup.py itself.

To solve this, yamllint/__init__.py will only contain constants. The
linting functions will be in yamllint/linter.py.
2016-01-24 17:48:20 +01:00
bin Introduce the 'cli' module and call it from the script 2016-01-20 17:39:26 +01:00
docs Refactor project layout to import yamllint alone 2016-01-24 17:48:20 +01:00
tests Tests: Remove Python 2.6 from CI tests 2016-01-24 17:39:36 +01:00
yamllint Refactor project layout to import yamllint alone 2016-01-24 17:48:20 +01:00
.gitignore Doc: Generate documentation with Sphinx 2016-01-22 18:20:28 +01:00
.travis.yml Tests: Remove Python 2.6 from CI tests 2016-01-24 17:39:36 +01:00
LICENSE Initial commit 2016-01-14 10:46:14 +01:00
README.rst Doc: Clarify Python compatibility in README 2016-01-23 14:32:02 +01:00
setup.py Distribution: Add new keywords 2016-01-24 15:03:38 +01:00

yamllint
========

A linter for YAML files.

.. image::
   https://travis-ci.org/adrienverge/yamllint.svg?branch=master
   :target: https://travis-ci.org/adrienverge/yamllint
   :alt: CI tests status
.. 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
.. image:: https://readthedocs.org/projects/yamllint/badge/?version=latest
   :target: http://yamllint.readthedocs.org/en/latest/?badge=latest
   :alt: Documentation status

Written in Python (compatible with Python 2 & 3).

Documentation
-------------

http://yamllint.readthedocs.org/

Short overview
--------------

Screenshot
^^^^^^^^^^

.. image:: docs/screenshot.png
   :alt: yamllint screenshot

Installation
^^^^^^^^^^^^

.. code:: bash

 pip install yamllint

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 custom lint configuration
 yamllint -c ~/myconfig file.yml

.. code:: bash

 # Output a parsable format (for syntax checking in editors like Vim, emacs...)
 yamllint -f parsable file.yml