interactive_rspec

RSpec on IRB

Ruby

= Interactive RSpec

RSpec on IRB

== Features

=== Execute RSpec matchers in the console

(1+1).should == 3
F

Failures:

1)
   Failure/Error: Unable to find matching line from backtrace
     expected: 3
          got: 2 (using ==)
   # (irb):2

Finished in 18.53 seconds
1 example, 1 failure

Failed examples:

rspec ./.rvm/gems/ruby-1.8.7-p334/gems/interactive_rspec-0.0.1/lib/interactive_rspec.rb:44 #
=> false

Let’s call this the “interactive RSpec”.

=== Execute spec file(s) via running IRB session

irspec ‘path/to/spec_file_spec.rb’

The filename parameter matches to various shortcuts such as:

‘spec/foo’ => spec/foo_spec.rb
‘models/user’ => spec/models/user_spec.rb
‘controllers’ => spec/controllers/**/_spec.rb
:all => **/_spec.rb

== How to start

=== Launch an interactive RSpec console via CLI

% irspec

=== Launch an interactive RSpec console via running IRB session

require ‘rubygems’
require ‘interactive_rspec’
irspec

== With Rails

=== Bundle interactive_rspec gem

gem ‘interactive_rspec’

% bundle

=== Start up your Rails console

% rails c

=== Then it’s done!

You can check how the matchers work:

irspec
User.new(:name => ‘matz’).should_not be_valid

You can run any of the existing spec files:

irspec ‘spec/requests/users_spec.rb’

You might notice that it runs suuuuper fast since irspec uses already loaded Rails process.

== Contributing to Interactive RSpec