1a0d8a51cd
Parse errors from libyaml now compensate for the offset of the documentation within a module.
249 lines
7.4 KiB
Python
249 lines
7.4 KiB
Python
#!/usr/bin/env python
|
|
"""Wrapper around yamllint that supports YAML embedded in Ansible modules."""
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
import ast
|
|
import json
|
|
import os
|
|
import sys
|
|
|
|
import yaml
|
|
from yaml.resolver import Resolver
|
|
from yaml.constructor import SafeConstructor
|
|
from yaml.error import MarkedYAMLError
|
|
from _yaml import CParser # pylint: disable=no-name-in-module
|
|
|
|
from yamllint import linter
|
|
from yamllint.config import YamlLintConfig
|
|
|
|
|
|
def main():
|
|
"""Main program body."""
|
|
paths = sys.argv[1:] or sys.stdin.read().splitlines()
|
|
|
|
checker = YamlChecker()
|
|
checker.check(paths)
|
|
checker.report()
|
|
|
|
|
|
class TestConstructor(SafeConstructor):
|
|
"""Yaml Safe Constructor that knows about Ansible tags"""
|
|
|
|
|
|
TestConstructor.add_constructor(
|
|
u'!unsafe',
|
|
TestConstructor.construct_yaml_str)
|
|
|
|
|
|
TestConstructor.add_constructor(
|
|
u'!vault',
|
|
TestConstructor.construct_yaml_str)
|
|
|
|
|
|
TestConstructor.add_constructor(
|
|
u'!vault-encrypted',
|
|
TestConstructor.construct_yaml_str)
|
|
|
|
|
|
class TestLoader(CParser, TestConstructor, Resolver):
|
|
def __init__(self, stream):
|
|
CParser.__init__(self, stream)
|
|
TestConstructor.__init__(self)
|
|
Resolver.__init__(self)
|
|
|
|
|
|
class YamlChecker:
|
|
"""Wrapper around yamllint that supports YAML embedded in Ansible modules."""
|
|
def __init__(self):
|
|
self.messages = []
|
|
|
|
def report(self):
|
|
"""Print yamllint report to stdout."""
|
|
report = dict(
|
|
messages=self.messages,
|
|
)
|
|
|
|
print(json.dumps(report, indent=4, sort_keys=True))
|
|
|
|
def check(self, paths):
|
|
"""
|
|
:type paths: str
|
|
"""
|
|
config_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'config')
|
|
|
|
yaml_conf = YamlLintConfig(file=os.path.join(config_path, 'default.yml'))
|
|
module_conf = YamlLintConfig(file=os.path.join(config_path, 'modules.yml'))
|
|
plugin_conf = YamlLintConfig(file=os.path.join(config_path, 'plugins.yml'))
|
|
|
|
for path in paths:
|
|
extension = os.path.splitext(path)[1]
|
|
|
|
with open(path) as f:
|
|
contents = f.read()
|
|
|
|
if extension in ('.yml', '.yaml'):
|
|
self.check_yaml(yaml_conf, path, contents)
|
|
elif extension == '.py':
|
|
if path.startswith('lib/ansible/modules/') or path.startswith('plugins/modules/'):
|
|
conf = module_conf
|
|
else:
|
|
conf = plugin_conf
|
|
|
|
self.check_module(conf, path, contents)
|
|
else:
|
|
raise Exception('unsupported extension: %s' % extension)
|
|
|
|
def check_yaml(self, conf, path, contents):
|
|
"""
|
|
:type conf: YamlLintConfig
|
|
:type path: str
|
|
:type contents: str
|
|
"""
|
|
self.check_parsable(path, contents)
|
|
self.messages += [self.result_to_message(r, path) for r in linter.run(contents, conf, path)]
|
|
|
|
def check_module(self, conf, path, contents):
|
|
"""
|
|
:type conf: YamlLintConfig
|
|
:type path: str
|
|
:type contents: str
|
|
"""
|
|
docs = self.get_module_docs(path, contents)
|
|
|
|
for key, value in docs.items():
|
|
yaml_data = value['yaml']
|
|
lineno = value['lineno']
|
|
|
|
if yaml_data.startswith('\n'):
|
|
yaml_data = yaml_data[1:]
|
|
lineno += 1
|
|
|
|
self.check_parsable(path, yaml_data, lineno)
|
|
|
|
messages = list(linter.run(yaml_data, conf, path))
|
|
|
|
self.messages += [self.result_to_message(r, path, lineno - 1, key) for r in messages]
|
|
|
|
def check_parsable(self, path, contents, lineno=1):
|
|
"""
|
|
:type path: str
|
|
:type contents: str
|
|
:type lineno: int
|
|
"""
|
|
try:
|
|
yaml.load(contents, Loader=TestLoader)
|
|
except MarkedYAMLError as e:
|
|
self.messages += [{'code': 'unparsable-with-libyaml',
|
|
'message': '%s - %s' % (e.args[0], e.args[2]),
|
|
'path': path,
|
|
'line': e.problem_mark.line + lineno,
|
|
'column': e.problem_mark.column + 1,
|
|
'level': 'error',
|
|
}]
|
|
|
|
@staticmethod
|
|
def result_to_message(result, path, line_offset=0, prefix=''):
|
|
"""
|
|
:type result: any
|
|
:type path: str
|
|
:type line_offset: int
|
|
:type prefix: str
|
|
:rtype: dict[str, any]
|
|
"""
|
|
if prefix:
|
|
prefix = '%s: ' % prefix
|
|
|
|
return dict(
|
|
code=result.rule or result.level,
|
|
message=prefix + result.desc,
|
|
path=path,
|
|
line=result.line + line_offset,
|
|
column=result.column,
|
|
level=result.level,
|
|
)
|
|
|
|
def get_module_docs(self, path, contents):
|
|
"""
|
|
:type path: str
|
|
:type contents: str
|
|
:rtype: dict[str, any]
|
|
"""
|
|
module_doc_types = [
|
|
'DOCUMENTATION',
|
|
'EXAMPLES',
|
|
'RETURN',
|
|
]
|
|
|
|
docs = {}
|
|
|
|
def check_assignment(statement, doc_types=None):
|
|
"""Check the given statement for a documentation assignment."""
|
|
for target in statement.targets:
|
|
if isinstance(target, ast.Tuple):
|
|
continue
|
|
|
|
if doc_types and target.id not in doc_types:
|
|
continue
|
|
|
|
docs[target.id] = dict(
|
|
yaml=statement.value.s,
|
|
lineno=statement.lineno,
|
|
end_lineno=statement.lineno + len(statement.value.s.splitlines())
|
|
)
|
|
|
|
module_ast = self.parse_module(path, contents)
|
|
|
|
if not module_ast:
|
|
return {}
|
|
|
|
is_plugin = path.startswith('lib/ansible/modules/') or path.startswith('lib/ansible/plugins/') or path.startswith('plugins/')
|
|
is_doc_fragment = path.startswith('lib/ansible/plugins/doc_fragments/') or path.startswith('plugins/doc_fragments/')
|
|
|
|
if is_plugin and not is_doc_fragment:
|
|
for body_statement in module_ast.body:
|
|
if isinstance(body_statement, ast.Assign):
|
|
check_assignment(body_statement, module_doc_types)
|
|
elif is_doc_fragment:
|
|
for body_statement in module_ast.body:
|
|
if isinstance(body_statement, ast.ClassDef):
|
|
for class_statement in body_statement.body:
|
|
if isinstance(class_statement, ast.Assign):
|
|
check_assignment(class_statement)
|
|
else:
|
|
raise Exception('unsupported path: %s' % path)
|
|
|
|
return docs
|
|
|
|
def parse_module(self, path, contents):
|
|
"""
|
|
:type path: str
|
|
:type contents: str
|
|
:rtype: ast.Module | None
|
|
"""
|
|
try:
|
|
return ast.parse(contents)
|
|
except SyntaxError as ex:
|
|
self.messages.append(dict(
|
|
code='python-syntax-error',
|
|
message=str(ex),
|
|
path=path,
|
|
line=ex.lineno,
|
|
column=ex.offset,
|
|
level='error',
|
|
))
|
|
except Exception as ex: # pylint: disable=broad-except
|
|
self.messages.append(dict(
|
|
code='python-parse-error',
|
|
message=str(ex),
|
|
path=path,
|
|
line=0,
|
|
column=0,
|
|
level='error',
|
|
))
|
|
|
|
return None
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|