rspec-core 2.99.2 → 3.0.0.beta1

data/spec/rspec/core/configuration_spec.rb

@@ -1,6 +1,5 @@
 require 'spec_helper'
 require 'tmpdir'
-require 'pathname'
 
 module RSpec::Core
 
@@ -19,7 +18,7 @@ module RSpec::Core
 
     describe '#deprecation_stream' do
       it 'defaults to standard error' do
-        expect(config.deprecation_stream).to eq $stderr
+        expect($rspec_core_without_stderr_monkey_patch.deprecation_stream).to eq STDERR
       end
 
       it 'is configurable' do
@@ -27,48 +26,17 @@ module RSpec::Core
         config.deprecation_stream = io
         expect(config.deprecation_stream).to eq io
       end
-
-      context 'when the reporter has already been initialized' do
-        before do
-          config.reporter
-          allow(config).to receive(:warn)
-        end
-
-        it 'prints a notice indicating the reconfigured output_stream will be ignored' do
-          config.deprecation_stream = double("IO")
-          expect(config).to have_received(:warn).with(/deprecation_stream.*#{__FILE__}:#{__LINE__ - 1}/)
-        end
-
-        it 'does not change the value of `output_stream`' do
-          config.deprecation_stream = double("IO")
-          expect(config.deprecation_stream).to eq($stderr)
-        end
-
-        it 'does not print a warning if set to the value it already has' do
-          config.deprecation_stream = config.deprecation_stream
-          expect(config).not_to have_received(:warn)
-        end
-      end
     end
 
-    shared_examples_for "output_stream" do |attribute|
-      define_method :attribute_value do
-        config.__send__(attribute)
-      end
-
-      update_line = __LINE__ + 2
-      define_method :update_attribute do |value|
-        config.__send__(:"#{attribute}=", value)
-      end
-
+    describe "#output_stream" do
       it 'defaults to standard output' do
-        expect(attribute_value).to eq $stdout
+        expect(config.output_stream).to eq $stdout
       end
 
       it 'is configurable' do
         io = double 'output io'
-        update_attribute(io)
-        expect(attribute_value).to eq io
+        config.output_stream = io
+        expect(config.output_stream).to eq io
       end
 
       context 'when the reporter has already been initialized' do
@@ -78,54 +46,22 @@ module RSpec::Core
         end
 
         it 'prints a notice indicating the reconfigured output_stream will be ignored' do
-          update_attribute(StringIO.new)
-          expect(config).to have_received(:warn).with(/output_stream.*#{__FILE__}:#{update_line}/)
+          config.output_stream = StringIO.new
+          expect(config).to have_received(:warn).with(/output_stream.*#{__FILE__}:#{__LINE__ - 1}/)
         end
 
         it 'does not change the value of `output_stream`' do
-          update_attribute(StringIO.new)
-          expect(attribute_value).to eq($stdout)
+          config.output_stream = StringIO.new
+          expect(config.output_stream).to eq($stdout)
         end
 
         it 'does not print a warning if set to the value it already has' do
-          update_attribute(attribute_value)
+          config.output_stream = config.output_stream
           expect(config).not_to have_received(:warn)
         end
       end
     end
 
-    describe "#output_stream" do
-      include_examples "output_stream", :output_stream
-    end
-
-    describe "#output" do
-      include_examples "output_stream", :output
-
-      specify 'the reader is deprecated' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /output/)
-        config.output
-      end
-
-      specify 'the writer is deprecated' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /output=/)
-        config.output = $stdout
-      end
-    end
-
-    describe "#out" do
-      include_examples "output_stream", :out
-
-      specify 'the reader is deprecated' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /out/)
-        config.out
-      end
-
-      specify 'the writer is deprecated' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /out=/)
-        config.out = $stdout
-      end
-    end
-
     describe "#setup_load_path_and_require" do
       include_context "isolate load path mutation"
 
@@ -178,33 +114,6 @@ module RSpec::Core
         config.should_receive(:load).once
         config.load_spec_files
       end
-
-      context "with rspec-1 loaded" do
-        before { stub_const("Spec::VERSION::MAJOR", 1) }
-
-        it "raises with a helpful message" do
-          expect {
-            config.load_spec_files
-          }.to raise_error(/rspec-1 has been loaded/)
-        end
-      end
-    end
-
-    describe "#treat_symbols_as_metadata_keys_with_true_values?" do
-      it 'defaults to false' do
-        expect(config.treat_symbols_as_metadata_keys_with_true_values?).to be_falsey
-      end
-
-      it 'prints a deprecation warning when explicitly set to false since RSpec 3 will not support that' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1)
-        config.treat_symbols_as_metadata_keys_with_true_values = false
-        expect(config.treat_symbols_as_metadata_keys_with_true_values?).to be false
-      end
-
-      it 'can be set to true' do
-        config.treat_symbols_as_metadata_keys_with_true_values = true
-        expect(config.treat_symbols_as_metadata_keys_with_true_values?).to be_truthy
-      end
     end
 
     describe "#mock_framework" do
@@ -250,40 +159,11 @@ module RSpec::Core
       it_behaves_like "a configurable framework adapter", :mock_with
 
       [:rspec, :mocha, :rr, :flexmock].each do |framework|
-        context "with :#{framework}" do
+        context "with #{framework}" do
           it "requires the adapter for #{framework}" do
             config.should_receive(:require).with("rspec/core/mocking/with_#{framework}")
             config.mock_with framework
           end
-
-          it "does not print a deprecation" do
-            expect(RSpec).not_to receive(:deprecate)
-            config.mock_with framework
-          end
-        end
-
-        context "with #{framework.to_s.inspect}" do
-          it "requires the adapter for #{framework}" do
-            config.should_receive(:require).with("rspec/core/mocking/with_#{framework}")
-            config.mock_with framework.to_s
-          end
-
-          it "prints a deprecation warning" do
-            expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /mock_with/)
-            config.mock_with framework.to_s
-          end
-        end
-
-        context "with :the_#{framework}_adapter" do
-          it "requires the adapter for #{framework}" do
-            config.should_receive(:require).with("rspec/core/mocking/with_#{framework}")
-            config.mock_with :"the_#{framework}_adapter"
-          end
-
-          it "prints a deprecation warning" do
-            expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /mock_with/)
-            config.mock_with :"the_#{framework}_adapter"
-          end
         end
       end
 
@@ -305,28 +185,9 @@ module RSpec::Core
         end
       end
 
-      context "with an unknown key" do
-        it "uses the null adapter" do
-          config.should_receive(:require).with('rspec/core/mocking/with_absolutely_nothing')
-          config.mock_with :crazy_new_mocking_framework_ive_not_yet_heard_of
-        end
-
-        it "prints a deprecation warning" do
-          expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /mock_with/)
-          config.mock_with :crazy_new_mocking_framework_ive_not_yet_heard_of
-        end
-      end
-
-      context "with :nothing" do
-        it "uses the null adapter" do
-          config.should_receive(:require).with('rspec/core/mocking/with_absolutely_nothing')
-          config.mock_with :nothing
-        end
-
-        it "does not print a deprecation warning" do
-          expect(RSpec).not_to receive(:deprecate)
-          config.mock_with :nothing
-        end
+      it "uses the null adapter when set to any unknown key" do
+        config.should_receive(:require).with('rspec/core/mocking/with_absolutely_nothing')
+        config.mock_with :crazy_new_mocking_framework_ive_not_yet_heard_of
       end
 
       context 'when there are already some example groups defined' do
@@ -367,92 +228,35 @@ module RSpec::Core
       end
     end
 
-    def stub_expectation_adapters
-      stub_const("Test::Unit::Assertions", Module.new)
-      stub_const("Minitest::Assertions", Module.new)
-      stub_const("RSpec::Core::TestUnitAssertionsAdapter", Module.new)
-      stub_const("RSpec::Core::MinitestAssertionsAdapter", Module.new)
-      allow(config).to receive(:require)
-    end
-
     describe "#expect_with" do
       before do
-        stub_expectation_adapters
+        stub_const("Test::Unit::Assertions", Module.new)
+        config.stub(:require)
       end
 
       it_behaves_like "a configurable framework adapter", :expect_with
 
-      context "with :stdlib" do
-        it "is deprecated" do
-          expect_deprecation_with_call_site __FILE__, __LINE__ + 1, /:stdlib/
-          config.expect_with :stdlib
-        end
-
-        it "requires test/unit/assertions" do
-          expect(config).to receive(:require).with('test/unit/assertions')
-          config.expect_with :stdlib
-        end
-
-        it "sets the expectation framework to ::Test::Unit::Assertions" do
-          config.expect_with :stdlib
-          expect(config.expectation_frameworks).to eq [::Test::Unit::Assertions]
-        end
-      end
-
-      context "with :rspec" do
-        it "requires rspec/expectations" do
-          expect(config).to receive(:require).with('rspec/expectations')
-          config.expect_with :rspec
-        end
-
-        it "sets the expectation framework to ::RSpec::Matchers" do
-          config.expect_with :rspec
-          expect(config.expectation_frameworks).to eq [::RSpec::Matchers]
-        end
-      end
-
-      context "with :test_unit" do
-        it "requires rspec/core/test_unit_assertions_adapter" do
-          expect(config).to receive(:require).
-            with('rspec/core/test_unit_assertions_adapter')
-          config.expect_with :test_unit
-        end
-
-        it "sets the expectation framework to ::Test::Unit::Assertions" do
-          config.expect_with :test_unit
-          expect(config.expectation_frameworks).to eq [
-            ::RSpec::Core::TestUnitAssertionsAdapter
-          ]
-        end
-      end
-
-      context "with :minitest" do
-        it "requires rspec/core/minitest_assertions_adapter" do
-          expect(config).to receive(:require).
-            with('rspec/core/minitest_assertions_adapter')
-          config.expect_with :minitest
-        end
-
-        it "sets the expectation framework to ::Minitest::Assertions" do
-          config.expect_with :minitest
-          expect(config.expectation_frameworks).to eq [
-            ::RSpec::Core::MinitestAssertionsAdapter
-          ]
+      [
+        [:rspec,  'rspec/expectations'],
+        [:stdlib, 'test/unit/assertions']
+      ].each do |framework, required_file|
+        context "with #{framework}" do
+          it "requires #{required_file}" do
+            config.should_receive(:require).with(required_file)
+            config.expect_with framework
+          end
         end
       end
 
       it "supports multiple calls" do
         config.expect_with :rspec
-        config.expect_with :minitest
-        expect(config.expectation_frameworks).to eq [
-          RSpec::Matchers,
-          RSpec::Core::MinitestAssertionsAdapter
-        ]
+        config.expect_with :stdlib
+        expect(config.expectation_frameworks).to eq [RSpec::Matchers, Test::Unit::Assertions]
       end
 
       it "raises if block given with multiple args" do
         expect {
-          config.expect_with :rspec, :minitest do |mod_config|
+          config.expect_with :rspec, :stdlib do |mod_config|
           end
         }.to raise_error(/expect_with only accepts/)
       end
@@ -480,16 +284,17 @@ module RSpec::Core
         it 'does not raise an error if re-setting the same config' do
           groups = []
           RSpec.world.stub(:example_groups => groups)
-          config.expect_with :minitest
+          config.expect_with :stdlib
           groups << double.as_null_object
-          config.expect_with :minitest
+          config.expect_with :stdlib
         end
       end
     end
 
     describe "#expecting_with_rspec?" do
       before do
-        stub_expectation_adapters
+        stub_const("Test::Unit::Assertions", Module.new)
+        config.stub(:require)
       end
 
       it "returns false by default" do
@@ -501,18 +306,18 @@ module RSpec::Core
         expect(config).to be_expecting_with_rspec
       end
 
-      it "returns true when `expect_with :rspec, :minitest` has been configured" do
-        config.expect_with :rspec, :minitest
+      it "returns true when `expect_with :rspec, :stdlib` has been configured" do
+        config.expect_with :rspec, :stdlib
         expect(config).to be_expecting_with_rspec
       end
 
-      it "returns true when `expect_with :minitest, :rspec` has been configured" do
-        config.expect_with :minitest, :rspec
+      it "returns true when `expect_with :stdlib, :rspec` has been configured" do
+        config.expect_with :stdlib, :rspec
         expect(config).to be_expecting_with_rspec
       end
 
-      it "returns false when `expect_with :minitest` has been configured" do
-        config.expect_with :minitest
+      it "returns false when `expect_with :stdlib` has been configured" do
+        config.expect_with :stdlib
         expect(config).not_to be_expecting_with_rspec
       end
     end
@@ -655,20 +460,8 @@ module RSpec::Core
       end
     end
 
-    specify "#filename_pattern is deprecated" do
-      expect_deprecation_with_call_site __FILE__, __LINE__ + 1
-      config.filename_pattern
-    end
-
-    specify "#filename_pattern= is deprecated" do
-      expect_deprecation_with_call_site __FILE__, __LINE__ + 1
-      config.filename_pattern = "/whatever"
-    end
-
     %w[pattern= filename_pattern=].each do |setter|
       describe "##{setter}" do
-        before { allow_deprecation } if setter == "filename_pattern="
-
         context "with single pattern" do
           before { config.send(setter, "**/*_foo.rb") }
           it "loads files following pattern" do
@@ -718,16 +511,15 @@ module RSpec::Core
 
         context "after files have already been loaded" do
           it 'will warn that it will have no effect' do
-            allow(Kernel).to receive(:warn)
+            expect_warning_with_call_site(__FILE__, __LINE__ + 2, /has no effect/)
             config.load_spec_files
-            config.send(setter, "rspec/**/*.spec"); line = __LINE__
-            expect(Kernel).to have_received(:warn).with(/has no effect.*#{__FILE__}:#{line}/)
+            config.send(setter, "rspec/**/*.spec")
           end
 
           it 'will not warn if reset is called after load_spec_files' do
             config.load_spec_files
             config.reset
-            expect(Kernel).to_not receive(:warn)
+            expect(RSpec).to_not receive(:warning)
             config.send(setter, "rspec/**/*.spec")
           end
         end
@@ -884,53 +676,8 @@ module RSpec::Core
       end
     end
 
-    specify '#color? is deprecated' do
-      expect_deprecation_with_call_site __FILE__, __LINE__+1
-      config.color?
-    end
-
-    specify "#color_enabled? is not deprecated" do
-      expect_no_deprecation
-      config.color_enabled?
-      config.color_enabled? double("output")
-    end
-
-    specify '#color with no argument is not deprecated' do
-      expect_no_deprecation
-      config.color
-    end
-
-    specify '#color with a non tty output and color = true is deprecated' do
-      allow(config.output_stream).to receive(:tty?).and_return(false)
-      config.color = true
-      expect_warn_deprecation_with_call_site __FILE__, __LINE__+1
-      expect(config.color).to be_falsey
-    end
-
-    specify '#color with an argument is deprecated' do
-      expect_deprecation_with_call_site __FILE__, __LINE__+1
-      config.color config.output_stream
-    end
-
-    specify '#color_enabled with no argument is deprecated' do
-      expect_deprecation_with_call_site __FILE__, __LINE__+1
-      config.color_enabled
-    end
-
-    specify '#color_enabled with an argument is deprecated in favour of #color_enabled?' do
-      expect_deprecation_with_call_site __FILE__, __LINE__+1
-      config.color_enabled config.output_stream
-    end
-
     %w[color color_enabled].each do |color_option|
       describe "##{color_option}=" do
-        before { allow_deprecation } if color_option == 'color_enabled'
-
-        specify "color_enabled is deprecated" do
-          expect_deprecation_with_call_site __FILE__, __LINE__+1
-          config.color_enabled = true
-        end
-
         context "given true" do
           before { config.send "#{color_option}=", true }
 
@@ -991,7 +738,6 @@ module RSpec::Core
               @original_host  = RbConfig::CONFIG['host_os']
               RbConfig::CONFIG['host_os'] = 'mingw'
               config.stub(:require)
-              config.stub(:warn)
             end
 
             after do
@@ -1019,10 +765,13 @@ module RSpec::Core
             end
 
             context "with ANSICON NOT available" do
+              before do
+                allow_warning
+              end
+
               it "warns to install ANSICON" do
                 config.stub(:require) { raise LoadError }
-                config.should_receive(:warn).
-                  with(/You must use ANSICON/)
+                expect_warning_with_call_site(__FILE__, __LINE__ + 1, /You must use ANSICON/)
                 config.send "#{color_option}=", true
               end
 
@@ -1089,7 +838,7 @@ module RSpec::Core
       end
 
       it "requires a formatter file based on its fully qualified name" do
-        config.formatter_loader.should_receive(:require).with('rspec/custom_formatter') do
+        config.should_receive(:require).with('rspec/custom_formatter') do
           stub_const("RSpec::CustomFormatter", Class.new(Formatters::BaseFormatter))
         end
         config.add_formatter "RSpec::CustomFormatter"
@@ -1097,7 +846,7 @@ module RSpec::Core
       end
 
       it "raises NameError if class is unresolvable" do
-        config.formatter_loader.should_receive(:require).with('rspec/custom_formatter3')
+        config.should_receive(:require).with('rspec/custom_formatter3')
         expect(lambda { config.add_formatter "RSpec::CustomFormatter3" }).to raise_error(NameError)
       end
 
@@ -1105,45 +854,13 @@ module RSpec::Core
         expect(lambda { config.add_formatter :progresss }).to raise_error(ArgumentError)
       end
 
-      it 'warns of deprecation for old document aliases' do
-        expect_deprecation_with_call_site __FILE__, __LINE__ + 1, 's'
-        config.add_formatter 's'
-        expect(config.formatters.first).to be_an_instance_of Formatters::DocumentationFormatter
-      end
-
-      it 'warns of deprecation of the text mate formatter' do
-        expect_deprecation_with_call_site __FILE__, __LINE__ + 1, /rspec-core/
-        config.add_formatter 't'
-      end
-
-      it 'warns of deprecation of the shortcut for the text mate formatter' do
-        stub_const("::RSpec::Mate::Formatters::TextMateFormatter", double)
-        expect_deprecation_with_call_site __FILE__, __LINE__ + 1, /shortcut/
-        config.add_formatter 't'
-      end
-
       context "with a 2nd arg defining the output" do
-        let(:path) { File.join(Dir.tmpdir, 'output.txt') }
-
         it "creates a file at that path and sets it as the output" do
+          path = File.join(Dir.tmpdir, 'output.txt')
           config.add_formatter('doc', path)
           expect(config.formatters.first.output).to be_a(File)
           expect(config.formatters.first.output.path).to eq(path)
         end
-
-        it "accepts Pathname objects for file paths" do
-           pathname = Pathname.new(path)
-           config.add_formatter('doc', pathname)
-           expect(config.formatters.first.output).to be_a(File)
-           expect(config.formatters.first.output.path).to eq(path)
-        end
-      end
-    end
-
-    describe "#formatters" do
-      it "is deprecated to mutate the array" do
-        expect_deprecation_with_call_site __FILE__, __LINE__ + 1
-        config.formatters.clear
       end
     end
 
@@ -1161,7 +878,6 @@ module RSpec::Core
       end
 
       it "sets the filter with a symbol" do
-        RSpec.configuration.stub(:treat_symbols_as_metadata_keys_with_true_values? => true)
         config.filter_run_including :foo
         expect(config.inclusion_filter[:foo]).to be(true)
       end
@@ -1173,18 +889,6 @@ module RSpec::Core
         expect(config.inclusion_filter[:foo]).to be(true)
         expect(config.inclusion_filter[:bar]).to be(false)
       end
-
-      context "given `:focused => true`" do
-        it "issues a deprecation warning" do
-          expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /filter_run_including :focused/)
-          config.filter_run_including :focused => true
-        end
-
-        it "issues a deprecation warning when using `filter_run`" do
-          expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /filter_run :focused/)
-          config.filter_run :focused => true
-        end
-      end
     end
 
     describe "#filter_run_excluding" do
@@ -1201,7 +905,6 @@ module RSpec::Core
       end
 
       it "sets the filter using a symbol" do
-        RSpec.configuration.stub(:treat_symbols_as_metadata_keys_with_true_values? => true)
         config.filter_run_excluding :foo
         expect(config.exclusion_filter[:foo]).to be(true)
       end
@@ -1224,7 +927,6 @@ module RSpec::Core
 
     describe "#inclusion_filter=" do
       it "treats symbols as hash keys with true values when told to" do
-        RSpec.configuration.stub(:treat_symbols_as_metadata_keys_with_true_values? => true)
         config.inclusion_filter = :foo
         expect(config.inclusion_filter).to eq({:foo => true})
       end
@@ -1271,9 +973,15 @@ module RSpec::Core
       end
     end
 
+    describe "#treat_symbols_as_metadata_keys_with_true_values=" do
+      it 'is deprecated' do
+        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1)
+        config.treat_symbols_as_metadata_keys_with_true_values = true
+      end
+    end
+
     describe "#exclusion_filter=" do
       it "treats symbols as hash keys with true values when told to" do
-        RSpec.configuration.stub(:treat_symbols_as_metadata_keys_with_true_values? => true)
         config.exclusion_filter = :foo
         expect(config.exclusion_filter).to eq({:foo => true})
       end
@@ -1286,8 +994,6 @@ module RSpec::Core
     end
 
     describe "line_numbers=" do
-      before { config.filter_manager.stub(:warn) }
-
       it "sets the line numbers" do
         config.line_numbers = ['37']
         expect(config.filter).to eq({:line_numbers => [37]})
@@ -1318,34 +1024,19 @@ module RSpec::Core
     end
 
     describe "#full_backtrace=" do
-      context "given true" do
-        it "clears the backtrace exclusion patterns" do
-          config.full_backtrace = true
-          expect(config.backtrace_exclusion_patterns).to eq([])
-        end
-      end
-
-      context "given false" do
-        it "restores backtrace clean patterns" do
-          config.full_backtrace = false
-          expect(config.backtrace_exclusion_patterns).to eq(RSpec::Core::BacktraceCleaner::DEFAULT_EXCLUSION_PATTERNS)
-        end
-      end
-
       it "doesn't impact other instances of config" do
         config_1 = Configuration.new
         config_2 = Configuration.new
 
         config_1.full_backtrace = true
-        expect(config_2.backtrace_exclusion_patterns).not_to be_empty
+        expect(config_2.full_backtrace?).to be_falsey
       end
     end
 
-    describe "#backtrace_clean_patterns=" do
+    describe "#backtrace_exclusion_patterns=" do
       it "actually receives the new filter values" do
-        RSpec.stub(:deprecate)
         config = Configuration.new
-        config.backtrace_clean_patterns = [/.*/]
+        config.backtrace_exclusion_patterns = [/.*/]
         expect(config.backtrace_formatter.exclude? "this").to be_truthy
       end
     end
@@ -1362,124 +1053,14 @@ module RSpec::Core
       end
     end
 
-    describe "#backtrace_clean_patterns" do
-      before { allow(RSpec).to receive(:deprecate) }
-      it "is deprecated" do
-        RSpec.should_receive(:deprecate)
-        config = Configuration.new
-        config.backtrace_clean_patterns
-      end
-
+    describe "#backtrace_exclusion_patterns" do
       it "can be appended to" do
         config = Configuration.new
-        config.backtrace_clean_patterns << /.*/
+        config.backtrace_exclusion_patterns << /.*/
         expect(config.backtrace_formatter.exclude? "this").to be_truthy
       end
     end
 
-    specify "#backtrace_cleaner is deprecated" do
-      expect_deprecation_with_call_site __FILE__, __LINE__ + 1
-      config.backtrace_cleaner
-    end
-
-    describe ".backtrace_formatter#exclude? defaults" do
-      before { allow_deprecation }
-
-      it "returns true for rspec files" do
-        expect(config.backtrace_formatter.exclude?("lib/rspec/core.rb")).to be_truthy
-      end
-
-      it "returns true for spec_helper" do
-        expect(config.backtrace_formatter.exclude?("spec/spec_helper.rb")).to be_truthy
-      end
-
-      it "returns true for java files (for JRuby)" do
-        expect(config.backtrace_formatter.exclude?("org/jruby/RubyArray.java:2336")).to be_truthy
-      end
-
-      it "returns true for files within installed gems" do
-        expect(config.backtrace_formatter.exclude?('ruby-1.8.7-p334/gems/mygem-2.3.0/lib/mygem.rb')).to be_truthy
-      end
-
-      it "returns false for files in projects containing 'gems' in the name" do
-        expect(config.backtrace_formatter.exclude?('code/my-gems-plugin/lib/plugin.rb')).to be_falsey
-      end
-
-      it "returns false for something in the current working directory" do
-        expect(config.backtrace_formatter.exclude?("#{Dir.getwd}/arbitrary")).to be_falsey
-      end
-    end
-
-    describe "#debug=true" do
-      before do
-        if defined?(Debugger)
-          @orig_debugger = Debugger
-          Object.send(:remove_const, :Debugger)
-        else
-          @orig_debugger = nil
-        end
-        config.stub(:require)
-        Object.const_set("Debugger", debugger)
-
-        allow_deprecation
-      end
-
-      after do
-        Object.send(:remove_const, :Debugger)
-        Object.const_set("Debugger", @orig_debugger) if @orig_debugger
-      end
-
-      let(:debugger) { double('Debugger').as_null_object }
-
-      it "requires 'ruby-debug'" do
-        config.should_receive(:require).with('ruby-debug')
-        config.debug = true
-      end
-
-      it "starts the debugger" do
-        debugger.should_receive(:start)
-        config.debug = true
-      end
-
-      it "warns that this feature is deprecated" do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1)
-        config.debug = true
-      end
-    end
-
-    describe "#debug=false" do
-      before { allow_deprecation }
-
-      it "does not require 'ruby-debug'" do
-        config.should_not_receive(:require).with('ruby-debug')
-        config.debug = false
-      end
-
-      it "warns that this feature is deprecated" do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1)
-        config.debug = false
-      end
-    end
-
-    describe "#debug?" do
-      before { allow_deprecation }
-
-      it 'returns true if the debugger has been loaded' do
-        stub_const("Debugger", Object.new)
-        expect(config.debug?).to be_truthy
-      end
-
-      it 'returns false if the debugger has not been loaded' do
-        hide_const("Debugger")
-        expect(config.debug?).to be_falsey
-      end
-
-      it "warns that this feature is deprecated" do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1)
-        config.debug?
-      end
-    end
-
     describe "#libs=" do
       include_context "isolate load path mutation"
 
@@ -1706,53 +1287,40 @@ module RSpec::Core
     end
 
     describe "#force" do
-      let(:collection) { [1, 2, 3, 4] }
-      let(:ordered)    { config.group_ordering_block.call(collection) }
+      context "for ordering options" do
+        let(:list) { [1, 2, 3, 4] }
+        let(:ordering_strategy) { config.ordering_registry.fetch(:global) }
+        let(:rng) { RSpec::Core::RandomNumberGenerator.new config.seed }
+        let(:shuffled) { Ordering::Random.new(config).shuffle list, rng }
 
-      it "forces order (when given default)" do
-        config.force :order => "default"
-        config.order = "rand"
-
-        expect(config.order).to eq("default")
-        expect(ordered).to eq([1, 2, 3, 4])
-      end
+        specify "CLI `--order defined` takes precedence over `config.order = rand`" do
+          config.force :order => "defined"
+          config.order = "rand"
 
-      it "forces order (when given defined)" do
-        config.force :order => "defined"
-        config.order = "rand"
-
-        expect(config.order).to eq("defined")
-        expect(ordered).to eq([1, 2, 3, 4])
-      end
-
-      it "forces order and seed with :order => 'rand:37'" do
-        config.force :order => "rand:37"
-        config.order = "default"
-
-        expect(config.order).to eq("rand")
-        expect(config.seed).to eq(37)
+          expect(ordering_strategy.order(list)).to eq([1, 2, 3, 4])
+        end
 
-        allow(Kernel).to receive(:rand).and_return(3, 1, 4, 2)
-        expect(ordered).to_not eq([1, 2, 3, 4])
-      end
+        specify "CLI `--order rand:37` takes precedence over `config.order = defined`" do
+          config.force :order => "rand:37"
+          config.order = "defined"
 
-      it "forces order and seed with :seed => '37'" do
-        config.force :seed => "37"
-        config.order = "defined"
+          expect(ordering_strategy.order(list)).to eq(shuffled)
+        end
 
-        expect(config.seed).to eq(37)
-        expect(config.order).to eq("rand")
+        specify "CLI `--seed 37` forces order and seed" do
+          config.force :seed => 37
+          config.order = "defined"
+          config.seed  = 145
 
-        allow(Kernel).to receive(:rand).and_return(3, 1, 4, 2)
-        expect(ordered).to eq([2, 4, 1, 3])
-      end
+          expect(ordering_strategy.order(list)).to eq(shuffled)
+          expect(config.seed).to eq(37)
+        end
 
-      it 'can set random ordering' do
-        config.force :seed => "rand:37"
-        RSpec.stub(:configuration => config)
-        list = [1, 2, 3, 4].extend(Extensions::Ordered::Examples)
-        Kernel.should_receive(:rand).and_return(3, 1, 4, 2)
-        expect(list.ordered).to eq([2, 4, 1, 3])
+        specify "CLI `--order defined` takes precedence over `config.register_ordering(:global)`" do
+          config.force :order => "defined"
+          config.register_ordering(:global, &:reverse)
+          expect(ordering_strategy.order(list)).to eq([1, 2, 3, 4])
+        end
       end
 
       it "forces 'false' value" do
@@ -1773,195 +1341,97 @@ module RSpec::Core
       end
     end
 
-    describe '#randomize?' do
-      context 'with order set to :random' do
-        before { config.order = :random }
-
-        it 'returns true' do
-          expect(config.randomize?).to be_truthy
-        end
+    describe "#seed_used?" do
+      def use_seed_on(registry)
+        registry.fetch(:random).order([1, 2])
       end
 
-      context 'with order set to nil' do
-        before { config.order = nil }
-
-        it 'returns false' do
-          expect(config.randomize?).to be_falsey
-        end
+      it 'returns false if neither ordering registry used the seed' do
+        expect(config.seed_used?).to be false
       end
 
-      it 'is deprecated' do
-        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /randomize\?/)
-        config.randomize?
+      it 'returns true if the ordering registry used the seed' do
+        use_seed_on(config.ordering_registry)
+        expect(config.seed_used?).to be true
       end
     end
 
     describe '#order=' do
-      context 'given "random:123"' do
-        before { config.order = 'random:123' }
+      context 'given "random"' do
+        before do
+          config.seed = 7654
+          config.order = 'random'
+        end
 
-        it 'sets order to "random"' do
-          expect(config.order).to eq('random')
+        it 'does not change the seed' do
+          expect(config.seed).to eq(7654)
         end
 
+        it 'sets up random ordering' do
+          RSpec.stub(:configuration => config)
+          global_ordering = config.ordering_registry.fetch(:global)
+          expect(global_ordering).to be_an_instance_of(Ordering::Random)
+        end
+      end
+
+      context 'given "random:123"' do
+        before { config.order = 'random:123' }
+
         it 'sets seed to 123' do
           expect(config.seed).to eq(123)
         end
 
         it 'sets up random ordering' do
           RSpec.stub(:configuration => config)
-          list = [1, 2, 3, 4].extend(Extensions::Ordered::Examples)
-          Kernel.should_receive(:rand).and_return(3, 1, 4, 2)
-          expect(list.ordered).to eq([2, 4, 1, 3])
+          global_ordering = config.ordering_registry.fetch(:global)
+          expect(global_ordering).to be_an_instance_of(Ordering::Random)
         end
       end
 
-      shared_examples_for "defined order" do |order|
+      context 'given "defined"' do
         before do
           config.order = 'rand:123'
-          config.order = order
-        end
-
-        it "sets the order to nil" do
-          expect(config.order).to be_nil
+          config.order = 'defined'
         end
 
-        it "sets the seed to nil" do
-          expect(config.seed).to be_nil
+        it "does not change the seed" do
+          expect(config.seed).to eq(123)
         end
 
         it 'clears the random ordering' do
           RSpec.stub(:configuration => config)
-          list = [1, 2, 3, 4].extend(Extensions::Ordered::Examples)
-          Kernel.should_not_receive(:rand)
-          expect(list.ordered).to eq([1, 2, 3, 4])
-        end
-      end
-
-      context "given 'default'" do
-        include_examples "defined order", 'default'
-
-        it 'prints a deprecation notice' do
-          expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /default/)
-          config.order = 'default'
+          list = [1, 2, 3, 4]
+          ordering_strategy = config.ordering_registry.fetch(:global)
+          expect(ordering_strategy.order(list)).to eq([1, 2, 3, 4])
         end
       end
-
-      context "given 'defined'" do
-        include_examples "defined order", 'defined'
-      end
-    end
-
-    describe "#order_examples" do
-      before do
-        allow_deprecation
-        RSpec.stub(:configuration => config)
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::Examples' do
-        examples = [1, 2, 3, 4]
-        examples.extend Extensions::Ordered::Examples
-        config.order_examples { |examples_to_order| examples_to_order.reverse }
-        expect(examples.ordered).to eq([4, 3, 2, 1])
-      end
-
-      it 'sets #order to "custom"' do
-        config.order_examples { |examples| examples.reverse }
-        expect(config.order).to eq("custom")
-      end
-
-      it 'prints a deprecation warning' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /RSpec::Configuration#order_examples/)
-        config.order_examples { }
-      end
-    end
-
-    describe "#example_ordering_block" do
-      it 'defaults to a block that returns the passed argument' do
-        expect(config.example_ordering_block.call([1, 2, 3])).to eq([1, 2, 3])
-      end
     end
 
-    describe "#order_groups" do
-      before do
-        allow_deprecation
-        RSpec.stub(:configuration => config)
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::ExampleGroups' do
-        groups = [1, 2, 3, 4]
-        groups.extend Extensions::Ordered::ExampleGroups
-        config.order_groups { |groups_to_order| groups_to_order.reverse }
-        expect(groups.ordered).to eq([4, 3, 2, 1])
-      end
-
-      it 'sets #order to "custom"' do
-        config.order_groups { |groups| groups.reverse }
-        expect(config.order).to eq("custom")
+    describe "#register_ordering" do
+      def register_reverse_ordering
+        config.register_ordering(:reverse, &:reverse)
       end
 
-      it 'prints a deprecation warning' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /RSpec::Configuration#order_groups/)
-        config.order_groups { }
-      end
-    end
+      it 'stores the ordering for later use' do
+        register_reverse_ordering
 
-    describe "#group_ordering_block" do
-      it 'defaults to a block that returns the passed argument' do
-        expect(config.group_ordering_block.call([1, 2, 3])).to eq([1, 2, 3])
+        list = [1, 2, 3]
+        strategy = config.ordering_registry.fetch(:reverse)
+        expect(strategy).to be_a(Ordering::Custom)
+        expect(strategy.order(list)).to eq([3, 2, 1])
       end
-    end
 
-    describe "#order_groups_and_examples" do
-      let(:examples) { [1, 2, 3, 4].extend Extensions::Ordered::Examples }
-      let(:groups)   { [1, 2, 3, 4].extend Extensions::Ordered::ExampleGroups }
-
-      before do
-        RSpec.stub(:configuration => config)
-        config.order_groups_and_examples { |list| list.reverse }
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::Examples' do
-        expect(examples.ordered).to eq([4, 3, 2, 1])
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::ExampleGroups' do
-        expect(groups.ordered).to eq([4, 3, 2, 1])
-      end
-    end
-
-    describe "#register_ordering(:global)" do
-      let(:examples) { [1, 2, 3, 4].extend Extensions::Ordered::Examples }
-      let(:groups)   { [1, 2, 3, 4].extend Extensions::Ordered::ExampleGroups }
-
-      before do
-        RSpec.stub(:configuration => config)
-        config.register_ordering(:global) { |list| list.reverse }
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::Examples' do
-        expect(examples.ordered).to eq([4, 3, 2, 1])
-      end
-
-      it 'sets a block that determines the ordering of a collection extended with Extensions::Ordered::ExampleGroups' do
-        expect(groups.ordered).to eq([4, 3, 2, 1])
-      end
-
-      it 'sets #order to "custom"' do
-        expect(config.order).to eq("custom")
-      end
-
-      it 'raises an ArgumentError if given a symbol other than `:global`' do
-        expect {
-          config.register_ordering(:custom) { }
-        }.to raise_error(ArgumentError, /:global/)
-      end
-    end
+      it 'can register an ordering object' do
+        strategy = Object.new
+        def strategy.order(list)
+          list.reverse
+        end
 
-    describe "#order" do
-      it 'is deprecated' do
-        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /order/)
-        config.order
+        config.register_ordering(:reverse, strategy)
+        list = [1, 2, 3]
+        fetched = config.ordering_registry.fetch(:reverse)
+        expect(fetched).to be(strategy)
+        expect(fetched.order(list)).to eq([3, 2, 1])
       end
     end
 
@@ -1982,12 +1452,7 @@ module RSpec::Core
         expect($VERBOSE).to eq false
       end
 
-      it 'returns the verbosity setting as a predicate' do
-        expect(config.warnings?).to eq $VERBOSE
-      end
-
-      it 'warns when using the deprecated `warnings` reader' do
-        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /warnings/)
+      it 'returns the verbosity setting' do
         expect(config.warnings).to eq $VERBOSE
       end
 
@@ -2030,42 +1495,6 @@ module RSpec::Core
         expect(value_1.description).to eq("works")
         expect(value_2).to be(value_1)
       end
-
-      [:example, :running_example].each do |name|
-        it "silences the deprecation warning for ##{name} when configured to expose via that name" do
-          RSpec.configuration.expose_current_running_example_as name
-          allow(RSpec).to receive(:deprecate)
-
-          ExampleGroup.describe "Group" do
-            specify { __send__(name) }
-          end.run
-
-          expect(RSpec).to_not have_received(:deprecate)
-        end
-      end
-    end
-
-    describe '#show_failures_in_pending_blocks' do
-      specify 'reader is deprecated' do
-        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 3,
-          /show_failures_in_pending_blocks/)
-
-        config.show_failures_in_pending_blocks
-      end
-
-      specify 'predicate is deprecated' do
-        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 3,
-          /show_failures_in_pending_blocks/)
-
-        config.show_failures_in_pending_blocks?
-      end
-
-      specify 'writer is deprecated' do
-        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 3,
-          /show_failures_in_pending_blocks/)
-
-        config.show_failures_in_pending_blocks = true
-      end
     end
 
   end