ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Ruby Debugger

by shuky19 ALL

Interactive debugger for sublime

Labels debug, debugger, rails, ruby

Details

Installs

  • Total 34K
  • Win 10K
  • Mac 17K
  • Linux 7K
Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17
Windows 0 1 1 0 1 0 0 0 0 0 0 0 1 2 1 0 0 1 0 1 1 2 1 0 0 1 1 0 2 1 0 0 1 2 1 3 0 0 0 0 0 0 0 1 0
Mac 0 0 0 0 0 0 0 0 0 1 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 1 0 0
Linux 0 0 0 0 1 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 1 0 0 1

Readme

Source
raw.​githubusercontent.​com

Sublime Ruby Debugger

A debugger plugin for interactive ruby and RoR debugging on Sublime Text.

By Shuky chen, based on the Debugger and Byebug gems.

Overview

First steps

In order to start debugging ruby or RoR applications all you need to do is to install Debugger plugin and press on F6 or Shift+F6 or Alt+Shift+F6

Features

  • Local debugging in Ruby and RoR applications.
  • Stepping up, down, over, and into while debugging (jumps and goto also available).
  • Add watch expression and run immediate code using the current program context.
  • Monitoring on stack, threads, output, and local variables in the program.
  • Builtin rails support.
  • Breakpoints, conditional breakpoints, and temporary breakpoints (goto) support.
  • Works in Sublime Text 2 and 3.
  • MRI 1.9.3 support (using debugger gem).
  • MRI 2.0.0 support (using byebug gem).
  • Linux, Window, OSX support

Soon

  • Edit and remove watch expressions

Commands

Here is a complete list of commands you can find Command Pallette under the Debugger namespace or in the menu under Tools / Debugger:

Start/Stop debugging session

  • Start Debugging - F6
  • Start Debugging Rails - Shift+F6
  • Start Debugging (Current file) - Alt+Shift+F6
  • Pause Debugger - Alt+d, b
  • Stop Debugging - Alt+d, k

Breakpoints

  • Toggle Breakpoint - F9
  • Toggle Conditional Breakpoint - Shift+F9
  • Clear Breakpoints - Alt+Shift+F9

Cursor control

  • Step Over - F10
  • Step Into - F11
  • Step up - Alt+d, u
  • Step down - Alt+d, d
  • Continue - F8
  • Run To Line (goto) - ctrl+F10 or ⌘+F10
  • Jumo to line - Ctrl+Shift+F10 or ⌘+Shift+F10

Expressions commands

  • Run expression (evaluate) - F7
  • Add watch expression - Alt+d, w
  • Send input (to stdin) - Alt+d, i

Layout commands

  • Show debug windows - Alt+l, s
  • Hide debug windows - Alt+l, h

Installation

Gem dependencies

Sublime Debugger relies on two seperate gems for diffirent ruby versions. For Ruby 1.9.3 you need the debugger gem, which can be installed using gem install debugger, and for Ruby 2.0.0 you need the byebug gem, which can be installed using gem install byebug.

Unsupported ruby versions

I cannot test this against all ruby versions, so I only explicity support Ruby 1.9.3 and Ruby 2.0.0. RVM is a good way to have multiple ruby versions installed at once and switch between them when debugging or running normally. Sublime Debugger will use the ruby version that you set as default, so you must set either Ruby 1.9.3 or Ruby 2.0.0 as the default. Remember to reinstall the byebug or debugger gem when you change ruby versions, or else you will get an Connection could not be made: [Errno ##] Connection refused error.

If you need to have your ruby program running with an unspported ruby version you can manually add the version to the supported versions list. In the package's directory, which you can get to by going to preferences -> browse packages in sublime text and then opening the Ruby Debugger folder, there is a ruby_version_discoverer.rb file where you can add your ruby version.

Sublime Ruby Debugger

Package Control

Execute “Package Control: Install Package” in the Command Pallette to retrieve a list of available packages. Search in the list and install package Ruby Debugger.

Git

Clone the repository by executing the following command in your Packages directory:

git clone https://github.com/shuky19/sublime_debugger.git "Ruby Debugger"

Download

Get the latest source from GitHub and extract the source into your Packages directory to a folder named “Ruby Debugger”.

Note: You can locate your Packages directory in the menu under Preferences / Browse Packages...

Troubleshoot

Why do I get Connection could not be made: [Errno 61] Connection refused in the output window?

Well, Most of the reasons for this error come from environmental problems, following the steps below will help you fix it:

  • Enable logging: preferences -> Package Settings -> Ruby Debugger -> Settings - Default (you can use User as well)
  • Run you ruby on a shell and make sure it runs perfectly.
  • From that shell run which ruby and ruby --version
  • Run the debugger and compare its output to yours
  • Figure out whether your ruby path comes from a different ruby environment (rbenv | rvm | custom executable)
  • Figure out whether your ruby default version is not set appropriately

Why do I get Errno::EADDRINUSE: Address already in use - bind(2) in the output window?

Either because there is another process running which is using ports 8989/8990 or the last debugger process is still alive (killall ruby will solve that).

License

RubyDebugger is released under the MIT License.

Todo

  • Settings file
  • Break point windows updates
  • Set view cursor on debug cursor change
  • Nice message when port is taken
  • Document & Refacor
  • Ruby 1.8.7 support

Screen Shots