experimental/sources/: yamllint-1.35.1 metadata and description

Simple index

A linter for YAML files.

author Adrien Vergé
classifiers
  • Development Status :: 5 - Production/Stable
  • Environment :: Console
  • Intended Audience :: Developers
  • License :: OSI Approved :: GNU General Public License v3 (GPLv3)
  • Programming Language :: Python
  • Topic :: Software Development
  • Topic :: Software Development :: Debuggers
  • Topic :: Software Development :: Quality Assurance
  • Topic :: Software Development :: Testing
description_content_type text/x-rst
keywords yaml,lint,linter,syntax,checker
license GPL-3.0-or-later
project_urls
  • homepage, https://github.com/adrienverge/yamllint
  • repository, https://github.com/adrienverge/yamllint
  • documentation, https://yamllint.readthedocs.io
provides_extras dev
requires_dist
  • pathspec>=0.5.3
  • pyyaml
  • doc8; extra == "dev"
  • flake8; extra == "dev"
  • flake8-import-order; extra == "dev"
  • rstcheck[sphinx]; extra == "dev"
  • sphinx; extra == "dev"
requires_python >=3.8
File Tox results History
yamllint-1.35.1.tar.gz
Size
131 KB
Type
Source

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.

CI tests status Code coverage status Documentation status

Written in Python (compatible with Python 3 only).

Documentation

https://yamllint.readthedocs.io/

Overview

Screenshot

yamllint screenshot

Installation

Using pip, the Python package manager:

pip install --user yamllint

yamllint is also packaged for all major operating systems, see installation examples (dnf, apt-get…) in the documentation.

Usage

# Lint one or more files
yamllint my_file.yml my_other_file.yaml ...
# Lint all YAML files in a directory
yamllint .
# 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
# Output a parsable format (for syntax checking in editors like Vim, emacs...)
yamllint -f parsable file.yaml

Read more in the complete documentation!

Features

Here is a yamllint configuration file example:

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:

This line is waaaaaaaaaay too long  # yamllint disable-line

or for a whole block:

# 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:

# 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!

License

GPL version 3