support project group and version in testKit DSL

fixup some javadocs

Author: John Burns

src/main/java/nebula/test/dsl/BuildTaskAssert.java

@@ -33,6 +33,7 @@ public static BuildTaskAssert assertThat(BuildTask actual) {
 
     /**
      * Assert that the task was run and resulted in the expected outcome
+     * @param outcome the expected outcome
      */
     @Contract("_ -> this")
     public BuildTaskAssert hasOutcome(TaskOutcome outcome) {
@@ -46,6 +47,7 @@ public BuildTaskAssert hasOutcome(TaskOutcome outcome) {
 
     /**
      * Assert that the task was run and resulted in any of the expected outcomes
+     * @param outcomes the expected possible outcomes
      */
     @Contract("_ -> this")
     public BuildTaskAssert hasOutcome(TaskOutcome... outcomes) {

src/main/java/nebula/test/dsl/PluginManagementBuilder.java

@@ -9,13 +9,15 @@ public class PluginManagementBuilder {
 
     /**
      * Apply settings plugins
+     * @return plugins DSL builder
      */
     public PluginsBuilder plugins() {
         return plugins;
     }
 
     /**
      * Configure project plugin management
+     * @return repositories DSL builder
      */
     public RepositoriesBuilder repositories() {
         return repositoriesBuilder;

src/main/java/nebula/test/dsl/ProjectBuilder.java

@@ -23,6 +23,10 @@ public class ProjectBuilder {
     private Integer javaToolchain = null;
     @Nullable
     private String rawBuildScript;
+    @Nullable
+    private String group = null;
+    @Nullable
+    private String version = null;
 
     ProjectBuilder(File projectDir) {
         this.projectDir = projectDir;
@@ -58,9 +62,33 @@ public SourcesBuilder src() {
         return sources;
     }
 
+    /**
+     * Set project group
+     * @param group group name to set on project
+     */
+    @NebulaTestKitDsl
+    public void group(String group) {
+        this.group = group;
+    }
+
+    /**
+     * Set project version, which is equivalent to passing -Pversion on the command line
+     * @param version group name to set on project
+     */
+    @NebulaTestKitDsl
+    public void version(String version) {
+        this.version = version;
+    }
+
     void build(BuildscriptLanguage language) {
         StringBuilder buildFileText = new StringBuilder();
         buildFileText.append(plugins.build(language, 0));
+        if (group != null) {
+            buildFileText.append("group = \"").append(group).append("\"\n");
+        }
+        if (version != null) {
+            buildFileText.append("version = \"").append(version).append("\"\n");
+        }
         buildFileText.append(repositoriesBuilder.build(language, 0));
         if (!dependencies.isEmpty()) {
             buildFileText.append("dependencies {\n");

src/main/java/nebula/test/dsl/SettingsBuilder.java

@@ -24,6 +24,7 @@ public class SettingsBuilder {
         this.projectDir = projectDir;
     }
 
+    @NebulaTestKitDsl
     public void name(String name) {
         this.name = name;
     }

src/test/groovy/nebula/test/dsl/GroovyDslSpockTest.groovy

@@ -43,7 +43,7 @@ public class Main {
         }
 
         when:
-        final var result = runner.run(["build"]) {
+        final var result = runner.run(["build", "--stacktrace"]) {
             withGradleVersion(gradle.version)
             forwardOutput()
         }

src/test/java/nebula/test/SupportedGradleVersion.java

@@ -1,7 +1,7 @@
 package nebula.test;
 
 public enum SupportedGradleVersion {
-    MIN("8.11.1"), MAX("9.1.0");
+    MIN("8.12.1"), MAX("9.1.0");
     public final String version;
     SupportedGradleVersion(String version) {
         this.version = version;

src/test/java/nebula/test/dsl/ProjectBuilderTest.java

@@ -62,4 +62,30 @@ class Test {
 
         assertThat(testProjectDir.toPath().resolve("src/integTest/java/netflix/Test.java")).exists();
     }
+
+    @Test
+    public void testGroup(@TempDir File testProjectDir) {
+        final var instance = new ProjectBuilder(testProjectDir);
+        instance.group("sample.group");
+        instance.build(BuildscriptLanguage.KOTLIN);
+        assertThat(testProjectDir.toPath().resolve("build.gradle.kts"))
+                .exists()
+                .content()
+                .contains("""
+                        group = "sample.group"
+                        """);
+    }
+
+    @Test
+    public void testVersion(@TempDir File testProjectDir) {
+        final var instance = new ProjectBuilder(testProjectDir);
+        instance.version("1.0.0");
+        instance.build(BuildscriptLanguage.KOTLIN);
+        assertThat(testProjectDir.toPath().resolve("build.gradle.kts"))
+                .exists()
+                .content()
+                .contains("""
+                        version = "1.0.0"
+                        """);
+    }
 }

src/test/kotlin/nebula/test/dsl/KotlinDslTest.kt

@@ -65,6 +65,7 @@ public class Main {
 
                     }
                 }
+                name("library")
             }
             rootProject {
                 plugins {
@@ -73,6 +74,8 @@ public class Main {
                 repositories {
                     mavenCentral()
                 }
+                group("com.example")
+                version("1.0.0")
                 dependencies("""implementation("org.jspecify:jspecify:1.0.0")""")
                 src {
                     main {
@@ -100,6 +103,7 @@ public class Main {
             .hasNoMutableStateWarnings()
         assertThat(result).task(":compileJava").hasOutcome(TaskOutcome.SUCCESS)
         assertThat(result).task(":build").hasOutcome(TaskOutcome.SUCCESS)
+        assertThat(testProjectDir.resolve("build/libs/library-1.0.0.jar")).exists()
     }