====

Check the link:{javadocPath}/org/gradle/api/artifacts/VersionCatalog.html[version catalog API] for all supported methods.

[[sec:sharing-catalogs]]
== Sharing catalogs

Version catalogs are used in a single build (possibly multi-project build) but may also be shared between builds.

}

testing {
    suites {
        // tag::version-catalogs-deps[]
        val test by getting(JvmTestSuite::class) {
            dependencies {
                runtimeOnly(libs.guava)
                implementation(libs.commons.lang3)
                implementation.bundle(libs.bundles.groovy)
            }
        }
        // end::version-catalogs-deps[]
    }

        private final Map<String, VersionCatalog> catalogs;

        @Inject
        public DefaultVersionCatalogsExtension(Map<String, VersionCatalog> catalogs) {
            this.catalogs = catalogs;
        }

        @Override
        public Optional<VersionCatalog> find(String name) {
            if (catalogs.containsKey(name)) {
                return Optional.of(catalogs.get(name));
            }

class PrecompiledScriptPluginVersionCatalogIntegrationTest : AbstractKotlinIntegrationTest() {

    @Test
    fun `version catalogs main extension is available`() {
        withKotlinBuildSrc()
        withSimpleVersionCatalog()
        val scriptBody = """
            // Can use outer build version catalog when applied
            println(versionCatalogs.named("libs").findLibrary("groovy").get().get())
        """

repositories {
    mavenCentral()
}

testing {
    suites {
        // tag::version-catalogs-deps[]
        test {
            dependencies {
                runtimeOnly libs.guava
                implementation libs.commons.lang3
                implementation.bundle(libs.bundles.groovy)
            }
        }
        // end::version-catalogs-deps[]
    }

    /**
     * Configures the version catalogs which will be used to generate type safe accessors for dependencies.
     * @param spec the spec to configure the dependencies
     *
     * @since 7.0
     */
    void versionCatalogs(Action<? super MutableVersionCatalogContainer> spec);

    /**
     * Returns the configurable version catalogs.
     *
     * @since 7.0
     */

        Instrumented.fileObserved(dependenciesFile, getClass().getName());
        if (dependenciesFile.exists()) {
            dm.versionCatalogs(catalogs -> {
                VersionCatalogBuilder builder = catalogs.findByName(defaultLibrary);
                if (builder == null) {
                    builder = catalogs.create(defaultLibrary);
                }
                builder.from(services.get(FileCollectionFactory.class).fixed(dependenciesFile));

        executer.expectDocumentedDeprecationWarning(
            "Accessing libraries or bundles from version catalogs in the plugins block. " +
                "This behavior has been deprecated. " +
                "This behavior is scheduled to be removed in Gradle 9.0. " +
                "Only use versions or plugins from catalogs in the plugins block. " +

Typically, this happens if you tried to import a catalog using `from(files("some-catalog.txt"))`.

Currently Gradle only supports TOML version catalogs.

To fix this problem, either import a TOML file, or use the `Settings` API to declare your catalog.

[[catalog_file_does_not_exist]]
== Catalog file doesn't exist

This error indicates that you tried to import a catalog file, but the file doesn't exist.

 */
package org.gradle.api.initialization.resolve;

import org.gradle.api.NamedDomainObjectContainer;
import org.gradle.api.initialization.dsl.VersionCatalogBuilder;

/**
 * The container for declaring version catalogs
 *
 * @since 7.0
 */
public interface MutableVersionCatalogContainer extends NamedDomainObjectContainer<VersionCatalogBuilder> {