rspec-loop adds a :loop option to run rspec examples multiple times.

Install the gem and add to the application's Gemfile by executing:

bundle add rspec-loop --group test

If bundler is not being used to manage dependencies, install the gem by executing:

gem install rspec-loop

Configure the options in your project's spec_helper.rb:

require "rspec/loop"

RSpec.configure do |config|
  config.default_loop_count = 5
end

To configure an individual test to run multiple times:

it "runs three times", loop: 3 do
  # test code here
end

To configure a group of examples to run multiple times:

describe "a group of tests", loop: 3 do
  it "runs three times" do
    # test code here
  end

  it "also runs three times" do
    # test code here
  end
end

To use the included formatter, use RSpec's --format option:

rspec spec --format RSpec::Loop::Formatter

Or via a rake task:

RSpec::Core::RakeTask.new(:loop) do |t|
  t.rspec_opts = "--format RSpec::Loop::Formatter"
end

After checking out the repo, run bin/setup to install dependencies. Then, run rake to run the tests and linter. You can also run bin/console for an interactive prompt that will allow you to experiment.

Bug reports and pull requests are welcome on GitHub at https://github.com/kcboschert/rspec-loop. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the rspec-loop project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.