Initial commit (split from bld-kotlin)

examples/src/bld/java/com/example/ExampleBuild.java

@@ -0,0 +1,116 @@
+package com.example;
+
+import rife.bld.BuildCommand;
+import rife.bld.Project;
+import rife.bld.extension.CompileKotlinOperation;
+import rife.bld.extension.DokkaOperation;
+import rife.bld.extension.dokka.LoggingLevel;
+import rife.bld.extension.dokka.OutputFormat;
+import rife.bld.operations.exceptions.ExitStatusException;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.logging.ConsoleHandler;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+import static rife.bld.dependencies.Repository.*;
+import static rife.bld.dependencies.Scope.compile;
+import static rife.bld.dependencies.Scope.test;
+
+public class ExampleBuild extends Project {
+    public ExampleBuild() {
+        pkg = "com.example";
+        name = "Example";
+        mainClass = "com.example.Example";
+        version = version(0, 1, 0);
+
+        javaRelease = 17;
+
+        downloadSources = true;
+        autoDownloadPurge = true;
+
+        repositories = List.of(MAVEN_LOCAL, MAVEN_CENTRAL, RIFE2_RELEASES);
+
+        final var kotlin = version(2, 0, 0);
+        scope(compile)
+                .include(dependency("org.jetbrains.kotlin", "kotlin-stdlib", kotlin));
+        scope(test)
+                .include(dependency("org.jetbrains.kotlin", "kotlin-test-junit5", kotlin))
+                .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 10, 2)))
+                .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 10, 2)));
+
+        // Include the Kotlin source directory when creating or publishing sources Java Archives
+        jarSourcesOperation().sourceDirectories(new File(srcMainDirectory(), "kotlin"));
+    }
+
+    public static void main(String[] args) {
+        // Enable detailed logging for the Kotlin extension
+//        var level = Level.ALL;
+//        var logger = Logger.getLogger("rife.bld.extension");
+//        var consoleHandler = new ConsoleHandler();
+//
+//        consoleHandler.setLevel(level);
+//        logger.addHandler(consoleHandler);
+//        logger.setLevel(level);
+//        logger.setUseParentHandlers(false);
+
+        new ExampleBuild().start(args);
+    }
+
+    @BuildCommand(summary = "Compiles the Kotlin project")
+    @Override
+    public void compile() throws IOException {
+        new CompileKotlinOperation()
+                .fromProject(this)
+                .execute();
+    }
+
+    @BuildCommand(value = "dokka-gfm", summary = "Generates documentation in GitHub flavored markdown format")
+    public void dokkaGfm() throws ExitStatusException, IOException, InterruptedException {
+        new DokkaOperation()
+                .fromProject(this)
+                .loggingLevel(LoggingLevel.INFO)
+                // Create build/dokka/gfm
+                .outputDir(Path.of(buildDirectory().getAbsolutePath(), "dokka", "gfm").toFile())
+                .outputFormat(OutputFormat.MARKDOWN)
+                .execute();
+    }
+
+    @BuildCommand(value = "dokka-html", summary = "Generates documentation in HTML format")
+    public void dokkaHtml() throws ExitStatusException, IOException, InterruptedException {
+        new DokkaOperation()
+                .fromProject(this)
+                .loggingLevel(LoggingLevel.INFO)
+                // Create build/dokka/html
+                .outputDir(Path.of(buildDirectory().getAbsolutePath(), "dokka", "html").toFile())
+                .outputFormat(OutputFormat.HTML)
+                .execute();
+    }
+
+    @BuildCommand(value = "dokka-jekyll", summary = "Generates documentation in Jekyll flavored markdown format")
+    public void dokkaJekyll() throws ExitStatusException, IOException, InterruptedException {
+        new DokkaOperation()
+                .fromProject(this)
+                .loggingLevel(LoggingLevel.INFO)
+                // Create build/dokka/jekyll
+                .outputDir(Path.of(buildDirectory().getAbsolutePath(), "dokka", "jekkyl").toFile())
+                .outputFormat(OutputFormat.JEKYLL)
+                .execute();
+    }
+
+    @BuildCommand(summary = "Generates Javadoc for the project")
+    @Override
+    public void javadoc() throws ExitStatusException, IOException, InterruptedException {
+        new DokkaOperation()
+                .fromProject(this)
+                .failOnWarning(true)
+                .loggingLevel(LoggingLevel.INFO)
+                // Create build/javadoc
+                .outputDir(new File(buildDirectory(), "javadoc"))
+                .outputFormat(OutputFormat.JAVADOC)
+                .execute();
+    }
+}

examples/src/main/kotlin/com/example/Example.kt

@@ -0,0 +1,28 @@
+package com.example
+
+/**
+ * Example class.
+ */
+class Example {
+    /**
+     * Message property.
+     */
+    val message: String
+        /**
+         * Returns the message property.
+         */
+        get() = "Hello World!"
+
+    /**
+     * Companion object.
+     */
+    companion object {
+        /**
+         * Main function.
+         */
+        @JvmStatic
+        fun main(args: Array<String>) {
+            println(Example().message)
+        }
+    }
+}

examples/src/test/kotlin/com/example/ExampleTest.kt

@@ -0,0 +1,11 @@
+package com.example
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class ExampleTest {
+    @Test
+    fun verifyHello() {
+        assertEquals("Hello World!", Example().message)
+    }
+}