Merge pull request #45 from SpineEventEngine/bump-kotlin

Bump Protobuf, Kotlin, and other dependencies

Author: alexander-yevsyukov

build.gradle.kts

@@ -29,6 +29,8 @@
 import io.spine.dependency.boms.BomsPlugin
 import io.spine.dependency.build.Dokka
 import io.spine.dependency.build.JSpecify
+import io.spine.dependency.lib.Grpc
+import io.spine.dependency.lib.Kotlin
 import io.spine.dependency.lib.KotlinPoet
 import io.spine.dependency.lib.Protobuf
 import io.spine.dependency.local.Base
@@ -56,13 +58,16 @@ buildscript {
     }
 
     dependencies {
+        // Put the plugin before in the classpath to avoid complaints about the version.
+        classpath(io.spine.dependency.build.Ksp.gradlePlugin)
         classpath(io.spine.dependency.local.McJava.pluginLib)
     }
 
     configurations {
         all {
             resolutionStrategy {
                 force(
+                    io.spine.dependency.lib.Kotlin.bom,
                     io.spine.dependency.build.Dokka.BasePlugin.lib,
                     io.spine.dependency.local.Base.lib,
                 )
@@ -103,14 +108,17 @@ configurations {
 
     all {
         resolutionStrategy {
+            Grpc.forceArtifacts(project, this@all, this@resolutionStrategy)
             force(
+                Kotlin.bom,
                 JSpecify.annotations,
                 KotlinPoet.lib,
                 Dokka.BasePlugin.lib,
                 Protobuf.compiler,
                 Base.lib,
                 Logging.lib,
                 ToolBase.lib,
+                ToolBase.psiJava,
                 ProtoData.api,
                 Validation.runtime,
                 CoreJava.server,

buildSrc/build.gradle.kts

@@ -75,7 +75,7 @@ val grGitVersion = "4.1.1"
  * This version may change from the [version of Kotlin][io.spine.dependency.lib.Kotlin.version]
  * used by the project.
  */
-val kotlinEmbeddedVersion = "2.1.20"
+val kotlinEmbeddedVersion = "2.1.21"
 
 /**
  * The version of Guava used in `buildSrc`.
@@ -103,7 +103,7 @@ val errorPronePluginVersion = "4.2.0"
  * @see <a href="https://github.com/google/protobuf-gradle-plugin/releases">
  *     Protobuf Gradle Plugins Releases</a>
  */
-val protobufPluginVersion = "0.9.4"
+val protobufPluginVersion = "0.9.5"
 
 /**
  * The version of Dokka Gradle Plugins.

buildSrc/src/main/kotlin/BuildExtensions.kt

@@ -73,6 +73,12 @@ fun ScriptHandlerScope.standardSpineSdkRepositories() {
     repositories.standardToSpineSdk()
 }
 
+/**
+ * Shortcut to [Protobuf] dependency object for using under `buildScript`.
+ */
+val ScriptHandlerScope.protobuf: Protobuf
+    get() = Protobuf
+
 /**
  * Shortcut to [McJava] dependency object for using under `buildScript`.
  */

buildSrc/src/main/kotlin/io/spine/dependency/Dependency.kt

@@ -0,0 +1,116 @@
+/*
+ * Copyright 2025, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package io.spine.dependency
+
+import io.spine.gradle.log
+import org.gradle.api.Project
+import org.gradle.api.artifacts.Configuration
+import org.gradle.api.artifacts.ResolutionStrategy
+
+/**
+ * A dependency is a software component we use in a project.
+ *
+ * It could be a library, a set of libraries, or a development tool
+ * that participates in a build.
+ */
+abstract class Dependency {
+
+    /**
+     * The version of the dependency in terms of Maven coordinates.
+     */
+    abstract val version: String
+
+    /**
+     * The group of the dependency in terms of Maven coordinates.
+     */
+    abstract val group: String
+
+    /**
+     * The modules of the dependency that we use directly or
+     * transitively in our projects.
+     */
+    abstract val modules: List<String>
+
+    /**
+     * The [modules] given with the [version].
+     */
+    final val artifacts: Map<String, String> by lazy {
+        modules.associateWith { "$it:$version" }
+    }
+
+    /**
+     * Obtains full Maven coordinates for the requested [module].
+     */
+    fun artifact(module: String): String = artifacts[module] ?: error(
+        "The dependency `${this::class.simpleName}` does not declare a module `$module`."
+    )
+
+    /**
+     * Forces all artifacts of this dependency using the given resolution strategy.
+     *
+     * @param project The project in which the artifacts are forced. Used for logging.
+     * @param cfg The configuration for which the artifacts are forced.  Used for logging.
+     * @param rs The resolution strategy which forces the artifacts.
+     */
+    fun forceArtifacts(project: Project, cfg: Configuration, rs: ResolutionStrategy) {
+        artifacts.values.forEach {
+            rs.forceWithLogging(project, cfg, it)
+        }
+    }
+}
+
+/**
+ * A dependency which declares a Maven Bill of Materials (BOM).
+ *
+ * @see <a href="https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Bill_of_Materials_.28BOM.29_POMs">
+ * Maven Bill of Materials</a>
+ * @see io.spine.dependency.boms.Boms
+ * @see io.spine.dependency.boms.BomsPlugin
+ */
+abstract class DependencyWithBom : Dependency() {
+
+    /**
+     * Maven coordinates of the dependency BOM.
+     */
+    abstract val bom: String
+}
+
+/**
+ * Returns the suffix of diagnostic messages for this configuration in the given project.
+ */
+fun Configuration.diagSuffix(project: Project): String =
+    "the configuration `$name` in the project: `${project.path}`."
+
+
+private fun ResolutionStrategy.forceWithLogging(
+    project: Project,
+    configuration: Configuration,
+    artifact: String
+) {
+    force(artifact)
+    project.log { "Forced the version of `$artifact` in " + configuration.diagSuffix(project) }
+}

buildSrc/src/main/kotlin/io/spine/dependency/boms/Boms.kt

@@ -26,37 +26,41 @@
 
 package io.spine.dependency.boms
 
+import io.spine.dependency.DependencyWithBom
 import io.spine.dependency.kotlinx.Coroutines
 import io.spine.dependency.lib.Jackson
 import io.spine.dependency.lib.Kotlin
+import io.spine.dependency.lib.Grpc
 import io.spine.dependency.test.JUnit
 
 /**
  * The collection of references to BOMs applied by [BomsPlugin].
+ *
+ * @see <a href="https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Bill_of_Materials_.28BOM.29_POMs">
+ * Maven Bill of Materials</a>
  */
 object Boms {
 
     /**
      * The base production BOMs.
      */
-    val core = listOf(
-        Kotlin.bom,
-        Coroutines.bom
+    val core: List<DependencyWithBom> = listOf(
+        Kotlin,
+        Coroutines
     )
 
     /**
      * The BOMs for testing dependencies.
      */
-    val testing = listOf(
-        JUnit.bom
+    val testing: List<DependencyWithBom> = listOf(
+        JUnit
     )
 
     /**
      * Technology-based BOMs.
      */
     object Optional {
-        val jackson = listOf(
-            Jackson.bom
-        )
+        val jackson = Jackson.bom
+        val grpc = Grpc.bom
     }
 }