Skip to main content

Directives

using directives

BuildInfo

Generate BuildInfo for project

//> using buildInfo

Examples

//> using buildInfo

Compiler options

Add Scala compiler options

//> using option option

//> using options option1 option2

Examples

//> using option -Xasync

//> using test.option -Xasync

//> using options -Xasync -Xfatal-warnings

Compiler plugins

Adds compiler plugins

using plugin org:name:ver

Examples

//> using plugin org.typelevel:::kind-projector:0.13.2

Compute Version

Method used to compute the version for BuildInfo

//> using computeVersion method

Examples

//> using computeVersion git

//> using computeVersion git:tag

//> using computeVersion git:dynver

Custom JAR

Manually add JAR(s) to the class path

//> using jar path

//> using jars path1 path2

Examples

//> using jar /Users/alexandre/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/chuusai/shapeless_2.13/2.3.7/shapeless_2.13-2.3.7.jar

//> using test.jar /Users/alexandre/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/chuusai/shapeless_2.13/2.3.7/shapeless_2.13-2.3.7.jar

//> using sourceJar /path/to/custom-jar-sources.jar

//> using sourceJars /path/to/custom-jar-sources.jar /path/to/another-jar-sources.jar

//> using test.sourceJar /path/to/test-custom-jar-sources.jar

Custom sources

Manually add sources to the project. Does not support chaining, sources are added only once, not recursively.

//> using file path

//> using files path1 path2

Examples

//> using file utils.scala

Dependency

Add dependencies

//> using dep org:name:ver

Examples

//> using dep com.lihaoyi::os-lib:0.9.1

//> using test.dep org.scalatest::scalatest:3.2.10

//> using test.dep org.scalameta::munit:0.7.29

//> using dep tabby:tabby:0.2.3,url=https://github.com/bjornregnell/tabby/releases/download/v0.2.3/tabby_3-0.2.3.jar

Exclude sources

Exclude sources from the project

//> using exclude pattern

//> using exclude pattern1 pattern2

Examples

//> using exclude utils.scala

//> using exclude "examples/*" "*/resources/*"

//> using exclude "*.sc"

JVM version

Use a specific JVM, such as 14, adopt:11, or graalvm:21, or system

//> using jvm value

Examples

//> using jvm 11

//> using jvm adopt:11

//> using jvm graalvm:21

Java home

Sets Java home used to run your application or tests

//> using javaHome path

Examples

//> using javaHome /Users/Me/jdks/11

Java options

Add Java options which will be passed when running an application.

//> using javaOpt options

Examples

//> using javaOpt -Xmx2g, -Dsomething=a

//> using test.javaOpt -Dsomething=a

Java properties

Add Java properties

//> using javaProp key=value

//> using javaProp key

Examples

//> using javaProp foo1=bar, foo2

//> using test.javaProp foo3=bar foo4

Javac options

Add Javac options which will be passed when compiling sources.

//> using javacOpt options

Examples

//> using javacOpt -source 1.8 -target 1.8

//> using test.javacOpt -source 1.8 -target 1.8

Main class

Specify default main class

//> using mainClass main-class

Examples

//> using mainClass HelloWorld

ObjectWrapper

Set the default code wrapper for scripts to object wrapper

//> using objectWrapper

Examples

//> using objectWrapper

Packaging

Set parameters for packaging

//> using packaging.packageType package-type

//> using packaging.output destination-path

Examples

//> using packaging.packageType assembly

//> using packaging.output foo

//> using packaging.provided org.apache.spark::spark-sql

//> using packaging.dockerFrom openjdk:11

//> using packaging.graalvmArgs --no-fallback

Platform

Set the default platform to Scala.js or Scala Native

//> using platform (jvm|scala-js|js|scala-native|native)+

Examples

//> using platform scala-js

//> using platform jvm scala-native

Publish

Set parameters for publishing

//> using publish.organization value

//> using publish.name value

//> using publish.version value

Examples

//> using publish.organization io.github.myself

//> using publish.name my-library

//> using publish.version 0.1.1

Publish (CI)

Set CI parameters for publishing

//> using publish.ci.computeVersion value

//> using publish.ci.repository value

//> using publish.ci.secretKey value

Examples

//> using publish.ci.computeVersion git:tag

//> using publish.ci.repository central-s01

//> using publish.ci.secretKey env:PUBLISH_SECRET_KEY

Publish (contextual)

Set contextual parameters for publishing

//> using publish.computeVersion value

//> using publish.repository value

//> using publish.secretKey value

//> using publish.doc boolean

Examples

//> using publish.computeVersion git:tag

//> using publish.repository central-s01

//> using publish.secretKey env:PUBLISH_SECRET_KEY

//> using publish.doc false

Python

Enable Python support

//> using python

Examples

//> using python

Repository

Add repositories for dependency resolution.

Accepts predefined repositories supported by Coursier (like sonatype:snapshots or m2Local) or a URL of the root of Maven repository

//> using repository repository

Examples

//> using repository jitpack

//> using repository sonatype:snapshots

//> using repository m2Local

//> using repository https://maven-central.storage-download.googleapis.com/maven2

Resource directories

Manually add a resource directory to the class path

//> using resourceDir path

//> using resourceDirs path1 path2

Examples

//> using resourceDir ./resources

//> using test.resourceDir ./resources

Scala Native options

Add Scala Native options

//> using nativeGc value

//> using nativeMode value

//> using nativeLto value

//> using nativeVersion value

//> using nativeCompile value1 value2

//> using nativeLinking value1 value2

//> using nativeClang value

//> using nativeClangPP value

//> using nativeEmbedResources true|false

//> using nativeTarget application|library-dynamic|library-static

Examples

//> using nativeVersion 0.4.0

Scala version

Set the default Scala version

//> using scala version+

Examples

//> using scala 3.0.2

//> using scala 2.13

//> using scala 2

//> using scala 2.13.6, 2.12.16

Scala.js options

Add Scala.js options

//> using jsVersion value

//> using jsMode value

//> using jsNoOpt true|false

//> using jsModuleKind value

//> using jsSmallModuleForPackage value1 value2

//> using jsCheckIr true|false

//> using jsEmitSourceMaps true|false

//> using jsDom true|false

//> using jsHeader value

//> using jsAllowBigIntsForLongs true|false

//> using jsAvoidClasses true|false

//> using jsAvoidLetsAndConsts true|false

//> using jsModuleSplitStyleStr value

//> using jsEsVersionStr value

Examples

//> using jsModuleKind common

Test framework

Set the test framework

//> using testFramework class-name

Examples

//> using testFramework utest.runner.Framework

Toolkit

Use a toolkit as dependency (not supported in Scala 2.12), 'default' version for Scala toolkit: 0.2.1, 'default' version for typelevel toolkit: 0.1.20

//> using toolkit version

Examples

//> using toolkit 0.1.0

//> using toolkit default

//> using test.toolkit default

target directives

Platform

Require a Scala platform for the current file

//> using target.platform platform

Examples

//> using target.platform scala-js

//> using target.platform scala-js, scala-native

//> using target.platform jvm

Scala version

Require a Scala version for the current file

//> using target.scala version

Examples

//> using target.scala 3

Scala version bounds

Require a Scala version for the current file

//> using target.scala.>= version

Examples

//> using target.scala.>= 2.13

//> using target.scala.< 3.0.2

Scope

Require a scope for the current file

//> using target.scope scope

Examples

//> using target.scope test