Augment JSON ABI

Add tags, bug and timeLimit traits to the test ABI JSON data.

Author: bkhouri

Documentation/ABI/JSON.md

@@ -157,10 +157,26 @@ additional `"testCases"` field describing the individual test cases.
   ["displayName": <string>,] ; the user-supplied custom display name
   "sourceLocation": <source-location>, ; where the test is defined
   "id": <test-id>,
-  "isParameterized": <bool> ; is this a parameterized test function or not?
+  "isParameterized": <bool>, ; is this a parameterized test function or not?
+  ["tags": <tags>,] ; the tags associated with this test function
+  ["bugs": <bugs>,] ; the bugs associated with this test function
+  ["timeLimit": <timeLimit>] ; the time limits associated with this test function
+
 }
 
 <test-id> ::= <string> ; an opaque string representing the test case
+
+<tags> ::= <string> <tags> | <string> ; a list of strings
+
+<bugs> ::= <bug> <bugs> | <bug> ; a list of bugs
+
+<bug> ::= {
+  ["url": <string>,] ; the bug url
+  ["id": <string>,] ; the bug id
+  "title": <string> ; the human readable bug title
+} ;
+
+<timeLimit> ::= <string> <timeLimit> | <string> ; a list of strings
 ```
 
 <!--

Sources/Testing/ABI/Encoded/ABI.EncodedTest.swift

@@ -1,7 +1,7 @@
 //
 // This source file is part of the Swift.org open source project
 //
-// Copyright (c) 2024 Apple Inc. and the Swift project authors
+// Copyright (c) 2024-2025 Apple Inc. and the Swift project authors
 // Licensed under Apache License v2.0 with Runtime Library Exception
 //
 // See https://swift.org/LICENSE.txt for license information
@@ -78,6 +78,15 @@ extension ABI {
     /// - Warning: Tags are not yet part of the JSON schema.
     var _tags: [String]?
 
+    /// The tags associated with the test.
+    var tags: [String]?
+
+    // The bugs associated with the test.
+    var bugs: [Bug]?
+
+    /// The time limits associated with the test.
+    var timeLimit: [String]?
+
     init(encoding test: borrowing Test) {
       if test.isSuite {
         kind = .suite
@@ -101,6 +110,25 @@ extension ABI {
           _tags = tags.map(String.init(describing:))
         }
       }
+
+      if V.versionNumber >= ABI.v6_3.versionNumber {
+        let tags = test.tags
+        if !tags.isEmpty {
+          self.tags = tags.map(String.init(describing:))
+        }
+        // From version 6.3 onwards, bugs are included as an experimental
+        // field.
+        let bugs = test.traits.compactMap { $0 as? Bug }
+        if !bugs.isEmpty {
+          self.bugs = bugs
+        }
+        if #available(_clockAPI , *) {
+          let timeLimits = test.traits.compactMap { $0 as? TimeLimitTrait }
+          if !timeLimits.isEmpty {
+            self.timeLimit = timeLimits.map { String(describing: $0.timeLimit) }
+          }
+        }
+      }
     }
   }
 }

Tests/TestingTests/SwiftPMTests.swift

@@ -377,9 +377,15 @@ struct SwiftPMTests {
     defer {
       _ = remove(temporaryFilePath)
     }
+    let testTimeLimit = Swift.Duration.seconds(3)
     do {
       let configuration = try configurationForEntryPoint(withArguments: ["PATH", outputArgumentName, temporaryFilePath, versionArgumentName, "\(version.versionNumber)"])
-      let test = Test(.tags(.blue)) {}
+      let test = Test(
+        .tags(.blue),
+        .bug("https://my.defect.com/1234"),
+        .bug("other defect"),
+        .timeLimit(testTimeLimit),
+      ) {}
       let eventContext = Event.Context(test: test, testCase: nil, configuration: nil)
 
       configuration.handleEvent(Event(.testDiscovered, testID: test.id, testCaseID: nil), in: eventContext)
@@ -407,6 +413,15 @@ struct SwiftPMTests {
       } else {
         #expect(testRecord._tags == nil)
       }
+
+      if version.versionNumber >= ABI.v6_3.versionNumber {
+        #expect(testRecord.tags != nil)
+        let bugs = try #require(testRecord.bugs)
+        #expect(bugs.count == 2)
+        let timeLimit = try #require(testRecord.timeLimit)
+        #expect(timeLimit == [String(describing: testTimeLimit)])
+      }
+
     }
     let eventRecords = decodedRecords.compactMap { record in
       if case let .event(event) = record.kind {