def "shows work in progress with included build"() {
        createDirs("child")
        settingsFile << """
            includeBuild "child"
        """
        buildFile << """
            ${server.callFromBuild('root-build-script')}
            task hello {
                dependsOn gradle.includedBuild("child").task(":hello")
            }
        """
        createDirs("child/a", "child/b")

    def setup() {
        mainProjectDir = file("main-project")
        mainProjectDir.file("settings.gradle").text = """
            rootProject.name = "main-project"
            include("app")
            includeBuild("../included-logging")
        """

        mainProjectDir.file("app/build.gradle").text = """
            plugins {
                id 'application'
            }

            dependencies {

    }

    @ToBeFixedForConfigurationCache(skip = INVESTIGATE)
    def "build path for calculated task graph is exposed"() {
        createDirs("b")
        settingsFile << """
            includeBuild "b"
        """

        file("buildSrc/settings.gradle").createFile()

        buildFile << """
            apply plugin:'java'

            dependencies {

                        doLast { println("NOT CI") }
                    }
                }
            }
        """
        settingsFile << """
            pluginManagement {
                includeBuild 'build-logic'
            }
        """
        buildFile << """
            plugins { id('$fixture.pluginId') }
        """

        when:
        configurationCacheRunLenient fixture.task

                withTransformPlugin(dir("transform-plugin"))
                withJavaLibrarySubproject(dir("subproject"))
            }

            file("settings.gradle") << """
                pluginManagement { includeBuild("transform-plugin") }
                include("subproject")
            """

            file("build.gradle") << """
            plugins { id("${TransformFixture.TRANSFORM_PLUGIN_ID}") }

class ConfigurationCacheDevelocityPluginIntegrationTest extends AbstractConfigurationCacheIntegrationTest {

    def setup() {
        settingsFile '''
            pluginManagement {
                includeBuild("dv-conventions")
            }
            plugins {
                id("dv-conventions")
            }
        '''

        buildFile '''
            plugins { id("java") }
        '''
    }

                    compileJava.doLast {
                        ${server.callFromBuild(buildName)}
                    }
                """
            }
            dependency "org.test:${buildName}:1.0"
            includeBuild build
        }

        server.expectConcurrent(included)

        then:
        execute(buildA, "jar", "--max-workers=4")
    }

        this.publicBuildPath = publicBuildPath;
        this.instantiator = instantiator;
        this.gradle = gradle;
    }

    @Override
    public CompositeBuildParticipantBuildState includeBuild(IncludedBuildSpec includedBuildSpec) {
        RootBuildState rootBuild = buildRegistry.getRootBuild();
        if (includedBuildSpec.rootDir.equals(rootBuild.getBuildRootDir())) {

            dir.file("build$scriptLanguage.extension") << dummyTaskIn(scriptLanguage)
            dir.file("settings$scriptLanguage.extension") << 'includeBuild("included-build")'

            dir.file("included-build", "build$scriptLanguage.extension") << dummyTaskIn(scriptLanguage)

[source,kotlin]
----
include("app")
include("business-logic")
include("data-model")
----

You can also include entire builds using link:{javadocPath}/org/gradle/api/initialization/IncludedBuild.html[`includeBuild`].

== Settings File Scripting

There are many more properties and methods on the `Settings` object that you can use to configure your build.