Class: RSpec::Core::Runner
- Inherits:
-
Object
- Object
- RSpec::Core::Runner
- Defined in:
- lib/rspec/core/runner.rb
Constant Summary collapse
- AT_EXIT_HOOK_BACKTRACE_LINE =
"#{__FILE__}:#{__LINE__ - 2}:in `autorun'"
Class Method Summary collapse
-
.autorun ⇒ Object
Register an at_exit hook that runs the suite.
-
.autorun_disabled? ⇒ Boolean
:nodoc:.
- .disable_autorun! ⇒ Object
-
.installed_at_exit? ⇒ Boolean
:nodoc:.
-
.run(args, err = $stderr, out = $stdout) ⇒ Object
Run a suite of RSpec examples.
-
.run_in_process(options, err, out) ⇒ Object
:nodoc:.
-
.run_over_drb(options, err, out) ⇒ Object
:nodoc:.
-
.running_in_drb? ⇒ Boolean
:nodoc:.
-
.trap_interrupt ⇒ Object
:nodoc:.
Class Method Details
.autorun ⇒ Object
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? @installed_at_exit = true at_exit { exit(run(ARGV, $stderr, $stdout).to_i) } end |
.autorun_disabled? ⇒ Boolean
:nodoc:
19 20 21 |
# File 'lib/rspec/core/runner.rb', line 19 def self.autorun_disabled? # :nodoc: @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
:nodoc:
23 24 25 |
# File 'lib/rspec/core/runner.rb', line 23 def self.installed_at_exit? # :nodoc: @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 = ConfigurationOptions.new(args) . if .[:drb] begin run_over_drb(, err, out) rescue DRb::DRbConnError err.puts "No DRb server is running. Running in local process instead ..." run_in_process(, err, out) end else run_in_process(, err, out) end ensure RSpec.reset end |
.run_in_process(options, err, out) ⇒ Object
:nodoc:
79 80 81 |
# File 'lib/rspec/core/runner.rb', line 79 def self.run_in_process(, err, out) # :nodoc: CommandLine.new(, RSpec::configuration, RSpec::world).run(err, out) end |
.run_over_drb(options, err, out) ⇒ Object
:nodoc:
75 76 77 |
# File 'lib/rspec/core/runner.rb', line 75 def self.run_over_drb(, err, out) # :nodoc: DRbCommandLine.new().run(err, out) end |
.running_in_drb? ⇒ Boolean
:nodoc:
27 28 29 30 |
# File 'lib/rspec/core/runner.rb', line 27 def self.running_in_drb? # :nodoc: (DRb.current_server rescue false) && DRb.current_server.uri =~ /druby\:\/\/127.0.0.1\:/ end |
.trap_interrupt ⇒ Object
:nodoc:
32 33 34 35 36 37 38 |
# File 'lib/rspec/core/runner.rb', line 32 def self.trap_interrupt # :nodoc: 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 |