pytest-timeout for time limits - Test Execution Trace

Test Overview

This test checks that a function completes within a set time limit using pytest-timeout. It verifies the test fails if the function runs too long.

Test Code - pytest

PyTest

import time
import pytest

@pytest.mark.timeout(2)
def test_sleep_short():
    time.sleep(1)  # Sleeps less than timeout, should pass

@pytest.mark.timeout(2)
def test_sleep_long():
    time.sleep(3)  # Sleeps longer than timeout, should fail

Execution Trace - 6 Steps

Step	Action	System State	Assertion	Result
1	Test runner starts and loads test_sleep_short	pytest environment ready, test_sleep_short loaded	-	PASS
2	test_sleep_short executes time.sleep(1)	Function running, sleeping for 1 second	Check if test completes within 2 seconds timeout	PASS
3	test_sleep_short finishes before timeout	Function completed normally	Test passes as execution time < 2 seconds	PASS
4	Test runner starts and loads test_sleep_long	pytest environment ready, test_sleep_long loaded	-	PASS
5	test_sleep_long executes time.sleep(3)	Function running, sleeping for 3 seconds	Check if test completes within 2 seconds timeout	FAIL
6	Timeout triggers after 2 seconds, test_sleep_long interrupted	Test interrupted by pytest-timeout plugin	Test fails due to exceeding time limit	FAIL

Failure Scenario

Failing Condition: Function execution exceeds the 2 seconds timeout limit

Execution Trace Quiz - 3 Questions

What causes test_sleep_long to fail?

A It runs longer than the 2 seconds timeout

B It raises an exception inside the function

C The test code has a syntax error

D The pytest-timeout plugin is not installed

Key Result

Using pytest-timeout helps catch tests that hang or run too long, improving test suite reliability by enforcing time limits.