import org.gradle.api.internal.project.ProjectInternal;

/**
 * Can be implemented by plugins to auto-configure each project.
 *
 * <p>Implementations are discovered using the JAR service locator mechanism (see {@link org.gradle.internal.service.ServiceLocator}).
 * Each action is invoked for each project that is to be configured, before the project has been configured. Actions are executed
 * in an arbitrary order.
 */

/**
 * Configures caches stored in the user home directory.  Note that these values can be read at any time,
 * but can only be configured via an init script, ideally stored in the init.d directory in the user home
 * directory.
 *
 * @since 8.0
 */
@HasInternalProtocol
@Incubating
public interface CacheConfigurations {

    /**

 * limitations under the License.
 */

package org.gradle.normalization;

import org.gradle.api.Action;
import org.gradle.internal.HasInternalProtocol;

/**
 * Used to configure input normalization.
 *
 * Currently, it is only possible to configure runtime classpath normalization.
 *
 * @since 4.0
 */
@HasInternalProtocol
public interface InputNormalizationHandler {
    /**

        stateString { configured() } == "EXECUTED"
        stateString { failed(new ProjectConfigurationException("bang", [])); configured() } == "FAILED (bang)"
    }

    String stateString(@DelegatesTo(ProjectStateInternal) Closure closure) {
        def state = ConfigureUtil.configure(closure, new ProjectStateInternal())

        when:
        container.configure {
            someObj { throw failure }
        }

        then:
        RuntimeException e = thrown()
        e.is(failure)
    }

    def "implicitly creates an object when container is being configured"() {
        when:
        container.configure {
            obj1
            obj2 { prop = 'value' }
        }

    }

    def "configures from -D command line argument"() {
        when:
        def properties = properties("-D$DaemonBuildOptions.IdleTimeoutOption.GRADLE_PROPERTY=125")
        def layout = layout(properties)

        then:
        converter.convert(properties, layout).properties.get(DaemonBuildOptions.IdleTimeoutOption.GRADLE_PROPERTY) == "125"
    }

    def "configures from system property of current JVM"() {

 *
 * @since 7.0
 */
@HasInternalProtocol
public interface CatalogPluginExtension {
    /**
     * Configures the version catalog.
     * @param spec the spec used to configure the dependencies
     */
    void versionCatalog(Action<? super VersionCatalogBuilder> spec);

    /**
     * Configures an explicit alias for a dependency in case of name clash
     */

    /**
     * Configures an object by name, without triggering its creation or configuration, failing if there is no such object.
     *
     * @see [NamedDomainObjectContainer.named]
     * @see [NamedDomainObjectProvider.configure]
     */
    operator fun String.invoke(configuration: T.() -> Unit): NamedDomainObjectProvider<T> =
        named(this).apply { configure(configuration) }

    /**

     *
     * @param type extension type
     * @param action the configure action
     * @throws UnknownDomainObjectException if no extension is found.
     */
    <T> void configure(Class<T> type, Action<? super T> action);

    /**
     * Looks for the extension of the specified type and configures it with the supplied action.
     *

        what             | when                         | withTool | withJavaHome | withExecutable | withJavaExtension | target
        "current JVM"    | "when nothing is configured" | null     | null         | null           | null              | "current"