pytest Quick Start Guide

Customizing a collection

By default, pytest collects tests using this heuristic:

• Files that match test_*.py and *_test.py
• Inside test modules, functions that match test* and classes that match Test*
• Inside test classes, methods that match test*

This convention is simple to understand and works for most projects, but they can be overwritten by these configuration options:

• python_files: a list of patterns to use to collect test modules
• python_functions: a list of patterns to use to collect test functions and test methods
• python_classes: a list of patterns to use to collect test classes

Here's an example of a configuration file changing the defaults:

[pytest]python_files = unittests_*.pypython_functions = check_*python_classes = *TestSuite ...