A simple debugger library and tooling for Scala. Tested on OpenJDK 7 for Windows and Linux.
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
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
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
.
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.
From the root of the project:
make
or
make build
This will build all modules for Scala 2.10, 2.11, and 2.12.
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.
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")
From the root of the project:
make docs
From the root of the project:
make serve-docs
From the root of the project:
make push-docs
This requires having contributor access to the repository.
Make sure that you have sbt-extras
installed as it will pick up memory and compiler options from .jvmopts
.
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.
From the root of the project:
make it-test-all
This will run integration tests for Scala 2.10, 2.11, and 2.12.
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.
The Scala debugger API is licensed under Apache 2.0.