ansible-later/docs/content/build_rules/standards_check.md

34 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2020-01-14 23:15:13 +00:00
---
title: Minimal standard checks
2020-01-14 23:15:13 +00:00
---
A typical standards check will look like:
<!-- prettier-ignore-start -->
<!-- spellchecker-disable -->
2020-01-14 23:15:13 +00:00
{{< highlight Python "linenos=table" >}}
class CheckBecomeUser(StandardBase):
sid = "ANSIBLE0015"
description = "Become should be combined with become_user"
helptext = "the task has `become` enabled but `become_user` is missing"
version = "0.1"
types = ["playbook", "task", "handler"]
def check(self, candidate, settings):
tasks, errors = self.get_normalized_tasks(candidate, settings)
true_value = [True, "true", "True", "TRUE", "yes", "Yes", "YES"]
if not errors:
gen = (task for task in tasks if "become" in task)
for task in gen:
if task["become"] in true_value and "become_user" not in task.keys():
errors.append(self.Error(task["__line__"], self.helptext))
return self.Result(candidate.path, errors)
2020-01-14 23:15:13 +00:00
{{< /highlight >}}
<!-- spellchecker-enable -->
<!-- prettier-ignore-end -->
2020-01-14 23:15:13 +00:00
They return a `Result` object, which contains a possibly empty list of `Error` objects. `Error` objects are formed of a line number and a message. If the error applies to the whole file being reviewed, set the line number to `None`.