Issue #22153: Improve unittest docs. Patch from Martin Panter and evilzero.

diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index e7e3262f9e160f1b49cc363a2c1afe687ee96509..f13100c9f8511dc2ee8a3c7f9d1c2af9b7a72137 100644 (file)
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -644,10 +644,8 @@ Test cases
    kinds of failure.
 
    Each instance of :class:`TestCase` will run a single base method: the method
-   named *methodName*.  However, the standard implementation of the default
-   *methodName*, ``runTest()``, will run every method starting with ``test``
-   as an individual test, and count successes and failures accordingly.
-   Therefore, in most uses of :class:`TestCase`, you will neither change
+   named *methodName*.
+   In most uses of :class:`TestCase`, you will neither change
    the *methodName* nor reimplement the default ``runTest()`` method.
 
    .. versionchanged:: 3.2
@@ -1551,6 +1549,12 @@ Loading and running tests
       Return a suite of all tests cases contained in the :class:`TestCase`\ -derived
       :class:`testCaseClass`.
 
+      A test case instance is created for each method named by
+      :meth:`getTestCaseNames`. By default these are the method names
+      beginning with ``test``. If :meth:`getTestCaseNames` returns no
+      methods, but the :meth:`runTest` method is implemented, a single test
+      case is created for that method instead.
+
 
    .. method:: loadTestsFromModule(module)
 

diff --git a/Misc/ACKS b/Misc/ACKS
index 63cf4da54619aad7db5f71c56d64de137beb369c..a6a9a9d92a5e60012f3b4f8b5fbaf2db2ea03002 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -1535,3 +1535,4 @@ Doug Zongker
 Peter Åstrand
 Laurent De Buyst
 Nicola Palumbo
+evilzero

diff --git a/Misc/NEWS b/Misc/NEWS
index a7f42bc7930b8e684548e1d28b6a2291870c769f..d38c4146f5a742efa16e8801821185c7a9138aaa 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -66,6 +66,8 @@ Core and Builtins
 Library
 -------
 
+- Issue #22153: Improve unittest docs. Patch from Martin Panter and evilzero.
+
 - Issue #24206: Fixed __eq__ and __ne__ methods of inspect classes.
 
 - Issue #21750: mock_open.read_data can now be read from each instance, as it