pytest-exit-status

Pytest plugin that overrides the exit codes.

Pytest only offers two exit status codes for full test executions (when all collected tests were executed):

• Exit code 0: All tests had the passed, xpassed or xfailed outcome.
• Exit code 1: Some tests had the failed outcome.

Some continuous integration tools like Jenkins support the unstable status and it can be frustrating not to take advantage of this pipeline status to highlight test executions with xfailed tests.

This plugin aims to modify the exit code 0 and add a new exit code 6.

The proposed exit codes are:

• Exit code 0: All tests had the passed or xpassed outcome.
• Exit code 6: Some tests had the xfailed outcome or there were some errors (setup or teardown errors).

The other exit codes are not modified.

To install the plugin:

pip install pytest-exit-status

If you like this software, consider contributing to the project through buy me a coffee