rspec_n 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 779f827fe4de372504a3fa7c5d4168914b4a0c3d51c05f7e441cf94ecd6953ba
+  data.tar.gz: 928f1f99ec404b2f3a65d07542521658dfb1296e0ed5e9e5623f256b22789db8
+SHA512:
+  metadata.gz: b5f002fde7c4a9ad096a17abfe21a836efa53a9ce42c3d8ad94de3df68213455555f2fe5e21bd808f3a883cfa8591f9401bb925adc3e3afe5e084ccd290b2280
+  data.tar.gz: 48060eb007f625e03ab00e498b2c5cdf2fd365b59fb658978549a527b438bc000f988c875ff960e4f5618dd4804627b06bf1cf9852fc5d4fe4e31b10c5dc4133

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/rubocop/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format progress
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_gem:
+  rubocop_plus: config/rubocop.yml
+
+Style/Documentation:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.5.1
+before_install: gem install bundler -v 2.0.1

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# CHANGELOG
+
+## Next Release
+
+1. (New) Add initial core logic. (Issue #1)
+1. (New) Add initial CLI. (Issue #4)
+1. (New) Write results of each iteration to a separate file.  (Issue #5)
+1. (New) Add `-s` option to stop on first failure.  (Issue #6)

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in rspec_n.gemspec
+gemspec
+
+group :development do
+  gem 'rubocop_plus', "~> 1.0", require: false
+end

data/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Roberts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,71 @@
+# 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 or flakiness issues in automated test suites.
+
+![sample](https://user-images.githubusercontent.com/2053901/52986788-d0bb7c80-33c6-11e9-9f13-0e191bdd2bb3.png)
+
+## Version Policy
+
+Releases are versioned using [semver 2.0.0](https://semver.org/spec/v2.0.0.html).
+
+## Installation
+
+Install by executing
+
+    $ gem install rspec_n
+
+The gem will install an exectuable called `rspec_n` on your system.  You may also want to add `rspec_n_iteration.*` to your `.gitignore` to exclude the output generated by rspec_n from your project's repo.
+
+## Usage
+
+To run RSpec N times
+
+    $ rspec_n N
+
+If your project has a `bin/start_rspec` file, rspec_n will invoke it to start RSpec (rspec_n assumes you have placed the necessary commands to cleanly start your test suite in that file). Otherwise, it will attempt to identify your project type and use best practices to start RSpec for your given project type.  The following is a list of project types supported by rspec_n, and the commands used when that project type is selected:
+
+1. Ruby on Rails - `DISABLE_DATABASE_ENVIRONMENT_CHECK=1 RAILS_ENV=test bundle exec rake db:drop db:create db:migrate && bundle exec rspec`.
+
+If it cannot guess a project type, rspec_n will invoke `bundle exec rspec`.  You can override this by specifying a command directly on the CLI.
+
+#### Use Custom Command to Start RSpec
+
+By default, rspec_n will inspect the files in your project and pick the best way to start RSpec.  You can take control by using the `-c` option which lets you specify a custom command.  The following example deletes the `tmp` folder before starting RSpec:
+
+    $ rspec_n 5 -c 'rm -rf tmp && bundle exec rspec'
+
+You must wrap your entire command string in single or double quotes if it contains spaces (which it probably will). This command will be invoked each time rspec_n attempts to start RSpec.
+
+#### Control spec Order
+
+rspec_n provides three command line options for controlling the execution order of your specs.
+
+1. `--order rand`    - Passes `--order rand` to RSpec which causes RSpec to run your specs in a random order.
+1. `--order defined` - Passes `--order defined` to RSpec which causes RSpec to run your specs in the order that they are loaded by RSpec.
+1. `--order project` - Passes nothing to RSpec, which means the project configuration files will determine the order.
+
+If you do nothing, rspec_n will use `--order rand`.  This ensures the specs in your project are executed in random order for each iteration of RSpec.  rspec_n doesn't supply a seed when it start RSpec using a random strategy; it lets RSpec choose the seed and reports the values in the results.
+
+#### Control File Ouput
+
+rspec_n writes output for each iteration in a sequence of files `rspec_n_iteration.1`, `rspec_n_iteration.2`, etc...  This saves you from having to rerun your test suite when you find a particular seed that causes your test suite to fail.  If you want to disable this, add the `--no-file` option to the command.
+
+**Note:** rspec_n deletes all files matching `rspec_n_iteration.*` when it starts so you must move those files to another location if you want to save them.
+
+#### Stop on First Failure
+
+You can tell rspec_n to abort when an iteration fails by using the `-s` flag.  Any remaining iterations will be skipped.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for a Pry console, or `rake console` for an IRB console, that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/roberts1000/rspec_n.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+task :console do
+  # exec "pry -r rspec_n -I ./lib"
+  exec "irb -r rspec_n -I ./lib"
+end

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rspec_n"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start
+
+# require "irb"
+# IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/rspec_n

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+
+# This script runs the rspec_n executable.
+#
+# EXECUTION
+#
+# rspec_n     # Run the project's RSpec test suite 10 times.
+# rspec_n N   # Run the projects's test suite N times.
+#
+# EXIT STATUS
+#
+# See below for exit status codes and their meaning.
+
+lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "cri"
+require "rspec_n/constants"
+require "rspec_n/errors"
+
+# rubocop:disable Metrics/BlockLength
+command = Cri::Command.define do
+  usage       'rspec_n [iterations] [options]'
+  description "rspec_n is an executable installed by the rspec_n Ruby gem.  It provides a " \
+    "way to re-run an RSpec test suite 'N' times, which is useful when determining " \
+    "if a test suite is consistent.\n\n" \
+    "STATUS CODES\n\n" \
+    "0 - rspec_n ran successfully                                            \u00A0\n" \
+    "1 - problem with the commandline options                                \u00A0"
+
+  flag :h, :help, 'show help' do |_value, cmd|
+    puts cmd.help
+    exit 0
+  end
+
+  command_description = "By default, rspec_n will guess the best command to run RSpec; " \
+    "override it by setting a custom command; wrap the entire command in single or double quotes; " \
+    "join multiple commands with '&&'"
+  option :c, :command, command_description, argument: :required
+
+  flag nil, "no-file", "Do not write iteration output to files"
+
+  flag :s, "stop-fast", "Stop when an iteration reports a failure."
+
+  command_description =
+    "The order RSpec uses when running specs. Can be one of three values:                          \u00A0\n" \
+    "\u00A0\u00A0defined - Run specs in same order           \u00A0\n" \
+    "\u00A0\u00A0project - Let project decide                \u00A0\n" \
+    "\u00A0\u00A0rand    - Randomize specs (default)"
+  option :o, :order, command_description, argument: :required
+
+  flag :v, :version, 'show the current version' do |_value, _cmd|
+    puts RspecN::VERSION
+    exit 0
+  end
+
+  run do |options, args, _cmd|
+    require "rspec_n"
+    RspecN::Runner.new(options, args).start
+  end
+end
+# rubocop:enable Metrics/BlockLength
+
+begin
+  command.run(ARGV)
+  exit 0
+# Raised when the user specifies an argument incorrectly.
+rescue RspecN::BadArgument => e
+  warn e.message.colorize(:red)
+  exit 1
+rescue RspecN::BadOption => e
+  warn e.message.colorize(:red)
+  exit 1
+end

data/lib/rspec_n/constants.rb

@@ -0,0 +1,9 @@
+module RspecN
+  ALLOWED_ORDER_OPTIONS = %w[defined project rand].freeze
+  DEFAULT_ITERATIONS = 10
+  DEFAULT_COMMAND = 'bundle exec rspec'.freeze
+  DEFAULT_RSPEC_STARTER_COMMAND = 'bin/start_rspec'.freeze
+  # rubocop:disable Metrics/LineLength
+  DEFAULT_RAILS_COMMAND = 'DISABLE_DATABASE_ENVIRONMENT_CHECK=1 RAILS_ENV=test bundle exec rake db:drop db:create db:migrate && bundle exec rspec'.freeze
+  # rubocop:enable Metrics/LineLength
+end

data/lib/rspec_n/errors/bad_argument.rb

@@ -0,0 +1,18 @@
+module RspecN
+  class BadArgument < StandardError
+    def initialize(msg="")
+      @details = msg
+      super
+    end
+
+    def message
+      "There was an error with the argument.  rspec_n only accepts a single argument, a number greater than 0, which \n" \
+      "specifies how times RSpec should run.  You entered:\n\n"\
+      "  #{@details}\n\n" \
+      "Here are some example ways to use rspec_n (some of these may not be valid for your particular test suite):\n\n" \
+      "  rspec_n 5\n" \
+      "  rspec_n 3 --command 'bundle exec rspec'\n" \
+      "  rspec_n --command 'bin/rails db:test:prepare && bundle exec rspec'"
+    end
+  end
+end

data/lib/rspec_n/errors/bad_option.rb

@@ -0,0 +1,13 @@
+module RspecN
+  class BadOption < StandardError
+    def initialize(msg="")
+      @details = msg
+      super
+    end
+
+    def message
+      allowed = RspecN::ALLOWED_ORDER_OPTIONS.collect { |val| "'" + val + "'" }
+      "Order must be #{allowed.to_sentence}.  '#{@details}' is not allowed.\n"
+    end
+  end
+end

data/lib/rspec_n/errors.rb

@@ -0,0 +1,2 @@
+require_relative "errors/bad_argument"
+require_relative "errors/bad_option"

data/lib/rspec_n/formatters/file_formatter.rb

@@ -0,0 +1,35 @@
+module RspecN
+  module Formatters
+    class FileFormatter
+      include RspecN::TimeHelpers
+
+      BASE_FILE_NAME = "rspec_n_iteration"
+
+      def initialize(runner:)
+        @runner = runner
+        @format = "%m/%d %l:%M:%S %p"
+        delete_all_files
+      end
+
+      def delete_all_files
+        Dir.glob("#{BASE_FILE_NAME}.**").each { |file| File.delete(file)}
+      end
+
+      def write(run)
+        return if run.skipped?
+        return unless @runner.input.write_files?
+
+        file_name = "#{BASE_FILE_NAME}.#{run.iteration}"
+
+        File.open(file_name, "w") do |f|
+          f.write("Iteration: #{run.iteration}\n")
+          f.write("Start Time: #{run.formatted_start_time(@format)}\n")
+          f.write("Finish Time: #{run.formatted_finish_time(@format)}\n")
+          f.write("Duration: #{convert_seconds_to_hms(run.duration_seconds)}\n\n")
+          f.write(run.rspec_stdout)
+          f.write(run.rspec_stderr)
+        end
+      end
+    end
+  end
+end

data/lib/rspec_n/formatters/table_formatter.rb

@@ -0,0 +1,93 @@
+module RspecN
+  module Formatters
+    class TableFormatter
+      include RspecN::TimeHelpers
+
+      attr_accessor :columns
+
+      def initialize(runner:)
+        @runner = runner
+        @columns = { "Run" => 8, "Start Time" => 22, "Finish Time" => 22, "Duration" => 13, "Seed" => 11, "Result" => 18 }
+        @header_columns_string = padded_header_column_labels
+        @table_width = @header_columns_string.size
+        @format = "%m/%d %l:%M:%S %p"
+      end
+
+      def observe
+        write_table_header
+        yield
+        write_conclusion
+      end
+
+      def show_pre_run_info(run)
+        print pad_field("Run", run.iteration)
+        print pad_field("Start Time", run.formatted_start_time(@format))
+      end
+
+      def show_post_run_info(run)
+        print pad_field("Finish Time", run.formatted_finish_time(@format))
+        print duration_field(run)
+        print seed_field(run)
+        puts result_field(run)
+      end
+
+      private
+
+      def write_table_header
+        puts @header_columns_string
+        puts "-" * @table_width
+      end
+
+      def write_conclusion
+        puts "-" * @table_width
+        puts ""
+        puts "Total Duration:              #{convert_seconds_to_hms(@runner.total_duration_seconds)}"
+        puts "Average Duration:            #{convert_seconds_to_hms(@runner.avg_duration_seconds)}"
+        puts "Total Passed:                #{@runner.total_passed.to_s.colorize(:green)}"
+        puts "Total Passed with Warnings:  #{@runner.total_passed_with_warnings.to_s.colorize(:green)}"
+        puts "Total Failed:                #{@runner.total_failed.to_s.colorize(:red)}"
+        puts "Total Skipped:               #{@runner.total_skipped}"
+        puts ""
+      end
+
+      def padded_header_column_label(name, width)
+        right_padding = width - name.size
+        name + (" " * right_padding)
+      end
+
+      def padded_header_column_labels
+        columns.collect { |name, max_width| padded_header_column_label(name, max_width) }.join("")
+      end
+
+      def max_column_width_for(name)
+        columns[name]
+      end
+
+      def pad_field(column_name, value)
+        max_width = max_column_width_for(column_name)
+        value_size = value.to_s.size
+        pad_count = max_width - value_size
+        value.to_s + (" " * pad_count)
+      end
+
+      def duration_field(run)
+        hms = convert_seconds_to_hms(run.duration_seconds)
+        pad_field("Duration", hms)
+      end
+
+      def seed_field(run)
+        run.seed.nil? ? pad_field("Seed", "None") : pad_field("Seed", run.seed)
+      end
+
+      def result_field(run)
+        case run.status_string
+        when "Pass with Warnings" then "Pass with Warnings".colorize(:yellow)
+        when "Pass" then "Pass".colorize(:green)
+        when "Fail" then "Fail".colorize(:red)
+        when "Skip" then "Skip".colorize(:yellow)
+        else "Unknown".colorize(:yellow)
+        end
+      end
+    end
+  end
+end

data/lib/rspec_n/helpers/core_ext/array.rb

@@ -0,0 +1,14 @@
+class Array
+  def to_sentence(word_connector: ", ", two_word_connector: " or ", last_word_connector: " or ")
+    case length
+    when 0
+      ""
+    when 1
+      self[0].to_s.dup
+    when 2
+      "#{self[0]}#{two_word_connector}#{self[1]}"
+    else
+      "#{self[0...-1].join(word_connector)}#{last_word_connector}#{self[-1]}"
+    end
+  end
+end

data/lib/rspec_n/helpers/core_ext/string.rb

@@ -0,0 +1,6 @@
+class String
+  # https://stackoverflow.com/questions/39743299/check-if-a-string-contains-only-digits-in-ruby
+  def all_digits?
+    self =~ /\A\d+\z/ ? true : false
+  end
+end

data/lib/rspec_n/helpers/time_helpers.rb

@@ -0,0 +1,14 @@
+module RspecN
+  module TimeHelpers
+    def convert_seconds_to_hms(total_seconds)
+      hours = total_seconds / (60 * 60)
+      minutes = (total_seconds / 60) % 60
+      seconds = total_seconds % 60
+      [hours, minutes, seconds].map do |t|
+        # Right justify and pad with 0 until length is 2.
+        # So if the duration of any of the time components is 0, then it will display as 00
+        t.round.to_s.rjust(2, '0')
+      end.join(':')
+    end
+  end
+end

data/lib/rspec_n/input.rb

@@ -0,0 +1,61 @@
+module RspecN
+  class Input
+    attr_accessor :iterations, :command, :stop_fast, :write_files
+    def initialize(options, args)
+      @args = args
+      @options = options
+      validate_args
+      validate_order
+      @iterations = determine_iterations
+      @order = options.fetch(:order, "rand")
+      @command = determine_command
+      @stop_fast = options.fetch(:"stop-fast", false)
+      @write_files = !options.fetch(:'no-file', false)
+    end
+
+    def write_files?
+      @write_files
+    end
+
+    private
+
+    def validate_args
+      return if @args.size.zero?
+      raise BadArgument, @args.join(', ') if @args.empty? || !@args.first.all_digits?
+      raise BadArgument, @args.first if @args.first.to_i < 1
+    end
+
+    def validate_order
+      return unless (order = @options.fetch(:order, nil))
+
+      raise BadOption, order unless RspecN::ALLOWED_ORDER_OPTIONS.include?(order)
+    end
+
+    def determine_iterations
+      @args.empty? ? RspecN::DEFAULT_ITERATIONS : @args.first.to_i
+    end
+
+    def determine_command
+      return @options[:command] if @options.fetch(:command, nil)
+
+      guessed_command + " --order " + @order
+    end
+
+    def guessed_command
+      return RspecN::DEFAULT_RSPEC_STARTER_COMMAND if project_uses_rspec_starter?
+      return RspecN::DEFAULT_RAILS_COMMAND if project_is_rails_based?
+
+      RspecN::DEFAULT_COMMAND
+    end
+
+    def project_uses_rspec_starter?
+      app_file_name = "bin/start_rspec"
+      File.file?(app_file_name)
+    end
+
+    def project_is_rails_based?
+      app_file_name = "config/application.rb"
+      File.file?(app_file_name) && File.readlines(app_file_name).grep(/Rails::Application/).any?
+    end
+  end
+end

data/lib/rspec_n/run.rb

@@ -0,0 +1,83 @@
+module RspecN
+  class Run
+    attr_accessor :iteration, :start_time, :finish_time, :seed, :rspec_stdout, :rspec_stderr, :rspec_status, :duration_seconds, :status_string
+
+    def initialize(iteration:)
+      @iteration = iteration
+      @start_time = nil
+      @finish_time = nil
+      @duration_seconds = nil
+      @seed = nil
+      @rspec_stdout = nil
+      @rspec_stderr = nil
+      @rspec_status = nil
+      @status_string = nil
+      @skipped = false
+    end
+
+    def start_clock
+      @start_time = Time.now
+    end
+
+    def stop_clock
+      @finish_time = Time.now
+      finalize_duration_seconds
+      finalize_seed
+      finalize_status_string
+    end
+
+    def go(command)
+      @rspec_stdout, @rspec_stderr, @rspec_status = Open3.capture3(command)
+    end
+
+    def formatted_start_time(format)
+      start_time.strftime(format)
+    end
+
+    def formatted_finish_time(format)
+      finish_time.strftime(format)
+    end
+
+    def passed?
+      @status_string == "Pass"
+    end
+
+    def passed_with_warnings?
+      @status_string == "Pass with Warnings"
+    end
+
+    def skip
+      @skipped = true
+      @duration_seconds = 0
+    end
+
+    def skipped?
+      @skipped
+    end
+
+    def failed?
+      @status_string == "Fail"
+    end
+
+    private
+
+    def finalize_duration_seconds
+      @duration_seconds = (@finish_time - @start_time).round
+    end
+
+    def finalize_seed
+      result = @rspec_stdout.match(/^Randomized with seed (\d*)/)
+      return if result.nil?  # A seed wasn't used
+
+      @seed = result.captures.first&.strip
+    end
+
+    def finalize_status_string
+      return @status_string = "Skip" if skipped?
+      return @status_string = "Pass with Warnings" if @rspec_status.exitstatus.zero? && !@rspec_stderr.empty?
+      return @status_string = "Pass" if @rspec_status.exitstatus.zero?
+      return @status_string = "Fail" if !@rspec_status.exitstatus.zero?
+      @status_string = "Undetermined"
+    end
+  end
+end

data/lib/rspec_n/runner.rb

@@ -0,0 +1,71 @@
+module RspecN
+  class Runner < Cri::CommandRunner
+    attr_reader :command, :input, :iterations, :runs
+
+    def initialize(options, args)
+      @input = Input.new(options, args)
+      @iterations = @input.iterations
+      @command = @input.command
+      @display_formatter = Formatters::TableFormatter.new(runner: self)
+      @file_formatter = Formatters::FileFormatter.new(runner: self)
+      initialize_runs
+    end
+
+    def start
+      display_intro
+      @display_formatter.observe { run_tests }
+    end
+
+    def total_duration_seconds
+      @runs.values.inject(0) { |sum, run| sum + run.duration_seconds }
+    end
+
+    def avg_duration_seconds
+      (total_duration_seconds / @iterations).floor
+    end
+
+    def total_passed
+      @runs.values.select { |run| run.passed? }.size
+    end
+
+    def total_passed_with_warnings
+      @runs.values.select { |run| run.passed_with_warnings? }.size
+    end
+
+    def total_failed
+      @runs.values.select { |run| run.failed? }.size
+    end
+
+    def total_skipped
+      @runs.values.select { |run| run.skipped? }.size
+    end
+
+    private
+
+    def initialize_runs
+      @runs = {}
+      @iterations.times { |i| @runs[i + 1] = Run.new(iteration: i + 1) }
+    end
+
+    def run_tests
+      found_failure = false
+
+      @runs.each do |_iteration, run|
+        next run.skip if @input.stop_fast && found_failure
+
+        run.start_clock
+        @display_formatter.show_pre_run_info(run)
+        run.go(@command)
+        run.stop_clock
+        @display_formatter.show_post_run_info(run)
+        found_failure ||= run.failed?
+        @file_formatter.write(run)
+      end
+    end
+
+    def display_intro
+      iteration_part = @iterations > 1 ? "#{@iterations} times" : "1 time"
+      puts "\nRSpec will execute #{iteration_part.colorize(:yellow)} using #{command.to_s.colorize(:yellow)}\n\n"
+    end
+  end
+end

data/lib/rspec_n/version.rb

@@ -0,0 +1,3 @@
+module RspecN
+  VERSION = "1.0.0".freeze
+end

data/lib/rspec_n.rb

@@ -0,0 +1,28 @@
+require "rspec_n/version"
+
+require "colorize"
+require "cri"
+require "open3"
+
+require "rspec_n/helpers/time_helpers"
+require "rspec_n/helpers/core_ext/array"
+require "rspec_n/helpers/core_ext/string"
+
+require "rspec_n/errors"
+
+require "rspec_n/constants"
+require "rspec_n/input"
+require "rspec_n/runner"
+require "rspec_n/run"
+require "rspec_n/formatters/file_formatter"
+require "rspec_n/formatters/table_formatter"
+
+# Setup pry for development when running "rake console". Guard against load
+# errors in production (since pry is only loaded as a DEVELOPMENT dependency
+# in the .gemspec)
+# rubocop:disable Lint/HandleExceptions
+begin
+  require "pry"
+rescue LoadError
+end
+# rubocop:enable Lint/HandleExceptions

data/rspec_n.gemspec

@@ -0,0 +1,45 @@
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "rspec_n/version"
+
+# rubocop:disable Metrics/BlockLength
+Gem::Specification.new do |spec|
+  spec.name          = "rspec_n"
+  spec.version       = RspecN::VERSION
+  spec.authors       = ["roberts1000"]
+  spec.email         = ["roberts@corlewsolutions.com"]
+
+  spec.summary       = "A ruby gem that runs RSpec N times."
+  spec.description   = "A ruby gem that runs RSpec N times."
+  spec.homepage      = "https://github.com/roberts1000/rspec_n"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["homepage_uri"] = spec.homepage
+    spec.metadata["source_code_uri"] = "https://github.com/roberts1000/rspec_n"
+    spec.metadata["changelog_uri"] = "https://github.com/roberts1000/rspec_n/blob/master/CHANGELOG.md"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "pry", "~> 0.11.2"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+
+  spec.add_dependency "colorize", "~> 0.8.0"
+  spec.add_dependency "cri", "~> 2.15.3"
+end
+# rubocop:enable Metrics/BlockLength

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: rspec_n
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- roberts1000
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-02-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: cri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.15.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.15.3
+description: A ruby gem that runs RSpec N times.
+email:
+- roberts@corlewsolutions.com
+executables:
+- rspec_n
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/rspec_n
+- lib/rspec_n.rb
+- lib/rspec_n/constants.rb
+- lib/rspec_n/errors.rb
+- lib/rspec_n/errors/bad_argument.rb
+- lib/rspec_n/errors/bad_option.rb
+- lib/rspec_n/formatters/file_formatter.rb
+- lib/rspec_n/formatters/table_formatter.rb
+- lib/rspec_n/helpers/core_ext/array.rb
+- lib/rspec_n/helpers/core_ext/string.rb
+- lib/rspec_n/helpers/time_helpers.rb
+- lib/rspec_n/input.rb
+- lib/rspec_n/run.rb
+- lib/rspec_n/runner.rb
+- lib/rspec_n/version.rb
+- rspec_n.gemspec
+homepage: https://github.com/roberts1000/rspec_n
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/roberts1000/rspec_n
+  source_code_uri: https://github.com/roberts1000/rspec_n
+  changelog_uri: https://github.com/roberts1000/rspec_n/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.8
+signing_key: 
+specification_version: 4
+summary: A ruby gem that runs RSpec N times.
+test_files: []