class RSpec::Core::Runner
def self.autorun
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
def self.autorun_disabled?
def self.autorun_disabled? @autorun_disabled ||= false end
def self.disable_autorun!
def self.disable_autorun! @autorun_disabled = true end
def self.installed_at_exit?
def self.installed_at_exit? @installed_at_exit ||= false end
def self.run(args, err=$stderr, out=$stdout)
#### Returns
* +out+ - output stream (Default: $stdout)
* +err+ - error stream (Default: $stderr)
* +args+ - an array of command-line-supported arguments
#### Parameters
instead of `require`.
want files like spec_helper.rb to be reloaded, be sure to load `load`
If you want to run this multiple times in the same process, and you
for use by any other automation tool.
This is used internally by RSpec to run a suite, but is available
Run a suite of RSpec examples.
def self.run(args, err=$stderr, out=$stdout) warn_about_calling_reset if RSpec.resets_required > 0 RSpec.resets_required += 1 trap_interrupt options = ConfigurationOptions.new(args) options.parse_options 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 options.options[:drb] require 'rspec/core/drb_command_line' begin DRbCommandLine.new(options).run(err, out) rescue DRb::DRbConnError err.puts "No DRb server is running. Running in local process instead ..." new(options).run(err, out) end else new(options).run(err, out) end ensure RSpec.internal_reset end
def self.running_in_drb?
def self.running_in_drb? defined?(DRb) && (DRb.current_server rescue false) && DRb.current_server.uri =~ /druby\:\/\/127.0.0.1\:/ end
def self.trap_interrupt
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
def self.warn_about_calling_reset
- Private: -
def self.warn_about_calling_reset RSpec.configuration.deprecation_stream.puts(<<-EOD) g `RSpec::Core::Runner.run` will no longer implicitly invoke .reset` as of RSpec 3.0.0. If you need RSpec to be reset between your to `RSpec::Core::Runner.run` please invoke `RSpec.reset` manually in the riate place. EOD end
def initialize(options, configuration=RSpec::configuration, world=RSpec::world)
def initialize(options, configuration=RSpec::configuration, world=RSpec::world) @options = options @configuration = configuration @world = world end
def run(err, out)
-
out
(IO
) -- -
err
(IO
) --
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