internal
enum class TopLevelBlockId {
    buildscript,
    plugins,
    pluginManagement,
    initscript;

    val tokenText: String
        get() = name

    companion object {

        fun topLevelBlockIdFor(target: ProgramTarget) = when (target) {
            ProgramTarget.Project -> arrayOf(buildscript, plugins)
            ProgramTarget.Settings -> arrayOf(buildscript, pluginManagement, plugins)

        id                  | pluginsBlock
        "plugins block"     | """
            plugins {
                id 'com.acme.my.plugin' version '1.0'
            }
        """

        "buildscript block" | """
                buildscript {
                    repositories {
                        maven {
                            url "%repoloc%"
                        }
                    }
                    dependencies {

        buildScript(scalaProjectBuildScript(defaultZincVersion, defaultScalaVersion))

        when:
        run 'compileScala'

        then:
        executedAndNotSkipped ':compileScala'

        when:
        run 'compileScala'

        then:
        skipped ':compileScala'

        when:
        buildScript(scalaProjectBuildScript(newZincVersion, newScalaVersion))

import org.gradle.internal.jvm.Jvm

class JavaToolchainIntegrationTest extends AbstractIntegrationSpec implements JavaToolchainFixture {

    def "fails when using an invalid toolchain spec when #description"() {

        buildScript """
            apply plugin: JvmToolchainsPlugin

            abstract class UnpackLauncher extends DefaultTask {
                @Nested
                abstract Property<JavaLauncher> getLauncher()

    def operations = new BuildOperationsFixture(executer, temporaryFolder)

    def "emits operation for each task action execution"() {
        when:
        buildScript """
            task t {
                doLast {}
                doLast {}
            }
        """
        succeeds "t"

        then:

        }
    }
}
// end::convention-callsites-from-plugin[]

// tag::convention-callsites-from-buildscript[]
apply<GreetingPlugin>()

tasks.withType<GreetingTask>().configureEach {
    // setting convention from build script
    guest.convention("Guest")
}
// end::convention-callsites-from-buildscript[]

abstract class GreetingTask : DefaultTask() {
    // tag::convention-callsites-from-constructor[]

    }

    /**
     * Configures the build script classpath for this project.
     *
     * @see [Project.buildscript]
     */
    @Suppress("unused")
    open fun buildscript(@Suppress("unused_parameter") block: ScriptHandlerScope.() -> Unit) {
        throw IllegalStateException("The `buildscript` block is not supported on Kotlin script plugins, please use the `plugins` block or project level dependencies.")
    }

    /**

        <title>Properties</title>
        <table>
            <thead>
                <tr>
                    <td>Name</td>
                </tr>
            </thead>
            <tr>
                <td>buildscript</td>
            </tr>
            <tr>
                <td>logger</td>
            </tr>
            <tr>
                <td>logging</td>
            </tr>
            <tr>

class ManagedModelPropertyTargetingRuleIntegrationTest extends AbstractIntegrationSpec {

    def "rule can target nested element of managed element as input"() {
        when:
        buildScript '''
            @Managed
            interface Platform {
                OperatingSystem getOperatingSystem()
            }

            @Managed
            interface OperatingSystem {

    }
}
// end::convention-callsites-from-plugin[]

apply plugin: GreetingPlugin

// tag::convention-callsites-from-buildscript[]
tasks.withType(GreetingTask).configureEach {
    // setting convention from build script
    guest.convention("Guest")
}
// end::convention-callsites-from-buildscript[]

abstract class GreetingTask extends DefaultTask {
    // tag::convention-callsites-from-constructor[]