2019-03-27 16:00:38 +00:00
|
|
|
"""Default package."""
|
|
|
|
|
2018-12-19 10:19:07 +00:00
|
|
|
__author__ = "Robert Kaussow"
|
|
|
|
__project__ = "ansible-later"
|
2019-03-25 10:30:41 +00:00
|
|
|
__version__ = "0.1.5"
|
2018-12-19 10:19:07 +00:00
|
|
|
__license__ = "MIT"
|
|
|
|
__maintainer__ = "Robert Kaussow"
|
|
|
|
__email__ = "mail@geeklabor.de"
|
|
|
|
__status__ = "Production"
|
|
|
|
|
|
|
|
import codecs
|
2019-03-27 16:00:38 +00:00
|
|
|
import os
|
|
|
|
import re
|
2018-12-19 10:19:07 +00:00
|
|
|
from distutils.version import LooseVersion
|
2019-03-27 16:00:38 +00:00
|
|
|
|
|
|
|
import ansible
|
|
|
|
|
|
|
|
from ansiblelater.utils import (abort, error, get_property, info,
|
|
|
|
is_line_in_ranges, lines_ranges,
|
|
|
|
read_standards, standards_latest, warn)
|
|
|
|
from .settings import Settings
|
2018-12-19 10:19:07 +00:00
|
|
|
|
|
|
|
try:
|
|
|
|
# Ansible 2.4 import of module loader
|
|
|
|
from ansible.plugins.loader import module_loader
|
|
|
|
except ImportError:
|
|
|
|
try:
|
|
|
|
from ansible.plugins import module_loader
|
|
|
|
except ImportError:
|
|
|
|
from ansible.utils import module_finder as module_loader
|
|
|
|
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
config = Settings()
|
2018-12-19 10:19:07 +00:00
|
|
|
|
|
|
|
|
|
|
|
class Standard(object):
|
2019-03-27 16:00:38 +00:00
|
|
|
"""
|
|
|
|
Standard definition for all defined rules.
|
|
|
|
|
|
|
|
Later lookup the config file for a path to a rules directory
|
|
|
|
or fallback to default `ansiblelater/examples/*`.
|
|
|
|
"""
|
|
|
|
|
2018-12-19 10:19:07 +00:00
|
|
|
def __init__(self, standard_dict):
|
2019-03-27 16:00:38 +00:00
|
|
|
"""
|
|
|
|
Initialize a new standard object and returns None.
|
|
|
|
|
|
|
|
:param standard_dict: Dictionary object containing all neseccary attributes
|
|
|
|
"""
|
|
|
|
if "id" not in standard_dict:
|
|
|
|
standard_dict.update(id="")
|
2018-12-19 10:19:07 +00:00
|
|
|
else:
|
2019-03-27 16:00:38 +00:00
|
|
|
standard_dict.update(id="[{}] ".format(standard_dict.get("id")))
|
|
|
|
|
2018-12-19 10:19:07 +00:00
|
|
|
self.id = standard_dict.get("id")
|
|
|
|
self.name = standard_dict.get("name")
|
|
|
|
self.version = standard_dict.get("version")
|
|
|
|
self.check = standard_dict.get("check")
|
|
|
|
self.types = standard_dict.get("types")
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
def __repr__(self): # noqa
|
2018-12-19 10:19:07 +00:00
|
|
|
return "Standard: %s (version: %s, types: %s)" % (
|
|
|
|
self.name, self.version, self.types)
|
|
|
|
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
class Candidate(object):
|
|
|
|
"""
|
|
|
|
Meta object for all files which later has to process.
|
2018-12-19 10:19:07 +00:00
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
Each file passed to later will be classified by type and
|
|
|
|
bundled with necessary meta informations for rule processing.
|
|
|
|
"""
|
2018-12-19 10:19:07 +00:00
|
|
|
|
|
|
|
def __init__(self, filename):
|
|
|
|
self.path = filename
|
2019-01-29 15:27:56 +00:00
|
|
|
self.binary = False
|
|
|
|
self.vault = False
|
|
|
|
|
2018-12-19 10:19:07 +00:00
|
|
|
try:
|
|
|
|
self.version = find_version(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
with codecs.open(filename, mode="rb", encoding="utf-8") as f:
|
2019-01-29 15:27:56 +00:00
|
|
|
if f.readline().startswith("$ANSIBLE_VAULT"):
|
|
|
|
self.vault = True
|
2018-12-19 10:19:07 +00:00
|
|
|
except UnicodeDecodeError:
|
|
|
|
self.binary = True
|
|
|
|
|
|
|
|
self.filetype = type(self).__name__.lower()
|
|
|
|
self.expected_version = True
|
|
|
|
|
|
|
|
def review(self, settings, lines=None):
|
|
|
|
return candidate_review(self, settings, lines)
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
def __repr__(self): # noqa
|
2018-12-19 10:19:07 +00:00
|
|
|
return "%s (%s)" % (type(self).__name__, self.path)
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
def __getitem__(self, item): # noqa
|
2018-12-19 10:19:07 +00:00
|
|
|
return self.__dict__.get(item)
|
|
|
|
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
class Error(object):
|
|
|
|
"""Default error object created if a rule failed."""
|
|
|
|
|
|
|
|
def __init__(self, lineno, message):
|
|
|
|
"""
|
|
|
|
Initialize a new error object and returns None.
|
|
|
|
|
|
|
|
:param lineno: Line number where the error from de rule occures
|
|
|
|
:param message: Detailed error description provided by the rule
|
|
|
|
"""
|
|
|
|
self.lineno = lineno
|
|
|
|
self.message = message
|
|
|
|
|
|
|
|
def __repr__(self): # noqa
|
|
|
|
if self.lineno:
|
|
|
|
return "%s: %s" % (self.lineno, self.message)
|
|
|
|
else:
|
|
|
|
return " %s" % (self.message)
|
|
|
|
|
|
|
|
|
|
|
|
class Result(object):
|
|
|
|
def __init__(self, candidate, errors=None):
|
|
|
|
self.candidate = candidate
|
|
|
|
self.errors = errors or []
|
|
|
|
|
|
|
|
def message(self):
|
|
|
|
return "\n".join(["{0}:{1}".format(self.candidate, error)
|
|
|
|
for error in self.errors])
|
|
|
|
|
|
|
|
|
2018-12-19 10:19:07 +00:00
|
|
|
class RoleFile(Candidate):
|
|
|
|
def __init__(self, filename):
|
|
|
|
super(RoleFile, self).__init__(filename)
|
|
|
|
self.version = None
|
|
|
|
parentdir = os.path.dirname(os.path.abspath(filename))
|
|
|
|
while parentdir != os.path.dirname(parentdir):
|
|
|
|
meta_file = os.path.join(parentdir, "meta", "main.yml")
|
|
|
|
if os.path.exists(meta_file):
|
|
|
|
self.version = find_version(meta_file)
|
|
|
|
if self.version:
|
|
|
|
break
|
|
|
|
parentdir = os.path.dirname(parentdir)
|
2019-03-27 16:00:38 +00:00
|
|
|
role_modules = os.path.join(parentdir, "library")
|
2018-12-19 10:19:07 +00:00
|
|
|
if os.path.exists(role_modules):
|
|
|
|
module_loader.add_directory(role_modules)
|
|
|
|
|
|
|
|
|
|
|
|
class Playbook(Candidate):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Task(RoleFile):
|
|
|
|
def __init__(self, filename):
|
|
|
|
super(Task, self).__init__(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
self.filetype = "tasks"
|
2018-12-19 10:19:07 +00:00
|
|
|
|
|
|
|
|
|
|
|
class Handler(RoleFile):
|
|
|
|
def __init__(self, filename):
|
|
|
|
super(Handler, self).__init__(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
self.filetype = "handlers"
|
2018-12-19 10:19:07 +00:00
|
|
|
|
|
|
|
|
|
|
|
class Vars(Candidate):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Unversioned(Candidate):
|
|
|
|
def __init__(self, filename):
|
|
|
|
super(Unversioned, self).__init__(filename)
|
|
|
|
self.expected_version = False
|
|
|
|
|
|
|
|
|
|
|
|
class InventoryVars(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class HostVars(InventoryVars):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class GroupVars(InventoryVars):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class RoleVars(RoleFile):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Meta(RoleFile):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Inventory(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Code(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Template(RoleFile):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Doc(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
# For ease of checking files for tabs
|
|
|
|
class Makefile(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class File(RoleFile):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
class Rolesfile(Unversioned):
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
def classify(filename):
|
|
|
|
parentdir = os.path.basename(os.path.dirname(filename))
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
if parentdir in ["tasks"]:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Task(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if parentdir in ["handlers"]:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Handler(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if parentdir in ["vars", "defaults"]:
|
2018-12-19 10:19:07 +00:00
|
|
|
return RoleVars(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "group_vars" in filename.split(os.sep):
|
2018-12-19 10:19:07 +00:00
|
|
|
return GroupVars(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "host_vars" in filename.split(os.sep):
|
2018-12-19 10:19:07 +00:00
|
|
|
return HostVars(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if parentdir in ["meta"]:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Meta(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if parentdir in ["library", "lookup_plugins", "callback_plugins",
|
|
|
|
"filter_plugins"] or filename.endswith(".py"):
|
2018-12-19 10:19:07 +00:00
|
|
|
return Code(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "inventory" in filename or "hosts" in filename or parentdir in ["inventory"]:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Inventory(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "rolesfile" in filename or "requirements" in filename:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Rolesfile(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "Makefile" in filename:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Makefile(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "templates" in filename.split(os.sep) or filename.endswith(".j2"):
|
2018-12-19 10:19:07 +00:00
|
|
|
return Template(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "files" in filename.split(os.sep):
|
2018-12-19 10:19:07 +00:00
|
|
|
return File(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if filename.endswith(".yml") or filename.endswith(".yaml"):
|
2018-12-19 10:19:07 +00:00
|
|
|
return Playbook(filename)
|
2019-03-27 16:00:38 +00:00
|
|
|
if "README" in filename:
|
2018-12-19 10:19:07 +00:00
|
|
|
return Doc(filename)
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
|
|
def candidate_review(candidate, settings, lines=None):
|
|
|
|
errors = 0
|
|
|
|
standards = read_standards(settings)
|
2019-03-27 16:00:38 +00:00
|
|
|
if getattr(standards, "ansible_min_version", None) and \
|
2018-12-19 10:19:07 +00:00
|
|
|
LooseVersion(standards.ansible_min_version) > LooseVersion(ansible.__version__):
|
|
|
|
raise SystemExit("Standards require ansible version %s (current version %s). "
|
|
|
|
"Please upgrade ansible." %
|
|
|
|
(standards.ansible_min_version, ansible.__version__))
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
if getattr(standards, "ansible_review_min_version", None) and \
|
2018-12-19 10:19:07 +00:00
|
|
|
LooseVersion(standards.ansible_review_min_version) > LooseVersion(
|
|
|
|
get_property("__version__")):
|
|
|
|
raise SystemExit("Standards require ansible-later version %s (current version %s). "
|
|
|
|
"Please upgrade ansible-later." %
|
|
|
|
(standards.ansible_review_min_version, get_property("__version__")))
|
|
|
|
|
|
|
|
if not candidate.version:
|
|
|
|
candidate.version = standards_latest(standards.standards)
|
|
|
|
if candidate.expected_version:
|
|
|
|
if isinstance(candidate, RoleFile):
|
|
|
|
warn("%s %s is in a role that contains a meta/main.yml without a declared "
|
|
|
|
"standards version. "
|
|
|
|
"Using latest standards version %s" %
|
|
|
|
(type(candidate).__name__, candidate.path, candidate.version),
|
|
|
|
settings)
|
|
|
|
else:
|
|
|
|
warn("%s %s does not present standards version. "
|
|
|
|
"Using latest standards version %s" %
|
|
|
|
(type(candidate).__name__, candidate.path, candidate.version),
|
|
|
|
settings)
|
|
|
|
|
|
|
|
info("%s %s declares standards version %s" %
|
|
|
|
(type(candidate).__name__, candidate.path, candidate.version),
|
|
|
|
settings)
|
|
|
|
|
|
|
|
for standard in standards.standards:
|
2019-03-27 16:00:38 +00:00
|
|
|
print(type(standard))
|
2018-12-19 10:19:07 +00:00
|
|
|
if type(candidate).__name__.lower() not in standard.types:
|
|
|
|
continue
|
|
|
|
if settings.standards_filter and standard.name not in settings.standards_filter:
|
|
|
|
continue
|
|
|
|
result = standard.check(candidate, settings)
|
|
|
|
|
|
|
|
if not result:
|
|
|
|
abort("Standard '%s' returns an empty result object." %
|
|
|
|
(standard.check.__name__))
|
|
|
|
|
|
|
|
for err in [err for err in result.errors
|
|
|
|
if not err.lineno or is_line_in_ranges(err.lineno, lines_ranges(lines))]:
|
|
|
|
if not standard.version:
|
|
|
|
warn("{id}Best practice '{name}' not met:\n{path}:{error}".format(
|
|
|
|
id=standard.id, name=standard.name, path=candidate.path, error=err), settings)
|
|
|
|
elif LooseVersion(standard.version) > LooseVersion(candidate.version):
|
|
|
|
warn("{id}Future standard '{name}' not met:\n{path}:{error}".format(
|
|
|
|
id=standard.id, name=standard.name, path=candidate.path, error=err), settings)
|
|
|
|
else:
|
|
|
|
error("{id}Standard '{name}' not met:\n{path}:{error}".format(
|
|
|
|
id=standard.id, name=standard.name, path=candidate.path, error=err))
|
|
|
|
errors = errors + 1
|
|
|
|
if not result.errors:
|
|
|
|
if not standard.version:
|
|
|
|
info("Best practice '%s' met" % standard.name, settings)
|
|
|
|
elif LooseVersion(standard.version) > LooseVersion(candidate.version):
|
|
|
|
info("Future standard '%s' met" % standard.name, settings)
|
|
|
|
else:
|
|
|
|
info("Standard '%s' met" % standard.name, settings)
|
|
|
|
|
|
|
|
return errors
|
|
|
|
|
|
|
|
|
|
|
|
def find_version(filename, version_regex=r"^# Standards:\s*([\d.]+)"):
|
|
|
|
version_re = re.compile(version_regex)
|
|
|
|
|
2019-03-27 16:00:38 +00:00
|
|
|
with codecs.open(filename, mode="rb", encoding="utf-8") as f:
|
2018-12-19 10:19:07 +00:00
|
|
|
for line in f:
|
|
|
|
match = version_re.match(line)
|
|
|
|
if match:
|
|
|
|
return match.group(1)
|
|
|
|
return None
|
2019-03-27 16:00:38 +00:00
|
|
|
|