Add --xctestrun-file for iOS

test_runner/src/main/kotlin/ftl/args/IosArgs.kt

@@ -42,7 +42,7 @@ class IosArgs(
 
     private val iosGcloud = iosGcloudYml.gcloud
     var xctestrunZip = cli?.test ?: iosGcloud.test
-    var xctestrunFile = iosGcloud.xctestrunFile
+    var xctestrunFile = cli?.xctestrunFile ?: iosGcloud.xctestrunFile
     val xcodeVersion = iosGcloud.xcodeVersion
     val devices = iosGcloud.device
 

test_runner/src/main/kotlin/ftl/cli/firebase/test/ios/IosRunCommand.kt

@@ -87,4 +87,10 @@ class IosRunCommand : Runnable {
         |  beginning with gs://. Note: any .xctestrun file in this zip file will be ignored if --xctestrun-file
         |   is specified."""])
     var test: String? = null
+
+    @Option(names = ["--xctestrun-file"], description = ["""The path to an .xctestrun file that will override any
+        |.xctestrun file contained in the --test package. Because the .xctestrun file contains environment variables
+        |along with test methods to run and/or ignore, this can be useful for customizing or sharding test suites. The
+        | given path may be in the local filesystem or in Google Cloud Storage using a URL beginning with gs://."""])
+    var xctestrunFile: String? = null
 }

test_runner/src/test/kotlin/ftl/args/IosArgsTest.kt

@@ -416,4 +416,19 @@ IosArgs
         assertThat(IosArgs.load(yaml).xctestrunZip).isEqualTo(xctestrunFileAbsolutePath)
         assertThat(IosArgs.load(yaml, cli).xctestrunZip).isEqualTo(testAbsolutePath)
     }
+
+    @Test
+    fun cli_xctestrunFile() {
+        val cli = IosRunCommand()
+        CommandLine(cli).parse("--xctestrun-file=$xctestrunFile")
+
+        val yaml = """
+        gcloud:
+          test: $testPath
+          xctestrun-file: $testPath
+      """
+
+        assertThat(IosArgs.load(yaml).xctestrunFile).isEqualTo(testAbsolutePath)
+        assertThat(IosArgs.load(yaml, cli).xctestrunFile).isEqualTo(xctestrunFileAbsolutePath)
+    }
 }

test_runner/src/test/kotlin/ftl/cli/firebase/test/ios/IosRunCommandTest.kt

@@ -69,6 +69,7 @@ class IosRunCommandTest {
         assertThat(cmd.testTargetsAlwaysRun).isNull()
         assertThat(cmd.testTargets).isNull()
         assertThat(cmd.test).isNull()
+        assertThat(cmd.xctestrunFile).isNull()
     }
 
     @Test
@@ -168,4 +169,12 @@ class IosRunCommandTest {
 
         assertThat(cmd.test).isEqualTo("a")
     }
+
+    @Test
+    fun test_xctestrunFile() {
+        val cmd = IosRunCommand()
+        CommandLine(cmd).parse("--xctestrun-file=a")
+
+        assertThat(cmd.xctestrunFile).isEqualTo("a")
+    }
 }