Project structure for tests in PyTest - Test Execution Trace

Test Overview

This test checks that the pytest framework can discover and run a simple test function placed in the recommended project folder structure.

It verifies that the test file is found and the test passes successfully.

Test Code - pytest

PyTest

import pytest

def test_addition():
    assert 2 + 3 == 5

# Project structure:
# /project_root
#   /tests
#     test_math.py  (this file)

# Run with: pytest tests/

Execution Trace - 4 Steps

Step	Action	System State	Assertion	Result
1	Test runner starts and looks for tests in the 'tests' folder	Project folder contains 'tests/test_math.py' with 'test_addition' function	-	PASS
2	pytest discovers 'test_addition' function inside 'test_math.py'	pytest test collection shows 1 test found	-	PASS
3	pytest runs 'test_addition' function	Function executes: assert 2 + 3 == 5	Check that 2 + 3 equals 5	PASS
4	pytest reports test result	Test passed with no errors	Test result is PASS	PASS

Failure Scenario

Failing Condition: Test file is missing or test function name does not start with 'test_'

Execution Trace Quiz - 3 Questions

Where should test files be placed for pytest to find them by default?

A Anywhere in the project root without restrictions

B Only in the root folder named 'src'

C Inside a folder named 'tests' or starting with 'test_'

D Inside a folder named 'docs'

Key Result

Organizing tests inside a dedicated 'tests' folder and naming test functions with 'test_' prefix helps pytest automatically discover and run tests, making test management easier and more reliable.