opal-rspec 0.4.3 → 0.5.0.beta1

data/{vendor_lib → rspec-core/lib}/rspec/core/configuration.rb

@@ -1,10 +1,11 @@
-require 'fileutils'
-require 'rspec/core/backtrace_formatter'
-require 'rspec/core/ruby_project'
-require 'rspec/core/formatters/deprecation_formatter'
+RSpec::Support.require_rspec_core "backtrace_formatter"
+RSpec::Support.require_rspec_core "ruby_project"
+RSpec::Support.require_rspec_core "formatters/deprecation_formatter"
 
 module RSpec
   module Core
+    # rubocop:disable Style/ClassLength
+
     # Stores runtime configuration information.
     #
     # Configuration options are loaded from `~/.rspec`, `.rspec`,
@@ -21,9 +22,9 @@ module RSpec
     #
     # @example Hooks
     #     RSpec.configure do |c|
-    #       c.before(:suite) { establish_connection }
-    #       c.before(:each)  { log_in_as :authorized }
-    #       c.around(:each)  { |ex| Database.transaction(&ex) }
+    #       c.before(:suite)   { establish_connection }
+    #       c.before(:example) { log_in_as :authorized }
+    #       c.around(:example) { |ex| Database.transaction(&ex) }
     #     end
     #
     # @see RSpec.configure
@@ -31,6 +32,7 @@ module RSpec
     class Configuration
       include RSpec::Core::Hooks
 
+      # @private
       class MustBeConfiguredBeforeExampleGroupsError < StandardError; end
 
       # @private
@@ -41,11 +43,6 @@ module RSpec
         end
       end
 
-      # @private
-      def self.deprecate_alias_key
-        RSpec.deprecate("add_setting with :alias option", :replacement => ":alias_with")
-      end
-
       # @private
       def self.define_aliases(name, alias_name)
         alias_method alias_name, name
@@ -55,7 +52,7 @@ module RSpec
 
       # @private
       def self.define_predicate_for(*names)
-        names.each {|name| alias_method "#{name}?", name}
+        names.each { |name| alias_method "#{name}?", name }
       end
 
       # @private
@@ -63,30 +60,38 @@ module RSpec
       # Invoked by the `add_setting` instance method. Use that method on a
       # `Configuration` instance rather than this class method.
       def self.add_setting(name, opts={})
-        raise "Use the instance add_setting method if you want to set a default" if opts.has_key?(:default)
-        if opts[:alias]
-          deprecate_alias_key
-          define_aliases(opts[:alias], name)
-        else
-          attr_writer name
-          define_reader name
-          define_predicate_for name
-        end
+        raise "Use the instance add_setting method if you want to set a default" if opts.key?(:default)
+        attr_writer name
+        add_read_only_setting name
+
         Array(opts[:alias_with]).each do |alias_name|
           define_aliases(name, alias_name)
         end
       end
 
+      # @private
+      #
+      # As `add_setting` but only add the reader
+      def self.add_read_only_setting(name, opts={})
+        raise "Use the instance add_setting method if you want to set a default" if opts.key?(:default)
+        define_reader name
+        define_predicate_for name
+      end
+
       # @macro [attach] add_setting
-      #   @attribute $1
+      #   @!attribute [rw] $1
+      #   @!method $1=(value)
       #
       # @macro [attach] define_reader
-      #   @attribute $1
+      #   @!attribute [r] $1
 
       # @macro add_setting
       # Path to use if no path is provided to the `rspec` command (default:
       # `"spec"`). Allows you to just type `rspec` instead of `rspec spec` to
       # run all the examples in the `spec` directory.
+      #
+      # Note: Other scripts invoking `rspec` indirectly will ignore this
+      # setting.
       add_setting :default_path
 
       # @macro add_setting
@@ -102,9 +107,44 @@ module RSpec
       # Default: `$stderr`.
       add_setting :error_stream
 
-      # @macro add_setting
-      # Default: `$stderr`.
-      add_setting :deprecation_stream
+      # Indicates if the DSL has been exposed off of modules and `main`.
+      # Default: true
+      def expose_dsl_globally?
+        Core::DSL.exposed_globally?
+      end
+
+      # Use this to expose the core RSpec DSL via `Module` and the `main`
+      # object. It will be set automatically but you can override it to
+      # remove the DSL.
+      # Default: true
+      def expose_dsl_globally=(value)
+        if value
+          Core::DSL.expose_globally!
+          Core::SharedExampleGroup::TopLevelDSL.expose_globally!
+        else
+          Core::DSL.remove_globally!
+          Core::SharedExampleGroup::TopLevelDSL.remove_globally!
+        end
+      end
+
+      # Determines where deprecation warnings are printed.
+      # Defaults to `$stderr`.
+      # @return [IO, String] IO to write to or filename to write to
+      define_reader :deprecation_stream
+
+      # Determines where deprecation warnings are printed.
+      # @param value [IO, String] IO to write to or filename to write to
+      def deprecation_stream=(value)
+        if @reporter && !value.equal?(@deprecation_stream)
+          warn "RSpec's reporter has already been initialized with " \
+            "#{deprecation_stream.inspect} as the deprecation stream, so your change to "\
+            "`deprecation_stream` will be ignored. You should configure it earlier for " \
+            "it to take effect, or use the `--deprecation-out` CLI option. " \
+            "(Called from #{CallerFilter.first_non_rspec_line})"
+        else
+          @deprecation_stream = value
+        end
+      end
 
       # @macro add_setting
       # Clean up and exit after the first failure (default: `false`).
@@ -124,35 +164,46 @@ module RSpec
       define_reader :requires
 
       # @macro define_reader
-      # Returns dirs that have been prepended to the load path by #lib=
+      # Returns dirs that have been prepended to the load path by the `-I` command line option
       define_reader :libs
 
       # @macro add_setting
+      # Determines where RSpec will send its output.
       # Default: `$stdout`.
-      # Also known as `output` and `out`
       define_reader :output_stream
+
+      # Set the output stream for reporter
+      # @attr value [IO] value for output, defaults to $stdout
       def output_stream=(value)
         if @reporter && !value.equal?(@output_stream)
-          warn "RSpec's reporter has already been initialized with " +
-            "#{output_stream.inspect} as the output stream, so your change to "+
-            "`output_stream` will be ignored. You should configure it earlier for " +
+          warn "RSpec's reporter has already been initialized with " \
+            "#{output_stream.inspect} as the output stream, so your change to "\
+            "`output_stream` will be ignored. You should configure it earlier for " \
             "it to take effect. (Called from #{CallerFilter.first_non_rspec_line})"
         else
           @output_stream = value
         end
       end
 
-      # @macro add_setting
-      # Load files matching this pattern (default: `'**/*_spec.rb'`)
-      add_setting :pattern, :alias_with => :filename_pattern
+      # @macro define_reader
+      # Load files matching this pattern (default: `'**{,/*/**}/*_spec.rb'`)
+      define_reader :pattern
 
-      def pattern= value
-        if @spec_files_loaded
-          RSpec.warning "Configuring `pattern` to #{value} has no effect since RSpec has already loaded the spec files."
-        end
-        @pattern = value
+      # Set pattern to match files to load
+      # @attr value [String] the filename pattern to filter spec files by
+      def pattern=(value)
+        update_pattern_attr :pattern, value
+      end
+
+      # @macro define_reader
+      # Exclude files matching this pattern
+      define_reader :exclude_pattern
+
+      # Set pattern to match files to exclude
+      # @attr value [String] the filename pattern to exclude spec files by
+      def exclude_pattern=(value)
+        update_pattern_attr :exclude_pattern, value
       end
-      alias :filename_pattern= :pattern=
 
       # @macro add_setting
       # Report the times for the slowest examples (default: `false`).
@@ -165,52 +216,64 @@ module RSpec
 
       # @macro add_setting
       # Color to use to indicate success.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:green` but can be set to one of the
+      #                       following: `[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :success_color
 
       # @macro add_setting
       # Color to use to print pending examples.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:yellow` but can be set to one of the
+      #                       following: `[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :pending_color
 
       # @macro add_setting
       # Color to use to indicate failure.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:red` but can be set to one of the
+      #                       following: `[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :failure_color
 
       # @macro add_setting
       # The default output color.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:white` but can be set to one of the
+      #                       following:`[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :default_color
 
       # @macro add_setting
       # Color used when a pending example is fixed.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:blue` but can be set to one of the
+      #                       following: `[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :fixed_color
 
       # @macro add_setting
       # Color used to print details.
-      # @param [Symbol] color one of the following: [:black, :white, :red, :green, :yellow, :blue, :magenta, :cyan]
+      # @param color [Symbol] defaults to `:cyan` but can be set to one of the
+      #                       following: `[:black, :white, :red, :green, :yellow,
+      #                       :blue, :magenta, :cyan]`
       add_setting :detail_color
 
-      # @macro add_setting
-      # When a block passed to pending fails (as expected), display the failure
-      # without reporting it as a failure (default: false).
-      add_setting :show_failures_in_pending_blocks
-
       # Deprecated. This config option was added in RSpec 2 to pave the way
       # for this being the default behavior in RSpec 3. Now this option is
       # a no-op.
-      def treat_symbols_as_metadata_keys_with_true_values=(value)
-        RSpec.deprecate("RSpec::Core::Configuration#treat_symbols_as_metadata_keys_with_true_values=")
+      def treat_symbols_as_metadata_keys_with_true_values=(_value)
+        RSpec.deprecate("RSpec::Core::Configuration#treat_symbols_as_metadata_keys_with_true_values=",
+                        :message => "RSpec::Core::Configuration#treat_symbols_as_metadata_keys_with_true_values= " \
+                                    "is deprecated, it is now set to true as default and setting it to false has no effect.")
       end
 
+      # Record the start time of the spec suite to measure load time
+      add_setting :start_time
+
       # @private
       add_setting :tty
       # @private
       add_setting :include_or_extend_modules
       # @private
-      add_setting :files_to_run
+      attr_writer :files_to_run
       # @private
       add_setting :expecting_with_rspec
       # @private
@@ -218,19 +281,17 @@ module RSpec
       # @private
       attr_reader :backtrace_formatter, :ordering_manager
 
-      # Alias for rspec-2.x's backtrace_cleaner (now backtrace_formatter)
-      #
-      # TODO: consider deprecating and removing this rather than aliasing in rspec-3?
-      alias backtrace_cleaner backtrace_formatter
-
       def initialize
+        # rubocop:disable Style/GlobalVars
+        @start_time = $_rspec_core_load_started_at || ::RSpec::Core::Time.now
+        # rubocop:enable Style/GlobalVars
         @expectation_frameworks = []
         @include_or_extend_modules = []
         @mock_framework = nil
-        @files_to_run = []
-        @formatters = []
+        @files_or_directories_to_run = []
         @color = false
-        @pattern = '**/*_spec.rb'
+        @pattern = '**{,/*/**}/*_spec.rb'
+        @exclude_pattern = ''
         @failure_exit_code = 1
         @spec_files_loaded = false
 
@@ -240,6 +301,7 @@ module RSpec
         @deprecation_stream = $stderr
         @output_stream = $stdout
         @reporter = nil
+        @reporter_buffer = nil
         @filter_manager = FilterManager.new
         @ordering_manager = Ordering::ConfigurationManager.new
         @preferred_options = {}
@@ -252,6 +314,7 @@ module RSpec
         @profile_examples = false
         @requires = []
         @libs = []
+        @derived_metadata_blocks = []
       end
 
       # @private
@@ -260,14 +323,13 @@ module RSpec
       def force(hash)
         ordering_manager.force(hash)
         @preferred_options.merge!(hash)
-        self.warnings = value_for :warnings, nil
       end
 
       # @private
       def reset
         @spec_files_loaded = false
         @reporter = nil
-        @formatters.clear
+        @formatter_loader = nil
       end
 
       # @overload add_setting(name)
@@ -307,15 +369,21 @@ module RSpec
       #     RSpec.configuration.foo? # returns true if foo returns anything but nil or false
       def add_setting(name, opts={})
         default = opts.delete(:default)
-        (class << self; self; end).class_eval do
+        (class << self; self; end).class_exec do
           add_setting(name, opts)
         end
-        send("#{name}=", default) if default
+        __send__("#{name}=", default) if default
       end
 
       # Returns the configured mock framework adapter module
       def mock_framework
-        mock_with :rspec unless @mock_framework
+        if @mock_framework.nil?
+          begin
+            mock_with :rspec
+          rescue LoadError
+            mock_with :nothing
+          end
+        end
         @mock_framework
       end
 
@@ -339,6 +407,8 @@ module RSpec
         @backtrace_formatter.exclusion_patterns
       end
 
+      # Set regular expressions used to exclude lines in backtrace
+      # @param patterns [Regexp] set the backtrace exlusion pattern
       def backtrace_exclusion_patterns=(patterns)
         @backtrace_formatter.exclusion_patterns = patterns
       end
@@ -355,10 +425,43 @@ module RSpec
         @backtrace_formatter.inclusion_patterns
       end
 
+      # Set regular expressions used to include lines in backtrace
+      # @attr patterns [Regexp] set backtrace_formatter inclusion_patterns
       def backtrace_inclusion_patterns=(patterns)
         @backtrace_formatter.inclusion_patterns = patterns
       end
 
+      # Adds {#backtrace_exclusion_patterns} that will filter lines from
+      # the named gems from backtraces.
+      #
+      # @param gem_names [Array<String>] Names of the gems to filter
+      #
+      # @example
+      #   RSpec.configure do |config|
+      #     config.filter_gems_from_backtrace "rack", "rake"
+      #   end
+      #
+      # @note The patterns this adds will match the named gems in their common
+      #   locations (e.g. system gems, vendored with bundler, installed as a
+      #   :git dependency with bundler, etc) but is not guaranteed to work for
+      #   all possible gem locations. For example, if you have the gem source
+      #   in a directory with a completely unrelated name, and use bundler's
+      #   :path option, this will not filter it.
+      def filter_gems_from_backtrace(*gem_names)
+        gem_names.each do |name|
+          @backtrace_formatter.filter_gem(name)
+        end
+      end
+
+      # @private
+      MOCKING_ADAPTERS = {
+        :rspec    => :RSpec,
+        :flexmock => :Flexmock,
+        :rr       => :RR,
+        :mocha    => :Mocha,
+        :nothing  => :Null
+      }
+
       # Sets the mock framework adapter module.
       #
       # `framework` can be a Symbol or a Module.
@@ -376,8 +479,8 @@ module RSpec
       #       - called before each example
       #
       #     verify_mocks_for_rspec
-      #       - called after each example. Framework should raise an exception
-      #         when expectations fail
+      #       - called after each example if the example hasn't yet failed.
+      #         Framework should raise an exception when expectations fail
       #
       #     teardown_mocks_for_rspec
       #       - called after verify_mocks_for_rspec (even if there are errors)
@@ -389,24 +492,19 @@ module RSpec
       #       mod_config.custom_setting = true
       #     end
       def mock_with(framework)
-        framework_module = case framework
-        when Module
-          framework
-        when String, Symbol
-          require case framework.to_s
-                  when /rspec/i
-                    'rspec/core/mocking/with_rspec'
-                  when /mocha/i
-                    'rspec/core/mocking/with_mocha'
-                  when /rr/i
-                    'rspec/core/mocking/with_rr'
-                  when /flexmock/i
-                    'rspec/core/mocking/with_flexmock'
-                  else
-                    'rspec/core/mocking/with_absolutely_nothing'
-                  end
-          RSpec::Core::MockFrameworkAdapter
-        end
+        framework_module =
+          if framework.is_a?(Module)
+            framework
+          else
+            const_name = MOCKING_ADAPTERS.fetch(framework) do
+              raise ArgumentError,
+                    "Unknown mocking framework: #{framework.inspect}. " \
+                    "Pass a module or one of #{MOCKING_ADAPTERS.keys.inspect}"
+            end
+
+            RSpec::Support.require_rspec_core "mocking_adapters/#{const_name.to_s.downcase}"
+            RSpec::Core::MockingAdapters.const_get(const_name)
+          end
 
         new_name, old_name = [framework_module, @mock_framework].map do |mod|
           mod.respond_to?(:framework_name) ?  mod.framework_name : :unnamed
@@ -426,7 +524,13 @@ module RSpec
 
       # Returns the configured expectation framework adapter module(s)
       def expectation_frameworks
-        expect_with :rspec if @expectation_frameworks.empty?
+        if @expectation_frameworks.empty?
+          begin
+            expect_with :rspec
+          rescue LoadError
+            expect_with Module.new
+          end
+        end
         @expectation_frameworks
       end
 
@@ -438,16 +542,17 @@ module RSpec
       # Sets the expectation framework module(s) to be included in each example
       # group.
       #
-      # `frameworks` can be `:rspec`, `:stdlib`, a custom module, or any
-      # combination thereof:
+      # `frameworks` can be `:rspec`, `:test_unit`, `:minitest`, a custom
+      # module, or any combination thereof:
       #
       #     config.expect_with :rspec
-      #     config.expect_with :stdlib
-      #     config.expect_with :rspec, :stdlib
+      #     config.expect_with :test_unit
+      #     config.expect_with :minitest
+      #     config.expect_with :rspec, :minitest
       #     config.expect_with OtherExpectationFramework
       #
-      # RSpec will translate `:rspec` and `:stdlib` into the appropriate
-      # modules.
+      # RSpec will translate `:rspec`, `:minitest`, and `:test_unit` into the
+      # appropriate modules.
       #
       # ## Configuration
       #
@@ -466,9 +571,12 @@ module RSpec
             require 'rspec/expectations'
             self.expecting_with_rspec = true
             ::RSpec::Matchers
-          when :stdlib
-            require 'test/unit/assertions'
-            ::Test::Unit::Assertions
+          when :test_unit
+            require 'rspec/core/test_unit_assertions_adapter'
+            ::RSpec::Core::TestUnitAssertionsAdapter
+          when :minitest
+            require 'rspec/core/minitest_assertions_adapter'
+            ::RSpec::Core::MinitestAssertionsAdapter
           else
             raise ArgumentError, "#{framework.inspect} is not supported"
           end
@@ -487,39 +595,49 @@ module RSpec
         @expectation_frameworks.push(*modules)
       end
 
+      # Check if full backtrace is enabled
+      # @return [Boolean] is full backtrace enabled
       def full_backtrace?
         @backtrace_formatter.full_backtrace?
       end
 
+      # Toggle full backtrace
+      # @attr true_or_false [Boolean] toggle full backtrace display
       def full_backtrace=(true_or_false)
         @backtrace_formatter.full_backtrace = true_or_false
       end
 
-      def color(output=output_stream)
-        # rspec's built-in formatters all call this with the output argument,
-        # but defaulting to output_stream for backward compatibility with
-        # formatters in extension libs
-        return false unless output_to_tty?(output)
+      # Returns the configuration option for color, but should not
+      # be used to check if color is supported.
+      #
+      # @see color_enabled?
+      # @return [Boolean]
+      def color
         value_for(:color, @color)
       end
 
-      def color=(bool)
-        if bool
-          if RSpec.windows_os? and not ENV['ANSICON']
-            RSpec.warning "You must use ANSICON 1.31 or later (http://adoxa.3eeweb.com/ansicon/) to use colour on Windows"
-            @color = false
-          else
-            @color = true
-          end
-        end
+      # Check if color is enabled for a particular output
+      # @param output [IO] an output stream to use, defaults to the current
+      #        `output_stream`
+      # @return [Boolean]
+      def color_enabled?(output=output_stream)
+        output_to_tty?(output) && color
       end
 
-      # TODO - deprecate color_enabled - probably not until the last 2.x
-      # release before 3.0
-      alias_method :color_enabled, :color
-      alias_method :color_enabled=, :color=
-      define_predicate_for :color_enabled, :color
+      # Toggle output color
+      # @attr true_or_false [Boolean] toggle color enabled
+      def color=(true_or_false)
+        return unless true_or_false
+
+        if RSpec.world.windows_os? && !ENV['ANSICON']
+          RSpec.warning "You must use ANSICON 1.31 or later (http://adoxa.3eeweb.com/ansicon/) to use colour on Windows"
+          @color = false
+        else
+          @color = true
+        end
+      end
 
+      # @private
       def libs=(libs)
         libs.map do |lib|
           @libs.unshift lib
@@ -527,26 +645,13 @@ module RSpec
         end
       end
 
-      def requires=(paths)
-        RSpec.deprecate("RSpec::Core::Configuration#requires=(paths)",
-                        :replacement => "paths.each {|path| require path}")
-        paths.map {|path| require path}
-        @requires += paths
-      end
-
-      # Run examples defined on `line_numbers` in all files to run.
-      def line_numbers=(line_numbers)
-        filter_run :line_numbers => line_numbers.map{|l| l.to_i}
-      end
-
-      def line_numbers
-        filter.fetch(:line_numbers,[])
-      end
-
+      # Run examples matching on `description` in all files to run.
+      # @param description [String, Regexp] the pattern to filter on
       def full_description=(description)
-        filter_run :full_description => Regexp.union(*Array(description).map {|d| Regexp.new(d) })
+        filter_run :full_description => Regexp.union(*Array(description).map { |d| Regexp.new(d) })
       end
 
+      # @return [Array] full description filter
       def full_description
         filter.fetch :full_description, nil
       end
@@ -563,27 +668,77 @@ module RSpec
       # and paths to use for output streams, but you should consider that a
       # private api that may change at any time without notice.
       def add_formatter(formatter_to_use, *paths)
-        formatter_class =
-          built_in_formatter(formatter_to_use) ||
-          custom_formatter(formatter_to_use) ||
-          (raise ArgumentError, "Formatter '#{formatter_to_use}' unknown - maybe you meant 'documentation' or 'progress'?.")
-
         paths << output_stream if paths.empty?
-        formatters << formatter_class.new(*paths.map {|p| String === p ? file_at(p) : p})
+        formatter_loader.add formatter_to_use, *paths
       end
-
       alias_method :formatter=, :add_formatter
 
+      # The formatter that will be used if no formatter has been set.
+      # Defaults to 'progress'.
+      def default_formatter
+        formatter_loader.default_formatter
+      end
+
+      # Sets a fallback formatter to use if none other has been set.
+      #
+      # @example
+      #
+      #   RSpec.configure do |rspec|
+      #     rspec.default_formatter = 'doc'
+      #   end
+      def default_formatter=(value)
+        formatter_loader.default_formatter = value
+      end
+
+      # Returns a duplicate of the formatters currently loaded in
+      # the `FormatterLoader` for introspection.
+      #
+      # Note as this is a duplicate, any mutations will be disregarded.
+      #
+      # @return [Array] the formatters currently loaded
       def formatters
-        @formatters ||= []
+        formatter_loader.formatters.dup
+      end
+
+      # @private
+      def formatter_loader
+        @formatter_loader ||= Formatters::Loader.new(Reporter.new(self))
+      end
+
+      # @private
+      #
+      # This buffer is used to capture all messages sent to the reporter during
+      # reporter initialization. It can then replay those messages after the
+      # formatter is correctly initialized. Otherwise, deprecation warnings
+      # during formatter initialization can cause an infinite loop.
+      class DeprecationReporterBuffer
+        def initialize
+          @calls = []
+        end
+
+        def deprecation(*args)
+          @calls << args
+        end
+
+        def play_onto(reporter)
+          @calls.each do |args|
+            reporter.deprecation(*args)
+          end
+        end
       end
 
+      # @private
       def reporter
-        @reporter ||= begin
-                        add_formatter('progress') if formatters.empty?
-                        add_formatter(RSpec::Core::Formatters::DeprecationFormatter, deprecation_stream, output_stream)
-                        Reporter.new(self, *formatters)
-                      end
+        # @reporter_buffer should only ever be set in this method to cover
+        # initialization of @reporter.
+        @reporter_buffer || @reporter ||=
+          begin
+            @reporter_buffer = DeprecationReporterBuffer.new
+            formatter_loader.setup_default output_stream, deprecation_stream
+            @reporter_buffer.play_onto(formatter_loader.reporter)
+            @reporter_buffer = nil
+            formatter_loader.reporter
+          end
       end
 
       # @api private
@@ -603,60 +758,114 @@ module RSpec
       def files_or_directories_to_run=(*files)
         files = files.flatten
         files << default_path if (command == 'rspec' || Runner.running_in_drb?) && default_path && files.empty?
-        self.files_to_run = get_files_to_run(files)
+        @files_or_directories_to_run = files
+        @files_to_run = nil
+      end
+
+      # The spec files RSpec will run
+      # @return [Array] specified files about to run
+      def files_to_run
+        @files_to_run ||= get_files_to_run(@files_or_directories_to_run)
       end
 
       # Creates a method that delegates to `example` including the submitted
       # `args`. Used internally to add variants of `example` like `pending`:
+      # @param name [String] example name alias
+      # @param args [Array<Symbol>, Hash] metadata for the generated example
+      #
+      # @note The specific example alias below (`pending`) is already
+      #   defined for you.
+      # @note Use with caution. This extends the language used in your
+      #   specs, but does not add any additional documentation.  We use this
+      #   in rspec to define methods like `focus` and `xit`, but we also add
+      #   docs for those methods.
       #
       # @example
-      #     alias_example_to :pending, :pending => true
+      #   RSpec.configure do |config|
+      #     config.alias_example_to :pending, :pending => true
+      #   end
       #
-      #     # This lets you do this:
+      #   # This lets you do this:
       #
-      #     describe Thing do
-      #       pending "does something" do
-      #         thing = Thing.new
-      #       end
+      #   describe Thing do
+      #     pending "does something" do
+      #       thing = Thing.new
       #     end
+      #   end
       #
-      #     # ... which is the equivalent of
+      #   # ... which is the equivalent of
       #
-      #     describe Thing do
-      #       it "does something", :pending => true do
-      #         thing = Thing.new
-      #       end
+      #   describe Thing do
+      #     it "does something", :pending => true do
+      #       thing = Thing.new
       #     end
-      def alias_example_to(new_name, *args)
+      #   end
+      def alias_example_to(name, *args)
         extra_options = Metadata.build_hash_from(args)
-        RSpec::Core::ExampleGroup.alias_example_to(new_name, extra_options)
+        RSpec::Core::ExampleGroup.define_example_method(name, extra_options)
+      end
+
+      # Creates a method that defines an example group with the provided
+      # metadata. Can be used to define example group/metadata shortcuts.
+      #
+      # @example
+      #   RSpec.configure do |config|
+      #     config.alias_example_group_to :describe_model, :type => :model
+      #   end
+      #
+      #   shared_context_for "model tests", :type => :model do
+      #     # define common model test helper methods, `let` declarations, etc
+      #   end
+      #
+      #   # This lets you do this:
+      #
+      #   RSpec.describe_model User do
+      #   end
+      #
+      #   # ... which is the equivalent of
+      #
+      #   RSpec.describe User, :type => :model do
+      #   end
+      #
+      # @note The defined aliased will also be added to the top level
+      #       (e.g. `main` and from within modules) if
+      #       `expose_dsl_globally` is set to true.
+      # @see #alias_example_to
+      # @see #expose_dsl_globally=
+      def alias_example_group_to(new_name, *args)
+        extra_options = Metadata.build_hash_from(args)
+        RSpec::Core::ExampleGroup.define_example_group_method(new_name, extra_options)
       end
 
       # Define an alias for it_should_behave_like that allows different
       # language (like "it_has_behavior" or "it_behaves_like") to be
       # employed when including shared examples.
       #
-      # Example:
-      #
-      #     alias_it_behaves_like_to(:it_has_behavior, 'has behavior:')
+      # @example
+      #   RSpec.configure do |config|
+      #     config.alias_it_behaves_like_to(:it_has_behavior, 'has behavior:')
+      #   end
       #
-      # allows the user to include a shared example group like:
+      #   # allows the user to include a shared example group like:
       #
-      #     describe Entity do
-      #       it_has_behavior 'sortability' do
-      #         let(:sortable) { Entity.new }
-      #       end
+      #   describe Entity do
+      #     it_has_behavior 'sortability' do
+      #       let(:sortable) { Entity.new }
       #     end
+      #   end
       #
-      # which is reported in the output as:
+      #   # which is reported in the output as:
+      #   # Entity
+      #   #   has behavior: sortability
+      #   #     ...sortability examples here
       #
-      #     Entity
-      #       has behavior: sortability
-      #         # sortability examples here
-      def alias_it_behaves_like_to(new_name, report_label = '')
-        RSpec::Core::ExampleGroup.alias_it_behaves_like_to(new_name, report_label)
+      # @note Use with caution. This extends the language used in your
+      #   specs, but does not add any additional documentation.  We use this
+      #   in rspec to define `it_should_behave_like` (for backward
+      #   compatibility), but we also add docs for that method.
+      def alias_it_behaves_like_to(new_name, report_label='')
+        RSpec::Core::ExampleGroup.define_nested_shared_group_method(new_name, report_label)
       end
-
       alias_method :alias_it_should_behave_like_to, :alias_it_behaves_like_to
 
       # Adds key/value pairs to the `inclusion_filter`. If `args`
@@ -689,7 +898,8 @@ module RSpec
       #
       #     filter_run_including :foo # same as filter_run_including :foo => true
       def filter_run_including(*args)
-        filter_manager.include_with_low_priority Metadata.build_hash_from(args)
+        meta = Metadata.build_hash_from(args, :warn_about_example_group_filtering)
+        filter_manager.include_with_low_priority meta
       end
 
       alias_method :filter_run, :filter_run_including
@@ -702,7 +912,8 @@ module RSpec
       # This overrides any inclusion filters/tags set on the command line or in
       # configuration files.
       def inclusion_filter=(filter)
-        filter_manager.include! Metadata.build_hash_from([filter])
+        meta = Metadata.build_hash_from([filter], :warn_about_example_group_filtering)
+        filter_manager.include_only meta
       end
 
       alias_method :filter=, :inclusion_filter=
@@ -745,7 +956,8 @@ module RSpec
       #
       #     filter_run_excluding :foo # same as filter_run_excluding :foo => true
       def filter_run_excluding(*args)
-        filter_manager.exclude_with_low_priority Metadata.build_hash_from(args)
+        meta = Metadata.build_hash_from(args, :warn_about_example_group_filtering)
+        filter_manager.exclude_with_low_priority meta
       end
 
       # Clears and reassigns the `exclusion_filter`. Set to `nil` if you don't
@@ -756,7 +968,8 @@ module RSpec
       # This overrides any exclusion filters/tags set on the command line or in
       # configuration files.
       def exclusion_filter=(filter)
-        filter_manager.exclude! Metadata.build_hash_from([filter])
+        meta = Metadata.build_hash_from([filter], :warn_about_example_group_filtering)
+        filter_manager.exclude_only meta
       end
 
       # Returns the `exclusion_filter`. If none has been set, returns an empty
@@ -798,7 +1011,8 @@ module RSpec
       #
       # @see #extend
       def include(mod, *filters)
-        include_or_extend_modules << [:include, mod, Metadata.build_hash_from(filters)]
+        meta = Metadata.build_hash_from(filters, :warn_about_example_group_filtering)
+        include_or_extend_modules << [:include, mod, meta]
       end
 
       # Tells RSpec to extend example groups with `mod`.  Methods defined in
@@ -831,7 +1045,8 @@ module RSpec
       #
       # @see #include
       def extend(mod, *filters)
-        include_or_extend_modules << [:extend, mod, Metadata.build_hash_from(filters)]
+        meta = Metadata.build_hash_from(filters, :warn_about_example_group_filtering)
+        include_or_extend_modules << [:extend, mod, meta]
       end
 
       # @private
@@ -841,29 +1056,31 @@ module RSpec
       def configure_group(group)
         include_or_extend_modules.each do |include_or_extend, mod, filters|
           next unless filters.empty? || group.any_apply?(filters)
-          send("safe_#{include_or_extend}", mod, group)
+          __send__("safe_#{include_or_extend}", mod, group)
         end
       end
 
       # @private
       def safe_include(mod, host)
-        host.send(:include,mod) unless host < mod
+        host.__send__(:include, mod) unless host < mod
       end
 
       # @private
-      def setup_load_path_and_require(paths)
+      def requires=(paths)
         directories = ['lib', default_path].select { |p| File.directory? p }
         RSpec::Core::RubyProject.add_to_load_path(*directories)
-        paths.each {|path| require path}
+        paths.each { |path| require path }
         @requires += paths
       end
 
       # @private
       if RUBY_VERSION.to_f >= 1.9
+        # @private
         def safe_extend(mod, host)
-          host.extend(mod) unless (class << host; self; end) < mod
+          host.extend(mod) unless host.singleton_class < mod
         end
       else
+        # @private
         def safe_extend(mod, host)
           host.extend(mod) unless (class << host; self; end).included_modules.include?(mod)
         end
@@ -871,19 +1088,21 @@ module RSpec
 
       # @private
       def configure_mock_framework
-        RSpec::Core::ExampleGroup.send(:include, mock_framework)
+        RSpec::Core::ExampleGroup.__send__(:include, mock_framework)
+        conditionally_disable_mocks_monkey_patching
       end
 
       # @private
       def configure_expectation_framework
         expectation_frameworks.each do |framework|
-          RSpec::Core::ExampleGroup.send(:include, framework)
+          RSpec::Core::ExampleGroup.__send__(:include, framework)
         end
+        conditionally_disable_expectations_monkey_patching
       end
 
       # @private
       def load_spec_files
-        files_to_run.uniq.each {|f| load File.expand_path(f) }
+        files_to_run.uniq.each { |f| load File.expand_path(f) }
         @spec_files_loaded = true
       end
 
@@ -907,6 +1126,8 @@ module RSpec
       end
 
       # @private
+      # @macro [attach] delegate_to_ordering_manager
+      #   @!method $1
       def self.delegate_to_ordering_manager(*methods)
         methods.each do |method|
           define_method method do |*args, &block|
@@ -969,11 +1190,12 @@ module RSpec
       delegate_to_ordering_manager :seed_used?, :ordering_registry
 
       # Set Ruby warnings on or off
-      def warnings= value
+      def warnings=(value)
         $VERBOSE = !!value
       end
 
-      def warnings
+      # @return [Boolean] Whether or not ruby warnings are enabled.
+      def warnings?
         $VERBOSE
       end
 
@@ -1000,7 +1222,7 @@ module RSpec
       #     end
       #   end
       def expose_current_running_example_as(method_name)
-        ExposeCurrentExample.module_eval do
+        ExposeCurrentExample.module_exec do
           extend RSpec::SharedContext
           let(method_name) { |ex| ex }
         end
@@ -1008,6 +1230,7 @@ module RSpec
         include ExposeCurrentExample
       end
 
+      # @private
       module ExposeCurrentExample; end
 
       # Turns deprecation warnings into errors, in order to surface
@@ -1024,26 +1247,138 @@ module RSpec
         self.deprecation_stream = Formatters::DeprecationFormatter::RaiseErrorStream.new
       end
 
+      # Enables zero monkey patching mode for RSpec. It removes monkey
+      # patching of the top-level DSL methods (`describe`,
+      # `shared_examples_for`, etc) onto `main` and `Module`, instead
+      # requiring you to prefix these methods with `RSpec.`. It enables
+      # expect-only syntax for rspec-mocks and rspec-expectations. It
+      # simply disables monkey patching on whatever pieces of rspec
+      # the user is using.
+      #
+      # @note It configures rspec-mocks and rspec-expectations only
+      #   if the user is using those (either explicitly or implicitly
+      #   by not setting `mock_with` or `expect_with` to anything else).
+      #
+      # @note If the user uses this options with `mock_with :mocha`
+      #   (or similiar) they will still have monkey patching active
+      #   in their test environment from mocha.
+      #
+      # @example
+      #
+      #   # It disables all monkey patching
+      #   RSpec.configure do |config|
+      #     config.disable_monkey_patching!
+      #   end
+      #
+      #   # Is an equivalent to
+      #   RSpec.configure do |config|
+      #     config.expose_dsl_globally = false
+      #
+      #     config.mock_with :rspec do |mocks|
+      #       mocks.syntax = :expect
+      #       mocks.patch_marshal_to_support_partial_doubles = false
+      #     end
+      #
+      #     config.mock_with :rspec do |expectations|
+      #       expectations.syntax = :expect
+      #     end
+      #   end
+      def disable_monkey_patching!
+        self.expose_dsl_globally = false
+        self.disable_monkey_patching = true
+        conditionally_disable_mocks_monkey_patching
+        conditionally_disable_expectations_monkey_patching
+      end
+
+      # @private
+      attr_accessor :disable_monkey_patching
+
+      # Defines a callback that can assign derived metadata values.
+      #
+      # @param filters [Array<Symbol>, Hash] metadata filters that determine which example
+      #   or group metadata hashes the callback will be triggered for. If none are given,
+      #   the callback will be run against the metadata hashes of all groups and examples.
+      # @yieldparam metadata [Hash] original metadata hash from an example or group. Mutate this in
+      #   your block as needed.
+      #
+      # @example
+      #   RSpec.configure do |config|
+      #     # Tag all groups and examples in the spec/unit directory with :type => :unit
+      #     config.define_derived_metadata(:file_path => %r{/spec/unit/}) do |metadata|
+      #       metadata[:type] = :unit
+      #     end
+      #   end
+      def define_derived_metadata(*filters, &block)
+        meta = Metadata.build_hash_from(filters, :warn_about_example_group_filtering)
+        @derived_metadata_blocks << [meta, block]
+      end
+
+      # @private
+      def apply_derived_metadata_to(metadata)
+        @derived_metadata_blocks.each do |filter, block|
+          block.call(metadata) if filter.empty? || MetadataFilter.any_apply?(filter, metadata)
+        end
+      end
+
     private
 
       def get_files_to_run(paths)
-        FlatMap.flat_map(paths) do |path|
+        FlatMap.flat_map(paths_to_check(paths)) do |path|
           path = path.gsub(File::ALT_SEPARATOR, File::SEPARATOR) if File::ALT_SEPARATOR
           File.directory?(path) ? gather_directories(path) : extract_location(path)
-        end.sort
+        end.sort.uniq
+      end
+
+      def paths_to_check(paths)
+        return paths if pattern_might_load_specs_from_vendored_dirs?
+        paths + ['.']
+      end
+
+      def pattern_might_load_specs_from_vendored_dirs?
+        pattern.split(File::SEPARATOR).first.include?('**')
       end
 
       def gather_directories(path)
+        include_files = get_matching_files(path, pattern)
+        exclude_files = get_matching_files(path, exclude_pattern)
+        (include_files - exclude_files).sort.uniq
+      end
+
+      def get_matching_files(path, pattern)
+        Dir[file_glob_from(path, pattern)].map { |file| File.expand_path(file) }
+      end
+
+      def file_glob_from(path, pattern)
         stripped = "{#{pattern.gsub(/\s*,\s*/, ',')}}"
-        files    = pattern =~ /^#{Regexp.escape path}/ ? Dir[stripped] : Dir["#{path}/#{stripped}"]
-        files.sort
+        return stripped if pattern =~ /^(\.\/)?#{Regexp.escape path}/ || absolute_pattern?(pattern)
+        File.join(path, stripped)
+      end
+
+      if RSpec::Support::OS.windows?
+        def absolute_pattern?(pattern)
+          pattern =~ /\A[A-Z]:\\/ || windows_absolute_network_path?(pattern)
+        end
+
+        def windows_absolute_network_path?(pattern)
+          return false unless ::File::ALT_SEPARATOR
+          pattern.start_with?(::File::ALT_SEPARATOR + ::File::ALT_SEPARATOR)
+        end
+      else
+        def absolute_pattern?(pattern)
+          pattern.start_with?(File::Separator)
+        end
       end
 
       def extract_location(path)
-        if path =~ /^(.*?)((?:\:\d+)+)$/
-          path, lines = $1, $2[1..-1].split(":").map{|n| n.to_i}
+        match = /^(.*?)((?:\:\d+)+)$/.match(path)
+
+        if match
+          captures = match.captures
+          path, lines = captures[0], captures[1][1..-1].split(":").map { |n| n.to_i }
           filter_manager.add_location path, lines
         end
+
+        return [] if path == default_path
         path
       end
 
@@ -1052,78 +1387,54 @@ module RSpec
       end
 
       def value_for(key, default=nil)
-        @preferred_options.has_key?(key) ? @preferred_options[key] : default
+        @preferred_options.key?(key) ? @preferred_options[key] : default
       end
 
       def assert_no_example_groups_defined(config_option)
-        if RSpec.world.example_groups.any?
-          raise MustBeConfiguredBeforeExampleGroupsError.new(
-            "RSpec's #{config_option} configuration option must be configured before " +
-            "any example groups are defined, but you have already defined a group."
-          )
-        end
+        return unless RSpec.world.example_groups.any?
+
+        raise MustBeConfiguredBeforeExampleGroupsError.new(
+          "RSpec's #{config_option} configuration option must be configured before " \
+          "any example groups are defined, but you have already defined a group."
+        )
       end
 
       def output_to_tty?(output=output_stream)
         tty? || (output.respond_to?(:tty?) && output.tty?)
       end
 
-      def built_in_formatter(key)
-        case key.to_s
-        when 'd', 'doc', 'documentation', 's', 'n', 'spec', 'nested'
-          require 'rspec/core/formatters/documentation_formatter'
-          RSpec::Core::Formatters::DocumentationFormatter
-        when 'h', 'html'
-          require 'rspec/core/formatters/html_formatter'
-          RSpec::Core::Formatters::HtmlFormatter
-        when 'p', 'progress'
-          require 'rspec/core/formatters/progress_formatter'
-          RSpec::Core::Formatters::ProgressFormatter
-        when 'j', 'json'
-          require 'rspec/core/formatters/json_formatter'
-          RSpec::Core::Formatters::JsonFormatter
-        end
-      end
+      def conditionally_disable_mocks_monkey_patching
+        return unless disable_monkey_patching && rspec_mocks_loaded?
 
-      def custom_formatter(formatter_ref)
-        if Class === formatter_ref
-          formatter_ref
-        elsif string_const?(formatter_ref)
-          begin
-            formatter_ref.gsub(/^::/,'').split('::').inject(Object) { |const,string| const.const_get string }
-          rescue NameError
-            require( path_for(formatter_ref) ) ? retry : raise
-          end
+        RSpec::Mocks.configuration.tap do |config|
+          config.syntax = :expect
+          config.patch_marshal_to_support_partial_doubles = false
         end
       end
 
-      def string_const?(str)
-        str.is_a?(String) && /\A[A-Z][a-zA-Z0-9_:]*\z/ =~ str
-      end
+      def conditionally_disable_expectations_monkey_patching
+        return unless disable_monkey_patching && rspec_expectations_loaded?
 
-      def path_for(const_ref)
-        underscore_with_fix_for_non_standard_rspec_naming(const_ref)
+        RSpec::Expectations.configuration.syntax = :expect
       end
 
-      def underscore_with_fix_for_non_standard_rspec_naming(string)
-        underscore(string).sub(%r{(^|/)r_spec($|/)}, '\\1rspec\\2')
+      def rspec_mocks_loaded?
+        defined?(RSpec::Mocks.configuration)
       end
 
-      # activesupport/lib/active_support/inflector/methods.rb, line 48
-      def underscore(camel_cased_word)
-        word = camel_cased_word.to_s.dup
-        word.gsub!(/::/, '/')
-        word.gsub!(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
-        word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
-        word.tr!("-", "_")
-        word.downcase!
-        word
+      def rspec_expectations_loaded?
+        defined?(RSpec::Expectations.configuration)
       end
 
-      def file_at(path)
-        FileUtils.mkdir_p(File.dirname(path))
-        File.new(path, 'w')
+      def update_pattern_attr(name, value)
+        if @spec_files_loaded
+          RSpec.warning "Configuring `#{name}` to #{value} has no effect since RSpec has already loaded the spec files."
+        end
+
+        instance_variable_set(:"@#{name}", value)
+        @files_to_run = nil
       end
     end
+    # rubocop:enable Style/ClassLength
   end
 end