require 'spec_helper'
require 'tmpdir'
require 'pathname'

module RSpec::Core

  describe Configuration do

    let(:config) { Configuration.new }

    describe "RSpec.configuration with a block" do
      before { RSpec.stub(:warn_deprecation) }

      it "is deprecated" do
        RSpec.should_receive(:warn_deprecation)
        RSpec.configuration {}
      end
    end

    describe '#deprecation_stream' do
      it 'defaults to standard error' do
        expect(config.deprecation_stream).to eq $stderr
      end

      it 'is configurable' do
        io = double 'deprecation io'
        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

      it 'defaults to standard output' do
        expect(attribute_value).to eq $stdout
      end

      it 'is configurable' do
        io = double 'output io'
        update_attribute(io)
        expect(attribute_value).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
          update_attribute(StringIO.new)
          expect(config).to have_received(:warn).with(/output_stream.*#{__FILE__}:#{update_line}/)
        end

        it 'does not change the value of `output_stream`' do
          update_attribute(StringIO.new)
          expect(attribute_value).to eq($stdout)
        end

        it 'does not print a warning if set to the value it already has' do
          update_attribute(attribute_value)
          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"

      def absolute_path_to(dir)
        File.expand_path("../../../../#{dir}", __FILE__)
      end

      it 'adds `lib` to the load path' do
        lib_dir = absolute_path_to("lib")
        $LOAD_PATH.delete(lib_dir)

        expect($LOAD_PATH).not_to include(lib_dir)
        config.setup_load_path_and_require []
        expect($LOAD_PATH).to include(lib_dir)
      end

      it 'adds the configured `default_path` to the load path' do
        config.default_path = 'features'
        foo_dir = absolute_path_to("features")

        expect($LOAD_PATH).not_to include(foo_dir)
        config.setup_load_path_and_require []
        expect($LOAD_PATH).to include(foo_dir)
      end

      it 'stores the required files' do
        config.should_receive(:require).with('a/path')
        config.setup_load_path_and_require ['a/path']
        expect(config.requires).to eq ['a/path']
      end

      context "when `default_path` refers to a file rather than a directory" do
        it 'does not add it to the load path' do
          config.default_path = 'Rakefile'
          config.setup_load_path_and_require []
          expect($LOAD_PATH).not_to include(match(/Rakefile/))
        end
      end
    end

    describe "#load_spec_files" do
      it "loads files using load" do
        config.files_to_run = ["foo.bar", "blah_spec.rb"]
        config.should_receive(:load).twice
        config.load_spec_files
      end

      it "loads each file once, even if duplicated in list" do
        config.files_to_run = ["a_spec.rb", "a_spec.rb"]
        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
      it "defaults to :rspec" do
        config.should_receive(:require).with('rspec/core/mocking/with_rspec')
        config.mock_framework
      end
    end

    describe "#mock_framework="do
      it "delegates to mock_with" do
        config.should_receive(:mock_with).with(:rspec)
        config.mock_framework = :rspec
      end
    end

    shared_examples "a configurable framework adapter" do |m|
      it "yields a config object if the framework_module supports it" do
        custom_config = Struct.new(:custom_setting).new
        mod = Module.new
        mod.stub(:configuration => custom_config)

        config.send m, mod do |mod_config|
          mod_config.custom_setting = true
        end

        expect(custom_config.custom_setting).to be_truthy
      end

      it "raises if framework module doesn't support configuration" do
        mod = Module.new

        expect {
          config.send m, mod do |mod_config|
          end
        }.to raise_error(/must respond to `configuration`/)
      end
    end

    describe "#mock_with" do
      before { config.stub(:require) }

      it_behaves_like "a configurable framework adapter", :mock_with

      [:rspec, :mocha, :rr, :flexmock].each do |framework|
        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

      it "allows rspec-mocks to be configured with a provided block" do
        mod = Module.new

        RSpec::Mocks.configuration.should_receive(:add_stub_and_should_receive_to).with(mod)

        config.mock_with :rspec do |c|
          c.add_stub_and_should_receive_to mod
        end
      end

      context "with a module" do
        it "sets the mock_framework_adapter to that module" do
          mod = Module.new
          config.mock_with mod
          expect(config.mock_framework).to eq(mod)
        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
      end

      context 'when there are already some example groups defined' do
        it 'raises an error since this setting must be applied before any groups are defined' do
          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
          expect {
            config.mock_with :mocha
          }.to raise_error(/must be configured before any example groups are defined/)
        end

        it 'does not raise an error if the default `mock_with :rspec` is re-configured' do
          config.mock_framework # called by RSpec when configuring the first example group
          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
          config.mock_with :rspec
        end

        it 'does not raise an error if re-setting the same config' do
          groups = []
          RSpec.world.stub(:example_groups => groups)
          config.mock_with :mocha
          groups << double.as_null_object
          config.mock_with :mocha
        end
      end
    end

    describe "#expectation_framework" do
      it "defaults to :rspec" do
        config.should_receive(:require).with('rspec/expectations')
        config.expectation_frameworks
      end
    end

    describe "#expectation_framework=" do
      it "delegates to expect_with=" do
        config.should_receive(:expect_with).with(:rspec)
        config.expectation_framework = :rspec
      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
      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
          ]
        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
        ]
      end

      it "raises if block given with multiple args" do
        expect {
          config.expect_with :rspec, :minitest do |mod_config|
          end
        }.to raise_error(/expect_with only accepts/)
      end

      it "raises ArgumentError if framework is not supported" do
        expect do
          config.expect_with :not_supported
        end.to raise_error(ArgumentError)
      end

      context 'when there are already some example groups defined' do
        it 'raises an error since this setting must be applied before any groups are defined' do
          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
          expect {
            config.expect_with :rspec
          }.to raise_error(/must be configured before any example groups are defined/)
        end

        it 'does not raise an error if the default `expect_with :rspec` is re-configured' do
          config.expectation_frameworks # called by RSpec when configuring the first example group
          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
          config.expect_with :rspec
        end

        it 'does not raise an error if re-setting the same config' do
          groups = []
          RSpec.world.stub(:example_groups => groups)
          config.expect_with :minitest
          groups << double.as_null_object
          config.expect_with :minitest
        end
      end
    end

    describe "#expecting_with_rspec?" do
      before do
        stub_expectation_adapters
      end

      it "returns false by default" do
        expect(config).not_to be_expecting_with_rspec
      end

      it "returns true when `expect_with :rspec` has been configured" do
        config.expect_with :rspec
        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
        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
        expect(config).to be_expecting_with_rspec
      end

      it "returns false when `expect_with :minitest` has been configured" do
        config.expect_with :minitest
        expect(config).not_to be_expecting_with_rspec
      end
    end

    describe "#files_to_run" do
      it "loads files not following pattern if named explicitly" do
        config.files_or_directories_to_run = "spec/rspec/core/resources/a_bar.rb"
        expect(config.files_to_run).to eq([      "spec/rspec/core/resources/a_bar.rb"])
      end

      it "prevents repetition of dir when start of the pattern" do
        config.pattern = "spec/**/a_spec.rb"
        config.files_or_directories_to_run = "spec"
        expect(config.files_to_run).to eq(["spec/rspec/core/resources/a_spec.rb"])
      end

      it "does not prevent repetition of dir when later of the pattern" do
        config.pattern = "rspec/**/a_spec.rb"
        config.files_or_directories_to_run = "spec"
        expect(config.files_to_run).to eq(["spec/rspec/core/resources/a_spec.rb"])
      end

      context "with <path>:<line_number>" do
        it "overrides inclusion filters set on config" do
          config.filter_run_including :foo => :bar
          config.files_or_directories_to_run = "path/to/file.rb:37"
          expect(config.inclusion_filter.size).to eq(1)
          expect(config.inclusion_filter[:locations].keys.first).to match(/path\/to\/file\.rb$/)
          expect(config.inclusion_filter[:locations].values.first).to eq([37])
        end

        it "overrides inclusion filters set before config" do
          config.force(:inclusion_filter => {:foo => :bar})
          config.files_or_directories_to_run = "path/to/file.rb:37"
          expect(config.inclusion_filter.size).to eq(1)
          expect(config.inclusion_filter[:locations].keys.first).to match(/path\/to\/file\.rb$/)
          expect(config.inclusion_filter[:locations].values.first).to eq([37])
        end

        it "clears exclusion filters set on config" do
          config.exclusion_filter = { :foo => :bar }
          config.files_or_directories_to_run = "path/to/file.rb:37"
          expect(config.exclusion_filter).to be_empty,
            "expected exclusion filter to be empty:\n#{config.exclusion_filter}"
        end

        it "clears exclusion filters set before config" do
          config.force(:exclusion_filter => { :foo => :bar })
          config.files_or_directories_to_run = "path/to/file.rb:37"
          expect(config.exclusion_filter).to be_empty,
            "expected exclusion filter to be empty:\n#{config.exclusion_filter}"
        end
      end

      context "with default pattern" do
        it "loads files named _spec.rb" do
          config.files_or_directories_to_run = "spec/rspec/core/resources"
          expect(config.files_to_run).to eq([      "spec/rspec/core/resources/a_spec.rb"])
        end

        it "loads files in Windows", :if => RSpec.windows_os? do
          config.files_or_directories_to_run = "C:\\path\\to\\project\\spec\\sub\\foo_spec.rb"
          expect(config.files_to_run).to eq([      "C:/path/to/project/spec/sub/foo_spec.rb"])
        end

        it "loads files in Windows when directory is specified", :if => RSpec.windows_os? do
          config.files_or_directories_to_run = "spec\\rspec\\core\\resources"
          expect(config.files_to_run).to eq([      "spec/rspec/core/resources/a_spec.rb"])
        end
      end

      context "with default default_path" do
        it "loads files in the default path when run by rspec" do
          config.stub(:command) { 'rspec' }
          config.files_or_directories_to_run = []
          expect(config.files_to_run).not_to be_empty
        end

        it "loads files in the default path when run with DRB (e.g., spork)" do
          config.stub(:command) { 'spork' }
          RSpec::Core::Runner.stub(:running_in_drb?) { true }
          config.files_or_directories_to_run = []
          expect(config.files_to_run).not_to be_empty
        end

        it "does not load files in the default path when run by ruby" do
          config.stub(:command) { 'ruby' }
          config.files_or_directories_to_run = []
          expect(config.files_to_run).to be_empty
        end
      end

      def specify_consistent_ordering_of_files_to_run
        File.stub(:directory?).with('a') { true }

        orderings = [
          %w[ a/1.rb a/2.rb a/3.rb ],
          %w[ a/2.rb a/1.rb a/3.rb ],
          %w[ a/3.rb a/2.rb a/1.rb ]
        ].map do |files|
          Dir.should_receive(:[]).with(/^\{?a/) { files }
          yield
          config.files_to_run
        end

        expect(orderings.uniq.size).to eq(1)
      end

      context 'when the given directories match the pattern' do
        it 'orders the files in a consistent ordering, regardless of the underlying OS ordering' do
          specify_consistent_ordering_of_files_to_run do
            config.pattern = 'a/*.rb'
            config.files_or_directories_to_run = 'a'
          end
        end
      end

      context 'when the pattern is given relative to the given directories' do
        it 'orders the files in a consistent ordering, regardless of the underlying OS ordering' do
          specify_consistent_ordering_of_files_to_run do
            config.pattern = '*.rb'
            config.files_or_directories_to_run = 'a'
          end
        end
      end

      context 'when given multiple file paths' do
        it 'orders the files in a consistent ordering, regardless of the given order' do
          File.stub(:directory?) { false } # fake it into thinking these a full file paths

          files = ['a/b/c_spec.rb', 'c/b/a_spec.rb']
          config.files_or_directories_to_run = *files
          ordering_1 = config.files_to_run

          config.files_or_directories_to_run = *(files.reverse)
          ordering_2 = config.files_to_run

          expect(ordering_1).to eq(ordering_2)
        end
      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
            file = File.expand_path(File.dirname(__FILE__) + "/resources/a_foo.rb")
            config.files_or_directories_to_run = file
            expect(config.files_to_run).to include(file)
          end

          it "loads files in directories following pattern" do
            dir = File.expand_path(File.dirname(__FILE__) + "/resources")
            config.files_or_directories_to_run = dir
            expect(config.files_to_run).to include("#{dir}/a_foo.rb")
          end

          it "does not load files in directories not following pattern" do
            dir = File.expand_path(File.dirname(__FILE__) + "/resources")
            config.files_or_directories_to_run = dir
            expect(config.files_to_run).not_to include("#{dir}/a_bar.rb")
          end
        end

        context "with multiple patterns" do
          it "supports comma separated values" do
            config.send(setter, "**/*_foo.rb,**/*_bar.rb")
            dir = File.expand_path(File.dirname(__FILE__) + "/resources")
            config.files_or_directories_to_run = dir
            expect(config.files_to_run).to include("#{dir}/a_foo.rb")
            expect(config.files_to_run).to include("#{dir}/a_bar.rb")
          end

          it "supports comma separated values with spaces" do
            config.send(setter, "**/*_foo.rb, **/*_bar.rb")
            dir = File.expand_path(File.dirname(__FILE__) + "/resources")
            config.files_or_directories_to_run = dir
            expect(config.files_to_run).to include("#{dir}/a_foo.rb")
            expect(config.files_to_run).to include("#{dir}/a_bar.rb")
          end

          it "supports curly braces glob syntax" do
            config.send(setter, "**/*_{foo,bar}.rb")
            dir = File.expand_path(File.dirname(__FILE__) + "/resources")
            config.files_or_directories_to_run = dir
            expect(config.files_to_run).to include("#{dir}/a_foo.rb")
            expect(config.files_to_run).to include("#{dir}/a_bar.rb")
          end
        end

        context "after files have already been loaded" do
          it 'will warn that it will have no effect' do
            allow(Kernel).to receive(:warn)
            config.load_spec_files
            config.send(setter, "rspec/**/*.spec"); line = __LINE__
            expect(Kernel).to have_received(:warn).with(/has no effect.*#{__FILE__}:#{line}/)
          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)
            config.send(setter, "rspec/**/*.spec")
          end
        end
      end
    end

    describe "path with line number" do
      it "assigns the line number as a location filter" do
        config.files_or_directories_to_run = "path/to/a_spec.rb:37"
        expect(config.filter).to eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37]}})
      end
    end

    context "with full_description set" do
      it "overrides filters" do
        config.filter_run :focused => true
        config.full_description = "foo"
        expect(config.filter).not_to have_key(:focused)
      end

      it 'is possible to access the full description regular expression' do
        config.full_description = "foo"
        expect(config.full_description).to eq(/foo/)
      end
    end

    context "without full_description having been set" do
      it 'returns nil from #full_description' do
        expect(config.full_description).to eq nil
      end
    end

    context "with line number" do
      it "assigns the file and line number as a location filter" do
        config.files_or_directories_to_run = "path/to/a_spec.rb:37"
        expect(config.filter).to eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37]}})
      end

      it "assigns multiple files with line numbers as location filters" do
        config.files_or_directories_to_run = "path/to/a_spec.rb:37", "other_spec.rb:44"
        expect(config.filter).to eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37],
                                                File.expand_path("other_spec.rb") => [44]}})
      end

      it "assigns files with multiple line numbers as location filters" do
        config.files_or_directories_to_run = "path/to/a_spec.rb:37", "path/to/a_spec.rb:44"
        expect(config.filter).to eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37, 44]}})
      end
    end

    context "with multiple line numbers" do
      it "assigns the file and line numbers as a location filter" do
        config.files_or_directories_to_run = "path/to/a_spec.rb:1:3:5:7"
        expect(config.filter).to eq({:locations => {File.expand_path("path/to/a_spec.rb") => [1,3,5,7]}})
      end
    end

    it "assigns the example name as the filter on description" do
      config.full_description = "foo"
      expect(config.filter).to eq({:full_description => /foo/})
    end

    it "assigns the example names as the filter on description if description is an array" do
      config.full_description = [ "foo", "bar" ]
      expect(config.filter).to eq({:full_description => Regexp.union(/foo/, /bar/)})
    end

    it 'is possible to access the full description regular expression' do
      config.full_description = "foo","bar"
      expect(config.full_description).to eq Regexp.union(/foo/,/bar/)
    end

    describe "#default_path" do
      it 'defaults to "spec"' do
        expect(config.default_path).to eq('spec')
      end
    end

    describe "#include" do

      module InstanceLevelMethods
        def you_call_this_a_blt?
          "egad man, where's the mayo?!?!?"
        end
      end

      it_behaves_like "metadata hash builder" do
        def metadata_hash(*args)
          config.include(InstanceLevelMethods, *args)
          config.include_or_extend_modules.last.last
        end
      end

      context "with no filter" do
        it "includes the given module into each example group" do
          RSpec.configure do |c|
            c.include(InstanceLevelMethods)
          end

          group = ExampleGroup.describe('does like, stuff and junk', :magic_key => :include) { }
          expect(group).not_to respond_to(:you_call_this_a_blt?)
          expect(group.new.you_call_this_a_blt?).to eq("egad man, where's the mayo?!?!?")
        end
      end

      context "with a filter" do
        it "includes the given module into each matching example group" do
          RSpec.configure do |c|
            c.include(InstanceLevelMethods, :magic_key => :include)
          end

          group = ExampleGroup.describe('does like, stuff and junk', :magic_key => :include) { }
          expect(group).not_to respond_to(:you_call_this_a_blt?)
          expect(group.new.you_call_this_a_blt?).to eq("egad man, where's the mayo?!?!?")
        end
      end

    end

    describe "#extend" do

      module ThatThingISentYou
        def that_thing
        end
      end

      it_behaves_like "metadata hash builder" do
        def metadata_hash(*args)
          config.extend(ThatThingISentYou, *args)
          config.include_or_extend_modules.last.last
        end
      end

      it "extends the given module into each matching example group" do
        RSpec.configure do |c|
          c.extend(ThatThingISentYou, :magic_key => :extend)
        end

        group = ExampleGroup.describe(ThatThingISentYou, :magic_key => :extend) { }
        expect(group).to respond_to(:that_thing)
      end

    end

    describe "#run_all_when_everything_filtered?" do

      it "defaults to false" do
        expect(config.run_all_when_everything_filtered?).to be_falsey
      end

      it "can be queried with question method" do
        config.run_all_when_everything_filtered = true
        expect(config.run_all_when_everything_filtered?).to be_truthy
      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 }

          context "with config.tty? and output.tty?" do
            it "does not set color_enabled" do
              output = StringIO.new
              config.output_stream = output

              config.tty = true
              config.output_stream.stub :tty? => true

              expect(config.send(color_option)).to be_truthy
              expect(config.send(color_option, output)).to be_truthy
            end
          end

          context "with config.tty? and !output.tty?" do
            it "sets color_enabled" do
              output = StringIO.new
              config.output_stream = output

              config.tty = true
              config.output_stream.stub :tty? => false

              expect(config.send(color_option)).to be_truthy
              expect(config.send(color_option, output)).to be_truthy
            end
          end

          context "with config.tty? and !output.tty?" do
            it "does not set color_enabled" do
              output = StringIO.new
              config.output_stream = output

              config.tty = false
              config.output_stream.stub :tty? => true

              expect(config.send(color_option)).to be_truthy
              expect(config.send(color_option, output)).to be_truthy
            end
          end

          context "with !config.tty? and !output.tty?" do
            it "does not set color_enabled" do
              output = StringIO.new
              config.output_stream = output

              config.tty = false
              config.output_stream.stub :tty? => false

              expect(config.send(color_option)).to be_falsey
              expect(config.send(color_option, output)).to be_falsey
            end
          end

          context "on windows" do
            before do
              @original_host  = RbConfig::CONFIG['host_os']
              RbConfig::CONFIG['host_os'] = 'mingw'
              config.stub(:require)
              config.stub(:warn)
            end

            after do
              RbConfig::CONFIG['host_os'] = @original_host
            end

            context "with ANSICON available" do
              around(:each) { |e| with_env_vars('ANSICON' => 'ANSICON', &e) }

              it "enables colors" do
                config.output_stream = StringIO.new
                config.output_stream.stub :tty? => true
                config.send "#{color_option}=", true
                expect(config.send(color_option)).to be_truthy
              end

              it "leaves output stream intact" do
                config.output_stream = $stdout
                config.stub(:require) do |what|
                  config.output_stream = 'foo' if what =~ /Win32/
                end
                config.send "#{color_option}=", true
                expect(config.output_stream).to eq($stdout)
              end
            end

            context "with ANSICON NOT available" do
              it "warns to install ANSICON" do
                config.stub(:require) { raise LoadError }
                config.should_receive(:warn).
                  with(/You must use ANSICON/)
                config.send "#{color_option}=", true
              end

              it "sets color_enabled to false" do
                config.stub(:require) { raise LoadError }
                config.send "#{color_option}=", true
                config.color_enabled = true
                expect(config.send(color_option)).to be_falsey
              end
            end
          end
        end
      end

      it "prefers incoming cli_args" do
        config.output_stream = StringIO.new
        config.output_stream.stub :tty? => true
        config.force :color => true
        config.color = false
        expect(config.color).to be_truthy
      end
    end

    describe '#formatter=' do
      it "delegates to add_formatter (better API for user-facing configuration)" do
        config.should_receive(:add_formatter).with('these','options')
        config.add_formatter('these','options')
      end
    end

    describe "#add_formatter" do

      it "adds to the list of formatters" do
        config.add_formatter :documentation
        expect(config.formatters.first).to be_an_instance_of(Formatters::DocumentationFormatter)
      end

      it "finds a formatter by name (w/ Symbol)" do
        config.add_formatter :documentation
        expect(config.formatters.first).to be_an_instance_of(Formatters::DocumentationFormatter)
      end

      it "finds a formatter by name (w/ String)" do
        config.add_formatter 'documentation'
        expect(config.formatters.first).to be_an_instance_of(Formatters::DocumentationFormatter)
      end

      it "finds a formatter by class" do
        formatter_class = Class.new(Formatters::BaseTextFormatter)
        config.add_formatter formatter_class
        expect(config.formatters.first).to be_an_instance_of(formatter_class)
      end

      it "finds a formatter by class name" do
        stub_const("CustomFormatter", Class.new(Formatters::BaseFormatter))
        config.add_formatter "CustomFormatter"
        expect(config.formatters.first).to be_an_instance_of(CustomFormatter)
      end

      it "finds a formatter by class fully qualified name" do
        stub_const("RSpec::CustomFormatter", Class.new(Formatters::BaseFormatter))
        config.add_formatter "RSpec::CustomFormatter"
        expect(config.formatters.first).to be_an_instance_of(RSpec::CustomFormatter)
      end

      it "requires a formatter file based on its fully qualified name" do
        config.formatter_loader.should_receive(:require).with('rspec/custom_formatter') do
          stub_const("RSpec::CustomFormatter", Class.new(Formatters::BaseFormatter))
        end
        config.add_formatter "RSpec::CustomFormatter"
        expect(config.formatters.first).to be_an_instance_of(RSpec::CustomFormatter)
      end

      it "raises NameError if class is unresolvable" do
        config.formatter_loader.should_receive(:require).with('rspec/custom_formatter3')
        expect(lambda { config.add_formatter "RSpec::CustomFormatter3" }).to raise_error(NameError)
      end

      it "raises ArgumentError if formatter is unknown" do
        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
          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

    describe "#filter_run_including" do
      it_behaves_like "metadata hash builder" do
        def metadata_hash(*args)
          config.filter_run_including(*args)
          config.inclusion_filter
        end
      end

      it "sets the filter with a hash" do
        config.filter_run_including :foo => true
        expect(config.inclusion_filter[:foo]).to be(true)
      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

      it "merges with existing filters" do
        config.filter_run_including :foo => true
        config.filter_run_including :bar => false

        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
      it_behaves_like "metadata hash builder" do
        def metadata_hash(*args)
          config.filter_run_excluding(*args)
          config.exclusion_filter
        end
      end

      it "sets the filter" do
        config.filter_run_excluding :foo => true
        expect(config.exclusion_filter[:foo]).to be(true)
      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

      it "merges with existing filters" do
        config.filter_run_excluding :foo => true
        config.filter_run_excluding :bar => false

        expect(config.exclusion_filter[:foo]).to be(true)
        expect(config.exclusion_filter[:bar]).to be(false)
      end
    end

    describe "#inclusion_filter" do
      it "returns {} even if set to nil" do
        config.inclusion_filter = nil
        expect(config.inclusion_filter).to eq({})
      end
    end

    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

      it "overrides any inclusion filters set on the command line or in configuration files" do
        config.force(:inclusion_filter => { :foo => :bar })
        config.inclusion_filter = {:want => :this}
        expect(config.inclusion_filter).to eq({:want => :this})
      end
    end

    describe "#exclusion_filter" do
      it "returns {} even if set to nil" do
        config.exclusion_filter = nil
        expect(config.exclusion_filter).to eq({})
      end

      describe "the default :if filter" do
        it "does not exclude a spec with  { :if => true } metadata" do
          expect(config.exclusion_filter[:if].call(true)).to be_falsey
        end

        it "excludes a spec with  { :if => false } metadata" do
          expect(config.exclusion_filter[:if].call(false)).to be_truthy
        end

        it "excludes a spec with  { :if => nil } metadata" do
          expect(config.exclusion_filter[:if].call(nil)).to be_truthy
        end
      end

      describe "the default :unless filter" do
        it "excludes a spec with  { :unless => true } metadata" do
          expect(config.exclusion_filter[:unless].call(true)).to be_truthy
        end

        it "does not exclude a spec with { :unless => false } metadata" do
          expect(config.exclusion_filter[:unless].call(false)).to be_falsey
        end

        it "does not exclude a spec with { :unless => nil } metadata" do
          expect(config.exclusion_filter[:unless].call(nil)).to be_falsey
        end
      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

      it "overrides any exclusion filters set on the command line or in configuration files" do
        config.force(:exclusion_filter => { :foo => :bar })
        config.exclusion_filter = {:want => :this}
        expect(config.exclusion_filter).to eq({:want => :this})
      end
    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]})
      end

      it "overrides filters" do
        config.filter_run :focused => true
        config.line_numbers = ['37']
        expect(config.filter).to eq({:line_numbers => [37]})
      end

      it "prevents subsequent filters" do
        config.line_numbers = ['37']
        config.filter_run :focused => true
        expect(config.filter).to eq({:line_numbers => [37]})
      end
    end

    describe "line_numbers" do
      it "returns the line numbers from the filter" do
        config.line_numbers = ['42']
        expect(config.line_numbers).to eq [42]
      end

      it "defaults to empty" do
        expect(config.line_numbers).to eq []
      end
    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
      end
    end

    describe "#backtrace_clean_patterns=" do
      it "actually receives the new filter values" do
        RSpec.stub(:deprecate)
        config = Configuration.new
        config.backtrace_clean_patterns = [/.*/]
        expect(config.backtrace_formatter.exclude? "this").to be_truthy
      end
    end

    describe 'full_backtrace' do
      it 'returns true when backtrace patterns is empty' do
        config.backtrace_exclusion_patterns = []
        expect(config.full_backtrace?).to eq true
      end

      it 'returns false when backtrace patterns isnt empty' do
        config.backtrace_exclusion_patterns = [:lib]
        expect(config.full_backtrace?).to eq false
      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

      it "can be appended to" do
        config = Configuration.new
        config.backtrace_clean_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"

      it "adds directories to the LOAD_PATH" do
        $LOAD_PATH.should_receive(:unshift).with("a/dir")
        config.libs = ["a/dir"]
      end
    end

    describe "libs" do
      include_context "isolate load path mutation"

      it 'records paths added to the load path' do
        config.libs = ["a/dir"]
        expect(config.libs).to eq ["a/dir"]
      end
    end

    describe "#requires=" do
      before { RSpec.should_receive :deprecate }

      it "requires the configured files" do
        config.should_receive(:require).with('foo').ordered
        config.should_receive(:require).with('bar').ordered
        config.requires = ['foo', 'bar']
      end

      it "stores require paths" do
        config.should_receive(:require).with("a/path")
        config.requires = ["a/path"]
        expect(config.requires).to eq ['a/path']
      end
    end

    describe "#add_setting" do
      describe "with no modifiers" do
        context "with no additional options" do
          before do
            config.add_setting :custom_option
          end

          it "defaults to nil" do
            expect(config.custom_option).to be_nil
          end

          it "adds a predicate" do
            expect(config.custom_option?).to be_falsey
          end

          it "can be overridden" do
            config.custom_option = "a value"
            expect(config.custom_option).to eq("a value")
          end
        end

        context "with :default => 'a value'" do
          before do
            config.add_setting :custom_option, :default => 'a value'
          end

          it "defaults to 'a value'" do
            expect(config.custom_option).to eq("a value")
          end

          it "returns true for the predicate" do
            expect(config.custom_option?).to be_truthy
          end

          it "can be overridden with a truthy value" do
            config.custom_option = "a new value"
            expect(config.custom_option).to eq("a new value")
          end

          it "can be overridden with nil" do
            config.custom_option = nil
            expect(config.custom_option).to eq(nil)
          end

          it "can be overridden with false" do
            config.custom_option = false
            expect(config.custom_option).to eq(false)
          end
        end
      end

      context "with :alias => " do
        it "is deprecated" do
          RSpec::should_receive(:deprecate).with(/:alias option/, :replacement => ":alias_with")
          config.add_setting :custom_option
          config.add_setting :another_custom_option, :alias => :custom_option
        end
      end

      context "with :alias_with => " do
        before do
          config.add_setting :custom_option, :alias_with => :another_custom_option
        end

        it "delegates the getter to the other option" do
          config.another_custom_option = "this value"
          expect(config.custom_option).to eq("this value")
        end

        it "delegates the setter to the other option" do
          config.custom_option = "this value"
          expect(config.another_custom_option).to eq("this value")
        end

        it "delegates the predicate to the other option" do
          config.custom_option = true
          expect(config.another_custom_option?).to be_truthy
        end
      end
    end

    describe "#configure_group" do
      it "extends with 'extend'" do
        mod = Module.new
        group = ExampleGroup.describe("group", :foo => :bar)

        config.extend(mod, :foo => :bar)
        config.configure_group(group)
        expect(group).to be_a(mod)
      end

      it "extends with 'module'" do
        mod = Module.new
        group = ExampleGroup.describe("group", :foo => :bar)

        config.include(mod, :foo => :bar)
        config.configure_group(group)
        expect(group.included_modules).to include(mod)
      end

      it "requires only one matching filter" do
        mod = Module.new
        group = ExampleGroup.describe("group", :foo => :bar)

        config.include(mod, :foo => :bar, :baz => :bam)
        config.configure_group(group)
        expect(group.included_modules).to include(mod)
      end

      it "includes each one before deciding whether to include the next" do
        mod1 = Module.new do
          def self.included(host)
            host.metadata[:foo] = :bar
          end
        end
        mod2 = Module.new

        group = ExampleGroup.describe("group")

        config.include(mod1)
        config.include(mod2, :foo => :bar)
        config.configure_group(group)
        expect(group.included_modules).to include(mod1)
        expect(group.included_modules).to include(mod2)
      end

      module IncludeOrExtendMeOnce
        def self.included(host)
          raise "included again" if host.instance_methods.include?(:foobar)
          host.class_eval { def foobar; end }
        end

        def self.extended(host)
          raise "extended again" if host.respond_to?(:foobar)
          def host.foobar; end
        end
      end

      it "doesn't include a module when already included in ancestor" do
        config.include(IncludeOrExtendMeOnce, :foo => :bar)

        group = ExampleGroup.describe("group", :foo => :bar)
        child = group.describe("child")

        config.configure_group(group)
        config.configure_group(child)
      end

      it "doesn't extend when ancestor is already extended with same module" do
        config.extend(IncludeOrExtendMeOnce, :foo => :bar)

        group = ExampleGroup.describe("group", :foo => :bar)
        child = group.describe("child")

        config.configure_group(group)
        config.configure_group(child)
      end
    end

    describe "#alias_example_to" do
      it_behaves_like "metadata hash builder" do
        after do
          RSpec::Core::ExampleGroup.module_eval do
            class << self
              undef :my_example_method if method_defined? :my_example_method
            end
          end
        end
        def metadata_hash(*args)
          config.alias_example_to :my_example_method, *args
          group = ExampleGroup.describe("group")
          example = group.my_example_method("description")
          example.metadata
        end
      end
    end

    describe "#reset" do
      it "clears the reporter" do
        expect(config.reporter).not_to be_nil
        config.reset
        expect(config.instance_variable_get("@reporter")).to be_nil
      end

      it "clears the formatters" do
        config.add_formatter "doc"
        config.reset
        expect(config.formatters).to be_empty
      end
    end

    describe "#force" do
      let(:collection) { [1, 2, 3, 4] }
      let(:ordered)    { config.group_ordering_block.call(collection) }

      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

      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)

        allow(Kernel).to receive(:rand).and_return(3, 1, 4, 2)
        expect(ordered).to_not eq([1, 2, 3, 4])
      end

      it "forces order and seed with :seed => '37'" do
        config.force :seed => "37"
        config.order = "defined"

        expect(config.seed).to eq(37)
        expect(config.order).to eq("rand")

        allow(Kernel).to receive(:rand).and_return(3, 1, 4, 2)
        expect(ordered).to eq([2, 4, 1, 3])
      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])
      end

      it "forces 'false' value" do
        config.add_setting :custom_option
        config.custom_option = true
        expect(config.custom_option?).to be_truthy
        config.force :custom_option => false
        expect(config.custom_option?).to be_falsey
        config.custom_option = true
        expect(config.custom_option?).to be_falsey
      end
    end

    describe '#seed' do
      it 'returns the seed as an int' do
        config.seed = '123'
        expect(config.seed).to eq(123)
      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
      end

      context 'with order set to nil' do
        before { config.order = nil }

        it 'returns false' do
          expect(config.randomize?).to be_falsey
        end
      end

      it 'is deprecated' do
        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /randomize\?/)
        config.randomize?
      end
    end

    describe '#order=' do
      context 'given "random:123"' do
        before { config.order = 'random:123' }

        it 'sets order to "random"' do
          expect(config.order).to eq('random')
        end

        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])
        end
      end

      shared_examples_for "defined order" do |order|
        before do
          config.order = 'rand:123'
          config.order = order
        end

        it "sets the order to nil" do
          expect(config.order).to be_nil
        end

        it "sets the seed to nil" do
          expect(config.seed).to be_nil
        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'
        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")
      end

      it 'prints a deprecation warning' do
        expect_deprecation_with_call_site(__FILE__, __LINE__ + 1, /RSpec::Configuration#order_groups/)
        config.order_groups { }
      end
    end

    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])
      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

    describe "#order" do
      it 'is deprecated' do
        expect_warn_deprecation_with_call_site(__FILE__, __LINE__ + 1, /order/)
        config.order
      end
    end

    describe '#warnings' do
      around do |example|
        @_original_setting = $VERBOSE
        example.run
        $VERBOSE = @_original_setting
      end

      it "sets verbose to true when true" do
        config.warnings = true
        expect($VERBOSE).to eq true
      end

      it "sets verbose to false when true" do
        config.warnings = false
        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/)
        expect(config.warnings).to eq $VERBOSE
      end

      it 'is loaded from config by #force' do
        config.force :warnings => true
        expect($VERBOSE).to eq true
      end
    end

    describe "#raise_errors_for_deprecations!" do
      it 'causes deprecations to raise errors rather than printing to the deprecation stream' do
        config.deprecation_stream = stream = StringIO.new
        config.raise_errors_for_deprecations!

        expect {
          config.reporter.deprecation(:deprecated => "foo", :call_site => "foo.rb:1")
        }.to raise_error(RSpec::Core::DeprecationError, /foo is deprecated/)

        expect(stream.string).to eq("")
      end
    end

    describe "#expose_current_running_example_as" do
      before { stub_const(Configuration::ExposeCurrentExample.name, Module.new) }

      it 'exposes the current example via the named method' do
        RSpec.configuration.expose_current_running_example_as :the_example
        RSpec.configuration.expose_current_running_example_as :another_example_helper

        value_1 = value_2 = nil

        ExampleGroup.describe "Group" do
          it "works" do
            value_1 = the_example
            value_2 = another_example_helper
          end
        end.run

        expect(value_1).to be_an(RSpec::Core::Example)
        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
end
