Skip to main content

Linter for Mistral Workflows

Project description

PyPI Version Build Status

Usage

$ pip install mistral-lint
$ mistral-lint path-to-files

Reviewing a review in OpenStack’s gerrit? We got you.

$ mistral-lint --review $GERRIT_REVIEW_ID

If you add –diff it will compare the patch to its parent commit, making it easier to see what changed. For example:

$ mistral-lint --diff --review 428178
+E101: Input flavor_list is not used in Workflow tripleo.validations.v1.collect_flavors
+W102: Workflow tripleo.validations.v1.collect_flavors has no description

Current Linters

These are the current linters that are included.

W101 & W102 Description

Checks that each workbook and workflow has a description.

W103 type

Checks the workflow type, if “direct” is given it gives a warning that it isn’t needed

E101 inputs

Checks that workflow inputs are used.

E102 task exists

Check that tasks are defined in the workflow when they are used in on-success, on-error or on-complete

E103, E104, E105 expressions

Checks that expressions have a matching number of opening and closing brackets. Validates YAML and Jinja2 expressions with the library parsers.

Example Output

workbooks/baremetal.yaml
W102: Workflow tripleo.baremetal.v1.set_node_state has no description
W102: Workflow tripleo.baremetal.v1.set_power_state has no description
W102: Workflow tripleo.baremetal.v1.manual_cleaning has no description
E103: Input node_uuids is not used in Workflow tripleo.baremetal.v1.cellv2_discovery

workbooks/deployment.yaml
W102: Workflow tripleo.deployment.v1.deploy_on_server has no description
W102: Workflow tripleo.deployment.v1.deploy_on_servers has no description

workbooks/plan_management.yaml
W102: Workflow tripleo.plan_management.v1.create_deployment_plan has no description
W102: Workflow tripleo.plan_management.v1.update_deployment_plan has no description
W102: Workflow tripleo.plan_management.v1.create_default_deployment_plan has no description

workbooks/stack.yaml
W102: Workflow tripleo.stack.v1.wait_for_stack_complete_or_failed has no description
W102: Workflow tripleo.stack.v1.wait_for_stack_in_progress has no description
W102: Workflow tripleo.stack.v1.wait_for_stack_does_not_exist has no description
W102: Workflow tripleo.stack.v1.delete_stack has no description

workbooks/validations.yaml
W102: Workflow tripleo.validations.v1.run_validation has no description
W102: Workflow tripleo.validations.v1.run_validations has no description
W102: Workflow tripleo.validations.v1.run_groups has no description
W102: Workflow tripleo.validations.v1.list has no description
W102: Workflow tripleo.validations.v1.list_groups has no description
W102: Workflow tripleo.validations.v1.add_validation_ssh_key_parameter has no description
W102: Workflow tripleo.validations.v1.copy_ssh_key has no description
E103: Input queue_name is not used in Workflow tripleo.validations.v1.add_validation_ssh_key_parameter

Ideas

  • Check that tasks exist (all those that are mentined in on-error, on-success on-complete etc.).

  • Check all tasks are called.

  • Check all tasks have an on-error/on-success or on-complete

  • Check zaqar format

  • Interactive workflow with zaqar posting the continue code.

  • Check sub-workflows are provided the queue name

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

mistral-lint-0.1.3.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

mistral_lint-0.1.3-py2.py3-none-any.whl (10.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file mistral-lint-0.1.3.tar.gz.

File metadata

File hashes

Hashes for mistral-lint-0.1.3.tar.gz
Algorithm Hash digest
SHA256 55db253c746622c500cac98f2fdcb6ffe8378806fc8fa2e98eb96a307c3409c3
MD5 100bdf4ce932079d1828cfff23202434
BLAKE2b-256 c4cce2ca700553f70d06dd95aa519a678dbbeb866fc69278fd2cd4010a74a305

See more details on using hashes here.

File details

Details for the file mistral_lint-0.1.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for mistral_lint-0.1.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c00ddb12d7bdefdb35811f51345d8edbfbc0c95b458bc5b7ad8bc08f0bcdd1d6
MD5 0749ec1184045597e79ca8a8e8030192
BLAKE2b-256 671b8f381f6ed5f6015bacc2137619337fd963531cbe075ad5c099b480d1734b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page