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.
 
 
Go to file
Adrien Vergé 38234a1d3c Doc: Generate documentation with Sphinx
HTML documentation should be built with sphinx. This enables easy
integration with Read The Docs [1]. It can also be generated manually by
running:

    make -C docs html

A man page can be generated by running:

    make -C docs man

[1]: http://yamllint.readthedocs.org/
9 years ago
bin Introduce the 'cli' module and call it from the script 9 years ago
docs Doc: Generate documentation with Sphinx 9 years ago
tests Rules: indentation: Add 'check-multi-line-strings' option 9 years ago
yamllint Doc: Generate documentation with Sphinx 9 years ago
.gitignore Doc: Generate documentation with Sphinx 9 years ago
.travis.yml Tests: Travis and Coveralls integration 9 years ago
LICENSE Initial commit 9 years ago
README.md cli: Allow passing directories as arguments 9 years ago
setup.py Tests: Travis and Coveralls integration 9 years ago

README.md

yamllint

A linter for YAML files.

Build Status Coverage Status

Compatible with Python 2 & 3.

Usage

yamllint my_file.yml my_other_file.yaml ...
yamllint .
yamllint -c ~/myconfig file.yml
# To output a format parsable (by editors like Vim, emacs, etc.)
yamllint -f parsable file.yml

Installation

pip install yamllint

Configuration

There is no documentation yet, so here is what you need to know: you can override some rules, disable them or pass them in warning (instead of error). Have a look at the content of yamllint/conf/default.yml and create your own configuration file.

It could look like this:

# This is my first, very own configuration file for yamllint!
# It extends the default conf by adjusting some options.

extends: default

rules:
  # 80 should be enough, but don't fail if a line is longer
  line-length:
    max: 80
    level: warning

  # accept both
  #    key:
  #      - item
  # and
  #    key:
  #    - item
  indentation:
    indent-sequences: whatever

  # don't bother me with this rule
  comments-indentation: disable

Tip: if you have a .yamllint file in your working directory, it will be automatically loaded as configuration by yamllint.