dmurphy_palindrome 0.1.0

data/vendor/cache/ruby/2.3.0/gems/minitest-reporters-1.2.0/lib/minitest/reporters/html_reporter.rb

@@ -0,0 +1,221 @@
+require 'builder'
+require 'fileutils'
+require 'erb'
+
+module Minitest
+  module Reporters
+    # A reporter for generating HTML test reports
+    # This is recommended to be used with a CI server, where the report is kept as an artifact and is accessible via a shared link
+    #
+    # The reporter sorts the results alphabetically and then by results so that failing and skipped tests are at the top.
+    #
+    # When using Minitest Specs, the number prefix is dropped from the name of the test so that it reads well
+    #
+    # On each test run all files in the reports directory are deleted, this prevents a build up of old reports
+    #
+    # The report is generated using ERB. A custom ERB template can be provided but it is not required
+    # The default ERB template uses JQuery and Bootstrap, both of these are included by referencing the CDN sites
+    class HtmlReporter < BaseReporter
+
+      # The title of the report
+      attr_reader :title
+
+      # The number of tests that passed
+      def passes
+        count - failures - errors - skips
+      end
+
+      # The percentage of tests that passed, calculated in a way that avoids rounding errors
+      def percent_passes
+        100 - percent_skipps - percent_errors_failures
+      end
+
+      # The percentage of tests that were skipped
+      def percent_skipps
+        (skips/count.to_f * 100).to_i
+      end
+
+      # The percentage of tests that failed
+      def percent_errors_failures
+        ((errors+failures)/count.to_f * 100).to_i
+      end
+
+      # Trims off the number prefix on test names when using Minitest Specs
+      def friendly_name(test)
+        groups = test.name.scan(/(test_\d+_)(.*)/i)
+        return test.name if groups.empty?
+        "it #{groups[0][1]}"
+      end
+
+      # The constructor takes a hash, and uses the following keys:
+      # :title - the title that will be used in the report, defaults to 'Test Results'
+      # :reports_dir - the directory the reports should be written to, defaults to 'test/html_reports'
+      # :erb_template - the path to a custom ERB template, defaults to the supplied ERB template
+      # :mode - Useful for debugging, :terse suppresses errors and is the default, :verbose lets errors bubble up
+      # :output_filename - the report's filename, defaults to 'index.html'
+      def initialize(args = {})
+        super({})
+
+        defaults = {
+            :title           => 'Test Results',
+            :erb_template    => "#{File.dirname(__FILE__)}/../templates/index.html.erb",
+            :reports_dir     => 'test/html_reports',
+            :mode            => :safe,
+            :output_filename => 'index.html'
+        }
+
+        settings = defaults.merge(args)
+
+        @mode = settings[:mode]
+        @title = settings[:title]
+        @erb_template = settings[:erb_template]
+        @output_filename = settings[:output_filename]
+        reports_dir = settings[:reports_dir]
+
+        @reports_path = File.absolute_path(reports_dir)
+      end
+
+      def start
+        super
+
+        puts "Emptying #{@reports_path}"
+        FileUtils.mkdir_p(@reports_path)
+        File.delete(html_file) if File.exist?(html_file)
+      end
+
+      # Called by the framework to generate the report
+      def report
+        super
+
+        begin
+          puts "Writing HTML reports to #{@reports_path}"
+          erb_str = File.read(@erb_template)
+          renderer = ERB.new(erb_str)
+
+          tests_by_suites = tests.group_by { |test| test_class(test) } # taken from the JUnit reporter
+
+          suites = tests_by_suites.map do |suite, tests|
+            suite_summary = summarize_suite(suite, tests)
+            suite_summary[:tests] = tests.sort { |a, b| compare_tests(a, b) }
+            suite_summary
+          end
+
+          suites.sort! { |a, b| compare_suites(a, b) }
+
+          result = renderer.result(binding)
+          File.open(html_file, 'w') do |f|
+            f.write(result)
+          end
+
+        rescue Exception => e
+          puts 'There was an error writing the HTML report'
+          puts 'This may have been caused by cancelling the test run'
+          puts 'Use mode => :verbose in the HTML reporters constructor to see more detail' if @mode == :terse
+          puts 'Use mode => :terse in the HTML reporters constructor to see less detail' if @mode != :terse
+          raise e if @mode != :terse
+        end
+
+      end
+
+      private
+      def html_file
+        "#{@reports_path}/#{@output_filename}"
+      end
+
+      def compare_suites_by_name(suite_a, suite_b)
+        suite_a[:name] <=> suite_b[:name]
+      end
+
+      def compare_tests_by_name(test_a, test_b)
+        friendly_name(test_a) <=> friendly_name(test_b)
+      end
+
+      # Test suites are first ordered by evaluating the results of the tests, then by test suite name
+      # Test suites which have failing tests are given highest order
+      # Tests suites which have skipped tests are given second highest priority
+      def compare_suites(suite_a, suite_b)
+        return compare_suites_by_name(suite_a, suite_b) if suite_a[:has_errors_or_failures] && suite_b[:has_errors_or_failures]
+        return -1 if suite_a[:has_errors_or_failures] && !suite_b[:has_errors_or_failures]
+        return 1 if !suite_a[:has_errors_or_failures] && suite_b[:has_errors_or_failures]
+
+        return compare_suites_by_name(suite_a, suite_b) if suite_a[:has_skipps] && suite_b[:has_skipps]
+        return -1 if suite_a[:has_skipps] && !suite_b[:has_skipps]
+        return 1 if !suite_a[:has_skipps] && suite_b[:has_skipps]
+
+        compare_suites_by_name(suite_a, suite_b)
+      end
+
+      # Tests are first ordered by evaluating the results of the tests, then by tests names
+      # Tess which fail are given highest order
+      # Tests which are skipped are given second highest priority
+      def compare_tests(test_a, test_b)
+        return compare_tests_by_name(test_a, test_b) if test_fail_or_error?(test_a) && test_fail_or_error?(test_b)
+
+        return -1 if test_fail_or_error?(test_a) && !test_fail_or_error?(test_b)
+        return 1 if !test_fail_or_error?(test_a) && test_fail_or_error?(test_b)
+
+        return compare_tests_by_name(test_a, test_b) if test_a.skipped? && test_b.skipped?
+        return -1 if test_a.skipped? && !test_b.skipped?
+        return 1 if !test_a.skipped? && test_b.skipped?
+
+        compare_tests_by_name(test_a, test_b)
+      end
+
+      def test_fail_or_error?(test)
+        test.error? || test.failure
+      end
+
+      # based on analyze_suite from the JUnit reporter
+      def summarize_suite(suite, tests)
+        summary = Hash.new(0)
+        summary[:name] = suite.to_s
+        tests.each do |test|
+          summary[:"#{result(test)}_count"] += 1
+          summary[:assertion_count] += test.assertions
+          summary[:test_count] += 1
+          summary[:time] += test.time
+        end
+        summary[:has_errors_or_failures] = (summary[:fail_count] + summary[:error_count]) > 0
+        summary[:has_skipps] = summary[:skip_count] > 0
+        summary
+      end
+
+      # based on message_for(test) from the JUnit reporter
+      def message_for(test)
+        suite = test.class
+        name = test.name
+        e = test.failure
+
+        if test.passed?
+          nil
+        elsif test.skipped?
+          "Skipped:\n#{name}(#{suite}) [#{location(e)}]:\n#{e.message}\n"
+        elsif test.failure
+          "Failure:\n#{name}(#{suite}) [#{location(e)}]:\n#{e.message}\n"
+        elsif test.error?
+          "Error:\n#{name}(#{suite}):\n#{e.message}"
+        end
+      end
+
+      # taken from the JUnit reporter
+      def location(exception)
+        last_before_assertion = ''
+        exception.backtrace.reverse_each do |s|
+          break if s =~ /in .(assert|refute|flunk|pass|fail|raise|must|wont)/
+          last_before_assertion = s
+        end
+        last_before_assertion.sub(/:in .*$/, '')
+      end
+
+      def total_time_to_hms
+        return ('%.2fs' % total_time) if total_time < 1
+
+        hours = (total_time / (60 * 60)).round
+        minutes = ((total_time / 60) % 60).round.to_s.rjust(2,'0')
+        seconds = (total_time % 60).round.to_s.rjust(2,'0')
+
+        "#{ hours }h#{ minutes }m#{ seconds }s"
+      end
+    end
+  end
+end

data/vendor/cache/ruby/2.3.0/gems/minitest-reporters-1.2.0/lib/minitest/reporters/junit_reporter.rb

@@ -0,0 +1,157 @@
+require 'builder'
+require 'fileutils'
+module Minitest
+  module Reporters
+    # A reporter for writing JUnit test reports
+    # Intended for easy integration with CI servers - tested on JetBrains TeamCity
+    #
+    # Inspired by ci_reporter (see https://github.com/nicksieger/ci_reporter)
+    # Also inspired by Marc Seeger's attempt at producing a JUnitReporter (see https://github.com/rb2k/minitest-reporters/commit/e13d95b5f884453a9c77f62bc5cba3fa1df30ef5)
+    # Also inspired by minitest-ci (see https://github.com/bhenderson/minitest-ci)
+    class JUnitReporter < BaseReporter
+      def initialize(reports_dir = "test/reports", empty = true, options = {})
+        super({})
+        @reports_path = File.absolute_path(reports_dir)
+        @single_file = options[:single_file]
+        @base_path = options[:base_path] || Dir.pwd
+
+        if empty
+          puts "Emptying #{@reports_path}"
+          FileUtils.mkdir_p(@reports_path)
+          File.delete(*Dir.glob("#{@reports_path}/TEST-*.xml"))
+        end
+      end
+
+      def report
+        super
+
+        puts "Writing XML reports to #{@reports_path}"
+        suites = tests.group_by { |test|
+          test_class(test)
+        }
+
+        if @single_file
+          xml = Builder::XmlMarkup.new(:indent => 2)
+          xml.instruct!
+          xml.test_suites do
+            suites.each do |suite, tests|
+              parse_xml_for(xml, suite, tests)
+            end
+          end
+          File.open(filename_for('minitest'), "w") { |file| file << xml.target! }
+        else
+          suites.each do |suite, tests|
+            xml = Builder::XmlMarkup.new(:indent => 2)
+            xml.instruct!
+            xml.test_suites do
+              parse_xml_for(xml, suite, tests)
+            end
+            File.open(filename_for(suite), "w") { |file| file << xml.target! }
+          end
+        end
+      end
+
+      private
+
+      def get_source_location(result)
+        if result.respond_to? :klass
+          result.source_location
+        else
+          result.method(result.name).source_location
+        end
+      end
+
+      def parse_xml_for(xml, suite, tests)
+        suite_result = analyze_suite(tests)
+        file_path = Pathname.new(get_source_location(tests.first).first)
+        base_path = Pathname.new(@base_path)
+        relative_path = file_path.relative_path_from(base_path)
+
+        xml.testsuite(:name => suite, :filepath => relative_path,
+                      :skipped => suite_result[:skip_count], :failures => suite_result[:fail_count],
+                      :errors => suite_result[:error_count], :tests => suite_result[:test_count],
+                      :assertions => suite_result[:assertion_count], :time => suite_result[:time]) do
+          tests.each do |test|
+            lineno = get_source_location(test).last
+            xml.testcase(:name => test.name, :lineno => lineno, :classname => suite, :assertions => test.assertions,
+                         :time => test.time) do
+              xml << xml_message_for(test) unless test.passed?
+            end
+          end
+        end
+      end
+
+      def xml_message_for(test)
+        # This is a trick lifted from ci_reporter
+        xml = Builder::XmlMarkup.new(:indent => 2, :margin => 2)
+
+        def xml.trunc!(txt)
+          txt.sub(/\n.*/m, '...')
+        end
+
+        e = test.failure
+
+        if test.skipped?
+          xml.skipped(:type => test.name)
+        elsif test.error?
+          xml.error(:type => test.name, :message => xml.trunc!(e.message)) do
+            xml.text!(message_for(test))
+          end
+        elsif test.failure
+          xml.failure(:type => test.name, :message => xml.trunc!(e.message)) do
+            xml.text!(message_for(test))
+          end
+        end
+      end
+
+      def message_for(test)
+        suite = test.class
+        name = test.name
+        e = test.failure
+
+        if test.passed?
+          nil
+        elsif test.skipped?
+          "Skipped:\n#{name}(#{suite}) [#{location(e)}]:\n#{e.message}\n"
+        elsif test.failure
+          "Failure:\n#{name}(#{suite}) [#{location(e)}]:\n#{e.message}\n"
+        elsif test.error?
+          "Error:\n#{name}(#{suite}):\n#{e.message}"
+        end
+      end
+
+      def location(exception)
+        last_before_assertion = ''
+        exception.backtrace.reverse_each do |s|
+          break if s =~ /in .(assert|refute|flunk|pass|fail|raise|must|wont)/
+          last_before_assertion = s
+        end
+        last_before_assertion.sub(/:in .*$/, '')
+      end
+
+      def analyze_suite(tests)
+        result = Hash.new(0)
+        result[:time] = 0
+        tests.each do |test|
+          result[:"#{result(test)}_count"] += 1
+          result[:assertion_count] += test.assertions
+          result[:test_count] += 1
+          result[:time] += test.time
+        end
+        result
+      end
+
+      def filename_for(suite)
+        file_counter = 0
+        suite_name = suite.to_s[0..240].gsub(/[^a-zA-Z0-9]+/, '-') # restrict max filename length, to be kind to filesystems
+        filename = "TEST-#{suite_name}.xml"
+        while File.exist?(File.join(@reports_path, filename)) # restrict number of tries, to avoid infinite loops
+          file_counter += 1
+          filename = "TEST-#{suite_name}-#{file_counter}.xml"
+          puts "Too many duplicate files, overwriting earlier report #{filename}" and break if file_counter >= 99
+        end
+        File.join(@reports_path, filename)
+      end
+    end
+  end
+end

data/vendor/cache/ruby/2.3.0/gems/minitest-reporters-1.2.0/lib/minitest/reporters/mean_time_reporter.rb

@@ -0,0 +1,392 @@
+require 'minitest/reporters'
+require 'yaml'
+
+module Minitest
+  module Reporters
+
+    # This reporter creates a report providing the average (mean), minimum and
+    # maximum times for a test to run. Running this for all your tests will
+    # allow you to:
+    #
+    # 1) Identify the slowest running tests over time as potential candidates
+    #    for improvements or refactoring.
+    # 2) Identify (and fix) regressions in test run speed caused by changes to
+    #    your tests or algorithms in your code.
+    # 3) Provide an abundance of statistics to enjoy.
+    #
+    # This is achieved by creating a (configurable) 'previous runs' statistics
+    # file which is parsed at the end of each run to provide a new
+    # (configurable) report. These statistics can be reset at any time by using
+    # a simple rake task:
+    #
+    #     rake reset_statistics
+    #
+    class MeanTimeReporter < Minitest::Reporters::DefaultReporter
+
+      class InvalidOrder < StandardError; end
+      class InvalidSortColumn < StandardError; end
+
+      # Reset the statistics file for this reporter. Called via a rake task:
+      #
+      #     rake reset_statistics
+      #
+      # @return [Boolean]
+      def self.reset_statistics!
+        new.reset_statistics!
+      end
+
+      # @param options [Hash]
+      # @option previous_runs_filename [String] Contains the times for each test
+      #   by description. Defaults to '/tmp/minitest_reporters_previous_run'.
+      # @option report_filename [String] Contains the parsed results for the
+      #   last test run. Defaults to '/tmp/minitest_reporters_report'.
+      # @option show_count [Fixnum] The number of tests to show in the report
+      #   summary at the end of the test run. Default is 15.
+      # @option show_progress [Boolean] If true it prints pass/skip/fail marks.
+      #   Default is true.
+      # @option show_all_runs [Boolean] If true it shows all recorded suit results.
+      #   Default is true.
+      # @option sort_column [Symbol] One of :avg (default), :min, :max, :last.
+      #   Determines the column by which the report summary is sorted.
+      # @option order [Symbol] One of :desc (default), or :asc. By default the
+      #   report summary is listed slowest to fastest (:desc). :asc will order
+      #   the report summary as fastest to slowest.
+      # @return [Minitest::Reporters::MeanTimeReporter]
+      def initialize(options = {})
+        super
+
+        @all_suite_times = []
+      end
+
+      # Copies the suite times from the
+      # {Minitest::Reporters::DefaultReporter#after_suite} method, making them
+      # available to this class.
+      #
+      # @return [Hash<String => Float>]
+      def after_suite(suite)
+        super
+
+        @all_suite_times = @suite_times
+      end
+
+      # Runs the {Minitest::Reporters::DefaultReporter#report} method and then
+      # enhances it by storing the results to the 'previous_runs_filename' and
+      # outputs the parsed results to both the 'report_filename' and the
+      # terminal.
+      #
+      def report
+        super
+
+        create_or_update_previous_runs!
+
+        create_new_report!
+
+        write_to_screen!
+      end
+
+      def on_start
+        super if options[:show_progress]
+      end
+
+      def on_record(test)
+        super if options[:show_progress]
+      end
+
+      def on_report
+        super if options[:show_progress]
+      end
+
+      # Resets the 'previous runs' file, essentially removing all previous
+      # statistics gathered.
+      #
+      # @return [void]
+      def reset_statistics!
+        File.open(previous_runs_filename, 'w+') { |f| f.write('') }
+      end
+
+      protected
+
+      attr_accessor :all_suite_times
+
+      private
+
+      # @return [Hash<String => Float>]
+      def current_run
+        Hash[all_suite_times]
+      end
+
+      # @return [Hash] Sets default values for the filenames used by this class,
+      #   and the number of tests to output to output to the screen after each
+      #   run.
+      def defaults
+        {
+          order:                  :desc,
+          show_count:             15,
+          show_progress:          true,
+          show_all_runs:          true,
+          sort_column:            :avg,
+          previous_runs_filename: '/tmp/minitest_reporters_previous_run',
+          report_filename:        '/tmp/minitest_reporters_report',
+        }
+      end
+
+      # Added to the top of the report file and to the screen output.
+      #
+      # @return [String]
+      def report_title
+        "\n\e[4mMinitest Reporters: Mean Time Report\e[24m " \
+        "(Samples: #{samples}, Order: #{sort_column.inspect} " \
+        "#{order.inspect})\n"
+      end
+
+      # The report itself. Displays statistics about all runs, ideal for use
+      # with the Unix 'head' command. Listed in slowest average descending
+      # order.
+      #
+      # @return [String]
+      def report_body
+        order_sorted_body.each_with_object([]) do |result, obj|
+          rating = rate(result[:last], result[:min], result[:max])
+
+          obj << "#{avg_label} #{result[:avg].to_s.ljust(12)} " \
+                 "#{min_label} #{result[:min].to_s.ljust(12)} " \
+                 "#{max_label} #{result[:max].to_s.ljust(12)} " \
+                 "#{run_label(rating)} #{result[:last].to_s.ljust(12)} " \
+                 "#{des_label} #{result[:desc]}\n"
+        end.join
+      end
+
+      # @return [String] All of the column-sorted results sorted by the :order
+      #   option. (Defaults to :desc).
+      def order_sorted_body
+        if desc?
+          column_sorted_body.reverse
+
+        elsif asc?
+          column_sorted_body
+
+        end
+      end
+
+      # @return [Array<Hash<Symbol => String>>] All of the results sorted by
+      #   the :sort_column option. (Defaults to :avg).
+      def column_sorted_body
+        runs = options[:show_all_runs] ? previous_run : current_run
+        runs.keys.each_with_object([]) do |description, obj|
+          timings = previous_run[description]
+          size = Array(timings).size
+          sum  = Array(timings).inject { |total, x| total + x }
+          obj << {
+            avg:  (sum / size).round(9),
+            min:  Array(timings).min.round(9),
+            max:  Array(timings).max.round(9),
+            last: Array(timings).last.round(9),
+            desc: description,
+          }
+        end.sort_by { |k| k[sort_column] }
+      end
+
+      # @return [Hash]
+      def options
+        defaults.merge!(@options)
+      end
+
+      # @return [Fixnum] The number of tests to output to output to the screen
+      #   after each run.
+      def show_count
+        options[:show_count]
+      end
+
+      # @return [Hash<String => Array<Float>]
+      def previous_run
+        @previous_run ||= YAML.load_file(previous_runs_filename)
+      end
+
+      # @return [String] The path to the file which contains all the durations
+      #   for each test run. The previous runs file is in YAML format, using the
+      #   test name for the key and an array containing the time taken to run
+      #   this test for values.
+      def previous_runs_filename
+        options[:previous_runs_filename]
+      end
+
+      # Returns a boolean indicating whether a previous runs file exists.
+      #
+      # @return [Boolean]
+      def previously_ran?
+        File.exist?(previous_runs_filename)
+      end
+
+      # @return [String] The path to the file which contains the parsed test
+      #   results. The results file contains a line for each test with the
+      #   average time of the test, the minimum time the test took to run,
+      #   the maximum time the test took to run and a description of the test
+      #   (which is the test name as emitted by Minitest).
+      def report_filename
+        options[:report_filename]
+      end
+
+      # A barbaric way to find out how many runs are in the previous runs file;
+      # this method takes the first test listed, and counts its samples
+      # trusting (naively) all runs to be the same number of samples. This will
+      # produce incorrect averages when new tests are added, so it is advised
+      # to restart the statistics by removing the 'previous runs' file. A rake
+      # task is provided to make this more convenient.
+      #
+      #    rake reset_statistics
+      #
+      # @return [Fixnum]
+      def samples
+        return 1 unless previous_run.first[1].is_a?(Array)
+
+        previous_run.first[1].size
+      end
+
+      # Creates a new 'previous runs' file, or updates the existing one with
+      # the latest timings.
+      #
+      # @return [void]
+      def create_or_update_previous_runs!
+        if previously_ran?
+          current_run.each do |description, elapsed|
+          new_times = if previous_run["#{description}"]
+                        Array(previous_run["#{description}"]) << elapsed
+
+                      else
+                        Array(elapsed)
+
+                      end
+
+            previous_run.store("#{description}", new_times)
+          end
+
+          File.write(previous_runs_filename, previous_run.to_yaml)
+
+        else
+
+          File.write(previous_runs_filename, current_run.to_yaml)
+
+        end
+      end
+
+      # Creates a new report file in the 'report_filename'. This file contains
+      # a line for each test of the following example format: (this is a single
+      # line despite explicit wrapping)
+      #
+      # Avg: 0.0555555 Min: 0.0498765 Max: 0.0612345 Last: 0.0499421
+      # Description: The test name
+      #
+      # Note however the timings are to 9 decimal places, and padded to 12
+      # characters and each label is coloured, Avg (yellow), Min (green),
+      # Max (red), Last (multi), and Description (blue). It looks pretty!
+      #
+      # The 'Last' label is special in that it will be colour coded depending
+      # on whether the last run was faster (bright green) or slower (bright red)
+      # or inconclusive (purple). This helps to identify changes on a per run
+      # basis.
+      #
+      # @return [void]
+      def create_new_report!
+        File.write(report_filename, report_title + report_body)
+      end
+
+      # Writes a number of tests (configured via the 'show_count' option) to the
+      # screen after creating the report. See '#create_new_report!' for example
+      # output information.
+      #
+      # @return [void]
+      def write_to_screen!
+        puts report_title
+        puts report_body.lines.take(show_count)
+      end
+
+      # @return [String] A yellow 'Avg:' label.
+      def avg_label
+        ANSI::Code.yellow('Avg:')
+      end
+
+      # @return [String] A blue 'Description:' label.
+      def des_label
+        ANSI::Code.blue('Description:')
+      end
+
+      # @return [String] A red 'Max:' label.
+      def max_label
+        ANSI::Code.red('Max:')
+      end
+
+      # @return [String] A green 'Min:' label.
+      def min_label
+        ANSI::Code.green('Min:')
+      end
+
+      # @param rating [Symbol] One of :faster, :slower or :inconclusive.
+      # @return [String] A purple 'Last:' label.
+      def run_label(rating)
+        case rating
+        when :faster then ANSI::Code.green('Last:')
+        when :slower then ANSI::Code.red('Last:')
+        else
+          ANSI::Code.magenta('Last:')
+        end
+      end
+
+      # @param run [Float] The last run time.
+      # @param min [Float] The minimum run time.
+      # @param max [Float] The maximum run time.
+      # @return [Symbol] One of :faster, :slower or :inconclusive.
+      def rate(run, min, max)
+        if run == min
+          :faster
+        elsif run == max
+          :slower
+        else
+          :inconclusive
+        end
+      end
+
+      # @return [Boolean] Whether the given :order option is :asc.
+      def asc?
+        order == :asc
+      end
+
+      # @return [Boolean] Whether the given :order option is :desc (default).
+      def desc?
+        order == :desc
+      end
+
+      # @raise [Minitest::Reporters::MeanTimeReporter::InvalidOrder]
+      #   When the given :order option is invalid.
+      # @return [Symbol] The :order option, or by default; :desc.
+      def order
+        orders = [:desc, :asc]
+
+        if orders.include?(options[:order])
+          options[:order]
+
+        else
+          fail Minitest::Reporters::MeanTimeReporter::InvalidOrder,
+               "`:order` option must be one of #{orders.inspect}."
+
+        end
+      end
+
+      # @raise [Minitest::Reporters::MeanTimeReporter::InvalidSortColumn]
+      #   When the given :sort_column option is invalid.
+      # @return [Symbol] The :sort_column option, or by default; :avg.
+      def sort_column
+        sort_columns = [:avg, :min, :max, :last]
+
+        if sort_columns.include?(options[:sort_column])
+          options[:sort_column]
+
+        else
+          fail Minitest::Reporters::MeanTimeReporter::InvalidSortColumn,
+               "`:sort_column` option must be one of #{sort_columns.inspect}."
+
+        end
+      end
+
+    end
+  end
+end