Include total count when listing tests

Author: briancroom

Documentation/Linux.md

@@ -44,6 +44,8 @@ $ ./FooTests Tests.FooTestCase          # Run all the tests in FooTestCase
 
 ```sh
 $ ./FooTests --list-tests
+Listing 4 tests in FooTests.xctest:
+
 Tests.FooTestCase/testFoo
 Tests.FooTestCase/testBar
 Tests.BarTestCase/test123

Sources/XCTest/TestListing.swift

@@ -27,6 +27,11 @@ internal struct TestListing {
     /// Prints a flat list of the tests in the suite, in the format used to
     /// specify a test by name when running tests.
     func printTestList() {
+        let list = testSuite.list()
+        let tests = list.count == 1 ? "test" : "tests"
+        let bundleName = testSuite.findBundleTestSuite()?.name ?? "<<unknown bundle>>"
+
+        print("Listing \(list.count) \(tests) in \(bundleName):\n")
         for entry in testSuite.list() {
             print(entry)
         }
@@ -76,6 +81,14 @@ extension XCTestSuite: Listable {
                    "tests": listedTests.bridge()
             ].bridge()
     }
+
+    func findBundleTestSuite() -> XCTestSuite? {
+        if name.hasSuffix(".xctest") {
+            return self
+        } else {
+            return tests.flatMap({ ($0 as? XCTestSuite)?.findBundleTestSuite() }).first
+        }
+    }
 }
 
 extension XCTestCase: Listable {

Tests/Functional/ListTests/main.swift

@@ -32,6 +32,8 @@ if Process.arguments.contains("--verify") {
     exit(0)
 }
 
+// CHECK: Listing 4 tests in .*\.xctest:
+// CHECK: ^$
 
 class FirstTestCase: XCTestCase {
     static var allTests = {