Skip to main content

Profiling examples (--profile)

The --profile command line option (available from RSpec.configure as #profile_examples), when set, will cause RSpec to dump out a list of your slowest examples. By default, it prints the 10 slowest examples, but you can set it to a different value to have it print more or fewer slow examples. If --fail-fast option is used together with --profile and there is a failure, slow examples are not shown.

Background

Given a file named "spec/spec_helper.rb" with:

And a file named "spec/example_spec.rb" with:

require "spec_helper"

RSpec.describe "something" do
it "sleeps for 0.1 seconds (example 1)" do
sleep 0.1
expect(1).to eq(1)
end

it "sleeps for 0 seconds (example 2)" do
expect(2).to eq(2)
end

it "sleeps for 0.15 seconds (example 3)" do
sleep 0.15
expect(3).to eq(3)
end

it "sleeps for 0.05 seconds (example 4)" do
sleep 0.05
expect(4).to eq(4)
end

it "sleeps for 0.05 seconds (example 5)" do
sleep 0.05
expect(5).to eq(5)
end

it "sleeps for 0.05 seconds (example 6)" do
sleep 0.05
expect(6).to eq(6)
end

it "sleeps for 0.05 seconds (example 7)" do
sleep 0.05
expect(7).to eq(7)
end

it "sleeps for 0.05 seconds (example 8)" do
sleep 0.05
expect(8).to eq(8)
end

it "sleeps for 0.05 seconds (example 9)" do
sleep 0.05
expect(9).to eq(9)
end

it "sleeps for 0.05 seconds (example 10)" do
sleep 0.05
expect(10).to eq(10)
end

it "sleeps for 0.05 seconds (example 11)" do
sleep 0.05
expect(11).to eq(11)
end
end

By default does not show profile

When I run rspec spec

Then the examples should all pass

And the output should not contain "example 1"

And the output should not contain "example 2"

And the output should not contain "example 3"

And the output should not contain "example 4"

And the output should not contain "example 5"

And the output should not contain "example 6"

And the output should not contain "example 7"

And the output should not contain "example 8"

And the output should not contain "example 9"

And the output should not contain "example 10"

And the output should not contain "example 11".

Setting profile_examples to true shows 10 examples

Given a file named "spec/spec_helper.rb" with:

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

When I run rspec spec

Then the examples should all pass

And the output should contain "Top 10 slowest examples"

And the output should contain "example 1"

And the output should not contain "example 2"

And the output should contain "example 3"

And the output should contain "example 4"

And the output should contain "example 5"

And the output should contain "example 6"

And the output should contain "example 7"

And the output should contain "example 8"

And the output should contain "example 9"

And the output should contain "example 10"

And the output should contain "example 11".

Setting profile_examples to 2 shows 2 examples

Given a file named "spec/spec_helper.rb" with:

RSpec.configure { |c| c.profile_examples = 2 }

When I run rspec spec

Then the examples should all pass

And the output should contain "Top 2 slowest examples"

And the output should contain "example 1"

And the output should not contain "example 2"

And the output should contain "example 3"

And the output should not contain "example 4"

And the output should not contain "example 5"

And the output should not contain "example 6"

And the output should not contain "example 7"

And the output should not contain "example 8"

And the output should not contain "example 9"

And the output should not contain "example 10"

And the output should not contain "example 11".

Setting profile examples through CLI using --profile

When I run rspec spec --profile 2

Then the examples should all pass

And the output should contain "Top 2 slowest examples"

And the output should contain "example 1"

And the output should not contain "example 2"

And the output should contain "example 3"

And the output should not contain "example 4"

And the output should not contain "example 5"

And the output should not contain "example 6"

And the output should not contain "example 7"

And the output should not contain "example 8"

And the output should not contain "example 9"

And the output should not contain "example 10"

And the output should not contain "example 11".

Using --no-profile overrules config options

Given a file named "spec/spec_helper.rb" with:

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

When I run rspec spec --no-profile

Then the examples should all pass

And the output should not contain "example 1"

And the output should not contain "example 2"

And the output should not contain "example 3"

And the output should not contain "example 4"

And the output should not contain "example 5"

And the output should not contain "example 6"

And the output should not contain "example 7"

And the output should not contain "example 8"

And the output should not contain "example 9"

And the output should not contain "example 10"

And the output should not contain "example 11".

Using --profile with --fail-fast shows slow examples if everything passes

When I run rspec spec --fail-fast --profile

Then the examples should all pass

And the output should contain "Top 10 slowest examples"

And the output should contain "example 1"

And the output should not contain "example 2"

And the output should contain "example 3"

And the output should contain "example 4"

And the output should contain "example 5"

And the output should contain "example 6"

And the output should contain "example 7"

And the output should contain "example 8"

And the output should contain "example 9"

And the output should contain "example 10"

And the output should contain "example 11".

Using --profile shows slow examples even in case of failures

Given a file named "spec/example_spec.rb" with:

require "spec_helper"

RSpec.describe "something" do
it "sleeps for 0.1 seconds (example 1)" do
sleep 0.1
expect(1).to eq(1)
end

it "fails" do
fail
end
end

When I run rspec spec --profile

Then the output should contain "2 examples, 1 failure"

And the output should contain "Top 2 slowest examples"

And the output should contain "example 1".

Using --profile with --fail-fast doesn't show slow examples in case of failures

Given a file named "spec/example_spec.rb" with:

require "spec_helper"

RSpec.describe "something" do
it "sleeps for 0.1 seconds (example 1)" do
sleep 0.1
expect(1).to eq(1)
end

it "fails" do
fail
end
end

When I run rspec spec --fail-fast --profile

Then the output should not contain "Top 2 slowest examples"

And the output should not contain "example 1".

Using --profile with slow before hooks includes hook execution time

Given a file named "spec/example_spec.rb" with:

RSpec.describe "slow before context hook" do
before(:context) do
sleep 0.2
end

context "nested" do
it "example" do
expect(10).to eq(10)
end
end
end

RSpec.describe "slow example" do
it "slow example" do
sleep 0.1
expect(10).to eq(10)
end
end

When I run rspec spec --profile 1

Then the output should report "slow before context hook" as the slowest example group.