Add tests for GradleTask.Builder

dependencies.md

@@ -1,6 +1,6 @@
 
 
-# Dependencies of `io.spine.tools:classic-codegen:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:classic-codegen:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -839,14 +839,14 @@
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:gradle-plugin-api:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:gradle-plugin-api:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
@@ -1752,14 +1752,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:gradle-plugin-api-test-fixtures:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:gradle-plugin-api-test-fixtures:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
@@ -2230,14 +2230,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:36 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:28 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:gradle-root-plugin:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:gradle-root-plugin:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -3095,14 +3095,14 @@ This report was generated on **Mon Apr 20 20:36:36 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:intellij-platform:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:intellij-platform:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : be.cyberelf.nanoxml. **Name** : nanoxml. **Version** : 2.2.3.
@@ -4183,14 +4183,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:intellij-platform-java:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:intellij-platform-java:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : be.cyberelf.nanoxml. **Name** : nanoxml. **Version** : 2.2.3.
@@ -5969,14 +5969,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:36 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:30 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:jvm-tool-plugins:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:jvm-tool-plugins:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -6826,14 +6826,14 @@ This report was generated on **Mon Apr 20 20:36:36 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:jvm-tools:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:jvm-tools:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : org.jetbrains. **Name** : annotations. **Version** : 26.0.2.
@@ -7600,14 +7600,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:plugin-base:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:plugin-base:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -8465,14 +8465,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:plugin-testlib:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:plugin-testlib:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.auto.value. **Name** : auto-value-annotations. **Version** : 1.10.2.
@@ -9434,14 +9434,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:protobuf-setup-plugins:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:protobuf-setup-plugins:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -10311,14 +10311,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:psi:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:psi:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : be.cyberelf.nanoxml. **Name** : nanoxml. **Version** : 2.2.3.
@@ -11426,14 +11426,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:psi-java:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:psi-java:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : be.cyberelf.nanoxml. **Name** : nanoxml. **Version** : 2.2.3.
@@ -13255,14 +13255,14 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:30 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
 
 
 
 
-# Dependencies of `io.spine.tools:tool-base:2.0.0-SNAPSHOT.377`
+# Dependencies of `io.spine.tools:tool-base:2.0.0-SNAPSHOT.378`
 
 ## Runtime
 1.  **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
@@ -14149,6 +14149,6 @@ This report was generated on **Mon Apr 20 20:36:35 WEST 2026** using
 
 The dependencies distributed under several licenses, are used according their commercial-use-friendly license.
 
-This report was generated on **Mon Apr 20 20:36:36 WEST 2026** using 
+This report was generated on **Wed Apr 22 17:29:29 WEST 2026** using 
 [Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under 
 [Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).

plugin-base/src/main/java/io/spine/tools/gradle/task/BaseTaskName.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2022, TeamDev. All rights reserved.
+ * Copyright 2026, 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.
@@ -23,6 +23,7 @@
  * (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.tools.gradle.task;
 
 import io.spine.annotation.VisibleForTesting;
@@ -33,7 +34,6 @@
  * @see <a href="https://docs.gradle.org/current/userguide/base_plugin.html#sec:base_tasks">
  *         the plugin doc</a>
  */
-@SuppressWarnings("unused")
 public enum BaseTaskName implements TaskName {
 
     /**
@@ -47,14 +47,14 @@ public enum BaseTaskName implements TaskName {
     assemble,
 
     /**
-     * A lifecycle task which marks the project verification routines, such as static code analysis,
-     * executing tests, etc.
+     * A lifecycle task that marks the project verification routines,
+     * such as static code analysis, executing tests, etc.
      */
     check,
 
     /**
-     * A lifecycle task which builds everything in the project, including running tests, producing
-     * production artifacts, and generating documentation.
+     * A lifecycle task that builds everything in the project, including running tests,
+     * producing production artifacts, and generating documentation.
      */
     build,
 

plugin-base/src/main/java/io/spine/tools/gradle/task/GradleTask.java

@@ -119,20 +119,19 @@ public Project getProject() {
      * {@code build(..)}. This is done to add some additional semantics to
      * such an irreversible action like this.
      */
-    @SuppressWarnings("unused")
     public static final class Builder {
         private final TaskName name;
         private final Action<Task> action;
 
-        private TaskName previousTask;
-        private TaskName previousTaskOfAllProjects;
-        private TaskName followingTask;
+        private @Nullable TaskName previousTask;
+        private @Nullable TaskName previousTaskOfAllProjects;
+        private @Nullable TaskName followingTask;
 
         private boolean allowNoDependencies;
 
         private boolean hasInputFiles = false;
         private final Set<File> inputs = new HashSet<>();
-        private Map<String, @Nullable Object> inputProperties;
+        private @Nullable Map<String, @Nullable Object> inputProperties;
         private boolean hasOutputFiles = false;
         private final Set<File> outputs = new HashSet<>();
 
@@ -193,12 +192,12 @@ public Builder insertAfterTask(TaskName target) {
          * <p>If a certain project does not have a task with the specified name, no action is
          * performed for that project.
          *
-         * <p>This method does not guarantee that the task will be included into a standard
+         * <p>This method does not guarantee that the task will be included in a standard
          * Gradle build.
          *
          * <p>Invocation of this method may substitute the invocation of
          * {@link #insertAfterTask} or {@link #insertBeforeTask} if it's guaranteed that at least
-         * one task with such name exists. Though the fallback is never handled and there is
+         * one task with such a name exists. Though the fallback is never handled, and there is
          * no guarantee that the task will get into the Gradle task graph.
          *
          * @param target
@@ -232,7 +231,7 @@ public Builder allowNoDependencies() {
          * <p>If none of the specified file system elements are present before the task
          * execution, the task will be marked as {@code NO-SOURCE} and skipped.
          *
-         * <p>Multiple invocations appends the new files to the existing ones.
+         * <p>Multiple invocations append the new files to the existing ones.
          *
          * @param inputs
          *         the task input files
@@ -251,8 +250,8 @@ public Builder withInputFiles(FileCollection inputs) {
          * <p>An input property is treated in a similar way as
          * an {@linkplain #withInputFiles input file}.
          *
-         * <p>Multiple invocations of this method append new properties. If there already is
-         * a property with is such a name, the value is overridden.
+         * <p>Multiple invocations of this method append new properties.
+         * If there already is a property with such a name, the value is overridden.
          *
          * @param propertyName
          *         the name of the property
@@ -309,9 +308,8 @@ public GradleTask applyNowTo(Project project) {
             log.debug("Creating task `{}` in the project `{}`.", taskName, projectName);
             TaskProvider<Task> newTask;
             try {
-                newTask = project.getTasks().register(taskName, Task.class, task -> {
-                    task.doLast(action);
-                });
+                newTask = project.getTasks()
+                                 .register(taskName, Task.class, task -> task.doLast(action));
             } catch (@SuppressWarnings("OverlyBroadCatchBlock") Exception e) {
                 log.error("Failed to create task `{}` in the project `{}`.", taskName, projectName);
                 throw new IllegalStateException(e);
@@ -356,6 +354,7 @@ private void dependTask(Task task, Project project) {
         }
 
         private void dependTaskOnAllProjects(Task task, Project rootProject) {
+            checkNotNull(previousTaskOfAllProjects, "Previous task of all projects is not set.");
             var prevTaskName = previousTaskOfAllProjects.name();
             ProjectHierarchy.applyToAll(rootProject, project -> {
                 var existingTask = project.getTasks()
@@ -399,7 +398,7 @@ public int hashCode() {
     }
 
     @Override
-    public boolean equals(Object obj) {
+    public boolean equals(@Nullable Object obj) {
         if (this == obj) {
             return true;
         }

plugin-base/src/main/java/io/spine/tools/gradle/task/TaskName.java

@@ -33,6 +33,11 @@
  */
 public interface TaskName {
 
+    /**
+     * The prefix for a compilation task name.
+     */
+    String COMPILE_PREFIX = "compile";
+
     /**
      * The value of the name.
      *

plugin-base/src/main/kotlin/io/spine/tools/gradle/project/ProjectExts.kt

@@ -35,6 +35,7 @@ import io.spine.tools.code.Language
 import io.spine.tools.code.SourceSetName
 import io.spine.tools.code.SourceSetName.Companion.main
 import io.spine.tools.gradle.ConfigurationName
+import io.spine.tools.gradle.task.TaskName
 import io.spine.tools.meta.MavenArtifact
 import java.lang.reflect.Method
 import org.gradle.api.Project
@@ -164,7 +165,7 @@ public fun Project.hasKotlin(): Boolean = hasCompileTask(Kotlin)
 public fun Project.hasCompileTask(language: Language): Boolean {
     val currentTasks = ImmutableList.copyOf(tasks)
     val compileTask = currentTasks.find {
-        it.name.startsWith("compile") && it.name.endsWith(language.name)
+        it.name.startsWith(TaskName.COMPILE_PREFIX) && it.name.endsWith(language.name)
     }
     return compileTask != null
 }