Class: RSpec::Core::Runner

Inherits:
Object
  • Object
show all
Defined in:
lib/rspec/core/runner.rb

Overview

Provides the main entry point to run a suite of RSpec examples.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options, configuration = RSpec.configuration, world = RSpec.world) ⇒ Runner

Returns a new instance of Runner



81
82
83
84
85
# File 'lib/rspec/core/runner.rb', line 81

def initialize(options, configuration=RSpec.configuration, world=RSpec.world)
  @options       = options
  @configuration = configuration
  @world         = world
end

Class Method Details

.autorunvoid

Note:

This is not generally needed. The rspec command takes care of running examples for you without involving an at_exit hook. This is only needed if you are running specs using the ruby command, and even then, the normal way to invoke this is by requiring rspec/autorun.

Register an at_exit hook that runs the suite when the process exits.



16
17
18
19
20
21
22
23
24
25
26
# File 'lib/rspec/core/runner.rb', line 16

def self.autorun
  if autorun_disabled?
    RSpec.deprecate("Requiring `rspec/autorun` when running RSpec via the `rspec` command")
    return
  elsif installed_at_exit? || running_in_drb?
    return
  end

  at_exit { perform_at_exit }
  @installed_at_exit = true
end

.invokevoid

Runs the suite of specs and exits the process with an appropriate exit code.



43
44
45
46
47
# File 'lib/rspec/core/runner.rb', line 43

def self.invoke
  disable_autorun!
  status = run(ARGV, $stderr, $stdout).to_i
  exit(status) if status != 0
end

.run(args, err = $stderr, out = $stdout) ⇒ Fixnum

Run a suite of RSpec examples. Does not exit.

This is used internally by RSpec to run a suite, but is available for use by any other automation tool.

If you want to run this multiple times in the same process, and you want files like spec_helper.rb to be reloaded, be sure to load load instead of require.

Parameters:

  • args (Array)

    command-line-supported arguments

  • err (IO) (defaults to: $stderr)

    error stream

  • out (IO) (defaults to: $stdout)

    output stream

Returns:

  • (Fixnum)

    exit status code. 0 if all specs passed, or the configured failure exit code (1 by default) if specs failed.



64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# File 'lib/rspec/core/runner.rb', line 64

def self.run(args, err=$stderr, out=$stdout)
  trap_interrupt
  options = ConfigurationOptions.new(args)

  if options.options[:drb]
    require 'rspec/core/drb'
    begin
      DRbRunner.new(options).run(err, out)
      return
    rescue DRb::DRbConnError
      err.puts "No DRb server is running. Running in local process instead ..."
    end
  end

  new(options).run(err, out)
end

Instance Method Details

#run(err, out) ⇒ void

Configures and runs a spec suite.

Parameters:

  • err (IO)

    error stream

  • out (IO)

    output stream



91
92
93
94
95
96
# File 'lib/rspec/core/runner.rb', line 91

def run(err, out)
  setup(err, out)
  run_specs(@world.ordered_example_groups).tap do
    persist_example_statuses
  end
end

#run_specs(example_groups) ⇒ Fixnum

Runs the provided example groups.

Parameters:

Returns:

  • (Fixnum)

    exit status code. 0 if all specs passed, or the configured failure exit code (1 by default) if specs failed.



116
117
118
119
120
121
122
# File 'lib/rspec/core/runner.rb', line 116

def run_specs(example_groups)
  @configuration.reporter.report(@world.example_count(example_groups)) do |reporter|
    @configuration.with_suite_hooks do
      example_groups.map { |g| g.run(reporter) }.all? ? 0 : @configuration.failure_exit_code
    end
  end
end

#setup(err, out) ⇒ void

Wires together the various configuration objects and state holders.

Parameters:

  • err (IO)

    error stream

  • out (IO)

    output stream



102
103
104
105
106
107
108
# File 'lib/rspec/core/runner.rb', line 102

def setup(err, out)
  @configuration.error_stream = err
  @configuration.output_stream = out if @configuration.output_stream == $stdout
  @options.configure(@configuration)
  @configuration.load_spec_files
  @world.announce_filters
end