123456789_123456789_123456789_123456789_123456789_

Class: Rails::TestUnit::Runner

Relationships & Source Files
Inherits: Object
Defined in: railties/lib/rails/test_unit/runner.rb

Constant Summary

Class Attribute Summary

Class Method Summary

Instance Attribute Summary

Class Attribute Details

.filters (readonly) Also known as: #filters

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 24

mattr_reader :filters, default: []

Class Method Details

.attach_before_load_options(opts)

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 27

def attach_before_load_options(opts)
  opts.on("--warnings", "-w", "Run with Ruby warnings enabled") { }
  opts.on("-e", "--environment ENV", "Run tests in the ENV environment") { }
end

.compose_filter(runnable, filter)

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 78

def compose_filter(runnable, filter)
  filter = normalize_declarative_test_filter(filter)

  if filters.any? { |_, lines| lines.any? }
    CompositeFilter.new(runnable, filter, filters)
  else
    filter
  end
end

.load_tests(argv)

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 57

def load_tests(argv)
  patterns = extract_filters(argv)
  tests = list_tests(patterns)
  tests.to_a.each do |path|
    abs_path = File.expand_path(path)
    require abs_path
  rescue LoadError => exception
    if exception.path == abs_path
      all_tests = list_tests([default_test_glob])
      corrections = DidYouMean::SpellChecker.new(dictionary: all_tests).correct(path)

      if corrections.empty?
        raise exception
      end
      raise InvalidTestError.new(path, DidYouMean::Formatter.message_for(corrections))
    else
      raise
    end
  end
end

.parse_options(argv)

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 32

def parse_options(argv)
  # Perform manual parsing and cleanup since option parser raises on unknown options.
  env_index = argv.index("--environment") || argv.index("-e")
  if env_index
    argv.delete_at(env_index)
    environment = argv.delete_at(env_index).strip
  end
  ENV["RAILS_ENV"] = environment || "test"

  w_index = argv.index("--warnings") || argv.index("-w")
  $VERBOSE = argv.delete_at(w_index) if w_index
end

.run(argv = [])

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 51

def run(argv = [])
  load_tests(argv)

  require "active_support/testing/autorun"
end

.run_from_rake(test_command, argv = [])

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 45

def run_from_rake(test_command, argv = [])
  # Ensure the tests run during the Rake Task action, not when the process exits
  success = system("rails", test_command, *argv, *Shellwords.split(ENV["TESTOPTS"] || ""))
  success || exit(false)
end

Instance Attribute Details

#filters (readonly)

[ GitHub ]

  
# File 'railties/lib/rails/test_unit/runner.rb', line 24

mattr_reader :filters, default: []