case ScriptLanguage.KOTLIN:
                return 'tasks.register("ok")'
        }
    }

    enum ScriptLanguage {

        GROOVY(".gradle"),
        KOTLIN(".gradle.kts")

        final String extension

        ScriptLanguage(String extension) {
            this.extension = extension
        }
    }

    static interface Scenario {

[[sec:groovy_usage]]
== Usage

To use the Groovy plugin, include the following in your build script:

.Using the Groovy plugin
====
include::sample[dir="snippets/groovy/quickstart/kotlin",files="build.gradle.kts[tags=use-plugin]"]
include::sample[dir="snippets/groovy/quickstart/groovy",files="build.gradle[tags=use-plugin]"]
====

[[sec:groovy_tasks]]
== Tasks

The Groovy plugin adds the following tasks to the project.

====

*Example 2:* Reading system properties at configuration time:
====
include::sample[dir="snippets/tutorial/systemProperties/kotlin",files="init.gradle.kts[];settings.gradle.kts[];build.gradle.kts[tags=system-properties]"]
include::sample[dir="snippets/tutorial/systemProperties/groovy",files="init.gradle[];settings.gradle[];build.gradle[tags=system-properties]"]
====

.Extending a configuration from another configuration
====
include::sample[dir="snippets/dependencyManagement/definingUsingConfigurations-inheritance/kotlin",files="build.gradle.kts[tags=configuration-definition]"]
include::sample[dir="snippets/dependencyManagement/definingUsingConfigurations-inheritance/groovy",files="build.gradle[tags=configuration-definition]"]
====

[[sec:resolvable-consumable-configs]]

.Applying the JVM Test Suite plugin
====
include::sample[dir="snippets/testing/test-suite-plugin/kotlin",files="build.gradle.kts[tags=apply-jvm-test-suite]"]
include::sample[dir="snippets/testing/test-suite-plugin/groovy",files="build.gradle[tags=apply-jvm-test-suite]"]
====

The plugins adds the following objects to the project:

.Locking a specific configuration
====
include::sample[dir="snippets/dependencyManagement/dependencyLocking-lockingSingleFilePerProject/kotlin",files="build.gradle.kts[tags=locking-single]"]
include::sample[dir="snippets/dependencyManagement/dependencyLocking-lockingSingleFilePerProject/groovy",files="build.gradle[tags=locking-single]"]
====

[[sec:signing_usage]]
== Usage

To use the Signing Plugin, include the following in your build script:

.Using the Signing Plugin
====
include::sample[dir="snippets/signing/maven-publish/kotlin",files="build.gradle.kts[tags=use-plugin]"]
include::sample[dir="snippets/signing/maven-publish/groovy",files="build.gradle[tags=use-plugin]"]
====

[[sec:signatory_credentials]]
== Signatory credentials

include::sample[dir="snippets/providers/property/kotlin",files="build.gradle.kts[tags=prop-managed]"]
include::sample[dir="snippets/providers/property/groovy",files="build.gradle[tags=prop-managed]"]
====

Or _read-only_, meaning that it has only a `get()` method.
The _read-only_ properties are _providers_:

====
include::sample[dir="snippets/providers/property/kotlin",files="build.gradle.kts[tags=prov-managed]"]

image::author-gradle-4.png[Build,500,63,align="left"]

As the build script executes, it configures `Project`.

The build script is either a `\*.gradle` file in Groovy or a `*.gradle.kts` file in Kotlin.

IMPORTANT: _Build scripts_ configure `Project` objects and their children.

== The `Project` object

The `Project` object is part of the link:{javadocPath}/org/gradle/api/Project.html[Gradle API]:

├── build   // <3>
├── gradle
│   └── wrapper // <4>
├── gradle.properties   // <5>
├── gradlew // <6>
├── gradlew.bat // <6>
├── settings.gradle.kts // <7>
├── subproject-one  // <8>
|   └── build.gradle.kts    // <9>
├── subproject-two  // <8>
|   └── build.gradle.kts    // <9>
└── ⋮
----
<1> Project-specific cache directory generated by Gradle.
<2> Version-specific caches (e.g., to support incremental builds).