gub and tortoise - A Go SSA Debugger and Interpreter

This project modifies the Go SSA interpreter to support a debugger. We provide the debugger here as well.

Setup

Make sure our Go environment is setup, e.g. $GOBIN, $GOPATH, ...
Make sure you have a 1.4 Go version installed. For Go 1.2.2 use the go1.2.2 branch, for Go 1.1.1, use the go1.1 branch.

    bash < <(curl -s https://raw.githubusercontent.com/rocky/ssa-interp/master/gub-installer)

If this doesn't work here is what the above does:

   go get github.com/rocky/ssa-interp
   cd $GOBIN/src/github.com/rocky/ssa-interp
   make install

Running the debugger:

  gub.sh -- *go-program* [-- *program-opts*...]
  tortoise -run -interp=S *go-program* [-- *program-opts*..]  # Same as above

Or just the interpreter, tortoise:

  tortoise -run *go-program* [-- *program-opts*..]

and now with a test suite, columnize:

  tortoise -run -interp=S -test columnize

Name		Name	Last commit message	Last commit date
Latest commit History 437 Commits
cmd		cmd
example		example
gub		gub
interp		interp
ssautil		ssautil
terminal		terminal
testdata		testdata
trepan		trepan
.gitignore		.gitignore
.travis.yml		.travis.yml
Makefile		Makefile
README.md		README.md
blockopt.go		blockopt.go
builder.go		builder.go
builder4gub.go		builder4gub.go
builder_test.go		builder_test.go
const.go		const.go
create.go		create.go
create4gub.go		create4gub.go
doc.go		doc.go
dom.go		dom.go
emit.go		emit.go
emit4gub.go		emit4gub.go
example_test.go		example_test.go
func.go		func.go
func4gub.go		func4gub.go
gub-installer		gub-installer
lift.go		lift.go
lvalue.go		lvalue.go
lvalue4gub.go		lvalue4gub.go
methods.go		methods.go
print.go		print.go
sanity.go		sanity.go
source.go		source.go
source_test.go		source_test.go
ssa.go		ssa.go
ssa4gub.go		ssa4gub.go
stdlib_test.go		stdlib_test.go
testmain.go		testmain.go
testmain_test.go		testmain_test.go
trace.go		trace.go
util.go		util.go
wrappers.go		wrappers.go