Package rife.bld.extension

Class CompileKotlinOperation

java.lang.Object

rife.bld.operations.AbstractOperation<CompileKotlinOperation>

rife.bld.extension.CompileKotlinOperation

public class CompileKotlinOperation
extends AbstractOperation<CompileKotlinOperation>

Compiles main and test Kotlin sources in the relevant build directories.

Since:

1.0

Author:

Erik C. Thauvin

Constructor Summary

Constructors

Constructor	Description
CompileKotlinOperation()

Method Summary

Modifier and Type	Method	Description
File	buildMainDirectory()	Retrieves the main build destination directory.
CompileKotlinOperation	buildMainDirectory(File directory)	Provides the main build destination directory.
CompileKotlinOperation	buildMainDirectory(String directory)	Provides the main build destination directory.
CompileKotlinOperation	buildMainDirectory(Path directory)	Provides the main build destination directory.
File	buildTestDirectory()	Retrieves the test build destination directory.
CompileKotlinOperation	buildTestDirectory(File directory)	Provides the test build destination directory.
CompileKotlinOperation	buildTestDirectory(String directory)	Provides the test build destination directory.
CompileKotlinOperation	buildTestDirectory(Path directory)	Provides the test build destination directory.
Set<String>	compileMainClasspath()	Retrieves the entries for the main compilation classpath.
CompileKotlinOperation	compileMainClasspath(String... classpath)	Provides entries for the main compilation classpath.
final CompileKotlinOperation	compileMainClasspath(Collection<String> classpath)	Provides the entries for the main compilation classpath.
CompileOptions	compileOptions()	Retrieves the compilation options for the compiler.
CompileKotlinOperation	compileOptions(CompileOptions options)	Provides the compilation options to pass to the Kotlin compiler.
Set<String>	compileTestClasspath()	Retrieves the entries for the test compilation classpath.
CompileKotlinOperation	compileTestClasspath(String... classpath)	Provides entries for the test compilation classpath.
final CompileKotlinOperation	compileTestClasspath(Collection<String> classpath)	Provides the entries for the test compilation classpath.
void	execute()	Performs the compile operation.
protected void	executeBuildMainSources()	Part of the execute operation, builds the main sources.
protected void	executeBuildSources(Collection<String> classpath, Collection<File> sources, File destination, File friendPaths)	Part of the execute operation, build sources to a given destination.
protected void	executeBuildTestSources()	Part of the execute operation, builds the test sources.
protected void	executeCreateBuildDirectories()	Part of the execute operation, creates the build directories.
static String	findKotlincPath()	Locates the Kotlin compiler (kotlinc) executable.
protected static String	findKotlincPath(boolean isSilent)	Locates the Kotlin compiler (kotlinc) executable.
CompileKotlinOperation	fromProject(BaseProject project)	Configures a compile operation from a BaseProject.
JvmOptions	jvmOptions()	Retrieves the Java Virtual Machine options.
CompileKotlinOperation	jvmOptions(JvmOptions options)	Provides the Java Virtual Machine options.
File	kotlinc()	Retrieves the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().
CompileKotlinOperation	kotlinc(File executable)	Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().
CompileKotlinOperation	kotlinc(String executable)	Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().
CompileKotlinOperation	kotlinc(Path executable)	Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().
File	kotlinHome()	Retrieves the Kotlin home directory.
CompileKotlinOperation	kotlinHome(File dir)	Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.
CompileKotlinOperation	kotlinHome(String dir)	Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.
CompileKotlinOperation	kotlinHome(Path dir)	Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.
List<File>	mainSourceDirectories()	Retrieves the main source directories that should be compiled.
CompileKotlinOperation	mainSourceDirectories(File... directories)	Provides main source directories that should be compiled.
CompileKotlinOperation	mainSourceDirectories(String... directories)	Provides main source directories that should be compiled.
CompileKotlinOperation	mainSourceDirectories(Path... directories)	Provides main source directories that should be compiled.
final CompileKotlinOperation	mainSourceDirectories(Collection<File> directories)	Provides the main source directories that should be compiled.
final CompileKotlinOperation	mainSourceDirectoriesPaths(Collection<Path> directories)	Provides the main source directories that should be compiled.
final CompileKotlinOperation	mainSourceDirectoriesStrings(Collection<String> directories)	Provides the main source directories that should be compiled.
List<File>	mainSourceFiles()	Retrieves the main files that should be compiled.
CompileKotlinOperation	mainSourceFiles(File... files)	Provides main source files that should be compiled.
CompileKotlinOperation	mainSourceFiles(String... files)	Provides main source files that should be compiled.
CompileKotlinOperation	mainSourceFiles(Path... files)	Provides main source files that should be compiled.
CompileKotlinOperation	mainSourceFiles(Collection<File> files)	Provides the main source files that should be compiled.
final CompileKotlinOperation	mainSourceFilesPaths(Collection<Path> files)	Provides the main source files that should be compiled.
final CompileKotlinOperation	mainSourceFilesStrings(Collection<String> files)	Provides the main source files that should be compiled.
Set<String>	plugins()	Retrieves the compiler plugins.
CompileKotlinOperation	plugins(File directory, CompilerPlugin... plugins)	Provides compiler plugins.
CompileKotlinOperation	plugins(String... plugins)	Provides compiler plugins.
CompileKotlinOperation	plugins(String directory, CompilerPlugin... plugins)	Provides compiler plugins.
CompileKotlinOperation	plugins(Path directory, CompilerPlugin... plugins)	Provides compiler plugins.
final CompileKotlinOperation	plugins(Collection<String> plugins)	Provides compiler plugins.
CompileKotlinOperation	plugins(CompilerPlugin... plugins)	Provides compiler plugins located in the kotlinHome() lib directory.
List<File>	testSourceDirectories()	Retrieves the test source directories that should be compiled.
CompileKotlinOperation	testSourceDirectories(File... directories)	Provides test source directories that should be compiled.
CompileKotlinOperation	testSourceDirectories(String... directories)	Provides test source directories that should be compiled.
CompileKotlinOperation	testSourceDirectories(Path... directories)	Provides test source directories that should be compiled.
final CompileKotlinOperation	testSourceDirectories(Collection<File> directories)	Provides the test source directories that should be compiled.
final CompileKotlinOperation	testSourceDirectoriesPaths(Collection<Path> directories)	Provides the test source directories that should be compiled.
final CompileKotlinOperation	testSourceDirectoriesStrings(Collection<String> directories)	Provides the test source directories that should be compiled.
List<File>	testSourceFiles()	Retrieves the test files that should be compiled.
CompileKotlinOperation	testSourceFiles(File... files)	Provides test source files that should be compiled.
CompileKotlinOperation	testSourceFiles(String... files)	Provides the test sources files that should be compiled.
CompileKotlinOperation	testSourceFiles(Path... files)	Provides the test sources files that should be compiled.
final CompileKotlinOperation	testSourceFiles(Collection<File> files)	Provides the test source files that should be compiled.
final CompileKotlinOperation	testSourceFilesPaths(Collection<Path> files)	Provides the test source files that should be compiled.
final CompileKotlinOperation	testSourceFilesStrings(Collection<String> files)	Provides the test source files that should be compiled.
File	workDir()	Retrieves the working directory.
CompileKotlinOperation	workDir(File dir)	Provides the working directory if it differs from the project's directory.
CompileKotlinOperation	workDir(String dir)	Provides the working directory if it differs from the project's directory.
CompileKotlinOperation	workDir(Path dir)	Provides the working directory if it differs from the project's directory.

Methods inherited from class rife.bld.operations.AbstractOperation

executeOnce, executeOnce, silent, silent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CompileKotlinOperation

public CompileKotlinOperation()

Method Details

execute

public void execute()
             throws Exception

Performs the compile operation.

Specified by:

execute in class AbstractOperation<CompileKotlinOperation>

Throws:

NullPointerException - if project or workDir is null

Exception - when an exception occurs during the execution

findKotlincPath

public static String findKotlincPath()

Locates the Kotlin compiler (kotlinc) executable.

Returns:

The path to the kotlinc executable, or kotlinc/kotlinc.bat if not found.

Since:

1.1.0

findKotlincPath

protected static String findKotlincPath(boolean isSilent)

Locates the Kotlin compiler (kotlinc) executable.

Parameters:

isSilent - do not log the path to the kotlinc executable, if true

Returns:

The path to the kotlinc executable, or kotlinc/kotlinc.bat if not found.

Since:

1.1.0

buildMainDirectory

public CompileKotlinOperation buildMainDirectory(@NonNull
 Path directory)

Provides the main build destination directory.

Parameters:

directory - the directory to use for the main build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

buildMainDirectory

public CompileKotlinOperation buildMainDirectory(@NonNull
 File directory)

Provides the main build destination directory.

Parameters:

directory - the directory to use for the main build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

buildMainDirectory

public CompileKotlinOperation buildMainDirectory(@NonNull
 String directory)

Provides the main build destination directory.

Parameters:

directory - the directory to use for the main build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

IllegalArgumentException - if directory is empty

buildMainDirectory

public File buildMainDirectory()

Retrieves the main build destination directory.

Returns:

the main build directory

buildTestDirectory

public CompileKotlinOperation buildTestDirectory(@NonNull
 File directory)

Provides the test build destination directory.

Parameters:

directory - the directory to use for the test build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

buildTestDirectory

public CompileKotlinOperation buildTestDirectory(@NonNull
 Path directory)

Provides the test build destination directory.

Parameters:

directory - the directory to use for the test build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

buildTestDirectory

public CompileKotlinOperation buildTestDirectory(@NonNull
 String directory)

Provides the test build destination directory.

Parameters:

directory - the directory to use for the test build destination

Returns:

this operation instance

Throws:

NullPointerException - if directory is null

IllegalArgumentException - if directory is empty

buildTestDirectory

public File buildTestDirectory()

Retrieves the test build destination directory.

Returns:

the test build directory

compileMainClasspath

public CompileKotlinOperation compileMainClasspath(@NonNull
 String... classpath)

Provides entries for the main compilation classpath.

Parameters:

classpath - one or more classpath entries

Returns:

this operation instance

Throws:

NullPointerException - if classpath is null

IllegalArgumentException - if classpath is empty, or contains null or empty elements

See Also:

• compileMainClasspath(Collection)

compileMainClasspath

public final CompileKotlinOperation compileMainClasspath(@NonNull
 Collection<String> classpath)

Provides the entries for the main compilation classpath.

Parameters:

classpath - the classpath entries

Returns:

this operation instance

Throws:

NullPointerException - if classpath is null

IllegalArgumentException - if classpath is empty, or contains null or empty elements

compileMainClasspath

public Set<String> compileMainClasspath()

Retrieves the entries for the main compilation classpath.

Returns:

the classpath entries

compileOptions

public CompileOptions compileOptions()

Retrieves the compilation options for the compiler.

Returns:

the compilation options

compileOptions

public CompileKotlinOperation compileOptions(@NonNull
 CompileOptions options)

Provides the compilation options to pass to the Kotlin compiler.

Parameters:

options - the compiler options

Returns:

this operation instance

Throws:

NullPointerException - if options is null

compileTestClasspath

public CompileKotlinOperation compileTestClasspath(@NonNull
 String... classpath)

Provides entries for the test compilation classpath.

Parameters:

classpath - one or more classpath entries

Returns:

this operation instance

Throws:

NullPointerException - if classpath is null

IllegalArgumentException - if classpath is empty, or contains null or empty elements

compileTestClasspath

public final CompileKotlinOperation compileTestClasspath(@NonNull
 Collection<String> classpath)

Provides the entries for the test compilation classpath.

Parameters:

classpath - the classpath entries

Returns:

this operation instance

Throws:

NullPointerException - if classpath is null

IllegalArgumentException - if classpath is empty, or contains null or empty elements

compileTestClasspath

public Set<String> compileTestClasspath()

Retrieves the entries for the test compilation classpath.

Returns:

the classpath entries

fromProject

public CompileKotlinOperation fromProject(@NonNull
 BaseProject project)

Configures a compile operation from a BaseProject.

Sets the following from the project:

• workDir to the project's directory, if not already set.
• buildMainDirectory, if not already set.
• buildTestDirectory, if not already set.
• compileMainClasspath, if not already set.
• compilesTestClasspath, if not already set.
• mainSourceDirectories to the kotlin directory in srcMainDirectory, if present and not already set.
• testSourceDirectories to the kotlin directory in srcTestDirectory, if present and not already set.
• jdkRelease to javaRelease, if not already set.
• jvmTarget to javaRelease, if not already set.
• noStdLib to true

Parameters:

project - the project to configure the compile operation from

Returns:

this operation instance

Throws:

NullPointerException - if project is null

jvmOptions

public JvmOptions jvmOptions()

Retrieves the Java Virtual Machine options.

Returns:

the JVM options

jvmOptions

public CompileKotlinOperation jvmOptions(@NonNull
 JvmOptions options)

Provides the Java Virtual Machine options.

Parameters:

options - the JVM options

Returns:

this operation instance

Throws:

NullPointerException - if options is null

Since:

1.2

kotlinHome

public CompileKotlinOperation kotlinHome(@NonNull
 String dir)

Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.

Parameters:

dir - the directory path

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

IllegalArgumentException - if dir is empty

kotlinHome

public CompileKotlinOperation kotlinHome(@NonNull
 File dir)

Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.

Parameters:

dir - the directory

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

kotlinHome

public CompileKotlinOperation kotlinHome(@NonNull
 Path dir)

Provides the Kotlin home directory, if it differs from the default KOTLIN_HOME.

Parameters:

dir - the directory path

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

kotlinHome

public File kotlinHome()

Retrieves the Kotlin home directory.

Returns:

the directory

kotlinc

public CompileKotlinOperation kotlinc(@NonNull
 String executable)

Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().

Parameters:

executable - the executable path

Returns:

this operation instance

Throws:

NullPointerException - if executable is null

IllegalArgumentException - if executable is empty

kotlinc

public File kotlinc()

Retrieves the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().

Returns:

the executable path

kotlinc

public CompileKotlinOperation kotlinc(@NonNull
 File executable)

Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().

Parameters:

executable - the executable path

Returns:

this operation instance

Throws:

NullPointerException - if executable is null

kotlinc

public CompileKotlinOperation kotlinc(@NonNull
 Path executable)

Provides the path to the Kotlin compiler (kotlinc) executable, if not in kotlinHome().

Parameters:

executable - the executable path

Returns:

this operation instance

Throws:

NullPointerException - if executable is null

mainSourceDirectories

public List<File> mainSourceDirectories()

Retrieves the main source directories that should be compiled.

Returns:

the main source directories

mainSourceDirectories

public CompileKotlinOperation mainSourceDirectories(@NonNull
 File... directories)

Provides main source directories that should be compiled.

Parameters:

directories - one or more main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• mainSourceDirectories(Collection)

mainSourceDirectories

public CompileKotlinOperation mainSourceDirectories(@NonNull
 Path... directories)

Provides main source directories that should be compiled.

Parameters:

directories - one or more main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• mainSourceDirectoriesPaths(Collection)

mainSourceDirectories

public CompileKotlinOperation mainSourceDirectories(@NonNull
 String... directories)

Provides main source directories that should be compiled.

Parameters:

directories - one or more main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null or empty elements

See Also:

• mainSourceDirectoriesStrings(Collection)

mainSourceDirectories

public final CompileKotlinOperation mainSourceDirectories(@NonNull
 Collection<File> directories)

Provides the main source directories that should be compiled.

Parameters:

directories - the main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• mainSourceDirectories(File...)

mainSourceDirectoriesPaths

public final CompileKotlinOperation mainSourceDirectoriesPaths(@NonNull
 Collection<Path> directories)

Provides the main source directories that should be compiled.

Parameters:

directories - the main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null elements

See Also:

• mainSourceDirectories(Path...)

mainSourceDirectoriesStrings

public final CompileKotlinOperation mainSourceDirectoriesStrings(@NonNull
 Collection<String> directories)

Provides the main source directories that should be compiled.

Parameters:

directories - the main source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null or empty elements

See Also:

• mainSourceDirectories(String...)

mainSourceFiles

public List<File> mainSourceFiles()

Retrieves the main files that should be compiled.

Returns:

the files

mainSourceFiles

public CompileKotlinOperation mainSourceFiles(@NonNull
 File... files)

Provides main source files that should be compiled.

Parameters:

files - one or more main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• mainSourceFiles(Collection)

mainSourceFiles

public CompileKotlinOperation mainSourceFiles(@NonNull
 String... files)

Provides main source files that should be compiled.

Parameters:

files - one or more main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null or empty elements

See Also:

• mainSourceFilesStrings(Collection)

mainSourceFiles

public CompileKotlinOperation mainSourceFiles(@NonNull
 Path... files)

Provides main source files that should be compiled.

Parameters:

files - one or more main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• mainSourceFilesPaths(Collection)

mainSourceFiles

public CompileKotlinOperation mainSourceFiles(@NonNull
 Collection<File> files)

Provides the main source files that should be compiled.

Parameters:

files - the main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• mainSourceFiles(File...)

mainSourceFilesPaths

public final CompileKotlinOperation mainSourceFilesPaths(@NonNull
 Collection<Path> files)

Provides the main source files that should be compiled.

Parameters:

files - the main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null elements

See Also:

• mainSourceFiles(Path...)

mainSourceFilesStrings

public final CompileKotlinOperation mainSourceFilesStrings(@NonNull
 Collection<String> files)

Provides the main source files that should be compiled.

Parameters:

files - the main source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null or empty elements

See Also:

• mainSourceFiles(String...)

plugins

public CompileKotlinOperation plugins(@NonNull
 String directory,
 @NonNull
 CompilerPlugin... plugins)

Provides compiler plugins.

Parameters:

directory - the directory containing the plugin JARs

plugins - one or more plugins

Returns:

this class instance

Throws:

NullPointerException - if directory or plugins is null

IllegalArgumentException - if directory is empty

plugins

public CompileKotlinOperation plugins(@NonNull
 File directory,
 @NonNull
 CompilerPlugin... plugins)

Provides compiler plugins.

Parameters:

directory - the directory containing the plugin JARs

plugins - one or more plugins

Returns:

this class instance

Throws:

NullPointerException - if directory or plugins is null

plugins

public Set<String> plugins()

Retrieves the compiler plugins.

Returns:

the compiler plugins

plugins

public CompileKotlinOperation plugins(@NonNull
 String... plugins)

Provides compiler plugins.

Parameters:

plugins - one or more plugins

Returns:

this class instance

Throws:

NullPointerException - if plugins is null

IllegalArgumentException - if plugins is empty, or contains null or empty elements

plugins

public final CompileKotlinOperation plugins(@NonNull
 Collection<String> plugins)

Provides compiler plugins.

Parameters:

plugins - the compiler plugins

Returns:

this class instance

Throws:

NullPointerException - if plugins is null

IllegalArgumentException - if plugins is empty, or contains null or empty elements

plugins

public CompileKotlinOperation plugins(@NonNull
 Path directory,
 @NonNull
 CompilerPlugin... plugins)

Provides compiler plugins.

Parameters:

directory - the directory containing the plugin JARs

plugins - one or more plugins

Returns:

this class instance

Throws:

NullPointerException - if directory or plugins is null

plugins

public CompileKotlinOperation plugins(@NonNull
 CompilerPlugin... plugins)

Provides compiler plugins located in the kotlinHome() lib directory.

Parameters:

plugins - one or more plugins

Returns:

this class instance

Throws:

NullPointerException - if plugins is null

IllegalArgumentException - if plugins is empty, or contains null elements

See Also:

• plugins(File, CompilerPlugin...)

testSourceDirectories

public List<File> testSourceDirectories()

Retrieves the test source directories that should be compiled.

Returns:

the test source directories

testSourceDirectories

public CompileKotlinOperation testSourceDirectories(@NonNull
 File... directories)

Provides test source directories that should be compiled.

Parameters:

directories - one or more test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• testSourceDirectories(Collection)

testSourceDirectories

public CompileKotlinOperation testSourceDirectories(@NonNull
 Path... directories)

Provides test source directories that should be compiled.

Parameters:

directories - one or more test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• testSourceDirectoriesPaths(Collection)

testSourceDirectories

public CompileKotlinOperation testSourceDirectories(@NonNull
 String... directories)

Provides test source directories that should be compiled.

Parameters:

directories - one or more test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null or empty elements

See Also:

• testSourceDirectoriesStrings(Collection)

testSourceDirectories

public final CompileKotlinOperation testSourceDirectories(@NonNull
 Collection<File> directories)

Provides the test source directories that should be compiled.

Parameters:

directories - the test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

See Also:

• testSourceDirectories(File...)

testSourceDirectoriesPaths

public final CompileKotlinOperation testSourceDirectoriesPaths(@NonNull
 Collection<Path> directories)

Provides the test source directories that should be compiled.

Parameters:

directories - the test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null elements

See Also:

• testSourceDirectories(Path...)

testSourceDirectoriesStrings

public final CompileKotlinOperation testSourceDirectoriesStrings(@NonNull
 Collection<String> directories)

Provides the test source directories that should be compiled.

Parameters:

directories - the test source directories

Returns:

this operation instance

Throws:

NullPointerException - if directories is null

IllegalArgumentException - if directories is empty, or contains null or empty elements

See Also:

• testSourceDirectories(String...)

testSourceFiles

public List<File> testSourceFiles()

Retrieves the test files that should be compiled.

Returns:

the test files

testSourceFiles

public CompileKotlinOperation testSourceFiles(@NonNull
 File... files)

Provides test source files that should be compiled.

Parameters:

files - one or more test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• testSourceFiles(Collection)

testSourceFiles

public CompileKotlinOperation testSourceFiles(@NonNull
 String... files)

Provides the test sources files that should be compiled.

Parameters:

files - one or more test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null or empty elements

See Also:

• testSourceFilesStrings(Collection)

testSourceFiles

public CompileKotlinOperation testSourceFiles(@NonNull
 Path... files)

Provides the test sources files that should be compiled.

Parameters:

files - one or more test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• testSourceFilesPaths(Collection)

testSourceFiles

public final CompileKotlinOperation testSourceFiles(@NonNull
 Collection<File> files)

Provides the test source files that should be compiled.

Parameters:

files - the test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

See Also:

• testSourceFiles(File...)

testSourceFilesPaths

public final CompileKotlinOperation testSourceFilesPaths(@NonNull
 Collection<Path> files)

Provides the test source files that should be compiled.

Parameters:

files - the test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null elements

See Also:

• testSourceFiles(Path...)

testSourceFilesStrings

public final CompileKotlinOperation testSourceFilesStrings(@NonNull
 Collection<String> files)

Provides the test source files that should be compiled.

Parameters:

files - the test source files

Returns:

this operation instance

Throws:

NullPointerException - if files is null

IllegalArgumentException - if files is empty, or contains null or empty elements

See Also:

• testSourceFiles(String...)

workDir

public CompileKotlinOperation workDir(@NonNull
 File dir)

Provides the working directory if it differs from the project's directory.

Parameters:

dir - the directory

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

workDir

public CompileKotlinOperation workDir(@NonNull
 Path dir)

Provides the working directory if it differs from the project's directory.

Parameters:

dir - the directory

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

workDir

public CompileKotlinOperation workDir(@NonNull
 String dir)

Provides the working directory if it differs from the project's directory.

Parameters:

dir - the directory path

Returns:

this operation instance

Throws:

NullPointerException - if dir is null

IllegalArgumentException - if dir is empty

workDir

public File workDir()

Retrieves the working directory.

Returns:

the directory

executeBuildMainSources

protected void executeBuildMainSources()
                                throws ExitStatusException

Part of the execute operation, builds the main sources.

Copies the configured classpath and sources to prevent mutation of operation state across multiple execute() invocations.

Throws:

ExitStatusException - if an error occurs

executeBuildSources

protected void executeBuildSources(Collection<String> classpath,
 Collection<File> sources,
 File destination,
 File friendPaths)
                            throws ExitStatusException

Part of the execute operation, build sources to a given destination.

Parameters:

classpath - the classpath list used for the compilation

sources - the source files to compile

destination - the destination directory

friendPaths - the output directory for friendly modules

Throws:

ExitStatusException - if an error occurs

executeBuildTestSources

protected void executeBuildTestSources()
                                throws ExitStatusException

Part of the execute operation, builds the test sources.

Copies the configured classpath and sources to prevent mutation of operation state across multiple execute() invocations. Test compilation uses the main build directory as a friend path for module visibility.

Throws:

ExitStatusException - if an error occurs

executeCreateBuildDirectories

protected void executeCreateBuildDirectories()
                                      throws IOException

Part of the execute operation, creates the build directories.

Throws:

IOException - if an error occurs