astosyk/doppio

A JVM in Coffeescript.

Doppio: A JVM in Coffeescript

Doppio is a double shot of espresso. In this case it's also a JVM written in Coffeescript.

It began life as a Mid-term project for CS 691ST, Spring 2012 at UMass Amherst.

To try Doppio now, head to the live demo page.

Getting & Building the Code

git clone https://github.com/plasma-umass/doppio.git
cd doppio
tools/setup.sh

Usage

To run Doppio on localhost:

make dev
tools/webrick.rb --dev

To get the optimized release version:

make release
tools/webrick.rb --release

Then point your browser to http://localhost:8000/.

The code can also be run from the console. For example:

make dev-cli
node build/dev/console/disassembler.js classes/demo/Fib
# doppio-dev -> node build/dev/console/runner.js
./doppio-dev classes/demo/Fib
./doppio-dev classes/demo/Fib --java 7  # passes an argument to the JVM
./doppio-dev --jar my_application.jar   # extracts and runs a JAR

To get the optimized version, use make release-cli. The build products can be found in build/release, and the runtime can be invoked via ./doppio.

Automated Rebuilding

bundle exec guard -i -g release # automates `make release-cli`
bundle exec guard -i -g dev # automates `make dev-cli`

The front-end currently lacks an auto-rebuild system.

Running Tests

Run all tests:

make test -j4

Run a specific test, or test with different options:

console/test_runner.coffee -h
console/test_runner.coffee classes/test/Strings