SF bug #1078905: Docs for unittest run() methods are misleading

diff --git a/Lib/unittest.py b/Lib/unittest.py
index 70645fbce5db8a2c39d7b2200b612163601acadf..efb2b025a89bf2700a3d93e617fef282bd2d4e14 100644 (file)
--- a/Lib/unittest.py
+++ b/Lib/unittest.py
@@ -277,7 +277,8 @@ class TestCase:
         finally:
             result.stopTest(self)
 
-    __call__ = run
+    def __call__(self, *args, **kwds):
+        return self.run(*args, **kwds)
 
     def debug(self):
         """Run the test without collecting errors in a TestResult"""
@@ -417,15 +418,15 @@ class TestSuite:
             self.addTest(test)
 
     def run(self, result):
-        return self(result)
-
-    def __call__(self, result):
         for test in self._tests:
             if result.shouldStop:
                 break
             test(result)
         return result
 
+    def __call__(self, *args, **kwds):
+        return self.run(*args, **kwds)
+
     def debug(self):
         """Run the tests without collecting errors in a TestResult"""
         for test in self._tests: test.debug()

diff --git a/Misc/NEWS b/Misc/NEWS
index 4411d858854c4c3330ba5468f9ad68d7379b9e93..afc742fa2d1f9ccc575c98a88e70be91cee29e43 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -15,6 +15,11 @@ Core and builtins
 Library
 -------
 
+- unittest.TestCase.run() and unittest.TestSuite.run() can now be successfully
+  extended or overridden by subclasses.  Formerly, the subclassed method would
+  be ignored by the rest of the module.  (Bug #1078905).
+
+
 Build
 -----