KtsRunner
KtsRunner is a light-weight tool that allows the execution of .kts (Kotlin Script) files from ordinary Kotlin programs. It's enabled by JSR 223 (Java Scripting Engines API).
Usage
Running a script from file system
A simple usage example for KtsRunner can be described as follows: The declaration of a class is placed in a .kts file, which is supposed to be loaded into a normal Kotlin program so that it can be processed further.
- Example class
data class ClassFromScript(val x: String)
.ktsfile
import de.swirtz.ktsrunner.objectloader.ClassFromScript
ClassFromScript("I was created in kts")
- Code to load the object
val scriptReader = Files.newBufferedReader(Paths.get("path/classDeclaration.kts"))
val loadedObj: ClassFromScript = KtsObjectLoader().load<ClassFromScript>(scriptReader)
println(loadedObj.x)
// >> I was created in kts
As shown, the KtsObjectLoader can be used for executing a .kts script and getting its result. The example shows a script that creates an instance of the ClassFromScript type that is loaded via KtsObjectLoader and then processed in the regular program.
Executing scripts directly
The KtsObjectLoader also allows the evaluation of simple String based scripts:
val scriptContent = "5 + 10"
val fromScript: Int = KtsObjectLoader().load<Int>(scriptContent))
println(fromScript)
// >> 15
Application Area
You might want to use KtsRunner when some part of your application's source has to be outsourced from the regular code. As an example, you can think of an application that provides a test suite runtime. The actual test cases are provided by a QA team which writes their test scripts using a domain specific language that is provided by the main application. Since you don't want QA to add source files (defining new test cases) to your application all the time, the test case creation is made via independent .kts (Kotlin Scripting) files in which the DSL is being utilized. The test suite main application can use the presented KtsRunner library for loading the test cases provided in .kts files and process them further afterward.
Controlling the ClassLoader
When instantiating an KtsObjectLoader, you can provide an explicit classloader as shown in this test case:
@Test
fun `when passing a custom classloader, it should be used when loading the script`() {
val myCl = object : ClassLoader() {
override fun loadClass(name: String?): Class<*> {
throw IllegalStateException()
}
}
assertExceptionThrownBy<IllegalStateException> {
KtsObjectLoader(myCl).load("anything")
}
}
Getting Started
In your Gradle build, simply include the following repository and dependency:
maven {
setUrl("https://dl.bintray.com/s1m0nw1/KtsRunner")
}
dependencies {
//...
implementation("de.swirtz:ktsRunner:0.0.x")
}
1.5k Dec 29, 2022
327 Dec 30, 2022
1.8k Dec 24, 2022
130 Nov 14, 2022
93 Nov 25, 2022
636 Dec 18, 2022
2.9k Dec 28, 2022
2 Nov 26, 2021
1 Jan 4, 2022
5 Sep 3, 2022
58 Dec 15, 2022
4 Jan 21, 2022
3 Aug 22, 2022
0 Oct 13, 2021
1 Oct 7, 2021
24 Nov 8, 2022
69 Jul 25, 2022
4 Aug 25, 2022
0 Nov 22, 2021