Gubed

A command-line tool for managing debugger breakpoints in Ruby projects. Find, comment, uncomment, and delete debugging statements like binding.pry, debugger, binding.irb, and more.

Installation

gem install gubed

Usage

Run gubed in any Ruby project directory to scan for debugging breakpoints:

$ gubed --help

gubed                    # Scan current directory
gubed /path/to/project   # Scan specific directory

Interactive Mode

Once Gubed finds breakpoints, you can:

Navigate with j (down) and k (up)
Press t to toggle comment/uncomment breakpoints
Press d to delete breakpoints
Press v to view surrounding code context
Press g to go to a specific breakpoint by number
Press r to refresh/rescan breakpoints
Press q to quit
Press h or ? for help

Supported Breakpoint Types

These are found based on regex.

binding.pry
binding.irb
binding.break
debugger
byebug

Example

$ gubed
Gubed - Ruby Breakpoint Manager
========================================

>  1. [#] binding.irb /Users/thomas.countz/Code/experiments/gubed/examples/calculator.rb:14
   2. [ ] binding.break /Users/thomas.countz/Code/experiments/gubed/examples/calculator.rb:19
   3. [ ] binding.pry /Users/thomas.countz/Code/experiments/gubed/examples/calculator.rb:3
   4. [#] debugger /Users/thomas.countz/Code/experiments/gubed/examples/calculator.rb:8
   5. [#] debugger /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:11
   6. [ ] debugger /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:15
   7. [#] binding.break /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:17
   8. [ ] binding.break /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:22
   9. [ ] byebug /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:25
  10. [ ] binding.pry /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:4
  11. [#] binding.irb /Users/thomas.countz/Code/experiments/gubed/examples/sample_app.rb:9

Commands: [j]down [k]up [g]oto [v]iew [t]oggle [d]elete [r]efresh [q]uit [h]elp
Selected: 1 of 11

Development

After checking out the repo, run bin/setup to install dependencies. Run rake test to run the tests.

gubed