Test modules in PyTest

Introduction

Test modules help organize your tests in separate files. This makes testing easier and keeps your code clean.

When you want to group related tests together in one file.

When your project grows and you need multiple test files.

When you want to run tests from a specific file only.

When you want to share setup code across tests in one module.

When you want to keep tests separate from your main code.

Syntax

PyTest

Create a Python file starting with test_ or ending with _test.py
Inside, write test functions starting with test_
Example:

def test_example():
    assert 1 + 1 == 2

Test modules must be named so pytest can find them automatically.

Test functions inside modules must start with test_ to be recognized.

Examples

This module tests addition. The function name starts with test_.

PyTest

# File: test_math.py

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

This module ends with _test.py and contains a subtraction test.

PyTest

# File: calculator_test.py

def test_subtraction():
    assert 5 - 2 == 3

Sample Program

This test module has three simple tests for string methods. Each test checks a different behavior.

PyTest

# File: test_sample.py

def test_uppercase():
    word = "hello"
    assert word.upper() == "HELLO"

def test_isupper():
    word = "HELLO"
    assert word.isupper() is True

def test_split():
    sentence = "hello world"
    assert sentence.split() == ["hello", "world"]

Important Notes

Always name your test files and functions properly so pytest can find and run them.

You can run tests from one module by specifying the file name: pytest test_sample.py.

Keep tests small and focused inside each module for easier debugging.

Summary

Test modules are Python files named to be found by pytest.

They group related tests for better organization.

Test functions inside must start with test_ to run automatically.

Practice

1. What is the correct way to name a Python file so that pytest recognizes it as a test module?

easy

A. The file name can be anything as long as it contains tests.

B. The file name should start with check_.

C. The file name should be pytest_module.py.

D. The file name should start with test_ or end with _test.py.

Solution

1. Step 1: Understand pytest file naming conventions

   pytest automatically discovers test files if their names start with test_ or end with _test.py.

2. Step 2: Evaluate each option

   Only The file name should start with test_ or end with _test.py. matches the correct naming pattern for pytest to find test modules automatically.

3. Final Answer:

   The file name should start with test_ or end with _test.py. -> Option D

4. Quick Check:

   pytest test file naming = start with test_ or end with _test.py [OK]

Hint: Remember test files start with test_ or end with _test.py [OK]

Common Mistakes:

• Assuming any file with tests is recognized
• Using incorrect prefixes like check_
• Naming files without .py extension

2. Which of the following is the correct syntax for a test function inside a pytest test module?

easy

A. def test_function():

B. def check_function():

C. def function_test():

D. def testing_function():

Solution

1. Step 1: Recall pytest test function naming rules

   pytest runs functions that start with test_ automatically as tests.

2. Step 2: Match options with naming rule

   Only def test_function(): defines a function starting with test_, so pytest will recognize it as a test.

3. Final Answer:

   def test_function(): -> Option A

4. Quick Check:

   Test functions start with test_ [OK]

Hint: Test functions must start with test_ to run automatically [OK]

Common Mistakes:

• Naming test functions without test_ prefix
• Using other prefixes like check_ or testing_
• Forgetting to define functions with def

3. Given the following test module test_sample.py with these functions:

def test_add():
    assert 1 + 1 == 2

def add():
    return 1 + 1

def test_subtract():
    assert 2 - 1 == 1

Which functions will pytest run as tests?

medium

A. All three functions

B. Only add

C. test_add and test_subtract

D. Only test_add

Solution

1. Step 1: Identify pytest test function naming

   pytest runs functions starting with test_ automatically as tests.

2. Step 2: Check each function name

   test_add and test_subtract start with test_, so pytest runs them. add does not start with test_, so it is ignored.

3. Final Answer:

   test_add and test_subtract -> Option C

4. Quick Check:

   Functions starting with test_ run as tests [OK]

Hint: Only functions starting with test_ run as tests [OK]

Common Mistakes:

• Thinking all functions in test file run as tests
• Confusing helper functions with test functions
• Ignoring function name prefixes

4. You have a test module named test_math.py with this code:

def test_multiply():
    assert 2 * 3 == 5

When you run pytest, what will happen?

medium

A. The test will fail because the assertion is incorrect.

B. pytest will not find any tests to run.

C. pytest will skip the test because of a syntax error.

D. The test will pass because 2 * 3 equals 6.

Solution

1. Step 1: Analyze the assertion in test_multiply

   The assertion checks if 2 * 3 == 5, which is false because 2 * 3 equals 6.

2. Step 2: Understand pytest test result

   pytest runs the test and finds the assertion false, so the test fails.

3. Final Answer:

   The test will fail because the assertion is incorrect. -> Option A

4. Quick Check:

   False assertion causes test failure [OK]

Hint: Check if assertion condition is true or false [OK]

Common Mistakes:

• Assuming test passes despite wrong assertion
• Confusing syntax errors with assertion failures
• Thinking pytest skips failing tests

5. You want to organize tests for a calculator app. You create two files: test_add.py and test_subtract.py. Each file has multiple test functions starting with test_. How does pytest handle these test modules when you run pytest in the folder?

hard

A. pytest requires you to specify each test module to run tests.

B. pytest runs all test functions from both modules automatically.

C. pytest runs only tests from the first module alphabetically.

D. pytest runs tests only if you import modules manually.

Solution

1. Step 1: Understand pytest test discovery

   pytest automatically finds all test modules named with test_ prefix and runs all test functions inside them.

2. Step 2: Apply to multiple test modules

   When running pytest in the folder, it collects tests from both test_add.py and test_subtract.py and runs all test functions starting with test_.

3. Final Answer:

   pytest runs all test functions from both modules automatically. -> Option B

4. Quick Check:

   pytest auto-discovers all test modules and functions [OK]

Hint: pytest runs all test_ modules and functions in folder automatically [OK]

Common Mistakes:

• Thinking pytest runs only one module at a time
• Believing manual imports are needed for tests
• Assuming tests must be specified explicitly