From 8467749cf002f7c74b21f8b51eb0a64c7c229187 Mon Sep 17 00:00:00 2001
From: Jonathan Grynspan <jgrynspan@apple.com>
Date: Fri, 3 Oct 2025 10:10:26 -0400
Subject: [PATCH] Add a property to `Test.Case` to get the values of its
 arguments.

This PR adds an experimental property to `Test.Case` to allow callers to get the
test case's arguments as a type-erased array. For example:

```swift
if let testCase = Test.Case.current {
  for value in testCase.argumentValues {
    print("\(value): \(type(of: value))")
  }
}
```

We already have an `arguments` property of a type that we do not intend to make
API, so the new property is named `argumentValues` pending any of SPI renaming.
---
 .../Testing/Parameterization/Test.Case.swift  | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/Sources/Testing/Parameterization/Test.Case.swift b/Sources/Testing/Parameterization/Test.Case.swift
index ab9183cf8..c2ad90136 100644
--- a/Sources/Testing/Parameterization/Test.Case.swift
+++ b/Sources/Testing/Parameterization/Test.Case.swift
@@ -100,6 +100,46 @@ extension Test {
       }
     }
 
+    /// The arguments passed to this test case, if any.
+    ///
+    /// The values in this array correspond to the arguments to the test
+    /// function of which this instance is a test case.
+    ///
+    /// ### Passing tuples to test functions
+    ///
+    /// If your test function takes a tuple (including a key-value pair from a
+    /// dictionary) as its input and maps it to more than one argument, the
+    /// value of this property represents each member of the tuple as a separate
+    /// argument. For example, given the following test function:
+    ///
+    /// ```swift
+    /// @Test(arguments: [(Food.burger, Temperature.hot), (.iceCream, .cold),
+    ///   (.burrito, .hot), (.popsicle, .cold)])
+    /// func `Serving temperature for food`(food: Food, temp: Temperature) {
+    ///   // ...
+    /// }
+    /// ```
+    ///
+    /// The value of this property will be an array with two elements. The first
+    /// element in the array will be an instance of `Food` and the second
+    /// element will be an instance of `Temperature`.
+    ///
+    /// ### Test functions with no arguments
+    ///
+    /// If your test function is not parameterized, the testing library assigns
+    /// it a single test case and the value of this property for that test case
+    /// is the empty array.
+    @_spi(Experimental)
+    @_unavailableInEmbedded
+    public var argumentValues: [any Sendable] {
+      switch _kind {
+      case .nonParameterized:
+        []
+      case let .parameterized(arguments, _, _):
+        arguments.map(\.value)
+      }
+    }
+
     /// A number used to distinguish this test case from others associated with
     /// the same parameterized test function whose arguments have the same ID.
     ///