Build Status

Using Rspec Situations

Using Rspec Situations is super simple.

In your Gemfile:

group :development, :testing do
  gem 'rspec-situations'
end

In your spec_helper.rb:

require 'rspec/situations'

Define a situation with the 'situation' method. Add a symbol key to identify the situation, and add an optional description if you like, and pass in a block creating the situation.

Describe a set of 1 or more situations with the 'describe_situation' method, and treat it just like a normal describe call.

describe Apple do
  subject( :apple ){ create :apple }

  situation( :bought ){ subject.bought_by = create :user }
  situation( :red    ){ subject.color = :red }

  situation( :one_yr_old, 'a year old' ) do # With optional description
    subject.created_at = 1.years.ago
  end

  describe_situation :bought, :red do
    it{ should be_tasty }
  end

  desribe_situation :bought, :one_yr_old, 'bought a year ago' do # With optional description
    it{ should_not be_tasty }
  end

  describe_situation :bought, :one_yr_old do
    it{ should_not be_tasty }
  end
end