A simple debugger library and tooling for Scala. Tested on OpenJDK 7 for Windows and Linux.

• Visit the main site for more documentation.
• Check out the wiki for the current roadmap.

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.