Project structure for tests in PyTest

Introduction

Organizing test files helps keep your tests easy to find and run. It makes your work neat and saves time.

When you start writing multiple test files for a project

When you want to run all tests easily with one command

When you want to separate tests by features or modules

When you want to share tests with teammates clearly

When you want to avoid confusion between test code and application code

Syntax

PyTest

project_root/
  ├── src/
  │    └── your_code.py
  ├── tests/
  │    ├── __init__.py
  │    ├── test_feature1.py
  │    └── test_feature2.py
  ├── pytest.ini
  └── requirements.txt

The tests/ folder holds all test files.

Test files start with test_ so pytest finds them automatically.

Examples

Separate test files for different features like login, signup, and logout.

PyTest

tests/
  ├── test_login.py
  ├── test_signup.py
  └── test_logout.py

Organize tests by type: unit tests in one folder, integration tests in another.

PyTest

tests/
  ├── unit/
  │    ├── test_utils.py
  │    └── test_models.py
  └── integration/
       └── test_api.py

Configuration file to tell pytest where tests are and how to run them quietly.

PyTest

pytest.ini

[pytest]
minversion = 6.0
addopts = -ra -q
testpaths = tests

Sample Program

This example shows a simple function and two tests in a separate file inside tests/. Pytest will find and run these tests.

PyTest

def add(a, b):
    return a + b

# tests/test_add.py
import pytest
from src.your_code import add

def test_add_positive():
    assert add(2, 3) == 5

def test_add_negative():
    assert add(-1, -1) == -2

Important Notes

Always name test files starting with test_ and test functions the same way.

Keep test code separate from application code to avoid confusion.

Use folders inside tests/ to organize large projects.

Summary

Organize tests in a tests/ folder for clarity.

Name test files and functions starting with test_ for pytest to find them.

Use subfolders and config files to manage bigger projects easily.