Integration of Seeing Is Believing (display results of every line of Ruby code) with Sublime Text 2
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
ActiveRecord.sublime-snippet
Default (Linux).sublime-keymap
Default (OSX).sublime-keymap
Default (Windows).sublime-keymap
Main.sublime-menu
Nokogiri.sublime-snippet
README.md
Reflection.sublime-snippet
Seeing Is Believing.sublime-commands
Seeing Is Believing.sublime-settings
Sinatra.sublime-snippet
seeing_is_believing.py

README.md

Seeing Is Believing

Integration of seeing_is_believing to Sublime Text 2 and 3.

Prerequisites

You need to have seeing_is_believing 2.0 or greater installed:

gem install seeing_is_believing

Installation

You have two options for installing the SeeingIsBelieving Plugin: using Git, or just downloading it. Then you will need to fix the settings.

Git

Open your terminal application and go to your Packages directory, whose location depends on your operating system:

Sublime Text 2:

  • OS X - cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages
  • Linux - cd ~/.Sublime\ Text 2/Packages/
  • Windows - cd %APPDATA%/Sublime Text 2/Packages/

Sublime Text 3:

  • OS X - cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
  • Linux - cd ~/.Sublime\ Text 3/Packages/
  • Windows - cd %APPDATA%/Sublime Text 3/Packages/

After this, you need to clone this repository: git clone git://github.com/JoshCheek/sublime-text-2-and-3-seeing-is-believing.git SeeingIsBelieving

Download

Click on the nice cloud icon above and download the zip file containing this plugin. Then unzip the file and move the resulting folder to your Packages directory.

Customizing

You can customize which Ruby to use, and how to invoke SiB in the settings.

In particular, you'll need to go here if it can't find your Ruby. In that situation, try opening a shell and running ruby -e 'p RbConfig.ruby', its possible that what it prints is the value you need to set. You can also set environment variables here, and set any flags that you want passed to SiB.

Usage

Open a Ruby file or write some code.

10.times do |i|
  i * 2
end

Now run the command Evaluate Ruby code with Seeing Is Believing from your command pallete (⌘ + ⇧ + P on OS X) or press the pre-defined keyboard shortcut (⌥ + ⌘ + B on OS X). You will see comments added adjacent to each line of your code, showing you what that line evaluated to.

10.times do |i|
  i * 2          # => 0, 2, 4, 6, 8, 10, 12, 14, 16, 18
end              # => 10

Now you want to edit it, so run Remove Seeing Is Believing annotations or press (⌥ + ⌘ + V on OS X). And you are back to the original.

There are also some default snippets you can use to play around with SiB.

  • s_arb tab - In memory ActiveRecord environment
  • s_nokogiri tab - Practice parsing html/xml/css selectors/xpath in Ruby
  • s_sinatra tab - Play with Sinatra, without needing to host it on a server
  • s_reflection tab - Examples of reflection in Ruby (knowing these makes SiB much more useful)

Configuration

You can edit these from your preferences folder. You can specify how to find Ruby (e.g. integrate with your version manager). And you can specify what command-line arguments to pass to Seeing Is Believing. I'm trying to figure out how to get this in the menu, but the docs are pretty weak.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Author

Karsten Silkenbäumer wrote the one for XMPfilter that I (Josh Cheek) modified to work with Seeing Is Believing.