plugins {
    id 'org.gradle.toolchains.foojay-resolver' version '0.8.0'
}

import java.util.Optional
import javax.inject.Inject

apply plugin: MadeUpPlugin

// tag::toolchain-management[]
toolchainManagement {
    jvm { // <1>
        javaRepositories {
            repository('foojay') { // <2>
                resolverClass = org.gradle.toolchains.foojay.FoojayToolchainResolver
            }
            repository('made_up') { // <3>

import org.gradle.jvm.toolchain.JavaToolchainResolverRegistry
import java.net.URI
import java.util.Optional
import javax.inject.Inject

apply<MadeUpPlugin>()

// tag::toolchain-management[]
toolchainManagement {
    jvm { // <1>
        javaRepositories {
            repository("foojay") { // <2>
                resolverClass = org.gradle.toolchains.foojay.FoojayToolchainResolver::class.java
            }

     *
     * @since 7.6
     */
    @Incubating
    void toolchainManagement(Action<? super ToolchainManagement> toolchainManagementConfiguration);

    /**
     * Returns the toolchain management configuration.
     *
     * @since 7.6
     */
    @Incubating
    ToolchainManagement getToolchainManagement();

    /**

    def "can inject custom toolchain registry via settings plugin"() {
        settingsKotlinFile << """
            ${applyToolchainRegistryPlugin("CustomToolchainResolver", customToolchainRegistryCode())}
            toolchainManagement {
                jvm {
                    javaRepositories {
                        repository("custom") {
                            resolverClass.set(CustomToolchainResolver::class.java)
                        }

                    ${resolverCode}
                }
            """}

            apply plugin: ${pluginName}

            ${(toolchainManagementCode != null) ? toolchainManagementCode : """
                toolchainManagement {
                    jvm {
                        javaRepositories {
                            repository('custom') {
                                resolverClass = ${resolverClass}
                            }

<3> Resolver plugins must apply the `jvm-toolchain-management` base plugin. This dynamically adds the `jvm` block to `toolchainManagement`, which makes registered toolchain repositories usable from the build....

                "CustormToolchainResolver",
                singleUrlResolverCode("https://good_for_nothing.com/"),
                JavaToolchainDownloadUtil.DEFAULT_PLUGIN,
                """
                    toolchainManagement {
                        jvm {
                            javaRepositories {
                                repository('custom') {
                                    resolverClass = CustomToolchainResolver

        settingsFile <<
            applyToolchainResolverPlugin("CustomToolchainResolver", singleUrlResolverCode(archiveUri), DEFAULT_PLUGIN,
                """
                    toolchainManagement {
                        jvm {
                            javaRepositories {
                                repository('custom') {
                                    resolverClass = CustomToolchainResolver

                    return Optional.empty();
                }
            }

            apply plugin: FakeResolverPlugin

            toolchainManagement {
                jvm {
                    javaRepositories {
                        repository('custom') {
                            resolverClass = FakeResolver
                        }

The following example uses these toolchain resolvers in a build via the `toolchainManagement` block in the settings file:

====
include::sample[dir="snippets/java/toolchain-management/kotlin/",files="settings.gradle.kts[tags=toolchain-management]"]
include::sample[dir="snippets/java/toolchain-management/groovy/",files="settings.gradle[tags=toolchain-management]"]
====
<1> In the `toolchainManagement` block, the `jvm` block contains configuration for Java toolchains.