pytest-failed-to-verify 0.1.5

A pytest plugin that helps better distinguishing real test failures from setup flakiness.

A pytest plugin that helps better distinguishing real test failures from setup flakiness.

Features

• Re-running only the setup-phase on failure

• Additional test-outcome: FAILED_TO_VERIFY if a failure happened in setup phase and prevented the actual test-logic from executing.

Installation

You can install the plugin using the following command:

$ pip install pytest-failed-to-verify

Usage

Based on the existing pytest-rerunfailures plugin we changed functionality to the following:

Once installed the plugin provides an additional test outcome failed-to-verify in case a test fails in the setup-phase, additionaly you are able to control the amount of re-runs specifically for the setup phase:

$ pytest --rerun-setup 1

What’s the idea behind it?

A pytest test consists of three phases (setup, call, teardown). Usually only the call phase contains the actual tested business logic and the outcome of this phase gives the most valuable result.

The setup phase is used to provide the pre-conditions for the test and might be even larger than the test.

Assuming that the flakiness of a test is evenly distributed between the lines of code a test is executing, having a large setup phase means an error due to flakiness is most likely to happen there. If that’s the case a test fails but is leaving you with no relevant test-outcome: the actual test did not happen.

So if the setup fails the result of a test will be failed-to-verify rather than failed.

Additionally re-running only the setup phase is a mechanism that assures the code that is testing the actual business logic (call-phase) is actually executed and provides you a valid test outcome without suffering from a flaky setup phase.

Credits

Credits to https://github.com/pytest-dev as some of the code was taken and re-used from the pytest-rerunfailures plugin. We used it as a starting point to implement the needed functionality.

Known issues

Because of the similarity it does not work well together with pytest-rerunfailures. If you still need to be able to rerun the complete test on case of an error you can do this as well using this plugin.

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

Issues

If you encounter any problems, please file an issue along with a detailed description.

---

This pytest plugin was generated with Cookiecutter along with @hackebrot’s cookiecutter-pytest-plugin template.