Skip to content

Wingar/sublime_debugger

 
 

Repository files navigation

SublimeRubyDebugger

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

SublimeRubyDebugger

Based Debugger gem package by Shuky chen.

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 Ruby and RoR applications.
  • Stepping up, down ,over and into while debugging (jumps and goto also available).
  • Add watch expression and run immidiate 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 on Sublime Text 3 (later version will work on both 2 and 3)
  • MRI 1.9.3 support (using debugger gem).
  • MRI 2.0.0 support (using my fork for byebug gem).
  • Linux, Window, OSX support

Soon

  • MRI 2.0 support
  • Sublime 2 support
  • 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

Ruby 1.9.3

Run command gem install debugger

Ruby 2.0.0

Run command gem install byebug --version '>=2.5.0'

Sublime Ruby Debugger

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 on the output window "Errno::EADDRINUSE: Address already in use - bind(2)"?

Thats because there is another process running on your OS who is using the port 8989/8990

Another option is that the last debugger process is still alive

License

SublimeTextXdebug is released under the MIT License.

Todo

  • 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

SublimeRubyDebugger

SublimeRubyDebugger

SublimeRubyDebugger

SublimeRubyDebugger

About

Interactive debugger for sublime

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 94.9%
  • Ruby 5.1%