rspec_n

rspec_n is a Ruby gem that makes it easy to run a project's RSpec test suite N times. You can customize the command that is used to start RSpec, or let rspec_n guess the best command (based on the files in your project). rspec_n is useful for finding repeatability issues in RSpec test suites.

example

Versioning Strategy

Releases are versioned using SemVer 2.0.0 with the following caveats:

  1. Support for Ruby versions, that reach EOL, can be removed in a major or minor release.

Supported Ruby Versions

Ruby 3.3, 3.4 and 4.0 are supported.

Installation

Install by executing:

gem install rspec_n

The gem will install an executable called rspec_n.

Add the following to your project's .gitignore to exclude the output generated by rspec_n from your project's repo:

rspec_n_iteration.*

Usage in a Gemfile

If you add rspec_n to your Gemfile, use the require: false option so rspec_n isn't loaded into your app. rspec_n doesn't provide any runtime benefit to apps and requiring it will add unnecessary code to your project. Also, rspec_n is designed as a standalone command line tool and isn't tested for compatibility inside other apps.

gem 'rspec_n', require: false

Usage

See the Usage Guide.

Development

See the Development Guide.

Contributing

See CONTRIBUTING or SECURITY.