Class: RSpec::Core::Runner
- Inherits:
-
Object
- Object
- RSpec::Core::Runner
- Defined in:
- lib/rspec/core/runner.rb,
lib/rspec/core/command_line.rb
Direct Known Subclasses
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
- .disable_autorun! ⇒ Object
- .installed_at_exit? ⇒ Boolean
-
.run(args, err = $stderr, out = $stdout) ⇒ Object
Run a suite of RSpec examples.
- .running_in_drb? ⇒ Boolean
- .trap_interrupt ⇒ Object
Instance Method Summary collapse
-
#initialize(options, configuration = RSpec::configuration, world = RSpec::world) ⇒ Runner
constructor
A new instance of Runner.
-
#run(err, out) ⇒ Object
Configures and runs a suite.
Constructor Details
#initialize(options, configuration = RSpec::configuration, world = RSpec::world) ⇒ Runner
Returns a new instance of Runner.
4 5 6 7 8 |
# File 'lib/rspec/core/command_line.rb', line 4 def initialize(, configuration=RSpec::configuration, world=RSpec::world) @options = @configuration = configuration @world = world end |
Class Method Details
.autorun ⇒ Object
Register an at_exit hook that runs the suite.
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
# File 'lib/rspec/core/runner.rb', line 6 def self.autorun return if autorun_disabled? || installed_at_exit? || running_in_drb? at_exit do # Don't bother running any specs and just let the program terminate # if we got here due to an unrescued exception (anything other than # SystemExit, which is raised when somebody calls Kernel#exit). next unless $!.nil? || $!.kind_of?(SystemExit) # We got here because either the end of the program was reached or # somebody called Kernel#exit. Run the specs and then override any # existing exit status with RSpec's exit status if any specs failed. status = run(ARGV, $stderr, $stdout).to_i exit status if status != 0 end @installed_at_exit = true end |
.autorun_disabled? ⇒ Boolean
28 29 30 |
# File 'lib/rspec/core/runner.rb', line 28 def self.autorun_disabled? @autorun_disabled ||= false end |
.disable_autorun! ⇒ Object
24 25 26 |
# File 'lib/rspec/core/runner.rb', line 24 def self.disable_autorun! @autorun_disabled = true end |
.installed_at_exit? ⇒ Boolean
32 33 34 |
# File 'lib/rspec/core/runner.rb', line 32 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)
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/rspec/core/runner.rb', line 66 def self.run(args, err=$stderr, out=$stdout) trap_interrupt = ConfigurationOptions.new(args) . major, minor, point = RUBY_VERSION.split('.').map { |v| v.to_i } if major == 1 && ( (minor == 9 && point < 2) || (minor == 8 && point < 7) ) RSpec.deprecate "RSpec support for Ruby #{RUBY_VERSION}", :replacement => "1.8.7 or >= 1.9.2", :call_site => nil end if .[:drb] require 'rspec/core/drb_command_line' begin DRbCommandLine.new().run(err, out) rescue DRb::DRbConnError err.puts "No DRb server is running. Running in local process instead ..." new().run(err, out) end else new().run(err, out) end ensure RSpec.reset end |
.running_in_drb? ⇒ Boolean
36 37 38 39 40 |
# File 'lib/rspec/core/runner.rb', line 36 def self.running_in_drb? defined?(DRb) && (DRb.current_server rescue false) && DRb.current_server.uri =~ /druby\:\/\/127.0.0.1\:/ end |
Instance Method Details
#run(err, out) ⇒ Object
Configures and runs a suite
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 |
# File 'lib/rspec/core/command_line.rb', line 14 def run(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 @configuration.reporter.report(@world.example_count, @configuration.send(:_randomize?) ? @configuration.seed : nil) do |reporter| begin @configuration.run_hook(:before, :suite) @world.example_groups.ordered.map {|g| g.run(reporter)}.all? ? 0 : @configuration.failure_exit_code ensure @configuration.run_hook(:after, :suite) end end end |