pytest-timeouts

Linux-only Pytest plugin to control durations of various test case execution phases.

Documentation

For documentation visit pytest-timeouts.readthedocs.io.

About

This plugin has been designed for specific use cases which are out of the scope of famous pytest-timeout plugin. It uses a SIGALRM signal to schedule a timer which breaks the test case.

Features

• setup, execution and teardown phase timeouts controllable by:
  • opts: --setup-timeout, --execution-timeout and --teardown-timeout
  • ini: setup_timeout, execution_timeout and teardown_timeout
  • mark: setup_timeout, execution_timeout and teardown_timeout
• fixed order of timeout settings: opts > markers > ini, controlled by --timeouts-order
• --timeouts-order allow change order of override timeout settings, and disable some settings, i.e. --timeout-order i disable markers and opts, any combination is allow
• timeout disabled when debugging with PDB

Installation

Stable

pip install pytest-timeouts

Master

pip install git+https://github.com/Scony/pytest-timeouts.git

Usage

Command line

pytest --setup-timeout 2.5 --execution-timeout 2.01  --teardown-timeout 0

pytest.ini setting

[pytest]
setup_timeout = 2.5
execution_timeout = 2.01
teardown_timeout = 0

Mark

import time

import pytest


@pytest.mark.setup_timeout(0.3)
@pytest.mark.execution_timeout(0.5)
@pytest.mark.teardown_timeout(0.4)
def test_timeout():
    time.sleep(1)

Contributors

• Pawel Lampe
• Kamil Luczak