Skip to content
Ruby MRI 2.1.5, 1.9.3 or 1.9.2 debugger. See also rbx-trepanning
Ruby Other
Latest commit dab44a6 @rocky Merge branch 'ruby-2.1'
Failed to load latest commit information.
app Get ready for release 2.15.3
bin
data Lots of little bugs. data: Ruby gem implementation is different.
interface When we have a non-local exception, show that.
io More blank stripping
lib Don't go into debugger command loop on exit if run with tracing. trac…
processor Small bugs, add step markdown.
sample Changed to support coderay 1.0.
test Small bugs, add step markdown.
.gitignore Add test of test-fn_helper.rb
ChangeLog Get ready for release 2.15.3
LICENSE I guess MIT license is okay
Makefile Makefile, check-filter.rb: reduce verbosity of testing output.
NEWS Get ready for release 2.15.3
README.md Get ready for release 0.3.0
Rakefile Get ready for release 2.15.3
check-filter.rb Makefile, check-filter.rb: reduce verbosity of testing output.
interface.rb Termination message should be associated with the command processor, …
io.rb When we have a non-local exception, show that.
processor.rb Lots of little bugs. data: Ruby gem implementation is different.
trepanning.gemspec Get ready for release 2.15.3

README.md

The trepanning debugger gdb-like debugger. As such, it is both a high-level and low-level debugger. It is a also a rewrite of ruby-debug. But to provide all of the functionality that it has, it requires a patched version of MRI Ruby 2.1.5, 1.9.3 or 1.9.2 found the ruby-debugger-runtime project. The additional run-time support in the MRI is what gives this powerful features that you won't find in other MRI 2.1 or 1.9 debuggers that don't use this runtime.

See the installation instructions.

There is a google group mailing list for Ruby debuggers.

If trepanning is installed, here is how to run:

   $ trepan ruby-program [program]

If your program needs options of its own:

   $ trepan -- ruby-program [program args...]

If you want to run from the source tree you can do that too:

  cd place-where-trepan-is-installed
 ./bin/trepan -- ruby-program [program args...]

Running from inside irb:

 require 'trepanning'
 Trepan.debug { your code }

The return value from Trepan is the return value of the block, i.e. the final value in the block.

You can run the same thing inside your Ruby program, but probably you don't want to give a block. Instead, you may want to have debugging start on the next statement in the code:

require 'trepanning'
...
debugger # stop here

There is extensive on-line help, much in markdown format that displays nicely in a terminal. Run help inside the debugger.

Something went wrong with that request. Please try again.