Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 2.43 KB

README.md

File metadata and controls

72 lines (52 loc) · 2.43 KB

Description

A fork of ruby-debug(19) that works on 1.9.2 and 1.9.3 and installs easily for rvm/rbenv rubies.

Build Status

Install

$ gem install debugger

# If install fails, try passing headers path
$ gem install debugger -- --with-ruby-include=PATH_TO_HEADERS

For Windows install instructions, see OLD_README.

Usage

Wherever you need a debugger, simply:

require 'debugger'; debugger

To use in your Rails app, drop in your Gemfile:

gem 'debugger'

Reason for Fork

  • ruby-debug19 maintainer isn't maintaining:
    • Despite patches from ruby core, no gem release in 2+ years! - 9/1/09.
    • Requests to release a known working 1.9.3 version have been ignored.
    • Doesn't respond to rubyforge issues and doesn't have github issues open.
  • Current install is painful. Requires either manually downloading gems from rubyforge and installing with compiler flags or recompiling ruby.
  • We need a decent ruby debugger for future rubies!

What's different from ruby-debug19

  • Major
    • Works on 1.9.2 and 1.9.3
      • 1.9.2 points to ruby-debug-base19-0.11.25 headers
      • 1.9.3 points to ruby-debug-base19-0.11.26 headers
    • Install painlessly for rvm and rbenv rubies i.e. no compiler flags needed
    • No downloading ruby source during install - was behavior of old ruby_core_source dependency
    • Fix LocalJumpError caused by using proc in extconf.rb
    • Passing tests are up on travis-ci
  • Minor
    • The gem name matches the module namespace, Debugger, and main required file, debugger.
    • ruby-debug-base19 and ruby-debug19 are released as one gem
    • Rake tasks have been updated
    • No more $LOAD_PATH manipulation or runtime code outside of lib
    • man page available via gem-man

Issues

Please report them on github.

Contributing

See here for contribution policies. Let's keep this working for the ruby community!

Credits

  • Thanks to the original authors: Kent Sibilev and Mark Moseley
  • Contributors: jnimety, adammck
  • Fork started on awesome @relevance fridays!

TODO

  • Fix test/test-*.rb
  • Work with others willing to tackle jruby, rubinius or windows support