From: Ezio Melotti Date: Tue, 8 Mar 2011 15:08:25 +0000 (+0200) Subject: #11298: Improve the unittest discovery explanation. X-Git-Tag: v2.7.2rc1~267 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9e1ed47e91ceadc961ae58e2179b324f085d54e5;p=thirdparty%2FPython%2Fcpython.git #11298: Improve the unittest discovery explanation. --- diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index 333b399f3b79..346b8a268271 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -257,9 +257,11 @@ Test Discovery .. versionadded:: 2.7 -Unittest supports simple test discovery. For a project's tests to be -compatible with test discovery they must all be importable from the top level -directory of the project (in other words, they must all be in Python packages). +Unittest supports simple test discovery. In order to be compatible with test +discovery, all of the test files must be :ref:`modules ` or +:ref:`packages ` importable from the top-level directory of +the project (this means that their filenames must be valid +:ref:`identifiers `). Test discovery is implemented in :meth:`TestLoader.discover`, but can also be used from the command line. The basic command-line usage is::