Class: RSpec::Core::Runner

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

Constant Summary collapse

AT_EXIT_HOOK_BACKTRACE_LINE =
"#{__FILE__}:#{__LINE__ - 2}:in `autorun'"

Class Method Summary collapse

Class Method Details

.autorunObject

Register an at_exit hook that runs the suite.


8
9
10
11
12
# File 'lib/rspec/core/runner.rb', line 8

def self.autorun
  return if autorun_disabled? || installed_at_exit? || running_in_drb?
  at_exit { exit run(ARGV, $stderr, $stdout).to_i }
  @installed_at_exit = true
end

.autorun_disabled?Boolean

Returns:

  • (Boolean)

19
20
21
# File 'lib/rspec/core/runner.rb', line 19

def self.autorun_disabled?
  @autorun_disabled ||= false
end

.disable_autorun!Object


15
16
17
# File 'lib/rspec/core/runner.rb', line 15

def self.disable_autorun!
  @autorun_disabled = true
end

.installed_at_exit?Boolean

Returns:

  • (Boolean)

23
24
25
# File 'lib/rspec/core/runner.rb', line 23

def self.installed_at_exit?
  @installed_at_exit ||= false
end

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

Run a suite of RSpec examples.

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 - an array of command-line-supported arguments

  • err - error stream (Default: $stderr)

  • out - output stream (Default: $stdout)

#### Returns

  • Fixnum - exit status code (0/1)


56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# File 'lib/rspec/core/runner.rb', line 56

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

  if options.options[:drb]
    begin
      run_over_drb(options, err, out)
    rescue DRb::DRbConnError
      err.puts "No DRb server is running. Running in local process instead ..."
      run_in_process(options, err, out)
    end
  else
    run_in_process(options, err, out)
  end
ensure
  RSpec.reset
end

.run_in_process(options, err, out) ⇒ Object


79
80
81
# File 'lib/rspec/core/runner.rb', line 79

def self.run_in_process(options, err, out)
  CommandLine.new(options, RSpec::configuration, RSpec::world).run(err, out)
end

.run_over_drb(options, err, out) ⇒ Object


75
76
77
# File 'lib/rspec/core/runner.rb', line 75

def self.run_over_drb(options, err, out)
  DRbCommandLine.new(options).run(err, out)
end

.running_in_drb?Boolean

Returns:

  • (Boolean)

27
28
29
30
# File 'lib/rspec/core/runner.rb', line 27

def self.running_in_drb?
  (DRb.current_server rescue false) &&
   DRb.current_server.uri =~ /druby\:\/\/127.0.0.1\:/
end

.trap_interruptObject


32
33
34
35
36
37
38
# File 'lib/rspec/core/runner.rb', line 32

def self.trap_interrupt
  trap('INT') do
    exit!(1) if RSpec.wants_to_quit
    RSpec.wants_to_quit = true
    STDERR.puts "\nExiting... Interrupt again to exit immediately."
  end
end