def setup() {
        withFailingTest() // ensures that withTestsFor statements are not ignored
    }

    @TargetGradleVersion('>=3.0 <7.6')
    def "older Gradle versions ignore withTestsFor calls"() {
        when:
        launchTests { TestLauncher launcher ->
            launcher.withTestsFor { TestSpecs specs ->
                specs.forTaskPath(':secondTest').includeClass('example.MyTest')

import spock.lang.Issue

@ToolingApiVersion('>=7.6')
@TargetGradleVersion(">=8.2")
class TestLauncherTestSpecCrossVersionSpec extends TestLauncherSpec {

    def setup() {
        withFailingTest() // ensures that withTestsFor statements are not ignored
    }

    @TargetGradleVersion(">=7.6 <8.2")
    @Issue("https://github.com/gradle/gradle/pull/25229")

    @TargetGradleVersion(">=7.6 <8.3")
    def "Cannot run tests with custom task implementation in older Gradle versions"() {
        when:
        launchTests { TestLauncher launcher ->
            launcher.withTestsFor { TestSpecs specs ->
                specs.forTaskPath(':myTestTask').includeClass('org.my.MyClass')
            }
        }

        then:
        Throwable exception = thrown(TestExecutionException)

            TestLauncher testLauncher = connection.newTestLauncher()
            collectOutputs(testLauncher)

            testLauncher.forTasks("setupTest")
                        .withTestsFor(s -> s.forTaskPath(":test")
                        .includeMethod('MyTest', 'pass'))
                        .forTasks("cleanupTest")
                        .run()
        }

        then:

 */

package org.gradle.tooling;

import org.gradle.api.Action;
import org.gradle.api.Incubating;

/**
 * Provides test selection from a specific test task.
 *
 * @see TestLauncher#withTestsFor(Action)
 * @since 7.6
 */
@Incubating
public interface TestSpecs {

    /**
     * Creates a new test selection for the target task.
     *
     * @param taskPath The target task.

     * <pre>
     *     TestLauncher testLauncher = projectConnection.newTestLauncher();
     *     testLauncher.withTestsFor(spec -&gt; {
     *         spec.forTaskPath(":test")
     *             .includePackage("org.pkg")
     *             .includeClass("com.TestClass")
     *             .includeMethod("com.TestClass")

 * <p>
 * A complex example:
 * <pre>
 * TestLauncher testLauncher = projectConnection.newTestLauncher();
 * testLauncher.withTestsFor(specs -&gt; {
 *     specs.forTaskPath(":test")                                    // configure the test selection on the ':test' task

                    return String.format("Could not execute tests using %s.", connection.getDisplayName());
                }
            }));
        }
    }

    @Override
    public TestLauncher withTestsFor(Action<TestSpecs> testSpec) {
        DefaultTestSpecs testSpecs = new DefaultTestSpecs();
        testSpec.execute(testSpecs);
        taskSpecs.addAll(testSpecs.getTestSpecs());
        return this;
    }