Rspec Cheat Sheet

Spec helpers

module UserSpecHelper
  def valid_user_attributes
    { :email => "[e-mail]",
      :username => "joebloggs",
      :password => "abcdefg"}
  end
end

describe User do
  include UserSpecHelper

  ...
end

[Doubles] Method stubs

allow(die).to receive(:roll)
allow(die).to receive(:roll) { 3 }
allow_any_instance_of(Die).to receive(:roll)

expect(die).to receive(:roll)
  .with(1)
  .with(1, true)
  .with(boolean)
  .with(anything)
  .with(any_args)
  .with(1, any_args)
  .with(no_args)
  .with(hash_including(a: 1))
  .with(hash_excluding(a: 1))
  .with(array_including(:a, :b))
  .with(array_excluding(:a, :b))
  .with(instance_of(Fixnum))
  .with(kind_of(Numeric))
  .with(<matcher>)

  .once
  .twice
  .exactly(n).times
  .at_least(:once)
  .at_least(:twice)
  .at_least(n).times
  .at_most(:once)
  .at_most(:twice)
  .at_most(n).times

https://relishapp.com/rspec/rspec-mocks/docs

Doubles

book = double('book')
book = instance_double('Book', pages: 250)

[Expectations] Change

expect { thing.approve! }.to \
  change(thing, :status)
  .from(Status::AWAITING_APPROVAL)
  .to(Status::APPROVED)

expect { thing.destroy }.to \
  change(Thing, :count)
  .by(-1)

[Expectations] Enumerables/arrays

expect(list).to include(<object>)

expect(list).to have(1).things
expect(list).to have_at_least(2).things
expect(list).to have_at_most(3).things

expect(list).to have(2).errors_on(:field)

[Expectations] Control flow

expect { user.save! }.to raise_error
expect { user.save! }.to raise_error(ExceptionName, /msg/)
expect { user.save! }.to throw :symbol

[Expectations] Objects

expect(obj).to be_an_instance_of MyClass
expect(obj).to be_a_kind_of MyClass
expect(obj).to respond_to :save!

[Expectations] Predicate

expect(x).to be_zero    # FixNum#zero?
expect(x).to be_empty   # Array#empty?
expect(x).to have_key   # Hash#has_key?

[Expectations] Comparison

expect(x).to be value
expect(x).to satisfy { |arg| ... }
expect(x).to match /regexp/

[Expectations] Numeric

expect(5).to be < 6
expect(5).to == 5
expect(5).to equal value
expect(5).to be_between(1, 10)
expect(5).to be_within(0.05).of value

Reference

• Rspec Cheat Sheet - cheatsheetmaker.com