class Minitest::Runnable
Represents anything “runnable”, like Test
, Spec
, Benchmark
, or whatever you can dream up.
Subclasses of this are automatically registered and available in Runnable.runnables
.
Attributes
Number of assertions executed in this run.
An assertion raised during the run, if any.
The time it took to run.
Public Class Methods
Returns all instance methods matching the pattern re
.
# File lib/minitest.rb, line 318 def self.methods_matching re public_instance_methods(true).grep(re).map(&:to_s) end
Responsible for running all runnable methods in a given class, each in its own instance. Each instance is passed to the reporter to record.
# File lib/minitest.rb, line 333 def self.run reporter, options = {} filtered_methods = if options[:filter] filter = options[:filter] filter = Regexp.new $1 if filter.is_a?(String) && filter =~ %r%/(.*)/% self.runnable_methods.find_all { |m| filter === m || filter === "#{self}##{m}" } else self.runnable_methods end if options[:exclude] exclude = options[:exclude] exclude = Regexp.new $1 if exclude =~ %r%/(.*)/% filtered_methods.delete_if { |m| exclude === m || exclude === "#{self}##{m}" } end return if filtered_methods.empty? with_info_handler reporter do filtered_methods.each do |method_name| run_one_method self, method_name, reporter end end end
Runs a single method and has the reporter record the result. This was considered internal API but is factored out of run so that subclasses can specialize the running of an individual test. See Minitest::ParallelTest::ClassMethods for an example.
# File lib/minitest.rb, line 369 def self.run_one_method klass, method_name, reporter reporter.prerecord klass, method_name reporter.record Minitest.run_one_method(klass, method_name) end
Each subclass of Runnable is responsible for overriding this method to return all runnable methods. See methods_matching.
# File lib/minitest.rb, line 414 def self.runnable_methods raise NotImplementedError, "subclass responsibility" end
Returns all subclasses of Runnable.
# File lib/minitest.rb, line 421 def self.runnables @@runnables end
Defines the order to run tests (:random by default). Override this or use a convenience method to change it for your tests.
# File lib/minitest.rb, line 378 def self.test_order :random end
Public Instance Methods
Name of the run.
# File lib/minitest.rb, line 304 def name @NAME end
Set the name of the run.
# File lib/minitest.rb, line 311 def name= o @NAME = o end
Did this run pass?
Note: skipped runs are not considered passing, but they don’t cause the process to exit non-zero.
# File lib/minitest.rb, line 464 def passed? raise NotImplementedError, "subclass responsibility" end
Returns a single character string to print based on the result of the run. One of "."
, "F"
, "E"
or "S"
.
# File lib/minitest.rb, line 473 def result_code raise NotImplementedError, "subclass responsibility" end
Runs a single method. Needs to return self.
# File lib/minitest.rb, line 454 def run raise NotImplementedError, "subclass responsibility" end
Was this run skipped? See passed?
for more information.
# File lib/minitest.rb, line 480 def skipped? raise NotImplementedError, "subclass responsibility" end