import org.gradle.internal.declarativedsl.evaluationSchema.buildEvaluationSchema
import org.gradle.internal.declarativedsl.evaluator.conventions.ConventionDefinition
import org.gradle.internal.declarativedsl.evaluator.conventions.ConventionsConfiguringBlock
import org.gradle.internal.declarativedsl.evaluator.conventions.ConventionsTopLevelReceiver
import org.gradle.internal.declarativedsl.software.softwareTypesConventions

// tag::conventions[]
tasks.register("show") {
    def property = objects.property(String)

    // Set a convention
    property.convention("convention 1")

    println("value = " + property.get())

    // Can replace the convention
    property.convention("convention 2")
    println("value = " + property.get())

    property.set("explicit value")

    // Once a value is set, the convention is ignored

// tag::conventions[]
tasks.register("show") {
    val property = objects.property(String::class)

    // Set a convention
    property.convention("convention 1")

    println("value = " + property.get())

    // Can replace the convention
    property.convention("convention 2")
    println("value = " + property.get())

    property.set("explicit value")

    // Once a value is set, the convention is ignored

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

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

    @NotYetImplemented

└── settings.gradle.kts
----
<1> Create the `myproject.java-conventions` convention plugin.
<2> Applies the `myproject.java-conventions` convention plugin.
=====
[.multi-language-sample]
=====
[source, groovy]
----
.
├── buildSrc
│   ├── src
│   │   └──main
│   │      └──groovy
│   │         └──myproject.java-conventions.gradle  // <1>
│   └── build.gradle
├── api
│   ├── src

    fun findConventions(softwareTypeName: String): SoftwareTypeConventionResolutionResults?
}


/**
 * Transformation logic for the kinds of resolution results that appear in conventions.
 * For any of the supported result records, supports replacing the `conventions { ... }` receiver in it with
 * the given [targetBaseReceiver].
 */
private
class ConventionTransformer(
    private val targetBaseReceiver: ObjectOrigin.ReceiverOrigin
) {

    fun conventions(conventions: ConventionsConfiguringBlock.() -> Unit)
}


/**
 * A receiver for the conventions block.  Note that this class is only used to provide a receiver for custom accessors
 * that expose the software types available in the build.
 */

    }
}
// end::closure[]

tasks.register('conventions') {
    def objects = objects
    doLast {
        // tag::conventions[]
        def files = objects.fileCollection().convention("src")
        files.from("src2")
        def dirNames = files*.name
        println("Source dirs: ${dirNames}") // [src, src2]
        // end::conventions[]
    }
}

tasks.register('usage') {

        conventions: TypedProjectSchemaEntryList = emptyList(),
        tasks: TypedProjectSchemaEntryList = emptyList(),
        containerElements: TypedProjectSchemaEntryList = emptyList(),
        configurations: List<String> = emptyList()
    ) = hashCodeFor(
        projectSchemaWith(
            extensions = extensions,
            conventions = conventions,
            tasks = tasks,

import org.gradle.internal.declarativedsl.dom.resolution.resolutionContainer
import org.gradle.internal.declarativedsl.evaluator.conventions.ConventionDocumentTransformation
import org.gradle.internal.declarativedsl.evaluator.conventions.findUsedSoftwareTypeNames
import org.gradle.internal.declarativedsl.evaluator.runner.AnalysisStepResult
import org.gradle.internal.declarativedsl.evaluator.runner.EvaluationResult