[Analysis API] AnalysisApiTestConfigurator: convert testPrefix -> testPrefixes

It allows us to provide a few prefixes at once to avoid duplication.
Use case: 3 tests use one test data file. The first test has some output.
The second one can either produce the same output or provide another
with some prefix. And the last one can either produce the same output
as any previous one or a new one. With `testPrefixes` we can allow the
last one to reuse both other outputs (without a prefix and with one
prefix)

^KT-71787

Author: dimonchik0036

analysis/analysis-api-fe10/tests/org/jetbrains/kotlin/analysis/api/fe10/test/configurator/AnalysisApiFe10TestConfigurator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -11,14 +11,11 @@ import org.jetbrains.kotlin.analysis.api.impl.base.test.configurators.AnalysisAp
 import org.jetbrains.kotlin.analysis.api.impl.base.test.configurators.AnalysisApiDecompiledCodeTestServiceRegistrar
 import org.jetbrains.kotlin.analysis.api.impl.base.test.configurators.AnalysisApiIdeModeTestServiceRegistrar
 import org.jetbrains.kotlin.analysis.api.standalone.base.projectStructure.AnalysisApiServiceRegistrar
-import org.jetbrains.kotlin.analysis.test.framework.projectStructure.KtSourceTestModuleFactory
-import org.jetbrains.kotlin.analysis.test.framework.projectStructure.KtTestModule
-import org.jetbrains.kotlin.analysis.test.framework.projectStructure.KtTestModuleFactory
-import org.jetbrains.kotlin.analysis.test.framework.projectStructure.KtTestModuleStructure
-import org.jetbrains.kotlin.analysis.test.framework.projectStructure.TestModuleStructureFactory
+import org.jetbrains.kotlin.analysis.test.framework.projectStructure.*
 import org.jetbrains.kotlin.analysis.test.framework.services.configuration.AnalysisApiBinaryLibraryIndexingMode
 import org.jetbrains.kotlin.analysis.test.framework.services.configuration.AnalysisApiIndexingConfiguration
-import org.jetbrains.kotlin.analysis.test.framework.services.libraries.*
+import org.jetbrains.kotlin.analysis.test.framework.services.libraries.configureLibraryCompilationSupport
+import org.jetbrains.kotlin.analysis.test.framework.services.libraries.configurePlatformEnvironmentConfigurators
 import org.jetbrains.kotlin.analysis.test.framework.test.configurators.AnalysisApiTestConfigurator
 import org.jetbrains.kotlin.analysis.test.framework.test.configurators.FrontendKind
 import org.jetbrains.kotlin.resolve.lazy.JvmResolveUtil
@@ -32,11 +29,8 @@ import kotlin.io.path.nameWithoutExtension
 
 object AnalysisApiFe10TestConfigurator : AnalysisApiTestConfigurator() {
     override val analyseInDependentSession: Boolean get() = false
-
     override val frontendKind: FrontendKind get() = FrontendKind.Fe10
-
-    override val testPrefix: String
-        get() = "descriptors"
+    override val testPrefixes: List<String> get() = listOf("descriptors")
 
     override fun configureTest(builder: TestConfigurationBuilder, disposable: Disposable) {
         builder.apply {
@@ -72,7 +66,7 @@ object AnalysisApiFe10TestConfigurator : AnalysisApiTestConfigurator() {
     }
 
     override fun computeTestDataPath(path: Path): Path {
-        val newPath = path.resolveSibling(path.nameWithoutExtension + "." + testPrefix + "." + path.extension)
+        val newPath = path.resolveSibling(path.nameWithoutExtension + "." + testPrefixes.single() + "." + path.extension)
         if (newPath.toFile().exists()) return newPath
         return path
     }

analysis/analysis-api-impl-base/tests/org/jetbrains/kotlin/analysis/api/impl/base/test/cases/session/AbstractSessionInvalidationTest.kt

@@ -1,12 +1,12 @@
 /*
- * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
 package org.jetbrains.kotlin.analysis.api.impl.base.test.cases.session
 
-import org.jetbrains.kotlin.analysis.api.projectStructure.KaModule
 import org.jetbrains.kotlin.analysis.api.platform.modification.KotlinModificationEventKind
+import org.jetbrains.kotlin.analysis.api.projectStructure.KaModule
 import org.jetbrains.kotlin.analysis.test.framework.base.AbstractAnalysisApiBasedTest
 import org.jetbrains.kotlin.analysis.test.framework.directives.publishWildcardModificationEventsByDirective
 import org.jetbrains.kotlin.analysis.test.framework.projectStructure.ktTestModuleStructure
@@ -90,7 +90,7 @@ abstract class AbstractSessionInvalidationTest<SESSION> : AbstractAnalysisApiBas
             // Standalone modes) to have different test results (since `testPrefix` normally supports this functionality), but (1) we are
             // currently only testing the IDE mode and (2) the test results between different modes should not differ for session
             // invalidation in the first place.
-            testPrefix = resultFileSuffix,
+            testPrefixes = listOfNotNull(resultFileSuffix),
         )
     }
 

analysis/analysis-api-standalone/tests/org/jetbrains/kotlin/analysis/api/standalone/fir/test/configurators/StandaloneModeConfiguratorBase.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -15,9 +15,7 @@ import org.jetbrains.kotlin.test.builders.TestConfigurationBuilder
 abstract class StandaloneModeConfiguratorBase : AnalysisApiTestConfigurator() {
     override val analyseInDependentSession: Boolean get() = false
     override val frontendKind: FrontendKind get() = FrontendKind.Fir
-
-    override val testPrefix: String
-        get() = "standalone.fir"
+    override val testPrefixes: List<String> get() = listOf("standalone.fir")
 
     override fun configureTest(builder: TestConfigurationBuilder, disposable: Disposable) {
         builder.apply {

analysis/analysis-test-framework/tests/org/jetbrains/kotlin/analysis/test/framework/base/AbstractAnalysisApiBasedTest.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -282,19 +282,6 @@ abstract class AbstractAnalysisApiBasedTest : TestWithDisposable() {
                 file.virtualFile.nameWithoutExtension == ktTestModule.testModule.mainFileName
     }
 
-    /**
-     * Checks whether the [actual] string matches the content of the test output file.
-     *
-     * Check the [assertEqualsToTestDataFileSibling] overload accepting a prefix list for more information.
-     */
-    protected fun AssertionsService.assertEqualsToTestDataFileSibling(
-        actual: String,
-        extension: String = ".txt",
-        testPrefix: String? = configurator.testPrefix,
-    ) {
-        assertEqualsToTestDataFileSibling(actual, extension, listOfNotNull(testPrefix))
-    }
-
     /**
      * Checks whether the [actual] string matches the content of the test output file.
      *
@@ -311,7 +298,7 @@ abstract class AbstractAnalysisApiBasedTest : TestWithDisposable() {
     protected fun AssertionsService.assertEqualsToTestDataFileSibling(
         actual: String,
         extension: String = ".txt",
-        testPrefixes: List<String>,
+        testPrefixes: List<String> = configurator.testPrefixes,
     ) {
         val expectedFiles = buildList {
             testPrefixes.mapNotNullTo(this) { findPrefixedTestDataSibling(extension, it) }
@@ -331,11 +318,11 @@ abstract class AbstractAnalysisApiBasedTest : TestWithDisposable() {
     }
 
     /**
-     * Returns the test output file with a [testPrefix] if it exists, of the non-prefixed (default) test output file.
+     * Returns the test output file with any of [testPrefixes] if it exists, of the non-prefixed (default) test output file.
      */
-    protected fun getTestDataSibling(extension: String = "txt", testPrefix: String? = configurator.testPrefix): Path {
-        if (testPrefix != null) {
-            findPrefixedTestDataSibling(extension, testPrefix)?.let { return it }
+    protected fun getTestDataSibling(extension: String = "txt", testPrefixes: List<String> = configurator.testPrefixes): Path {
+        for (prefix in testPrefixes) {
+            findPrefixedTestDataSibling(extension, prefix)?.let { return it }
         }
 
         return getDefaultTestDataSibling(extension)

analysis/analysis-test-framework/tests/org/jetbrains/kotlin/analysis/test/framework/test/configurators/AnalysisApiTestConfigurator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -20,7 +20,10 @@ import org.jetbrains.kotlin.test.testFramework.runWriteAction
 import java.nio.file.Path
 
 abstract class AnalysisApiTestConfigurator {
-    open val testPrefix: String? get() = null
+    /**
+     * @see org.jetbrains.kotlin.analysis.test.framework.base.AbstractAnalysisApiBasedTest.assertEqualsToTestDataFileSibling
+     */
+    open val testPrefixes: List<String> get() = emptyList()
 
     abstract val frontendKind: FrontendKind
 

analysis/low-level-api-fir/tests/org/jetbrains/kotlin/analysis/low/level/api/fir/test/configurators/AnalysisApiFirLibrarySourceTestConfigurator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -21,7 +21,8 @@ import org.jetbrains.kotlin.analysis.test.framework.projectStructure.TestModuleS
 import org.jetbrains.kotlin.analysis.test.framework.services.configuration.AnalysisApiBinaryLibraryIndexingMode
 import org.jetbrains.kotlin.analysis.test.framework.services.configuration.AnalysisApiIndexingConfiguration
 import org.jetbrains.kotlin.analysis.test.framework.services.configuration.AnalysisApiJvmEnvironmentConfigurator
-import org.jetbrains.kotlin.analysis.test.framework.services.libraries.*
+import org.jetbrains.kotlin.analysis.test.framework.services.libraries.DispatchingTestModuleCompiler
+import org.jetbrains.kotlin.analysis.test.framework.services.libraries.TestModuleCompiler
 import org.jetbrains.kotlin.analysis.test.framework.test.configurators.AnalysisApiTestConfigurator
 import org.jetbrains.kotlin.analysis.test.framework.test.configurators.FrontendKind
 import org.jetbrains.kotlin.test.builders.TestConfigurationBuilder
@@ -32,7 +33,7 @@ import org.jetbrains.kotlin.test.services.configuration.JsEnvironmentConfigurato
 object AnalysisApiFirLibrarySourceTestConfigurator : AnalysisApiTestConfigurator() {
     override val analyseInDependentSession: Boolean get() = false
     override val frontendKind: FrontendKind get() = FrontendKind.Fir
-    override val testPrefix: String get() = "librarySource"
+    override val testPrefixes: List<String> get() = listOf("librarySource")
 
     override fun configureTest(
         builder: TestConfigurationBuilder,

analysis/low-level-api-fir/tests/org/jetbrains/kotlin/analysis/low/level/api/fir/test/configurators/AnalysisApiFirOutOfContentRootTestConfigurator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -30,8 +30,7 @@ import org.jetbrains.kotlin.test.services.targetPlatform
 import java.nio.file.Path
 
 object AnalysisApiFirOutOfContentRootTestConfigurator : AnalysisApiFirSourceLikeTestConfigurator(false) {
-    override val testPrefix: String
-        get() = "out_of_src_roots"
+    override val testPrefixes: List<String> get() = listOf("out_of_src_roots")
 
     override fun configureTest(builder: TestConfigurationBuilder, disposable: Disposable) {
         super.configureTest(builder, disposable)

analysis/low-level-api-fir/tests/org/jetbrains/kotlin/analysis/low/level/api/fir/test/configurators/AnalysisApiFirSourceLikeTestConfigurator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -40,8 +40,8 @@ abstract class AnalysisApiFirSourceLikeTestConfigurator(override val analyseInDe
         }
     }
 
-    override val testPrefix: String?
-        get() = if (analyseInDependentSession) "dependent.fir" else null
+    override val testPrefixes: List<String>
+        get() = if (analyseInDependentSession) listOf("dependent.fir") else emptyList()
 
     override val serviceRegistrars: List<AnalysisApiServiceRegistrar<TestServices>> = listOf(
         AnalysisApiBaseTestServiceRegistrar,

analysis/symbol-light-classes/tests/org/jetbrains/kotlin/light/classes/symbol/base/AbstractSymbolLightClassesStructureByFqNameTest.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -31,7 +31,7 @@ abstract class AbstractSymbolLightClassesStructureByFqNameTest(
             psiClass?.let { handleClass(it) } ?: append(LightClassTestCommon.NOT_GENERATED_DIRECTIVE)
         }
 
-        testServices.assertions.assertEqualsToTestDataFileSibling(result, testPrefix = testPrefix)
+        testServices.assertions.assertEqualsToTestDataFileSibling(result, testPrefixes = listOf(testPrefix))
 
         doTestInheritors(ktFiles, testServices)
     }

analysis/symbol-light-classes/tests/org/jetbrains/kotlin/light/classes/symbol/base/AbstractSymbolLightClassesStructureTest.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -32,7 +32,7 @@ abstract class AbstractSymbolLightClassesStructureTest(
             }
         }
 
-        testServices.assertions.assertEqualsToTestDataFileSibling(result, testPrefix = testPrefix)
+        testServices.assertions.assertEqualsToTestDataFileSibling(result, testPrefixes = listOf(testPrefix))
         doTestInheritors(ktFiles, testServices)
     }
 }

analysis/symbol-light-classes/tests/org/jetbrains/kotlin/light/classes/symbol/base/AbstractSymbolLightClassesStructureTestBase.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Copyright 2010-2025 JetBrains s.r.o. and Kotlin Programming Language contributors.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
  */
 
@@ -35,7 +35,7 @@ open class AbstractSymbolLightClassesStructureTestBase(
 ) : AbstractSymbolLightClassesTestBase(configurator) {
     override val currentExtension: String get() = throw UnsupportedOperationException()
     protected fun doTestInheritors(ktFiles: List<KtFile>, testServices: TestServices) {
-        val testData = getTestDataSibling(extension = INHERITORS_EXTENSION, testPrefix = testPrefix)
+        val testData = getTestDataSibling(extension = INHERITORS_EXTENSION, testPrefixes = listOf(testPrefix))
         if (testData.notExists()) return
         val project = ktFiles.first().project
 
@@ -63,8 +63,8 @@ open class AbstractSymbolLightClassesStructureTestBase(
 
         testServices.assertions.assertEqualsToTestDataFileSibling(
             actual = result,
-            testPrefix = testPrefix,
             extension = INHERITORS_EXTENSION,
+            testPrefixes = listOf(testPrefix),
         )
     }