- Understand transitive dependencies
- Adding a version catalog
****

[[part3_begin]]
== Step 0. Before you Begin

1. You initialized your Java app in <<part1_gradle_init.adoc#part1_begin,part 1>>.
2. You ran several tasks in <<part2_gradle_tasks#part2_begin,part 2>>.

== Step 1. Understanding the Version Catalog
A version catalog is used to declare all direct dependencies of a project in a central location.

 * limitations under the License.
 */

package org.gradle.catalog

import static org.gradle.util.internal.TextUtil.normaliseLineSeparators

trait VersionCatalogSupport {
    void expectPlatformContents(File expectedTomlFile = file("build/version-catalog/libs.versions.toml"), String resultFile) {
        assert expectedTomlFile.exists()

import org.gradle.api.internal.artifacts.DependencyResolutionServices;
import org.gradle.api.internal.artifacts.ImmutableVersionConstraint;
import org.gradle.api.internal.catalog.DefaultVersionCatalog;
import org.gradle.api.internal.catalog.DefaultVersionCatalogBuilder;
import org.gradle.api.logging.Logger;
import org.gradle.api.logging.Logging;
import org.gradle.api.model.ObjectFactory;

import javax.inject.Inject;

    // Use the plugin `versions` as declared in the `libs` version catalog
    alias(libs.plugins.versions)
}
// end::use_plugin[]

// tag::simple_dependency_use[]
dependencies {
    implementation(libs.groovy.core)
}
// end::simple_dependency_use[]

// tag::use_version[]
checkstyle {
    // will use the version declared in the catalog
    toolVersion = libs.versions.checkstyle.get()
}
// end::use_version[]

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.gradle.integtests.resolve.catalog

import org.gradle.integtests.resolve.PluginDslSupport
import org.gradle.test.fixtures.file.LeaksFileHandles
import org.gradle.test.fixtures.plugin.PluginBuilder

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.gradle.api.plugins.catalog.internal;

import com.google.common.collect.Interners;
import org.gradle.api.Action;
import org.gradle.api.artifacts.Configuration;
import org.gradle.api.initialization.dsl.VersionCatalogBuilder;

 * limitations under the License.
 */
package org.gradle.api.plugins.catalog.internal;

import org.gradle.api.DefaultTask;
import org.gradle.api.GradleException;
import org.gradle.api.file.RegularFileProperty;
import org.gradle.api.internal.catalog.DefaultVersionCatalog;
import org.gradle.api.provider.Property;
import org.gradle.api.tasks.CacheableTask;

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.gradle.kotlin.dsl.support

import org.gradle.api.internal.catalog.ExternalModuleDependencyFactory
import org.gradle.api.model.ObjectFactory
import org.gradle.initialization.DependenciesAccessors
import org.gradle.kotlin.dsl.*
import org.gradle.plugin.use.PluginDependenciesSpec

     *
     * @since 4.1
     */
    String SWIFT_API = "swift-api";

    /**
     * A version catalog, packaged as TOML files, for use as recommendations
     * for dependency and plugin versions.
     *
     * @since 7.0
     */
    String VERSION_CATALOG = "version-catalog";

        when:
        parser("force()").parseNotation(provider)

        then:
        def ex = thrown(InvalidUserDataException)
        ex.message.contains "Cannot convert a version catalog entry 'pluginId:1.0' to an object of type ModuleVersionSelector. Only dependency accessors are supported but not plugin, bundle or version accessors for 'force()'"
    }

    def "reports unsupported provider convertible type"() {