mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-11-18 10:50:40 +00:00
150 lines
4.7 KiB
Python
150 lines
4.7 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright (C) 2016 Adrien Vergé
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""
|
|
Use this rule to set a limit to lines length.
|
|
|
|
Note: with Python 2, the ``line-length`` rule may not work properly with
|
|
unicode characters because of the way strings are represented in bytes. We
|
|
recommend running yamllint with Python 3.
|
|
|
|
.. rubric:: Options
|
|
|
|
* ``max`` defines the maximal (inclusive) length of lines.
|
|
* ``allow-non-breakable-words`` is used to allow non breakable words (without
|
|
spaces inside) to overflow the limit. This is useful for long URLs, for
|
|
instance. Use ``true`` to allow, ``false`` to forbid.
|
|
* ``allow-non-breakable-inline-mappings`` implies ``allow-non-breakable-words``
|
|
and extends it to also allow non-breakable words in inline mappings.
|
|
|
|
.. rubric:: Examples
|
|
|
|
#. With ``line-length: {max: 70}``
|
|
|
|
the following code snippet would **PASS**:
|
|
::
|
|
|
|
long sentence:
|
|
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
|
|
eiusmod tempor incididunt ut labore et dolore magna aliqua.
|
|
|
|
the following code snippet would **FAIL**:
|
|
::
|
|
|
|
long sentence:
|
|
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
|
|
tempor incididunt ut labore et dolore magna aliqua.
|
|
|
|
#. With ``line-length: {max: 60, allow-non-breakable-words: true}``
|
|
|
|
the following code snippet would **PASS**:
|
|
::
|
|
|
|
this:
|
|
is:
|
|
- a:
|
|
http://localhost/very/very/very/very/very/very/very/very/long/url
|
|
|
|
# this comment is too long,
|
|
# but hard to split:
|
|
# http://localhost/another/very/very/very/very/very/very/very/very/long/url
|
|
|
|
the following code snippet would **FAIL**:
|
|
::
|
|
|
|
- this line is waaaaaaaaaaaaaay too long but could be easily split...
|
|
|
|
and the following code snippet would also **FAIL**:
|
|
::
|
|
|
|
- foobar: http://localhost/very/very/very/very/very/very/very/very/long/url
|
|
|
|
#. With ``line-length: {max: 60, allow-non-breakable-words: true,
|
|
allow-non-breakable-inline-mappings: true}``
|
|
|
|
the following code snippet would **PASS**:
|
|
::
|
|
|
|
- foobar: http://localhost/very/very/very/very/very/very/very/very/long/url
|
|
|
|
#. With ``line-length: {max: 60, allow-non-breakable-words: false}``
|
|
|
|
the following code snippet would **FAIL**:
|
|
::
|
|
|
|
this:
|
|
is:
|
|
- a:
|
|
http://localhost/very/very/very/very/very/very/very/very/long/url
|
|
"""
|
|
|
|
|
|
import yaml
|
|
|
|
from yamllint.linter import LintProblem
|
|
|
|
|
|
ID = 'line-length'
|
|
TYPE = 'line'
|
|
CONF = {'max': int,
|
|
'allow-non-breakable-words': bool,
|
|
'allow-non-breakable-inline-mappings': bool}
|
|
DEFAULT = {'max': 80,
|
|
'allow-non-breakable-words': True,
|
|
'allow-non-breakable-inline-mappings': False}
|
|
|
|
|
|
def check_inline_mapping(line):
|
|
loader = yaml.SafeLoader(line.content)
|
|
try:
|
|
while loader.peek_token():
|
|
if isinstance(loader.get_token(), yaml.BlockMappingStartToken):
|
|
while loader.peek_token():
|
|
if isinstance(loader.get_token(), yaml.ValueToken):
|
|
t = loader.get_token()
|
|
if isinstance(t, yaml.ScalarToken):
|
|
return (
|
|
' ' not in line.content[t.start_mark.column:])
|
|
except yaml.scanner.ScannerError:
|
|
pass
|
|
|
|
return False
|
|
|
|
|
|
def check(conf, line):
|
|
if line.end - line.start > conf['max']:
|
|
conf['allow-non-breakable-words'] |= \
|
|
conf['allow-non-breakable-inline-mappings']
|
|
if conf['allow-non-breakable-words']:
|
|
start = line.start
|
|
while start < line.end and line.buffer[start] == ' ':
|
|
start += 1
|
|
|
|
if start != line.end:
|
|
if line.buffer[start] in ('#', '-'):
|
|
start += 2
|
|
|
|
if line.buffer.find(' ', start, line.end) == -1:
|
|
return
|
|
|
|
if (conf['allow-non-breakable-inline-mappings'] and
|
|
check_inline_mapping(line)):
|
|
return
|
|
|
|
yield LintProblem(line.line_no, conf['max'] + 1,
|
|
'line too long (%d > %d characters)' %
|
|
(line.end - line.start, conf['max']))
|