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.