buildFile << """
            task someTask(type: OutputDirectoryTask)
        """
        def someTask = ":someTask"
        def externalFile = file("build/overlap/external.txt")
        def someTaskOutput = file("build/overlap/someTask.txt")
        externalFile.text = "Created by something else"
        when:
        withBuildCache().run(someTask)
        then:
        // someTask cannot be cached.

            import ${Project.name}
            import ${Plugin.name}

            class SomePlugin: Plugin<Project> {
                override fun apply(project: Project) {
                    project.tasks.register("someTask", SomeTask::class.java) {
                        flag.set(true)
                        message.set("some value")
                        number.set(1.23)
                        list.set(listOf(1, 2))

// tag::task-type[]
abstract class SomeTask : DefaultTask() {
    @TaskAction
    fun action() {
        project.copy { // <1>
            from("source")
            into("destination")
        }
    }
}
// end::task-type[]

tasks.register<SomeTask>("someTaskType")

// tag::ad-hoc-task[]
tasks.register("someTask") {
    doLast {
        project.copy { // <1>
            from("source")
            into("destination")

        buildFile << """

            class SomeTask extends DefaultTask {

                @Input
                TextResource textResource = project.resources.text.$expression

                @TaskAction
                def action() {
                    println('> ' + textResource.asString())
                }
            }

            tasks.register("someTask", SomeTask)
        """

        when:

commands: [{
  executable: gradle
  args: "--rerun-tasks someTask -DsomeDestination=dest"
  expected-output-file: store.out
  allow-additional-output: true
}, {
  executable: gradle
  args: "--rerun-tasks someTask -DsomeDestination=dest"
  expected-output-file: load.out
  allow-additional-output: true
}, {
   executable: gradle
   args: "--rerun-tasks someTask -DsomeDestination=another"
   expected-output-file: load-another.out

commands: [{
  executable: gradle
  args: "--rerun-tasks someTask -DsomeDestination=dest"
  expected-output-file: store.out
  allow-additional-output: true
}, {
  executable: gradle
  args: "--rerun-tasks someTask -DsomeDestination=dest"
  expected-output-file: load.out
  allow-additional-output: true
}, {
   executable: gradle
   args: "--rerun-tasks someTask -DsomeDestination=another"
   expected-output-file: store-another.out

plugins {
    java
}

// tag::task-type[]
abstract class SomeTask : DefaultTask() {

    @get:InputFiles @get:Classpath
    abstract val classpath: ConfigurableFileCollection // <1>

    @TaskAction
    fun action() {
        val classpathFiles = classpath.files
        // ...
    }
}
// end::task-type[]

tasks.register<SomeTask>("someTaskType") {
    classpath.from(sourceSets.main.get().compileClasspath)
}

commands: [{
  executable: gradle
  args: "--rerun-tasks someTask -DsomeDestination=dest"
  expect-failure: true
  expected-output-file: fail.out
  allow-additional-output: true
  allow-disordered-output: true
},{
  executable: gradle
  args: "--rerun-tasks --configuration-cache-problems=warn someTask -DsomeDestination=dest"
  expect-failure: false
  expected-output-file: store.out
  allow-additional-output: true
}, {
  executable: gradle

// tag::task-type[]
abstract class SomeTask extends DefaultTask {
    @TaskAction
    void action() {
        project.copy { // <1>
            from 'source'
            into 'destination'
        }
    }
}
// end::task-type[]

tasks.register('someTaskType', SomeTask)

// tag::ad-hoc-task[]
tasks.register('someTask') {
    doLast {
        project.copy { // <1>
            from 'source'
            into 'destination'

            import ${LinkedHashMap.name};

            public class SomePlugin implements Plugin<Project> {
                public void apply(Project project) {
                    project.getTasks().register("someTask", SomeTask.class, t -> {
                        t.getFlag().set(true);
                        t.getMessage().set("some value");
                        t.getNumber().set(1.23);