Test packages in PyTest - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is a test package in pytest?

A test package is a directory containing multiple test modules and an __init__.py file, allowing pytest to discover and run tests organized in that directory.

beginner

Why do we need an __init__.py file in a pytest test package?

The __init__.py file makes the directory a Python package, which helps pytest recognize it as a test package and allows importing modules within it.

beginner

How does pytest discover tests inside a test package?

Pytest looks for files matching test_*.py or *_test.py inside the package directory and runs test functions or methods inside those files.

intermediate

Can you organize tests in sub-packages inside a pytest test package?

Yes, you can create subdirectories with __init__.py files inside a test package to organize tests hierarchically, and pytest will discover tests recursively.

intermediate

What is a practical benefit of using test packages in pytest?

Test packages help keep tests organized by feature or module, making it easier to maintain and run specific groups of tests without running everything.

What file must be present in a directory for pytest to treat it as a test package?

A setup.py

B __init__.py

C conftest.py

D requirements.txt

The __init__.py file marks the directory as a Python package, which pytest uses to recognize test packages.

Which file name pattern does pytest use to find test modules inside a test package?

A test_*.py or *_test.py

B module_*.py

C testpackage.py

D setup_*.py

Pytest looks for files starting with test_ or ending with _test to find test modules.

Can pytest discover tests in subdirectories inside a test package?

A Only if tests are in a single file

B No, pytest only looks in the top-level directory

C Yes, if subdirectories have __init__.py files

D Only if tests are imported manually

Subdirectories with __init__.py files are treated as sub-packages, allowing pytest to discover tests recursively.

What is the main advantage of organizing tests into packages?

A Better organization and selective test running

B Faster test execution

C Automatic bug fixing

D No need for test functions

Organizing tests into packages helps keep tests structured and allows running specific groups of tests easily.

If a directory lacks __init__.py, what happens when pytest tries to discover tests there?

A It will fail to find any tests

B It will run tests twice

C It will automatically create __init__.py

D It treats it as a normal directory, not a package, which may affect imports

Without __init__.py, the directory is not a package, so relative imports inside tests may fail, but pytest can still find tests by filename.

Explain how to create and organize a test package in pytest.

Think about Python packages and test discovery rules.

Describe the benefits of using test packages when writing tests with pytest.

Consider how grouping tests helps in real projects.

Practice

1. What is the main purpose of a test package in pytest?

easy

A. To group related test files into a folder with an __init__.py file

B. To run tests only from a single test file

C. To create a virtual environment for tests

D. To install pytest dependencies automatically

Solution

1. Step 1: Understand test package structure

   A test package groups related test files inside a folder that contains an __init__.py file.

2. Step 2: Purpose of grouping tests

   This grouping helps organize tests and allows pytest to find and run them together.

3. Final Answer:

   To group related test files into a folder with an __init__.py file -> Option A

4. Quick Check:

   Test packages group tests = A [OK]

Hint: Test packages group tests in folders with __init__.py [OK]

Common Mistakes:

• Confusing test packages with virtual environments
• Thinking test packages run only one file
• Believing pytest installs dependencies automatically

2. Which of the following is the correct way to make a folder a test package in pytest?

easy

A. Add a file named test_package.py inside the folder

B. Create a file named setup.py inside the folder

C. Add a file named __init__.py inside the folder

D. Add a file named requirements.txt inside the folder

Solution

1. Step 1: Identify the marker for Python packages

   Python treats folders with an __init__.py file as packages, including test packages.

2. Step 2: Confirm pytest package recognition

   pytest uses this file to recognize the folder as a test package and find tests inside it.

3. Final Answer:

   Add a file named __init__.py inside the folder -> Option C

4. Quick Check:

   __init__.py marks test packages = B [OK]

Hint: Add __init__.py to folder to make it a test package [OK]

Common Mistakes:

• Adding test files instead of __init__.py to mark package
• Confusing setup.py with package marker
• Using requirements.txt for package identification

3. Given this folder structure:

tests/
  __init__.py
  test_math.py
  test_string.py

What will happen when you run pytest tests/?

medium

A. pytest will skip all tests because folder has __init__.py

B. pytest will run only test_math.py tests

C. pytest will raise an error because __init__.py is present

D. pytest will run all tests in both test_math.py and test_string.py

Solution

1. Step 1: Understand pytest test discovery in packages

   pytest finds and runs all test files inside a test package folder when you run pytest on that folder.

2. Step 2: Effect of __init__.py on test discovery

   The presence of __init__.py marks the folder as a package but does not prevent pytest from running tests inside.

3. Final Answer:

   pytest will run all tests in both test_math.py and test_string.py -> Option D

4. Quick Check:

   pytest runs all tests in package folder = D [OK]

Hint: pytest runs all tests in package folder with __init__.py [OK]

Common Mistakes:

• Thinking __init__.py blocks test discovery
• Assuming only one test file runs
• Expecting errors due to __init__.py presence

4. You have a folder tests/ with test files but forgot to add __init__.py. What issue might you face?

medium

A. pytest will not recognize the folder as a test package and may skip tests inside

B. pytest will raise a syntax error when running tests

C. pytest will run tests twice

D. pytest will automatically create __init__.py for you

Solution

1. Step 1: Role of __init__.py in test packages

   Without __init__.py, the folder is not a recognized Python package, so pytest may not treat it as a test package.

2. Step 2: Effect on test discovery

   pytest might skip tests inside such folders or not group them properly during test runs.

3. Final Answer:

   pytest will not recognize the folder as a test package and may skip tests inside -> Option A

4. Quick Check:

   Missing __init__.py can cause pytest to skip tests = C [OK]

Hint: Always add __init__.py to test folders to avoid skipped tests [OK]

Common Mistakes:

• Expecting syntax errors without __init__.py
• Thinking pytest auto-creates __init__.py
• Assuming tests run twice without __init__.py

5. You want to organize tests for a large project using pytest. You create nested folders with __init__.py files like this:

tests/
  __init__.py
  unit/
    __init__.py
    test_utils.py
  integration/
    __init__.py
    test_api.py

How can you run only the integration tests using pytest?

hard

A. Run pytest tests/ and pytest will run only integration tests automatically

B. Run pytest tests/integration/ to run only integration tests

C. Run pytest tests/unit/ to run integration tests

D. Remove __init__.py files to run only integration tests

Solution

1. Step 1: Understand folder-based test selection

   pytest runs tests in the folder path you specify. To run only integration tests, specify the integration folder.

2. Step 2: Confirm effect of nested __init__.py files

   Nested __init__.py files mark subfolders as packages but do not affect running tests by folder path.

3. Final Answer:

   Run pytest tests/integration/ to run only integration tests -> Option B

4. Quick Check:

   Run pytest on specific folder to run its tests = A [OK]

Hint: Run pytest on specific test folder to run only those tests [OK]

Common Mistakes:

• Expecting pytest to auto-filter integration tests without folder path
• Running wrong folder path for desired tests
• Removing __init__.py thinking it filters tests