• puts and p statements in specs are actually viewable!
• Changed should snippets so they do not have target as the first step. (ie sh=⇥ gives you should == NOT target.should ==). I find this is flows more naturally.
• Added generic snippet sh⇥ which brings up menu of sh matchers
• Added snippet shbw⇥ for should be_within(tolerance).of(amount)
• Updated bef⇥ and shrt⇥ snippets so they do not include the : in the snippet step.
• Added snippet for expects {x}.to change {y}.by(), expects {x}.to raise_error

mkdir -p ~/Library/Application\ Support/TextMate/Pristine\ Copy/Bundles
cd ~/Library/Application\ Support/TextMate/Pristine\ Copy/Bundles
git clone git://github.com/rspec/rspec-tmbundle.git RSpec.tmbundle
osascript -e 'tell app "TextMate" to reload bundles'

This RSpec.tmbundle works with both rspec-1 and rspec-2. Given that they work differently, the RSpec.tmbundle tries its best to figure out which one you're using in each project when you try to run RSpec examples. There are two separate parts to this process, and you have some control over how each one works.

The first thing that happens is that the RSpec.tmbundle prepares the Load Path as follows:

If a Gemfile is present, it assumes you want to use Bundler to prepare the Load Path, so it requires 'bundler' and runs Bundler.setup (this can be overridden - see below).

If not using Bundler, then it looks to see if rspec is in vendor/plugins or vendor/gems, in which cases it adds its lib directory to the Load Path.

Once the Load Path is prepared, the bundle tries to determine which version of RSpec to invoke as follows:

First, it looks for a ./rspec-tm file in the project root directory. If this is present, it looks to see if it contains a setting for the RSpec version. To use this, just add .rspec-tm to the project root with:

--rspec-version 2.0.0

or which ever version you are using. This is the one fool proof way to ensure that the right version is invoked, but you don't really need to do this in most cases.

If the version is not configured, it then checks to see if rspec was found in vendor/gems or vendor/plugins. If so, it figures out which version to invoke based on files present in that rspec directory.

If no version is configured, and no rspec directory is found in vendor, then it just tries to require 'rspec/core' (for RSpec-2) and then 'spec/autorun' (for RSpec-1).

The effectiveness of each approach is dependent, in part, upon how you manage your gem environment. The simplest approach to choosing is to first see if it just works, and if not, then configure the version you want in the .rspec-tm file.

The RSpec TextMate bundle does not require "rubygems" so that users who choose other packaging mechanisms can still use it. If you are using Rubygems as your package manager, then the simplest thing to do is

• open up TextMate Preferences
• go to the Advanced tab
• add a variable named RUBYOPT with the value rubygems

You can set the following options in an .rspec-tm file in the root directory of your project:

see RSpec-version, above.

Tell the TMBundle to use Bundler, even if there is no Gemfile (in which case you should have the BUNDLER_GEMFILE environment variable set).

Tell the TMBundle not to use Bundler, even if there is a Gemfile.

In addition to the standard TextMate shell variables, the RSpec TextMate bundle supports the following:

Use to set a custom formatter other than RSpec's TextMate formatter. Use the full classname e.g. 'Spec::Core::Formatters::WebKit'

Use this to set RSpec options just as you would in a .rspec file.

If you're hacking on rspec yourself, point this to the rspec-core project directory for rspec-2, or the rspec directory for rspec-1.

There are lots of ways to configure TextMate to work with rvm, but this is the one the we recommend:

First, copy the following into ~/.rvm/bin/textmate_ruby

#!/usr/bin/env sh
source ~/.rvm/scripts/rvm
cd .
exec ruby "$@"

Next, set up a TM_RUBY option in TextMate/Preferences/Advanced/Shell Variables that points to the textmate_ruby command.

Learn more at:

• http://beginrescueend.com/integration/textmate/
• http://groups.google.com/group/rubyversionmanager/browse_thread/thread/64b84bbcdf49e9b?fwc=1&pli=1

Parts of RSpec.tmbundle is based on Florian Weber's TDDMate.

The license of RSpec.tmbundle is the same as RSpec's.