Logo: Relish

  1. Sign in

Project: RSpec Core 2.13

Publisher: RSpec

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
  1. exit with 0 when all examples pass
  2. exit with 1 when one example fails
  3. exit with 1 when a nested examples fails
  4. exit with 0 when no examples are run
  5. exit with 2 when one example fails and --failure-exit-code is 2
  6. 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: 
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: 
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: 
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: 
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) }

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.