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.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94bc01387ee9846cc340d9dcf8d8bece6b8636cd5862850a13c405b21f06cead |
|
MD5 | c79a6df8df6b77d0e9d6ec2a61120336 |
|
BLAKE2b-256 | 49a25bf5954850b8dfcc0d3af4faa369a38aa785397a0a9d88d65c9d5dda75c1 |