discover Publisher's description
from Michael Foord
Test discovery for unittest backported from Python 2.7 for Python 2.4+.
discover is a test discovery mechanism for unittest tests backported from Python 2.7 to work with Python 2.4 or more recent.
After installing (use pip or easy_install) you can run:
python -m discover
This will discover all tests (with certain restrictions) from the current directory. The discover module has several options to control its behavior:
Usage: discover.py [options]
-v, --verbose Verbose output
-s directory Directory to start discovery ('.' default)
-p pattern Pattern to match test files ('test*.py' default)
-t directory Top level directory of project (default to
For test discovery all test modules must be importable from the top
level directory of the project.
This is implemented in discover.DiscoveringTestLoader.discover.
This method finds and returns all test modules from the specified start directory, recursing into subdirectories to find them. Only test files that match pattern will be loaded. (Using shell style pattern matching.)
All test modules must be importable from the top level of the project. If the start directory is not the top level directory then the top level directory must be specified separately.
If a test package name (directory with __init__.py) matches the pattern then the package will be checked for a load_tests function. If this exists then it will be called with loader, tests, pattern.
If load_tests exists then discovery does not recurse into the package, load_tests is responsible for loading all tests in the package.
The pattern is deliberately not stored as a loader attribute so that packages can continue discovery themselves. top_level_dir is stored so load_tests does not need to pass this argument in to loader.discover().
System Requirements:В· Python
Program Release Status:
Program Install Support: Install and Uninstall