Module: Minitest

Relationships & Source Files
Namespace Children
Classes: `BacktraceFilterWithFallback`, `ProfileReporter`, `SuppressedSummaryReporter`
Defined in:	railties/lib/minitest/rails_plugin.rb

Class Attribute Summary

.run_via (also: #run_via) readonly

Backwards compatibility with ::Rails 5.0 generated plugin test scripts.

Class Method Summary

.plugin_rails_init(options)

Owes great inspiration to test runner trailblazers like RSpec, minitest-reporters, maxitest, and others.
.plugin_rails_options(opts, options)

Instance Attribute Summary

#run_via readonly

Class Attribute Details

.run_via (readonly) Also known as: #run_via

Backwards compatibility with ::Rails 5.0 generated plugin test scripts

[ GitHub ]

# File 'railties/lib/minitest/rails_plugin.rb', line 139


mattr_reader :run_via, default: {}

Class Method Details

.plugin_rails_init(options)

Owes great inspiration to test runner trailblazers like RSpec, minitest-reporters, maxitest, and others.

[ GitHub ]

# File 'railties/lib/minitest/rails_plugin.rb', line 111


def self.plugin_rails_init(options)
  # Don't mess with Minitest unless RAILS_ENV is set
  return unless ENV["RAILS_ENV"] || ENV["RAILS_MINITEST_PLUGIN"]

  unless options[:full_backtrace]
    # Plugin can run without Rails loaded, check before filtering.
    if ::Rails.respond_to?(:backtrace_cleaner)
      Minitest.backtrace_filter = BacktraceFilterWithFallback.new(::Rails.backtrace_cleaner, Minitest.backtrace_filter)
    end
  end

  # Suppress summary reports when outputting inline rerun snippets.
  if reporter.reporters.reject! { |reporter| reporter.kind_of?(SummaryReporter) }
    reporter << SuppressedSummaryReporter.new(options[:io], options)
  end

  # Replace progress reporter for colors.
  if reporter.reporters.reject! { |reporter| reporter.kind_of?(ProgressReporter) }
    reporter << ::Rails::TestUnitReporter.new(options[:io], options)
  end

  # Add slowest tests reporter at the end.
  if options[:profile]
    reporter << ProfileReporter.new(options[:io], options)
  end
end

.plugin_rails_options(opts, options)

[ GitHub ]

# File 'railties/lib/minitest/rails_plugin.rb', line 68


def self.plugin_rails_options(opts, options)
  ::Rails::TestUnit::Runner.attach_before_load_options(opts)

  opts.on("-b", "--backtrace", "Show the complete backtrace") do
    options[:full_backtrace] = true
  end

  opts.on("-d", "--defer-output", "Output test failures and errors after the test run") do
    options[:output_inline] = false
  end

  opts.on("-f", "--fail-fast", "Abort test run on first failure or error") do
    options[:fail_fast] = true
  end

  opts.on("-c", "--[no-]color", "Enable color in the output") do |value|
    options[:color] = value
  end

  opts.on("--profile [COUNT]", "Enable profiling of tests and list the slowest test cases (default: 10)") do |value|
    default_count = 10

    if value.nil?
      count = default_count
    else
      count = Integer(value, exception: false)
      if count.nil?
        warn("Non integer specified as profile count, separate " \
             "your path from options with -- e.g. " \
             "`#{::Rails::TestUnitReporter.executable} --profile -- #{value}`")
        count = default_count
      end
    end

    options[:profile] = count
  end

  options[:color] = true
  options[:output_inline] = true
end

Instance Attribute Details

#run_via (readonly)

[ GitHub ]

# File 'railties/lib/minitest/rails_plugin.rb', line 139


mattr_reader :run_via, default: {}