Adds a 'rake debug' task to Ruby on Rails to restart Phusion Passenger with an interactive debugger connected
Ruby
Permalink
Failed to load latest commit information.
lib Prepare for release Aug 12, 2013
.gitignore First version Mar 11, 2012
Gemfile
LICENSE.txt
README.md
Rakefile First version Mar 11, 2012
ruby-debug-passenger.gemspec Update documentation with Byebug support Aug 12, 2013

README.md

ruby-debug-passenger


Warning: This project is no longer maintained and may not work any more.


Background

I wanted to use Phusion Passenger as an Apache module (not standalone) but still be able to use the interactive Ruby debugger.

Thanks to Adam Meehan I was able to do that, and I decided to make it into a reusable Gem.

Requirements

  • Ruby on Rails 3.0+
  • Ruby 1.9+ (untested on 1.8 but it may work)
  • Ruby Debug / Debugger / Byebug
  • Phusion Passenger

Installation

Add this to your Gemfile if you are on Ruby 2.0:

gem "byebug"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.9:

gem "debugger"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.8 (but it hasn't been tested!):

gem "ruby-debug"
gem "ruby-debug-passenger"

Then run bundle install to install it.

Usage

Add debugger (Ruby 1.9 or lower) or byebug (Ruby 2.0+) anywhere in your Ruby code that you want to invoke the debugger. Or in an ERB template add <% debugger %> or <% byebug %> instead.

Run rake debug to restart Phusion Passenger and connect to the debugger. (You will be prompted to reload the app in your browser.)

Recommended reading

Changelog

0.2.0

  • Support for byebug gem (David Rodríguez) - #2

0.1.0

  • Support for debugger gem (Kai Middleton) - #1

0.0.1

  • Initial release

License

MIT License - see LICENSE.txt.