pytest-workflow 0.4.0

A pytest plugin for configuring workflow/pipeline tests using YAML files

pytest-workflow is a pytest plugin that aims to make pipeline/workflow testing easy by using yaml files for the test configuration.

For our complete documentation checkout our readthedocs page.

Installation

Pytest-workflow requires Python 3.5 or higher. It is tested on Python 3.5, 3.6 and 3.7. Python 2 is not supported.

• Make sure your virtual environment is activated.

• Install using pip pip install pytest-workflow

• Create a tests directory in the root of your repository.

• Create your test yaml files in the tests directory.

Quickstart

Run pytest from an environment with pytest-workflow installed. Pytest will automatically gather files in the tests directory starting with test and ending in .yaml or .yml.

For debugging pipelines running pytest -v --keep-workflow-wd is recommended. This will save the logs and the workflow directory so it is possible to check where the pipeline crashed. It will also give a better overview of succeeded and failed tests.

Below is an example of a YAML file that defines a test:

- name: Touch a file
  command: touch test.file
  files:
    - path: test.file

This will run touch test.file and check afterwards if a file with path: test.file is present. It will also check if the command has exited with exit code 0, which is the only default test that is run. Testing workflows that exit with another exit code is also possible.

Documentation for more advanced use cases can be found on our readthedocs page.