yamllint


Ⅰ. 插件描述

A linter for YAML files.

Ⅱ. 基本信息

创建日期:  2016-01-11
使用用户:  2
Github星:  988
插件作者:  Adrien Vergé

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:
Plugin 'adrienverge/yamllint'
… 然后在Vim中运行以下命令:
:source %
:PluginInstall

对于Vundle版本 < 0.10.2,请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:
NeoBundle 'adrienverge/yamllint'
… 然后在Vim中运行以下命令:
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:
Plug 'adrienverge/yamllint'
… 然后在Vim中运行以下命令:
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:
cd ~/.vim/bundle
git clone https://github.com/adrienverge/yamllint

Ⅳ. 文档说明

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.

.. 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: https://yamllint.readthedocs.io/en/latest/?badge=latest
:alt: Documentation status

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

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/>_

License

GPL version 3 <LICENSE>_

添加新评论