Merge pull request #240 from SpineEventEngine/migrate-to-reaction-api

Migrate to `Reaction` API

Author: alexander-yevsyukov

buildSrc/src/main/kotlin/build-proto-model.gradle.kts

@@ -1,11 +1,11 @@
 /*
- * Copyright 2022, TeamDev. All rights reserved.
+ * 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
  *
- * http://www.apache.org/licenses/LICENSE-2.0
+ * 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

buildSrc/src/main/kotlin/io/spine/dependency/build/LicenseReport.kt

@@ -29,7 +29,7 @@ package io.spine.dependency.build
 // https://github.com/jk1/Gradle-License-Report
 @Suppress("unused")
 object LicenseReport {
-    private const val version = "1.16"
+    private const val version = "3.0.1"
     const val lib = "com.github.jk1:gradle-license-report:$version"
 
     object GradlePlugin {

buildSrc/src/main/kotlin/io/spine/dependency/local/Compiler.kt

@@ -29,7 +29,7 @@ package io.spine.dependency.local
 /**
  * Dependencies on the Spine Compiler modules.
  *
- * To use a locally published ProtoData version instead of the version from a public plugin
+ * To use a locally published Compiler version instead of the version from a public plugin
  * registry, set the `COMPILER_VERSION` and/or the `COMPILER_DF_VERSION` environment variables
  * and stop the Gradle daemons so that Gradle observes the env change:
  * ```
@@ -67,22 +67,22 @@ object Compiler {
     const val module = "io.spine.tools:compiler"
 
     /**
-     * The version of ProtoData dependencies.
+     * The version of the Compiler dependencies.
      */
     val version: String
-    private const val fallbackVersion = "2.0.0-SNAPSHOT.030"
+    private const val fallbackVersion = "2.0.0-SNAPSHOT.034"
 
     /**
-     * The distinct version of ProtoData used by other build tools.
+     * The distinct version of the Compiler used by other build tools.
      *
-     * When ProtoData is used both for building the project and as a part of the Project's
-     * transitional dependencies, this is the version used to build the project itself.
+     * When the Compiler is used both for building the project and as a part of the Project's
+     * transitive dependencies, this is the version used to build the project itself.
      */
     val dogfoodingVersion: String
     private const val fallbackDfVersion = "2.0.0-SNAPSHOT.030"
 
     /**
-     * The artifact for the ProtoData Gradle plugin.
+     * The artifact for the Compiler Gradle plugin.
      */
     val pluginLib: String
 

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvm.kt

@@ -27,17 +27,18 @@
 package io.spine.dependency.local
 
 // For backward compatibility.
+@Suppress("unused")
 typealias CoreJava = CoreJvm
 
 /**
- * Dependencies on `core-java` modules.
+ * Dependencies on `core-jvm` modules.
  *
- * See [`SpineEventEngine/core-java`](https://github.com/SpineEventEngine/core-java/).
+ * See [`SpineEventEngine/core-jvm`](https://github.com/SpineEventEngine/core-jvm/).
  */
 @Suppress("ConstPropertyName", "unused")
 object CoreJvm {
     const val group = Spine.group
-    const val version = "2.0.0-SNAPSHOT.346"
+    const val version = "2.0.0-SNAPSHOT.356"
 
     const val coreArtifact = "spine-core"
     const val clientArtifact = "spine-client"

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvmCompiler.kt

@@ -46,12 +46,12 @@ object CoreJvmCompiler {
     /**
      * The version used to in the build classpath.
      */
-    const val dogfoodingVersion = "2.0.0-SNAPSHOT.034"
+    const val dogfoodingVersion = "2.0.0-SNAPSHOT.035"
 
     /**
      * The version to be used for integration tests.
      */
-    const val version = "2.0.0-SNAPSHOT.034"
+    const val version = "2.0.0-SNAPSHOT.035"
 
     /**
      * The ID of the Gradle plugin.

buildSrc/src/main/kotlin/io/spine/gradle/git/Repository.kt

@@ -26,8 +26,10 @@
 
 package io.spine.gradle.git
 
+import com.google.common.util.concurrent.Uninterruptibles.sleepUninterruptibly
 import io.spine.gradle.Cli
 import io.spine.gradle.fs.LazyTempPath
+import java.util.concurrent.TimeUnit.MILLISECONDS
 import org.gradle.api.logging.Logger
 
 /**
@@ -133,8 +135,10 @@ class Repository private constructor(
      * Performs a pull with rebase before pushing to ensure the local branch is up-to-date.
      */
     fun push() {
-        repoExecute("git", "pull", "--rebase")
-        repoExecute("git", "push")
+        withRetries(description = "Pushing to $sshUrl, branch = '$currentBranch'") {
+            repoExecute("git", "pull", "--rebase")
+            repoExecute("git", "push")
+        }
     }
 
     override fun close() {
@@ -174,3 +178,43 @@ class Repository private constructor(
         }
     }
 }
+
+/**
+ * Executes a given operation with retries using exponential backoff strategy.
+ *
+ * If the operation fails, it will be retried up to the specified number of times
+ * with increasing delays between attempts.
+ * The delay increases exponentially but is capped at the specified maximum value.
+ *
+ * If all retries fail, the exception from the final attempt will be thrown to the caller.
+ *
+ * @param T the type of value returned by the operation
+ * @param times the maximum number of attempts to execute the operation (default: 3)
+ * @param initialDelay the delay before the first retry in milliseconds (default: 100ms)
+ * @param maxDelay the maximum delay between retries in milliseconds (default: 2000ms)
+ * @param factor the multiplier used to increase delay after each failure (default: 2.0)
+ * @param description a description of the operation for error reporting (default: empty string)
+ * @param block the operation to execute
+ * @return the result of the successful operation execution
+ */
+private fun <T> withRetries(
+    times: Int = 3,
+    initialDelay: Long = 100,      // ms
+    maxDelay: Long = 2000,         // ms
+    factor: Double = 2.0,
+    description: String = "",
+    block: () -> T
+): T {
+    var currentDelay = initialDelay
+    repeat(times - 1) {
+        try {
+            return block()
+        } catch (e: Exception) {
+            System.err.println("'$description' failed. " +
+                    "Message: '${e.message}'. Retrying in $currentDelay ms.")
+        }
+        sleepUninterruptibly(currentDelay, MILLISECONDS)
+        currentDelay = (currentDelay * factor).toLong().coerceAtMost(maxDelay)
+    }
+    return block()
+}

buildSrc/src/main/kotlin/io/spine/gradle/report/license/LicenseReporter.kt

@@ -155,8 +155,14 @@ object LicenseReporter {
             .map {
                 val buildDir = it.layout.buildDirectory.asFile.get()
                 "$buildDir/${Paths.relativePath}/${Paths.outputFilename}"
-            }.filter { File(it).exists() }
-        println("Merging the license reports from the all projects.")
+            }.filter {
+                val exists = File(it).exists()
+                if (!exists) {
+                    rootProject.logger.debug("License report file not found: $it")
+                }
+                exists
+            }
+        println("Merging the license reports from all projects.")
         val mergedContent = paths.joinToString("\n\n\n") { (File(it)).readText() }
         val output = File("${rootProject.rootDir}/${Paths.outputFilename}")
         output.writeText(mergedContent)

buildSrc/src/main/kotlin/module.gradle.kts

@@ -43,6 +43,7 @@ import io.spine.dependency.local.Time
 import io.spine.dependency.local.ToolBase
 import io.spine.dependency.local.Validation
 import io.spine.dependency.test.JUnit
+import io.spine.gradle.github.pages.updateGitHubPages
 import io.spine.gradle.javac.configureErrorProne
 import io.spine.gradle.javac.configureJavac
 import io.spine.gradle.javadoc.JavadocConfig
@@ -86,6 +87,7 @@ project.run {
     configureTaskDependencies()
     dependTestOnJavaRuntime()
     configureProtoc()
+    setupDocPublishing()
 }
 
 /**
@@ -276,3 +278,16 @@ fun Module.configureProtoc() {
         protoc { artifact = Protobuf.compiler }
     }
 }
+
+/**
+ * Configures documentation publishing for this subproject.
+ */
+fun Module.setupDocPublishing() {
+    updateGitHubPages {
+        rootFolder.set(rootDir)
+    }
+
+    tasks.named("publish") {
+        dependsOn("${project.path}:updateGitHubPages")
+    }
+}

buildSrc/src/main/kotlin/test-module.gradle.kts

@@ -26,11 +26,14 @@
 
 import io.spine.dependency.local.Base
 import io.spine.dependency.local.Validation
+import io.spine.gradle.report.license.LicenseReporter
 
 plugins {
     java
     `java-test-fixtures`
+    id("module-testing")
 }
+LicenseReporter.generateReportIn(project)
 
 dependencies {
     arrayOf(