minitest / 5.11.3 / minitest / runnable.html /

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 ::runnables.


assertions [RW]

Number of assertions executed in this run.

failures [RW]

An assertion raised during the run, if any.

time [RW]

The time it took to run.

Public Class Methods

methods_matching (re) Show source
# File lib/minitest.rb, line 287
def self.methods_matching re

Returns all instance methods matching the pattern re.

run (reporter, options = {}) Show source
# File lib/minitest.rb, line 302
def reporter, options = {}
  filter = options[:filter] || "/./"
  filter = $1 if filter =~ %r%/(.*)/%

  filtered_methods = self.runnable_methods.find_all { |m|
    filter === m || filter === "#{self}##{m}"

  exclude = options[:exclude]
  exclude = $1 if exclude =~ %r%/(.*)/%

  filtered_methods.delete_if { |m|
    exclude === m || exclude === "#{self}##{m}"

  return if filtered_methods.empty?

  with_info_handler reporter do
    filtered_methods.each do |method_name|
      run_one_method self, method_name, reporter

Responsible for running all runnable methods in a given class, each in its own instance. Each instance is passed to the reporter to record.

run_one_method (klass, method_name, reporter) Show source
# File lib/minitest.rb, line 332
def self.run_one_method klass, method_name, reporter
  reporter.prerecord klass, method_name
  reporter.record Minitest.run_one_method(klass, method_name)

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.

runnable_methods () Show source
# File lib/minitest.rb, line 369
def self.runnable_methods
  raise NotImplementedError, "subclass responsibility"

Each subclass of Runnable is responsible for overriding this method to return all runnable methods. See methods_matching.

runnables () Show source
# File lib/minitest.rb, line 376
def self.runnables

Returns all subclasses of Runnable.

Public Instance Methods

name () Show source
# File lib/minitest.rb, line 273
def name

Name of the run.

name= (o) Show source
# File lib/minitest.rb, line 280
def name= o
  @NAME = o

Set the name of the run.

passed? () Show source
# File lib/minitest.rb, line 419
def passed?
  raise NotImplementedError, "subclass responsibility"

Did this run pass?

Note: skipped runs are not considered passing, but they don't cause the process to exit non-zero.

result_code () Show source
# File lib/minitest.rb, line 427
def result_code
  raise NotImplementedError, "subclass responsibility"

Returns a single character string to print based on the result of the run. Eg “.”, “F”, or “E”.

run () Show source
# File lib/minitest.rb, line 409
def run
  raise NotImplementedError, "subclass responsibility"

Runs a single method. Needs to return self.

skipped? () Show source
# File lib/minitest.rb, line 434
def skipped?
  raise NotImplementedError, "subclass responsibility"

Was this run skipped? See passed? for more information.

© Ryan Davis, seattle.rb
Licensed under the MIT License.