ko1/debugger2

port of debugger that works on MRI 2.0.0

Description

debugger2 is a fork of [debugger] (https://github.com/cldwalker/debugger) for Ruby 2.0.

It uses only external C-APIs. Not of Ruby core sources.

(and debugger is a fork of ruby-debug(19) that works on 1.9.2 and 1.9.3 and installs easily for rvm/rbenv rubies :)

I want to merge original debugger if it has no problem. So debugger2 may be obsolete. Feel free to give us your comments.

Install

First clone this repository:

git clone [email protected]:ko1/debugger2.git

Next, compile the extension:

rake compile

Build the gem package and install it:

gem build debugger2.gemspec
gem install debugger2*.gem

Supported Rubies

Ruby 2.0.0 or later.

Usage

Wherever you need a debugger, simply:

require 'debugger'; debugger

To use with bundler, drop in your Gemfile:

gem 'debugger2', :git => "git://github.com/ko1/debugger2.git"

Configuration

At initialization time, debugger loads config files, executing their lines as if they were actual commands a user has typed. config files are loaded from two locations:

• /.rdebugrc (/rdebug.ini for windows)
• $PWD/.rdebugrc ($PWD/rdebug.ini for windows)

Here's a common configuration (yeah, I should make this the default):

set autolist
set autoeval
set autoreload

To see debugger's current settings, use the set command.

Using Commands

For a list of commands:

(rdb: 1) help

Most commands are described in rdebug's man page

$ gem install gem-man
$ man rdebug

More documentation

I forked this project from https://github.com/cldwalker/debugger. Maybe it can work same as debugger'. However, now don't support post-motem' mode and `threading'.

Please give us your feedback.

Reason for Fork

Ruby 2.0.0 has debugger support API. No need to install internal headers.

Issues

Please report them on github.

Credits

All ruby's debugger programmers.

Quote from [original README.md] (https://github.com/cldwalker/debugger/blob/master/README.md).

• Thanks to the original authors: Kent Sibilev and Mark Moseley
• Thanks to astashov for bringing in a new and improved test suite and various bug fixes.
• Thanks to windwiny for porting to 2.0.0
• Contributors: ericpromislow, jnimety, adammck, hipe, FooBarWidget, aghull
• Fork started on awesome @relevance fridays!

And I want to say thank you to Asakusa.rb members. They tell me a lot of things, such as how to use github, and so on :).

TODO

• Collect feedback.

debugger2's Issues

Doesn't work

Here is what I get:

2.0.0-p0 :001 > require 'debugger'
LoadError: cannot load such file -- ruby_debug.so

I created a new Gemfile (bundle init) with this content:

source "https://rubygems.org"

gem 'debugger', github: 'ko1/debugger2'

If you try to "bundle exec irb" and 'require "debugger"', you'll get the error above. How can I test this?

How to install this? Does the name of debugger2 exist?

I don't find debugger2 in rubygems now.

This is readme:

gem build debugger2.gemspec
gem install debugger-1.0.0.gem

I built but I found debugger2-1.0.0.beta2.gem. I installed this then I found gem debugger2 (1.0.0.beta2) .

I'm confused.

the debugger stops at some locations where breakpoint is not set

For example, when debugging this webapp under WEBrick, the debugger always stops inside Rack or WEBRick code (e.g. in my case, rack-1.5.2/lib/rack/handler/webrick.rb).

require 'sinatra'
require 'debugger2'
get '/' do
  debugger
  'Hello'
end

Strangely, this does never happen when running exact the same app under Thin web server (but unfortunately, it DOES happen when debugging Rails apps under any sort of web server, which indeed is our major concern).

Push latest version to rubygems.org

Hi guys, any chance to get the latest (1.3.3) version on rubygems.org ?