pytest-instafail

Warnings

• breaking Version 0.5.0 dropped support for Python 3.6. Ensure your environment uses Python 3.7 or newer.
  Fix: Upgrade Python to 3.7+ or use an older version of pytest-instafail (e.g., 0.4.x) if Python 3.6 is a strict requirement.
• breaking pytest-instafail requires pytest 5 or newer. Using it with older pytest versions may lead to compatibility issues or errors.
  Fix: Upgrade pytest to version 5 or newer (`pip install --upgrade pytest`).
• deprecated Older versions of pytest-instafail might issue deprecation warnings when used with pytest 7.2.0+ due to changes in hook configuration. Version 0.5.0 addressed this by using `pytest.hookimpl`.
  Fix: Upgrade to pytest-instafail 0.5.0 or newer to ensure compatibility and avoid deprecation warnings with recent pytest versions.
• gotcha When used in conjunction with `pytest-xdist`, ensure `pytest-instafail` is at least version 0.4.2 to avoid issues related to deprecated `pytest-xdist` slave aliases.
  Fix: Upgrade to pytest-instafail 0.4.2 or newer if using `pytest-xdist` for parallel test execution.

Install

• pip install pytest-instafail Install with pip

Imports

• Plugin Activation

  This is a pytest plugin and is activated via the command line (--instafail) or automatically by pytest upon installation. It does not require explicit Python 'import' statements in user code.

  pytest plugins are typically auto-discovered or activated via CLI flags.

Quickstart

To use pytest-instafail, simply install it and then run your tests with the `--instafail` flag. This will cause failures to be reported instantly.

import pytest

def test_passing_example():
    assert True

def test_failing_example():
    assert False

# To run this, save as 'test_example.py' and execute in terminal:
# pytest --instafail test_example.py