summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Doc/library/unittest.rst12
-rw-r--r--Misc/ACKS1
-rw-r--r--Misc/NEWS2
3 files changed, 11 insertions, 4 deletions
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index cfce019..5085703 100644
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -651,10 +651,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
@@ -1572,6 +1570,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, pattern=None)
diff --git a/Misc/ACKS b/Misc/ACKS
index 2dc6411..e3d3448 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -1584,3 +1584,4 @@ Peter Åstrand
Ignacio Rossi
Laurent De Buyst
Nicola Palumbo
+evilzero
diff --git a/Misc/NEWS b/Misc/NEWS
index ba27a55..4e43e77 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -25,6 +25,8 @@ Core and Builtins
Library
-------
+- Issue #22153: Improve unittest docs. Patch from Martin Panter and evilzero.
+
- Issue #24580: Symbolic group references to open group in re patterns now are
explicitly forbidden as well as numeric group references.