YAML validator for the CLI
Project description
Step Function Validator for e.g. (AWS)
An issue we have is that we are quite human and we often make mistakes in the YAML "code".
These could be syntactical errors (for example, an incorrect indent), but also semantical (for example, forgetting to add a required parameter to a step).
We only find out about these errors in the last step of the CI/CD, when the step function fails to deploy to AWS. This makes troubleshooting very.. slow...
So we came up with this little tool.
Authors
Installation
- create virtual environment in python and activate this one in Terminal or CMD
python3 -m venv env
Windows:
env\Script\activate.bat
Mac/Linux:
source env/bin/activate
- pip install the tool via pypi
####################### [ NOTE !!! ] ############################################################
# you NEED to see in your command line the env before your prompt
# so you know that you are in your virtual environment:
#
# example: (env) niels@Mac%
################################################################################################
if above is clear then:
pip install stepfunction-validator or pip3 install stepfunction-validator # to install the required libraries and the tool
Usage/Examples
stepfunction_validator.exe [-s test.yaml] [-j <stepfunctions_schema.json>] [--no-lint]
This will validate a YAML file against the schema you provided in the CLI. If the -c parameter is omitted, the script runs against every .yml file it can find in the current working directory. A default schema for AWS stepfunctions is included, but an overriding schema can be passed with the -j parameters. Skip linting with "--no-lint". If any linting, syntax or schema errors are found an exit code 1 will be returned with a list of errors found. Example output:
.\test\step_function_invalid.yml:1:missing document start "---" (document-start)
.\test\step_function_invalid.yml:1:no new line character at the end of file (new-line-at-end-of-file)
.\test\step_function_invalid.yml:'Pass' is not one of ['Choice']. Failed validating enum in deque([0, 'properties', 'Type', 'enum']): {'type': 'string', 'enum': ['Choice']}
Project details
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 stepfunction_validator-0.0.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72d299487c45b0a6214f4969031c5f1d05e85e005bec1dc616ca3bd9d4f703e1 |
|
MD5 | 7767ba0699c14ceb8dfa9b6dcc5de0dd |
|
BLAKE2b-256 | e757747d724ff23210852ec38caa8430e46ec69105c313dcfde49a70c78b962e |
Hashes for stepfunction_validator-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 295de89a3f2af2884c0e8cbf64632babf81d4d4348cb8b45b50ac72fddca86e9 |
|
MD5 | 2902f3c957cdcc46b594a192af357510 |
|
BLAKE2b-256 | 67996360b66319b71e6771ae942ad8a676aa529b7c707079f4b887bf33a44c76 |