# Python tests should be named test_*.py for pytest support

XMLWordPrintable

## Details

• Type: RFC
• Status: Implemented
• Resolution: Done
• Component/s:
• Labels:
None

## Description

Now that we’re beginning to use pytest to run unit tests, it makes sense to use pytest’s default test discovery so that simply running py.test (without arguments) will have pytest discover and run all tests in the tests/ directory. Currently we must type py.test tests/*.py.

We can achieve this simplicity through a coding standard that specifies all Python unit test modules must be named with the test_ pattern:

 tests/test_example.py 

(Our current standard is tests/testExample.py. The Python Style Guide implies this style, and the Python Unit Testing guide assumes this naming style.)

I think this is a straightforward coding style change that will make life easier in the long run.

Alternative

An alternative to changing the names of test modules, while still making py.test work without arguments is to add a configuration file to each repo that tells pytest how to find our test modules.

I don’t recommend this. I think it’s better just to use a correct and consistent naming schema.

## People

• Assignee:
Jonathan Sick
Reporter:
Jonathan Sick
Watchers:
John Parejko, Jonathan Sick, Pim Schellart [X] (Inactive), Tim Jenness