/**
     * Sets the file which the report will be written to. Set this to {@code null} to write the report to {@code System.out}.
     *
     * @param outputFile The output file. May be null.
     */
    public void setOutputFile(@Nullable File outputFile) {
        this.outputFile = outputFile;
    }

    /**
     * Returns the set of project to generate this report for. By default, the report is generated for the task's

     * <p>
     * This report IS enabled by default.
     *
     * @return The checkstyle XML report
     */
    @Internal
    SingleFileReport getXml();

    /**
     * The checkstyle SARIF report
     * <p>
     * This report is NOT enabled by default.
     *
     * @return The checkstyle SARIF report
     * @since 8.1
     */
    @Internal
    @Incubating
    SingleFileReport getSarif();

        def report = TestUtil.objectFactory(tmpDir.testDirectory).newInstance(TaskGeneratedSingleDirectoryReport, "report", Stub(Task), "entryPoint")
        def output = new File("report.dir")
        def resolvedOutput = tmpDir.file("report.dir")

        expect:
        !report.outputLocation.isPresent()

        report.conventionMapping.map("destination") { output }

        result.output.assertContains("failed-report-with-leftover/build/tmp/teŝt files/leftover")
        result.output.assertContains("failed-test-with-leftover/build/tmp/teŝt files/leftover")

        assertArchivedFilesSeen(
            "report-failed-test-with-leftover-test.zip",
            "report-failed-report-with-leftover-reports.zip",
            "report-failed-test-with-leftover-leftover.zip",

import org.gradle.api.reporting.Report
import org.gradle.api.reporting.ReportContainer
import org.gradle.internal.Describables
import org.gradle.util.TestUtil
import spock.lang.Specification

class DefaultReportContainerTest extends Specification {
    static class TestReportContainer extends DefaultReportContainer {
        TestReportContainer(Closure c) {

import java.io.File;

/**
 * A file based report to be created with a configurable destination.
 *
 * Note this is a legacy type which offers no additional functionality.  Reports
 * should implement {@link Report} directly instead of using this interface.
 */
public interface ConfigurableReport extends Report {
    /**
     * Sets the destination for the report.
     *
     * @param file The destination for the report.

import javax.annotation.Nullable;

/**
 * A HTML Report whose generation can be customized with a XSLT stylesheet.
 */
public interface CustomizableHtmlReport extends SingleFileReport {

    /**
     * The stylesheet to use to generate the HTML report.
     *
     * @return the stylesheet to use to generate the HTML report
     */
    @Nullable
    @Optional
    @Nested

[[test_report_aggregation_plugin]]
= The Test Report Aggregation Plugin

The Test Report Aggregation plugin (plugin id: `test-report-aggregation`) provides tasks and configurations used to aggregate the results of multiple link:{groovyDslPath}/org.gradle.api.tasks.testing.Test.html[Test] task invocations (potentially spanning multiple Gradle projects) into a single HTML report.

[[sec:test_report_aggregation_usage]]
== Usage

    private final DirectoryProperty reportDir;
    private File outputFile;

    /**
     * Returns the project report directory.
     * <p>
     * The {@code project-report} plugin sets the default value for all tasks of this type to {@code buildDir/project}.
     * <p>
     * Note, that if the {@code project-report} plugin is not applied then this property is ignored.
     *
     * @return the directory to store project reports

// tag::test-report[]
plugins {
    id 'xctest'
}

xctest {
    binaries.configureEach {
        runTask.get().configure {
            // Disable the test report for the individual test task
            reports.html.required = false
        }
    }
}

// Share the test report data to be aggregated for the whole project
configurations {
    binaryTestResultsElements {
        canBeResolved = false
        attributes {