Added option to specify the Kotlin compiler (kotlinc) path directly

README.md

@@ -8,7 +8,8 @@
 [![Snapshot](https://flat.badgen.net/maven/v/metadata-url/repo.rife2.com/snapshots/com/uwyn/rife2/bld-kotlin/maven-metadata.xml?label=snapshot)](https://repo.rife2.com/#/snapshots/com/uwyn/rife2/bld-kotlin)
 [![GitHub CI](https://github.com/rife2/bld-kotlin/actions/workflows/bld.yml/badge.svg)](https://github.com/rife2/bld-kotlin/actions/workflows/bld.yml)
 
-To install, please refer to the [extensions](https://github.com/rife2/bld/wiki/Extensions) and [support](https://github.com/rife2/bld/wiki/Kotlin-Support)
+To install, please refer to the [extensions](https://github.com/rife2/bld/wiki/Extensions)
+and [support](https://github.com/rife2/bld/wiki/Kotlin-Support)
 documentation.
 
 ## Compile Kotlin Source Code
@@ -16,6 +17,7 @@ documentation.
 To compile the source code located in `src/main/kotlin` and `src/test/kotlin` from the current project:
 
 ```java
+
 @BuildCommand(summary = "Compiles the Kotlin project")
 public void compile() throws Exception {
     new CompileKotlinOperation()
@@ -30,16 +32,18 @@ public void compile() throws Exception {
 
 - [View Examples Project](https://github.com/rife2/bld-kotlin/tree/main/examples/)
 
-Please check the [Compile Operation documentation](https://rife2.github.io/bld-kotlin/rife/bld/extension/CompileKotlinOperation.html#method-summary)
+Please check
+the [Compile Operation documentation](https://rife2.github.io/bld-kotlin/rife/bld/extension/CompileKotlinOperation.html#method-summary)
 for all available configuration options.
 
 ## Kotlin Compiler Requirement
 
-Please make sure Kotlin is installed and that the `KOTLIN_HOME` environment variable is set.
+Please make sure the Kotlin compiler is [installed](https://kotlinlang.org/docs/command-line.html#install-the-compiler).
 
 You can also manually configure the Kotlin home location as follows:
 
 ```java
+
 @BuildCommand(summary = "Compiles the Kotlin project")
 public void compile() throws Exception {
     new CompileKotlinOperation()
@@ -49,8 +53,23 @@ public void compile() throws Exception {
 }
 ```
 
-While older version of Kotlin are likely working with the extension, only version 1.9.24 or higher are officially supported.
+The Kotlin compiler executable can also be specified directly:
+
+```java
+
+@BuildCommand(summary = "Compiles the Kotlin project")
+public void compile() throws Exception {
+    new CompileKotlinOperation()
+            .fromProject(this)
+            .kotlinc("/usr/bin/kotlinc")
+            .execute();
+}
+```
+
+While older version of Kotlin are likely working with the extension, only version 1.9.24 or higher are officially
+supported.
 
 ## Template Project
 
-There is also a [Template Project](https://github.com/rife2/kotlin-bld-example) with support for the [Dokka](https://github.com/rife2/bld-dokka) and [Detekt](https://github.com/rife2/bld-detekt) extensions.
+There is also a [Template Project](https://github.com/rife2/kotlin-bld-example) with support for
+the [Dokka](https://github.com/rife2/bld-dokka) and [Detekt](https://github.com/rife2/bld-detekt) extensions.

examples/README.md

@@ -18,5 +18,4 @@
 
 ## Requirements
 
-- Kotlin installed
+- A Kotlin compiler must be [installed](https://kotlinlang.org/docs/command-line.html#install-the-compiler).
-- `KOTLIN_HOME` environment variable set

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

@@ -5,7 +5,6 @@ import rife.bld.Project;
 import rife.bld.extension.CompileKotlinOperation;
 
 import java.io.File;
-import java.io.IOException;
 import java.util.List;
 import java.util.logging.ConsoleHandler;
 import java.util.logging.Level;
@@ -61,6 +60,8 @@ public class ExampleBuild extends Project {
         // The source code located in src/main/kotlin and src/test/kotlin will be compiled
         new CompileKotlinOperation()
                 .fromProject(this)
+//                .kotlinHome("path/to/kotlin")
+//                .kotlinc("path/to/kotlinc")
                 .execute();
 
 //        var op = new CompileKotlinOperation().fromProject(this);

src/main/java/rife/bld/extension/CompileKotlinOperation.java

@@ -52,6 +52,7 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
     private File buildTestDirectory_;
     private CompileOptions compileOptions_ = new CompileOptions();
     private File kotlinHome_;
+    private File kotlinc_;
     private BaseProject project_;
     private File workDir_;
 
@@ -205,13 +206,6 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
             throw new ExitStatusException(ExitStatusException.EXIT_FAILURE);
         }
 
-        if (kotlinHome_ == null) {
-            if (LOGGER.isLoggable(Level.SEVERE) && !silent()) {
-                LOGGER.severe("The KOTLIN_HOME environment variable is not set.");
-            }
-            throw new ExitStatusException(ExitStatusException.EXIT_FAILURE);
-        }
-
         executeCreateBuildDirectories();
         executeBuildMainSources();
         executeBuildTestSources();
@@ -227,7 +221,7 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      * @throws ExitStatusException if an error occurs
      */
     @SuppressWarnings("PMD.SystemPrintln")
-    protected void executeBuildMainSources() throws ExitStatusException, IOException, InterruptedException {
+    protected void executeBuildMainSources() throws ExitStatusException {
         if (!silent()) {
             System.out.println("Compiling Kotlin main sources.");
         }
@@ -248,20 +242,18 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      * @param friendPaths the output directory for friendly modules
      * @throws ExitStatusException if an error occurs
      */
+    @SuppressWarnings("PMD.PreserveStackTrace")
     protected void executeBuildSources(Collection<String> classpath, Collection<File> sources, File destination,
                                        File friendPaths)
-            throws ExitStatusException, InterruptedException, IOException {
+            throws ExitStatusException {
         if (sources.isEmpty() || destination == null) {
             return;
         }
 
-        var kotlinc = Path.of(kotlinHome_.getAbsolutePath(), "bin", "kotlinc").toFile();
-
-        if (kotlinc.exists() && kotlinc.canExecute()) {
         var args = new ArrayList<String>();
 
         // kotlinc
-            args.add(kotlinc.getAbsolutePath());
+        args.add(kotlinCompiler());
 
         // classpath
         args.add("-cp");
@@ -298,12 +290,13 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         pb.command(args);
         pb.directory(workDir_);
 
+        try {
             var proc = pb.start();
             proc.waitFor();
             ExitStatusException.throwOnFailure(proc.exitValue());
-        } else {
+        } catch (IOException | InterruptedException e) {
             if (LOGGER.isLoggable(Level.SEVERE) && !silent()) {
-                LOGGER.severe("The Kotlin compiler could not be found or executed: " + kotlinc.getAbsolutePath());
+                LOGGER.severe(e.getLocalizedMessage());
             }
             throw new ExitStatusException(ExitStatusException.EXIT_FAILURE);
         }
@@ -315,7 +308,7 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      * @throws ExitStatusException if an error occurs
      */
     @SuppressWarnings("PMD.SystemPrintln")
-    protected void executeBuildTestSources() throws ExitStatusException, IOException, InterruptedException {
+    protected void executeBuildTestSources() throws ExitStatusException {
         if (!silent()) {
             System.out.println("Compiling Kotlin test sources.");
         }
@@ -386,6 +379,18 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         return op;
     }
 
+    private String kotlinCompiler() {
+        if (kotlinc_ != null) {
+            return kotlinc_.getAbsolutePath();
+        } else if (kotlinHome_ != null) {
+            var kotlinc = Path.of(kotlinHome_.getAbsolutePath(), "bin", "kotlinc").toFile();
+            if (kotlinc.exists() && kotlinc.canExecute()) {
+                return kotlinc.getAbsolutePath();
+            }
+        }
+        return "kotlinc";
+    }
+
     /**
      * Provides the Kotlin home directory, if it differs from the default {@code KOTLIN_HOME}.
      *
@@ -416,6 +421,36 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         return kotlinHome_;
     }
 
+    /**
+     * Retrieves the path to the Kotlin compiler ({@code kotlinc}) executable, if not in {@link #kotlinHome()}.
+     *
+     * @return the executable path
+     */
+    public File kotlinc() {
+        return kotlinc_;
+    }
+
+    /**
+     * Provides the path to the Kotlin compiler ({@code kotlinc}) executable, if not in {@link #kotlinHome()}.
+     *
+     * @param executable the executable path
+     * @return this operation instance
+     */
+    public CompileKotlinOperation kotlinc(File executable) {
+        kotlinc_ = executable;
+        return this;
+    }
+
+    /**
+     * Provides the path to the Kotlin compiler ({@code kotlinc}) executable, if not in {@link #kotlinHome()}.
+     *
+     * @param executable the executable path
+     * @return this operation instance
+     */
+    public CompileKotlinOperation kotlinc(String executable) {
+        return kotlinc(new File(executable));
+    }
+
     /**
      * Provides main source directories that should be compiled.
      *
@@ -546,9 +581,7 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
     }
 
     /**
-     * Provides compiler plugins.
+     * Provides compiler plugins located in the {@link #kotlinHome()} lib directory.
-     * <p>
-     * The {@link #kotlinHome()} should be set first.
      *
      * @param plugins one or more plugins
      * @return this class instance

src/test/java/rife/bld/extension/CompileKotlinOperationTest.java

@@ -54,6 +54,7 @@ class CompileKotlinOperationTest {
         var op = new CompileKotlinOperation()
                 .fromProject(new Project())
                 .kotlinHome("/kotlin_home")
+                .kotlinc("kotlinc")
                 .workDir("work_dir")
                 .compileMainClasspath("path1", "path2")
                 .compileOptions(new CompileOptions().jdkRelease("17").verbose(true))
@@ -75,6 +76,7 @@ class CompileKotlinOperationTest {
                         CompilerPlugin.ALL_OPEN, CompilerPlugin.SAM_WITH_RECEIVER);
 
         assertThat(op.kotlinHome().getName()).as("kotlin_home").isEqualTo("kotlin_home");
+        assertThat(op.kotlinc().getName()).as("kotlinc").isEqualTo("kotlinc");
         assertThat(op.workDir().getName()).as("work_dir").isEqualTo("work_dir");
 
         assertThat(op.compileMainClasspath()).as("compileMainClassPath")