Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/amatsuda/interactive_rspec

RSpec on IRB
https://github.com/amatsuda/interactive_rspec

Last synced: 12 days ago
JSON representation

RSpec on IRB

Awesome Lists containing this project

README

        

= 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

* Fork, fix, then send me a pull request.

== Copyright

Copyright (c) 2011 Akira Matsuda. See MIT-LICENSE for further details.