mirror of
https://github.com/adrienverge/yamllint.git
synced 2024-11-22 07:36:25 -06:00
ebd6b90d3e
According to the YAML specification [^1]: - > It is an error for an alias node to use an anchor that does not > previously occur in the document. The `forbid-undeclared-aliases` option checks that aliases do have a matching anchor declared previously in the document. Since this is required by the YAML spec, this option is enabled by default. - > The alias refers to the most recent preceding node having the same > anchor. This means that having a same anchor repeated in a document is allowed. However users could want to avoid this, so the new option `forbid-duplicated-anchors` allows that. It's disabled by default. - > It is not an error to specify an anchor that is not used by any > alias node. This means that it's OK to declare anchors but don't have any alias referencing them. However users could want to avoid this, so a new option (e.g. `forbid-unused-anchors`) could be implemented in the future. See https://github.com/adrienverge/yamllint/pull/537. Fixes #395 Closes #420 [^1]: https://yaml.org/spec/1.2.2/#71-alias-nodes
132 lines
2.0 KiB
ReStructuredText
132 lines
2.0 KiB
ReStructuredText
Rules
|
|
=====
|
|
|
|
When linting a document with yamllint, a series of rules (such as
|
|
``line-length``, ``trailing-spaces``, etc.) are checked against.
|
|
|
|
A :doc:`configuration file <configuration>` can be used to enable or disable
|
|
these rules, to set their level (*error* or *warning*), but also to tweak their
|
|
options.
|
|
|
|
This page describes the rules and their options.
|
|
|
|
.. contents:: List of rules
|
|
:local:
|
|
:depth: 1
|
|
|
|
anchors
|
|
-------
|
|
|
|
.. automodule:: yamllint.rules.anchors
|
|
|
|
braces
|
|
------
|
|
|
|
.. automodule:: yamllint.rules.braces
|
|
|
|
brackets
|
|
--------
|
|
|
|
.. automodule:: yamllint.rules.brackets
|
|
|
|
colons
|
|
------
|
|
|
|
.. automodule:: yamllint.rules.colons
|
|
|
|
commas
|
|
------
|
|
|
|
.. automodule:: yamllint.rules.commas
|
|
|
|
comments
|
|
--------
|
|
|
|
.. automodule:: yamllint.rules.comments
|
|
|
|
comments-indentation
|
|
--------------------
|
|
|
|
.. automodule:: yamllint.rules.comments_indentation
|
|
|
|
document-end
|
|
------------
|
|
|
|
.. automodule:: yamllint.rules.document_end
|
|
|
|
document-start
|
|
--------------
|
|
|
|
.. automodule:: yamllint.rules.document_start
|
|
|
|
empty-lines
|
|
-----------
|
|
|
|
.. automodule:: yamllint.rules.empty_lines
|
|
|
|
empty-values
|
|
------------
|
|
|
|
.. automodule:: yamllint.rules.empty_values
|
|
|
|
float-values
|
|
------------
|
|
|
|
.. automodule:: yamllint.rules.float_values
|
|
|
|
|
|
hyphens
|
|
-------
|
|
|
|
.. automodule:: yamllint.rules.hyphens
|
|
|
|
indentation
|
|
-----------
|
|
|
|
.. automodule:: yamllint.rules.indentation
|
|
|
|
key-duplicates
|
|
--------------
|
|
|
|
.. automodule:: yamllint.rules.key_duplicates
|
|
|
|
key-ordering
|
|
--------------
|
|
|
|
.. automodule:: yamllint.rules.key_ordering
|
|
|
|
line-length
|
|
-----------
|
|
|
|
.. automodule:: yamllint.rules.line_length
|
|
|
|
new-line-at-end-of-file
|
|
-----------------------
|
|
|
|
.. automodule:: yamllint.rules.new_line_at_end_of_file
|
|
|
|
new-lines
|
|
---------
|
|
|
|
.. automodule:: yamllint.rules.new_lines
|
|
|
|
octal-values
|
|
------------
|
|
|
|
.. automodule:: yamllint.rules.octal_values
|
|
|
|
quoted-strings
|
|
--------------
|
|
|
|
.. automodule:: yamllint.rules.quoted_strings
|
|
|
|
trailing-spaces
|
|
---------------
|
|
|
|
.. automodule:: yamllint.rules.trailing_spaces
|
|
|
|
truthy
|
|
---------------
|
|
|
|
.. automodule:: yamllint.rules.truthy
|