タグによるテスト実行のフィルタリング

--filter / --skip オプションの引数に、特別な接頭辞 tag: を導入します。タグでフィルタリング・スキップしたいときは、引数を tag: で始めます。

swift test --skip tag:uiTest

tag: に続く部分（この例では uiTest）は、対象とするタグ名にマッチさせる正規表現です。通常の --filter / --skip と同じく、オプションを複数回指定すると、指定したタグの いずれか にマッチするテストをフィルタリング・スキップします。

swift test --skip tag:uiTest --skip tag:integrationTest

複数の --filter / --skip を指定した場合の挙動は or（いずれか）であり、and（すべて）ではない点に注意してください。指定したすべてのタグにマッチするテストだけを対象にする、という指定は現状ではできません。

id: 接頭辞による曖昧さの解消

SE-0451 で raw identifier が導入され、次のような関数名も書けるようになりました。

@Test func `tag:uiTest`() { /* ... */ }

このような名前のテストも引き続きマッチできるよう、id: というもう 1 つの接頭辞を導入します。id: は「テストのシンボル名に対してマッチする」ことを明示するための接頭辞で、続く部分は tag: と同様に正規表現として扱われます。

swift test --skip 'id:tag:uiTest'

id: は新しい挙動を加えるものではなく、Swift Testing がこれまでサポートしてきたフィルタリングそのものです。接頭辞を省略することもでき、既知の接頭辞（tag: / id:）のいずれも付いていない場合は id: が指定されたものとみなされます。これにより、既存の使い方はそのまま動作します。

raw identifier をタグ名に使う場合

逆に、raw identifier をタグ名として使うこともできます。

extension Tag {
    @Tag static var `some tag with spaces`: Self
}

@Test(.tags(.`some tag with spaces`))
func myTest() { /* ... */ }

このようにスペースを含むタグ名でフィルタリングするときは、引数全体をシングルクォートで囲み、tag: の後ろをそのまま 1 つのタグ名として扱わせます。

swift test --filter 'tag:some tag with spaces'

raw identifier を区切るためのバッククォートはシンボル名の一部ではないため、次のようにバッククォートごと指定してもマッチしません。

swift test --filter 'tag:`some tag with spaces`' # INVALID: シンボルにマッチしない

引数全体がバッククォートで囲まれている場合（より正確には正規表現 /^`[^`]*`$/ にマッチする場合）は、ユーザーが raw identifier を意図したものと判断し、エラーメッセージを表示したうえでバッククォートを取り除きます。

Backticks aren't a valid part of a Swift symbol. Replacing '`some tag with spaces`' with 'some tag with spaces'.

互換性についての注意

テスト関数やスイートの名前に文字列 tag: が含まれている場合、tag: で始まるフィルタリング・スキップ引数の挙動はこの提案によって変わり、正規表現ではなくタグとして解釈されます。ただし、シンボル名に tag: が現れるのは前述の raw identifier を使った場合に限られるため、影響を受けるのは比較的まれなケースです。この場合は id: 接頭辞を使えば、これまで通りシンボル名に対してマッチできます。