python · vstinner · May 31, 2017
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
@@ -219,6 +219,10 @@ Command-line options

   Stop the test run on the first error or failure.

+.. cmdoption:: --list-tests
+
+   Only display the list of test names, don't run tests.
+
 .. cmdoption:: --locals

   Show local variables in tracebacks.
@@ -229,6 +233,9 @@ Command-line options
 .. versionadded:: 3.5
   The command-line option ``--locals``.

+.. versionadded:: 3.7
+   The command-line option ``--list-tests``.
+
 The command line can also be used for test discovery, for running all of the
 tests in a project or just a subset.


diff --git a/Lib/unittest/main.py b/Lib/unittest/main.py
@@ -59,7 +59,8 @@ class TestProgram(object):
    def __init__(self, module='__main__', defaultTest=None, argv=None,
                    testRunner=None, testLoader=loader.defaultTestLoader,
                    exit=True, verbosity=1, failfast=None, catchbreak=None,
-                    buffer=None, warnings=None, *, tb_locals=False):
+                    buffer=None, warnings=None,
+                    *, tb_locals=False, list_tests=False):
        if isinstance(module, str):
            self.module = __import__(module)
            for part in module.split('.')[1:]:
@@ -73,6 +74,7 @@ def __init__(self, module='__main__', defaultTest=None, argv=None,
        self.failfast = failfast
        self.catchbreak = catchbreak
        self.verbosity = verbosity
+        self.list_tests = list_tests
        self.buffer = buffer
        self.tb_locals = tb_locals
        if warnings is None and not sys.warnoptions:
@@ -164,6 +166,10 @@ def _getParentArgParser(self):
        parser.add_argument('--locals', dest='tb_locals',
                            action='store_true',
                            help='Show local variables in tracebacks')
+        parser.add_argument('--list-tests',
+                            action='store_true',
+                            help="Only display the list of test names, "
+                                 "don't run tests")
        if self.failfast is None:
            parser.add_argument('-f', '--failfast', dest='failfast',
                                action='store_true',
@@ -231,7 +237,9 @@ def _do_discovery(self, argv, Loader=None):
    def runTests(self):
        if self.catchbreak:
            installHandler()
-        if self.testRunner is None:
+        if self.list_tests:
+            self.testRunner = runner.TextListTestRunner
+        elif self.testRunner is None:
            self.testRunner = runner.TextTestRunner
        if isinstance(self.testRunner, type):
            try:

diff --git a/Lib/unittest/runner.py b/Lib/unittest/runner.py
@@ -5,6 +5,8 @@
 import warnings

 from . import result
+from .case import TestCase
+from .suite import TestSuite
 from .signals import registerResult

 __unittest = True
@@ -219,3 +221,31 @@ def run(self, test):
        else:
            self.stream.write("\n")
        return result
+
+
+class TextListTestRunner(TextTestRunner):
+    """A test runner class that only displays test names, don't run them."""
+    resultclass = TextTestResult
+
+    def list_tests(self, test_list, test):
+        if isinstance(test, TestSuite):
+            for subtest in test:
+                self.list_tests(test_list, subtest)
+        elif isinstance(test, TestCase):
+            name = []
+            cls = test.__class__
+            if cls.__module__ != "__main__":
+                name.append(cls.__module__)
+            name.append(cls.__name__)
+            name.append(test._testMethodName)
+            test_list.append('.'.join(name))
+        else:
+            raise ValueError("unknown test object: %s" % type(test))
+
+    def run(self, test):
+        test_list = []
+        self.list_tests(test_list, test)
+        test_list.sort()
+        for name in test_list:
+            self.stream.writeln(name)
+        return self._makeResult()
diff --git a/Lib/unittest/test/test_break.py b/Lib/unittest/test/test_break.py
@@ -215,6 +215,7 @@ def __init__(self, catchbreak):
                self.testRunner = FakeRunner
                self.test = test
                self.result = None
+                self.list_tests = False

        p = Program(False)
        p.runTests()

diff --git a/Lib/unittest/test/test_program.py b/Lib/unittest/test/test_program.py
@@ -140,6 +140,7 @@ class InitialisableProgram(unittest.TestProgram):
    module = '__main__'
    progName = 'test'
    test = 'test'
+    list_tests = False
    def __init__(self, *args):
        pass