The Scala REPL is a tool (scala) for evaluating expressions in Scala.
The scala command will execute a source script by wrapping it in a template and then compiling and executing the resulting program.
In interactive mode, the REPL reads expressions at the prompt, wraps them in an executable template, and then compiles and executes the result.
Previous results are automatically imported into the scope of the current expression as required.
The REPL also provides some command facilities, described below.
An alternative REPL is available in the Ammonite project, which also provides a richer shell environment.
Useful REPL features include:
- the REPL’s IMain is bound to
- the REPL’s last exception is bound to
- use tab for completion.
//print<tab>to show typed desugarings.
:helpfor a list of commands.
:pasteto enter a class and object as companions.
:paste -rawto disable code wrapping, to define a package.
:javapto inspect class artifacts.
-Yrepl-outdirto inspect class artifacts with external tools.
:powerto enter power mode and import compiler components.
- user code can be wrapped in either an object (so that the code runs during class initialization)
or a class (so that the code runs during instance construction). The switch is
:power mode imports identifiers from the interpreter’s compiler.
That is analogous to importing from the runtime reflective context using
import reflect.runtime._, universe._.
Power mode also offers some utility methods as documented in the welcome banner.
Its facilities can be witnessed using
Contributing to Scala REPL
The REPL source is part of the Scala project. Issues are tracked by the standard mechanism for the project and pull requests are accepted at the github repository.