ensime / Scala Debugger
Projects that are alternatives of or similar to Scala Debugger
Scala Debugger
A simple debugger library and tooling for Scala. Tested on OpenJDK 7 for Windows and Linux.
About
The project contains several modules including
- A wrapper library around the Java Debugger Interface
- A tool similar to
jdb
, written to allow debugging Java and Scala interactively - A programming language used as the interactive CLI for the debugger tool
- An sbt plugin leveraging the debugger tool for interactive debugging
Installing the debugger tool
Homebrew
The formula for sdb
, the interactive debugger tool for the command line, is
available via the chipsenkbeil/personal tap.
Install via:
brew install chipsenkbeil/personal/scala-debugger
Once installed, you can run sdb
on the command line.
sdb
sbt
With sbt
installed, add the following plugin to ~/.sbt/0.13/plugins/sdb.sbt
:
addSbtPlugin("org.scala-debugger" %% "sbt-scala-debugger" % "1.1.0-M3")
You can now run the plugin via sbt sdb:run
.
Building from source
Make sure that you have some form of sbt installed and available on your path as it is used to compile the Scala Debugger source modules.
Compiling all modules
From the root of the project:
make
or
make build
This will build all modules for Scala 2.10, 2.11, and 2.12.
Assembling executable jars
From the root of the project:
make assembly
This will assemble relevant modules such as sdb
for Scala 2.10, 2.11, and 2.12.
Documentation
Make sure that you have some form of sbt installed and available on your path
as it is used to compile the Scala Debugger documentation module. Furthermore,
you must have the grus plugin enabled for
your version of sbt. This can be done by adding the
following to ~/.sbt/0.13/plugins/grus.sbt
:
addSbtPlugin("org.senkbeil" %% "sbt-grus" % "0.1.0")
Building the documentation
From the root of the project:
make docs
Serving the documentation locally
From the root of the project:
make serve-docs
Publishing the documentation to remote host
From the root of the project:
make push-docs
This requires having contributor access to the repository.
Running tests
Make sure that you have sbt-extras
installed as it will pick up memory and compiler options from .jvmopts
.
Unit Tests
From the root of the project:
make unit-test-all
This will run unit tests for Scala 2.10, 2.11, and 2.12.
Note: Roughly 2.5 GB of RAM is needed to compile the unit tests.
Integration Tests
From the root of the project:
make it-test-all
This will run integration tests for Scala 2.10, 2.11, and 2.12.
View project statistics
This requires you to have cloc installed and available on your path.
make stats
This will calculate statistical information about the project and print it out to the terminal.
License
The Scala debugger API is licensed under Apache 2.0.