Scripts with instant startup
Scala CLI allows to easly compile and run Scala Scripts. It also allows for straightforward compilation with Scala Native. Scala Native is an ahead-of-time compiler to native binary allowing for instant startup times, meaning that along with scala-cli, it should perfectly suit the needs of a fast scripting tool.
Using Scala Native
As an example, let’s build a script printing files from a directory with sizes bigger than a passed value.
//> using scala 3.1.1
//> using dep com.lihaoyi::os-lib::0.8.1
@main
def sizeHigherThan(dir: String, minSizeMB: Int) =
val wd = os.pwd / dir
val files = os.walk.attrs(wd).collect{
case (p, attrs) if attrs.size > minSizeMB * 10E6 => p
}
files.foreach(println(_))
Running this for a dir
directory and 20 MB as a lower limit with
scala-cli size-higher-than.scala – dir 20
can give us for example:
(>20MB of text)
scala-cli size-higher-than.scala -- dir 20
Compiling project (Scala 3.4.1, JVM)
Compiled project (Scala 3.4.1, JVM)
/Users/user/Documents/workspace/dir/large-file.txt
A keen eye will notice that we have not yet compiled to Scala Native. We are still running on the JVM!
We can fix that by either running with a —-native
option, or,
in this case, by including an additional using directive:
//> using dep com.lihaoyi::os-lib::0.10.0
//> using platform scala-native
@main
def sizeHigherThan(dir: String, minSizeMB: Int) =
val wd = os.pwd / dir
val files = os.walk.attrs(wd).collect{
case (p, attrs) if attrs.size > minSizeMB * 10E6 => p
}
files.foreach(println(_))
After rerunning, you may notice that while the initial compilation took a little longer, subsequent runs will severely cut on the startup time compared to the JVM.
Optimization options
We can make the runtime itself even faster, using various Scala Native optimization options:
debug
- what was used by default up to this point, fast compilation with a slower runtimerelease-fast
- moderate compilation time with a faster runtimerelease-full
- slow compilation time with the fastest runtime
We pass these using a -–native-mode
scala-cli option or, like previously, by adding a using directive:
//> using dep com.lihaoyi::os-lib::0.10.0
//> using platform scala-native
//> using nativeMode release-full
@main
def sizeHigherThan(dir: String, minSizeMB: Int) =
val wd = os.pwd / dir
val files = os.walk.attrs(wd).collect{
case (p, attrs) if attrs.size > minSizeMB * 10E6 => p
}
files.foreach(println(_))
We can also package this script into a separate binary with the package
command,
useful especially on Windows where typically shebangs won’t work:
Additional considerations
Some things to look out for when working with Scala Native:
- dependencies - libraries have to be published separately for Scala Native. Notice the
org::project::version
double colon syntax used for os-lib - it basically hidesorg::project_native[Scala Native binary version]:version
underneath. Fortunately, many libraries are already available for Scala Native. However, Java dependencies will not work altogether. - some differences exist when compared to Scala on the JVM.