feat: Implement env parsing

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

@@ -291,3 +291,14 @@ fun String.normalizeFilePath(): String =
 fun List<String>.normalizeToTestTargets(): ShardChunks =
     if (isEmpty()) emptyList()
     else map { it.split(',', ';') }
+
+fun getEnv(name: String): String? = System.getenv(name)
+
+fun List<String>.parseEnvsIfNeeded() = this
+    .partition { it.startsWith("$") }
+    .let { (envs, commonTestTargets) ->
+        commonTestTargets + envs
+            .mapNotNull { getEnv(it.drop(1)) }
+            .flatMap { it.split(",") }
+            .map { it.trim() }
+    }

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

@@ -20,7 +20,7 @@ fun createAndroidArgs(
     appApk = gcloud.app?.normalizeFilePath(),
     testApk = gcloud.test?.normalizeFilePath(),
     useOrchestrator = gcloud::useOrchestrator.require(),
-    testTargets = gcloud::testTargets.require().filterNotNull(),
+    testTargets = gcloud::testTargets.require().filterNotNull().parseEnvsIfNeeded(),
     testRunnerClass = gcloud.testRunnerClass,
     roboDirectives = gcloud::roboDirectives.require().parseRoboDirectives(),
     performanceMetrics = gcloud::performanceMetrics.require(),
@@ -35,6 +35,7 @@ fun createAndroidArgs(
         it.copy(
             app = it.app?.normalizeFilePath(),
             test = it.test.normalizeFilePath(),
+            testTargets = it.testTargets?.parseEnvsIfNeeded()
         )
     } ?: emptyList(),
     useLegacyJUnitResult = flank::useLegacyJUnitResult.require(),

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

@@ -30,7 +30,7 @@ private fun createIosArgs(
     xctestrunFile = gcloud.xctestrunFile?.normalizeFilePath().orEmpty(),
     xcodeVersion = gcloud.xcodeVersion,
     additionalIpas = gcloud::additionalIpas.require().map { it.normalizeFilePath() },
-    testTargets = flank.testTargets?.filterNotNull().orEmpty(),
+    testTargets = flank.testTargets?.filterNotNull().orEmpty().parseEnvsIfNeeded(),
     obfuscateDumpShards = obfuscate,
     app = gcloud.app?.normalizeFilePath().orEmpty(),
     testSpecialEntitlements = gcloud.testSpecialEntitlements ?: false,

test_runner/src/main/kotlin/ftl/config/android/AndroidGcloudConfig.kt

@@ -204,7 +204,8 @@ data class AndroidGcloudConfig @JsonIgnore constructor(
                 "(default: run all test targets). Each target filter must be fully qualified with the package name, class name, " +
                 "or test annotation desired. Any test filter supported by am instrument -e … is supported. " +
                 "See https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner for more " +
-                "information."
+                "information. You can also pass values as environment variables: \$TEST_TARGETS_IN_ENV. This can be also list of " +
+                "strings delimited by coma."
         ]
     )
     @set:JsonProperty("test-targets")

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

@@ -13,6 +13,8 @@ import ftl.test.util.TestHelper.absolutePath
 import ftl.test.util.TestHelper.assert
 import ftl.test.util.TestHelper.getPath
 import ftl.test.util.TestHelper.getString
+import io.mockk.every
+import io.mockk.mockkStatic
 import kotlinx.coroutines.runBlocking
 import org.junit.Assert.assertEquals
 import org.junit.Rule
@@ -102,6 +104,18 @@ class AndroidArgsFileTest {
         }
     )
 
+    @Test
+    fun `should parse test-targets from env`() {
+        mockkStatic("ftl.args.ArgsHelperKt")
+        every { getEnv("FROM_ENV") } returns "class from.env.Class,notAnnotation from.env.Annotation"
+        val config = AndroidArgs.load(localYamlFile)
+        assertThat(config.testTargets).containsExactly(
+            "class from.env.Class",
+            "notAnnotation from.env.Annotation",
+            "class com.example.app.ExampleUiTest#testPasses"
+        )
+    }
+
     @Test
     fun `calculateShards additionalAppTestApks`() {
         val test1 = "src/test/kotlin/ftl/fixtures/tmp/apk/app-debug-androidTest_1.apk"

test_runner/src/test/kotlin/ftl/fixtures/flank.local.yml

@@ -10,6 +10,7 @@ gcloud:
   async: true
   test-targets:
   - class com.example.app.ExampleUiTest#testPasses
+  - $FROM_ENV
   device:
   - model: NexusLowRes
     version: 23