タグ・バグ・時間制限の trait のメタデータを event stream に含める

JSON event stream のスキーマバージョン "6.4" 以降で、テスト関数およびテストスイートを表す構造に "tags"、"bugs"、"timeLimit" の 3 つのフィールドを追加します。これらはいずれもオプショナルで、対応する trait がテストに付与されていない場合は出力から省略され、JSON が無駄に肥大化したり null で埋め尽くされたりしないようになっています。

追加は純粋に additive で、既存のスキーマバージョン（"0" や "6.3" など）を消費しているツールには影響しません。

スキーマの追加内容

<test-suite> および <test-function> 構造に対する BNF 上の差分は次のとおりです。

   ["displayName": <string>,]
   "sourceLocation": <source-location>,
   "id": <test-id>,
-  "isParameterized": <bool>
+  "isParameterized": <bool>,
+  ["tags": <array:tag>,]
+  ["bugs": <array:bug>,]
+  ["timeLimit": <number>]
 }

+<tag> ::= <string>
+
+<bug> ::= {
+  ["url": <string>,]
+  ["id": <string>,]
+  ["title": <string>]
+}

各フィールドの意味は次のとおりです。

• tags: テストに付与されたタグの文字列表現の配列
• bugs: テストに関連付けられたバグの配列。要素は url / id / title を持つオブジェクトで、いずれもオプショナル
• timeLimit: テストに設定された時間制限を秒数で表す数値

出力例

たとえば次のようなテスト関数を考えます。

extension Tag {
  @Tag public static var blue: Self
  @Tag public static var red: Self

  public enum Foo {
    @Tag public static var bar: Self
  }
}

@Test(
  .tags(.blue),
  .tags(Tag.red),
  .bug("https://my.defect.com/1234"),
  .bug(id: "12345", "other defect"),
  .timeLimit(.minutes(testTimeLimit + 1)),
  .timeLimit(.minutes(testTimeLimit)),
  .timeLimit(.minutes(testTimeLimit + 10)),
  arguments: expectedArgs as [String]
)
func example() {}

このテストに対して新スキーマで生成される JSON の payload には、次のような形でメタデータが含まれます。

{
  "kind": "test",
  "payload": {
    "bugs": [
      { "url": "https://my.defect.com/1234" },
      { "id": "12345", "title": "other defect" }
    ],
    "tags": [
      "blue",
      "red"
    ],
    "timeLimit": 3
  }
}

タグの文字列化ルール

tags フィールドの各要素は、@Tag で宣言された Swift のプロパティを文字列化したものになります。Tag 型からの相対パスとして表現され、Tag 自体や Testing モジュール名のような共通の前置きは取り除かれます。

これにより、Swift コード上の表記の揺れにかかわらず、同じタグであれば JSON 上でも同じ文字列で識別できます。

バグと時間制限の取り扱い

bugs の各要素では url / id / title のいずれもオプショナルで、.bug(_:) や .bug(id:_:) などの呼び出しで指定された情報のみが含まれます。指定されていないキーはオブジェクトから省略されます。

timeLimit は秒単位の数値です。同一テストに複数の .timeLimit(...) が付与されている場合は、Swift Testing 内部で最も短い時間制限が選ばれ、その値が秒に変換されて出力されます。上記の例では、testTimeLimit を含む 3 つの指定のうち最も短い .minutes(testTimeLimit)（テスト実行時の値で 3 秒）が採用されています。

ツール側で期待できる体験

これらのフィールドが揃うことで、JSON event stream を消費するツール側で次のような体験を組み立てられるようになります。

• IDE がテストレポートをタグで並べ替え・絞り込みする
• CI 上でタグごとに集計したテストレポートを生成する
• 時間制限つきテストを抽出し、その実行時間を追跡する
• 既知バグに関連付けられたテストの失敗・成功を、バグトラッカ側と紐付けて表示する