Project: RSpec Core 3.0

Publisher: RSpec

`--failure-exit-code` option (exit status)

The rspec command exits with an exit status of 0 if all examples pass, and 1
if any examples fail. The failure exit code can be overridden using the
--failure-exit-code option.

Scenarios

Exit with 0 when all examples pass
Exit with 1 when one example fails
Exit with 1 when a nested examples fails
Exit with 0 when no examples are run
Exit with 2 when one example fails and `--failure-exit-code` is 2
Exit with RSpec's exit code when an `at_exit` hook is added upstream

Exit with 0 when all examples pass

Given

a file named "ok_spec.rb" with:

RSpec.describe "ok" do
  it "passes" do
  end
end

When

I run rspec ok_spec.rb

Then

the exit status should be 0

And

the examples should all pass

Exit with 1 when one example fails

Given

a file named "ko_spec.rb" with:

RSpec.describe "KO" do
  it "fails" do
    raise "KO"
  end
end

When

I run rspec ko_spec.rb

Then

the exit status should be 1

And

the output should contain "1 example, 1 failure"

Exit with 1 when a nested examples fails

Given

a file named "nested_ko_spec.rb" with:

RSpec.describe "KO" do
  describe "nested" do
    it "fails" do
      raise "KO"
    end
  end
end

When

I run rspec nested_ko_spec.rb

Then

the exit status should be 1

And

the output should contain "1 example, 1 failure"

Exit with 0 when no examples are run

Given

a file named "a_no_examples_spec.rb" with:

When

I run rspec a_no_examples_spec.rb

Then

the exit status should be 0

And

the output should contain "0 examples"

Exit with 2 when one example fails and `--failure-exit-code` is 2

Given

a file named "ko_spec.rb" with:

RSpec.describe "KO" do
  it "fails" do
    raise "KO"
  end
end

When

I run rspec --failure-exit-code 2 ko_spec.rb

Then

the exit status should be 2

And

the output should contain "1 example, 1 failure"

Exit with RSpec's exit code when an `at_exit` hook is added upstream

Given

a file named "exit_at_spec.rb" with:

require 'rspec/autorun'
at_exit { exit(0) }

RSpec.describe "exit 0 at_exit" do
  it "does not interfere with rspec's exit code" do
    fail
  end
end

When

I run ruby exit_at_spec.rb

Then

the exit status should be 1

And

the output should contain "1 example, 1 failure"

Last published over 5 years ago by myronmarston.

`--failure-exit-code` option (exit status)

RSpec Core settings