Logo: Relish

  1. Sign in

Project: RSpec Core 2.13

Publisher: RSpec

configure expectation framework

By default, RSpec is configured to include rspec-expectations for expressing
desired outcomes. You can also configure RSpec to use:

  • rspec/expectations (explicitly)
  • stdlib assertions
    • test/unit assertions in ruby 1.8
    • minitest assertions in ruby 1.9
  • rspec/expectations and stlib assertions

Note that when you do not use rspec-expectations, you must explicitly
provide a description to every example. You cannot rely on the generated
descriptions provided by rspec-expectations.

Scenarios
  1. rspec-expectations can be used by default if nothing is configured
  2. configure rspec-expectations (explicitly)
  3. configure test/unit assertions (passing examples)
  4. configure test/unit assertions (failing examples)
  5. configure rspec/expecations AND test/unit assertions
rspec-expectations can be used by default if nothing is configured
Given
a file named "example_spec.rb" with: 
RSpec::Matchers.define :be_a_multiple_of do |factor|
  match do |actual|
    actual % factor == 0
  end
end

describe 6 do
  it { should be_a_multiple_of(3) }
end
When
I run rspec example_spec.rb
Then
the examples should all pass
configure rspec-expectations (explicitly)
Given
a file named "example_spec.rb" with: 
RSpec.configure do |config|
  config.expect_with :rspec
end

describe 5 do
  it "is greater than 4" do
    5.should be > 4
  end
end
When
I run rspec example_spec.rb
Then
the examples should all pass
configure test/unit assertions (passing examples)
Given
a file named "example_spec.rb" with: 
RSpec.configure do |config|
  config.expect_with :stdlib
end

describe 5 do
  it "is greater than 4" do
    assert 5 > 4, "expected 5 to be greater than 4"
  end

  specify { assert 5 < 6 }
end
When
I run rspec example_spec.rb
Then
the output should contain "2 examples, 0 failures"
configure test/unit assertions (failing examples)
Given
a file named "example_spec.rb" with: 
RSpec.configure do |config|
  config.expect_with :stdlib
end

describe 5 do
  it "is greater than 6 (no it isn't!)" do
    assert 5 > 6, "errantly expected 5 to be greater than 5"
  end

  specify { assert 5 > 6 }
end
When
I run rspec example_spec.rb
Then
the output should contain "2 examples, 2 failures"
configure rspec/expecations AND test/unit assertions
Given
a file named "example_spec.rb" with: 
RSpec.configure do |config|
  config.expect_with :rspec, :stdlib
end

describe 5 do
  it "is greater than 4" do
    assert 5 > 4, "expected 5 to be greater than 4"
  end

  it "is less than 6" do
    5.should be < 6
  end
end
When
I run rspec example_spec.rb
Then
the examples should all pass

Last published over 5 years ago by myronmarston.