A CLI tool to perform syntactic and semantic validation of YAML files.
Project description
iac-validate
A CLI tool to perform syntactic and semantic validation of YAML files.
$ iac-validate -h
Usage: iac-validate [OPTIONS] PATH
A CLI tool to perform syntactic and semantic validation of YAML files.
Options:
--version Show the version and exit.
-v, --verbosity LVL Either CRITICAL, ERROR, WARNING, INFO or DEBUG
-s, --schema FILE Path to schema file.
-r, --rules DIRECTORY Path to semantic rules.
-h, --help Show this message and exit.
Syntactic validation is done by providing a Yamale schema and validating all YAML files against that schema. Semantic validation is done by providing a set of rules (implemented in Python) which are then validated against the YAML data. Every rule is implemented as a Python class and should be placed in a .py
file located in the --rules
path.
Each .py
file must have a single class named Rule
. This class must have the following attributes: id
, description
and severity
. It must implement a classmethod()
named match
that has a single function argument data
which is the data read from all YAML files. It should return a list of strings, one for each rule violation with a descriptive message. A sample rule can be found below.
class Rule:
id = "101"
description = "Verify child naming restrictions"
severity = "HIGH"
@classmethod
def match(cls, data):
results = []
try:
for child in data["root"]["children"]:
if child["name"] == "FORBIDDEN":
results.append("root.children.name" + " - " + str(child["name"]))
except KeyError:
pass
return results
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for iac_validate-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e6f03d613403a4c9f580da3c53135c4a92f2c4341b06d4bb74cd78823fbb0b0a |
|
MD5 | ee98830f5d2a36565a513a63902c2452 |
|
BLAKE2b-256 | c03f2cfc72202ba3786ee70da8d883ca6ec463a0602e0224de46461a92abd610 |