Deprecate unittest.makeSuite, unittest.findTestCases, and unittest.getTestCaseNames

Scheduled for removal in Python 3.12

Author: Erlend E. Aasland

Doc/library/unittest.rst

@@ -1830,6 +1830,9 @@ Loading and running tests
       Return a sorted sequence of method names found within *testCaseClass*;
       this should be a subclass of :class:`TestCase`.
 
+      .. deprecated:: 3.10
+         Scheduled for removal in Python 3.12.
+
 
    .. method:: discover(start_dir, pattern='test*.py', top_level_dir=None)
 

Lib/test/support/__init__.py

@@ -1077,7 +1077,7 @@ def run_unittest(*classes):
         elif isinstance(cls, valid_types):
             suite.addTest(cls)
         else:
-            suite.addTest(unittest.makeSuite(cls))
+            suite.addTest(unittest.TestLoader().loadTestsFromTestCase(cls))
     _filter_suite(suite, match_test)
     _run_suite(suite)
 

Lib/unittest/__init__.py

@@ -52,6 +52,7 @@ def testMultiply(self):
            'addModuleCleanup']
 
 # Expose obsolete functions for backwards compatibility
+# Issue 5846: Deprecated in Python 3.10, scheduled for removal in Python 3.12.
 __all__.extend(['getTestCaseNames', 'makeSuite', 'findTestCases'])
 
 __unittest = True

Lib/unittest/loader.py

@@ -503,15 +503,31 @@ def _makeLoader(prefix, sortUsing, suiteClass=None, testNamePatterns=None):
         loader.suiteClass = suiteClass
     return loader
 
+# Issue 5846: getTestCaseNames, makeSuite, and findTestCases are deprecated as
+#             of Python 3.10, scheduled for removal in Python 3.12.
 def getTestCaseNames(testCaseClass, prefix, sortUsing=util.three_way_cmp, testNamePatterns=None):
+    warnings.warn(
+        "getTestCaseNames() is deprecated and will be removed in Python 3.12.",
+        DeprecationWarning, stacklevel=2
+    )
     return _makeLoader(prefix, sortUsing, testNamePatterns=testNamePatterns).getTestCaseNames(testCaseClass)
 
 def makeSuite(testCaseClass, prefix='test', sortUsing=util.three_way_cmp,
               suiteClass=suite.TestSuite):
+    warnings.warn(
+        "makeSuite() is deprecated and will be removed in Python 3.12. "
+        "Please use loadTestsFromTestCase() instead.",
+        DeprecationWarning, stacklevel=2
+    )
     return _makeLoader(prefix, sortUsing, suiteClass).loadTestsFromTestCase(
         testCaseClass)
 
 def findTestCases(module, prefix='test', sortUsing=util.three_way_cmp,
                   suiteClass=suite.TestSuite):
+    warnings.warn(
+        "findTestCases() is deprecated and will be removed in Python 3.12. "
+        "Please use loadTestsFromModule() instead.",
+        DeprecationWarning, stacklevel=2
+    )
     return _makeLoader(prefix, sortUsing, suiteClass).loadTestsFromModule(\
         module)