Logo: Relish

  1. Sign in

Project: RSpec Core 2.99

Publisher: RSpec

Profile examples

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"

describe "something" do
  it "sleeps for 0.1 seconds (example 1)" do
    sleep 0.1
    1.should == 1
  end

  it "sleeps for 0 seconds (example 2)" do
    2.should == 2
  end

  it "sleeps for 0.15 seconds (example 3)" do
    sleep 0.15
    3.should == 3
  end

  it "sleeps for 0.05 seconds (example 4)" do
    sleep 0.05
    4.should == 4
  end

  it "sleeps for 0.05 seconds (example 5)" do
    sleep 0.05
    5.should == 5
  end

  it "sleeps for 0.05 seconds (example 6)" do
    sleep 0.05
    6.should == 6
  end

  it "sleeps for 0.05 seconds (example 7)" do
    sleep 0.05
    7.should == 7
  end

  it "sleeps for 0.05 seconds (example 8)" do
    sleep 0.05
    8.should == 8
  end

  it "sleeps for 0.05 seconds (example 9)" do
    sleep 0.05
    9.should == 9
  end

  it "sleeps for 0.05 seconds (example 10)" do
    sleep 0.05
    10.should == 10
  end

  it "sleeps for 0.05 seconds (example 11)" do
    sleep 0.05
    11.should == 11
  end
end
Scenarios
  1. by default does not show profile
  2. setting `profile_examples` to true shows 10 examples
  3. setting `profile_examples` to 2 shows 2 examples
  4. setting profile examples through CLI
  5. Using `--no-profile` overrules config options
  6. Using `--profile` with `--fail-fast` shows slow examples if everything passes
  7. Using `--profile` shows slow examples even in case of failures
  8. Using `--profile` with `--fail-fast` doesn't show slow examples in case of failures
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
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"

describe "something" do
  it "sleeps for 0.1 seconds (example 1)" do
    sleep 0.1
    1.should == 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"

describe "something" do
  it "sleeps for 0.1 seconds (example 1)" do
    sleep 0.1
    1.should == 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"

Last published about 6 years ago by myronmarston.