*
     * @see <a href="https://junit.org/junit5/docs/current/user-guide/#writing-tests-tagging-and-filtering">Tagging and Filtering</a>
     */
    public JUnitPlatformOptions includeTags(String... includeTags) {
        this.includeTags.addAll(Arrays.asList(includeTags));
        return this;
    }

    /**
     * The set of engines to exclude.
     *

            .excludeEngines("sourceExcludedCategory")
            .includeTags("sourceIncludedTag")
            .excludeTags("sourceExcludedTag")

        when:
        def target = new JUnitPlatformOptions()
            .includeEngines("targetIncludedCategory")
            .excludeEngines("targetExcludedCategory")
            .includeTags("targetIncludedTag")
            .excludeTags("targetExcludedTag")

    private final Set<String> excludeEngines;
    private final Set<String> includeTags;
    private final Set<String> excludeTags;
    private final boolean isDryRun;

    public JUnitPlatformSpec(
        TestFilterSpec filter,
        Set<String> includeEngines,
        Set<String> excludeEngines,
        Set<String> includeTags,
        Set<String> excludeTags,
        boolean isDryRun
    ) {

    private final Set<String> includeTags;
    private final Set<String> excludeTags;
    private final Set<String> includeEngines;
    private final Set<String> excludeEngines;

    DefaultTestTaskFilters(
        Set<String> includePatterns,
        Set<String> commandLineIncludePatterns,
        Set<String> excludePatterns,
        Set<String> includeTags,
        Set<String> excludeTags,

    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

// tag::test-tags[]
tasks.withType<Test>().configureEach {
    useJUnitPlatform {
        includeTags("fast")
        excludeTags("slow")
    }
}

/**
 * This annotation is a marker and guarantees all integration tests are tagged.
 *
 * When we use JUnit Platform `includeTags('SomeTag')`, all spock tests are excluded:
 * https://github.com/spockframework/spock/issues/1288 . As a workaround,
 * we tag all non-spock integration tests and use `includeTags(none() | SomeTag)` to make
 * sure spock engine tests are executed.
 */
@Retention(RetentionPolicy.RUNTIME)

 *   tests annotated by this is handled by `JUnitPlatformOptions.includeTags/excludeTags`.
 * For JUnit 4 tests, because we run them in Vintage engine, we have to annotate the tests with `@Category(Flaky.class)` so it can be transparently

    implementation 'org.junit.jupiter:junit-jupiter:5.7.1'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

// tag::test-tags[]
tasks.withType(Test).configureEach {
    useJUnitPlatform {
        includeTags 'fast'
        excludeTags 'slow'
    }
}

            """
        }

        @Override
        String getIncludeCategoryOrTagConfigurationElement() {
            return "includeTags"
        }

        @Override
        String getExcludeCategoryOrTagConfigurationElement() {
            return "excludeTags"
        }
    }

                filter {
                    includeTestsMatching('*Class')
                    excludeTestsMatching('exclude-pattern')
                }
                useJUnitPlatform {
                    includeTags('included-tag')
                    excludeTags('excluded-tag')
                    includeEngines('included-engine')
                    excludeEngines('excluded-engine')
                }