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

- (Runner) initialize(options, configuration = RSpec.configuration, world = RSpec.world)

Returns a new instance of Runner

75
76
77
78
79
# File 'lib/rspec/core/runner.rb', line 75
def initialize(options, configuration=RSpec.configuration, world=RSpec.world)
  @options       = options
  @configuration = configuration
  @world         = world
end

Class Method Details

+ (void) autorun

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

+ (void) invoke

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

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

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
# 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[:runner]
    options.options[:runner].call(options, err, out)
  else
    new(options).run(err, out)
  end
end

Instance Method Details

- (void) run(err, out)

Configures and runs a spec suite.

Parameters:

  • err (IO)

    error stream

  • out (IO)

    output stream

85
86
87
88
89
90
# File 'lib/rspec/core/runner.rb', line 85
def run(err, out)
  setup(err, out)
  run_specs(@world.ordered_example_groups).tap do
    persist_example_statuses
  end
end

- (Fixnum) run_specs(example_groups)

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.

110
111
112
113
114
115
116
117
118
119
120
121
122
123
# File 'lib/rspec/core/runner.rb', line 110
def run_specs(example_groups)
  examples_count = @world.example_count(example_groups)
  success = @configuration.reporter.report(examples_count) do |reporter|
    @configuration.with_suite_hooks do
      if examples_count == 0 && @configuration.fail_if_no_examples
        return @configuration.failure_exit_code
      end
      example_groups.map { |g| g.run(reporter) }.all?
    end
  end && !@world.non_example_failure
  success ? 0 : @configuration.failure_exit_code
end

- (void) setup(err, out)

Wires together the various configuration objects and state holders.

Parameters:

  • err (IO)

    error stream

  • out (IO)

    output stream

96
97
98
99
100
101
102
# File 'lib/rspec/core/runner.rb', line 96
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