Logo: Relish

  1. Sign in

Project: RSpec Core 2.2

Publisher: RSpec

fail fast

Use the fail_fast option to tell RSpec to abort the run on first failure.

RSpec.configure {|c| c.fail_fast = true}

When an example fails, all of its related after blocks are run before exiting:

after(:each) # for that group
after(:all) # for that group
after(:suite)

Background
Given
a file named "spec/spec_helper.rb" with: 
RSpec.configure {|c| c.fail_fast = true}
Scenarios
  1. fail_fast with no failures (runs all examples)
  2. fail_fast with first example failing (only runs the one example)
  3. fail_fast with multiple files, second example failing (only runs the first two examples)
fail_fast with no failures (runs all examples)
Given
a file named "spec/example_spec.rb" with: 
describe "something" do
  it "passes" do
  end

  it "passes too" do
  end
end
When
I run "rspec spec/example_spec.rb"
Then
the output should contain "2 examples, 0 failures"
fail_fast with first example failing (only runs the one example)
Given
a file named "spec/example_spec.rb" with: 
require "spec_helper"
describe "something" do
  it "fails" do
    fail
  end

  it "passes" do
  end
end
When
I run "rspec spec/example_spec.rb -fd"
Then
the output should contain "1 example, 1 failure"
fail_fast with multiple files, second example failing (only runs the first two examples)
Given
a file named "spec/example_1_spec.rb" with: 
require "spec_helper"
describe "something" do
  it "passes" do
  end

  it "fails" do
    fail
  end
end

describe "something else" do
  it "fails" do
    fail
  end
end
And
a file named "spec/example_2_spec.rb" with: 
require "spec_helper"
describe "something" do
  it "passes" do
  end
end

describe "something else" do
  it "fails" do
    fail
  end
end
When
I run "rspec spec"
Then
the output should contain "2 examples, 1 failure"

Last published over 5 years ago by dchelimsky.