summaryrefslogtreecommitdiffstats
path: root/Doc/library/unittest.rst
diff options
context:
space:
mode:
authorEzio Melotti <ezio.melotti@gmail.com>2011-03-08 14:17:35 (GMT)
committerEzio Melotti <ezio.melotti@gmail.com>2011-03-08 14:17:35 (GMT)
commit3d995843ce0e5f0c1f5875a6092369bfe83cbec0 (patch)
tree6be09c62081cdf511ef36014054c9440383aa250 /Doc/library/unittest.rst
parent3b59f332b62770f0659fe2cb38b80cc7c7944056 (diff)
downloadcpython-3d995843ce0e5f0c1f5875a6092369bfe83cbec0.zip
cpython-3d995843ce0e5f0c1f5875a6092369bfe83cbec0.tar.gz
cpython-3d995843ce0e5f0c1f5875a6092369bfe83cbec0.tar.bz2
#11298: Improve the unittest discovery explanation.
Diffstat (limited to 'Doc/library/unittest.rst')
-rw-r--r--Doc/library/unittest.rst8
1 files changed, 5 insertions, 3 deletions
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index 047d458..8366bab 100644
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -277,9 +277,11 @@ Test Discovery
.. versionadded:: 3.2
-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 <tut-modules>` or
+:ref:`packages <tut-packages>` importable from the top-level directory of
+the project (this means that their filenames must be valid
+:ref:`identifiers <identifiers>`).
Test discovery is implemented in :meth:`TestLoader.discover`, but can also be
used from the command line. The basic command-line usage is::