rspec-mocks 3.0.0.beta2 → 3.0.0.rc1

data/spec/rspec/mocks/mutate_const_spec.rb

@@ -1,542 +0,0 @@
-require 'spec_helper'
-
-TOP_LEVEL_VALUE_CONST = 7
-
-class TestClass
-  M = :m
-  N = :n
-
-  class Nested
-    class NestedEvenMore
-    end
-  end
-end
-
-class TestClassThatDefinesSend
-  C = :c
-
-  def self.send
-  end
-end
-
-class TestSubClass < TestClass
-  P = :p
-end
-
-module RSpec
-  module Mocks
-    describe "Constant Mutating" do
-      include RSpec::Mocks::RecursiveConstMethods
-
-      def reset_rspec_mocks
-        ::RSpec::Mocks.space.reset_all
-      end
-
-      shared_context "constant example methods" do |const_name|
-        define_method :const do
-          recursive_const_get(const_name)
-        end
-
-        define_method :parent_const do
-          recursive_const_get("Object::" + const_name.sub(/(::)?[^:]+\z/, ''))
-        end
-
-        define_method :last_const_part do
-          const_name.split('::').last
-        end
-      end
-
-      shared_examples_for "loaded constant stubbing" do |const_name|
-        include_context "constant example methods", const_name
-
-        let!(:original_const_value) { const }
-        after { change_const_value_to(original_const_value) }
-
-        def change_const_value_to(value)
-          parent_const.__send__(:remove_const, last_const_part)
-          parent_const.const_set(last_const_part, value)
-        end
-
-        it 'allows it to be stubbed' do
-          expect(const).not_to eq(7)
-          stub_const(const_name, 7)
-          expect(const).to eq(7)
-        end
-
-        it 'resets it to its original value when rspec clears its mocks' do
-          original_value = const
-          expect(original_value).not_to eq(:a)
-          stub_const(const_name, :a)
-          reset_rspec_mocks
-          expect(const).to be(original_value)
-        end
-
-        it 'returns the stubbed value' do
-          expect(stub_const(const_name, 7)).to eq(7)
-        end
-      end
-
-      shared_examples_for "loaded constant hiding" do |const_name|
-        before do
-          expect(recursive_const_defined?(const_name)).to be_truthy
-        end
-
-        it 'allows it to be hidden' do
-          hide_const(const_name)
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'resets the constant when rspec clear its mocks' do
-          hide_const(const_name)
-          reset_rspec_mocks
-          expect(recursive_const_defined?(const_name)).to be_truthy
-        end
-
-        it 'returns nil' do
-          expect(hide_const(const_name)).to be_nil
-        end
-      end
-
-      shared_examples_for "unloaded constant stubbing" do |const_name|
-        include_context "constant example methods", const_name
-
-        before do
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'allows it to be stubbed' do
-          stub_const(const_name, 7)
-          expect(const).to eq(7)
-        end
-
-        it 'removes the constant when rspec clears its mocks' do
-          stub_const(const_name, 7)
-          reset_rspec_mocks
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'returns the stubbed value' do
-          expect(stub_const(const_name, 7)).to eq(7)
-        end
-
-        it 'ignores the :transfer_nested_constants option if passed' do
-          stub = Module.new
-          stub_const(const_name, stub, :transfer_nested_constants => true)
-          expect(stub.constants).to eq([])
-        end
-      end
-
-      shared_examples_for "unloaded constant hiding" do |const_name|
-        include_context "constant example methods", const_name
-
-        before do
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'allows it to be hidden, though the operation has no effect' do
-          hide_const(const_name)
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'remains undefined after rspec clears its mocks' do
-          hide_const(const_name)
-          reset_rspec_mocks
-          expect(recursive_const_defined?(const_name)).to be_falsey
-        end
-
-        it 'returns nil' do
-          expect(hide_const(const_name)).to be_nil
-        end
-      end
-
-      describe "#hide_const" do
-        context "for a loaded constant nested in a module that redefines `send`" do
-          it_behaves_like "loaded constant hiding", "TestClassThatDefinesSend::C"
-        end
-
-
-        context 'for a loaded nested constant' do
-          it_behaves_like "loaded constant hiding", "TestClass::Nested"
-        end
-
-        context 'for a loaded constant prefixed with ::' do
-          it_behaves_like 'loaded constant hiding', "::TestClass"
-        end
-
-        context 'for an unloaded constant with nested name that matches a top-level constant' do
-          it_behaves_like "unloaded constant hiding", "TestClass::Hash"
-
-          it 'does not hide the top-level constant' do
-            top_level_hash = ::Hash
-
-            hide_const("TestClass::Hash")
-            expect(::Hash).to equal(top_level_hash)
-          end
-
-          it 'does not affect the ability to access the top-level constant from nested contexts', :silence_warnings do
-            top_level_hash = ::Hash
-
-            hide_const("TestClass::Hash")
-            expect(TestClass::Hash).to equal(top_level_hash)
-          end
-        end
-
-        context 'for a loaded deeply nested constant' do
-          it_behaves_like "loaded constant hiding", "TestClass::Nested::NestedEvenMore"
-        end
-
-        context 'for an unloaded unnested constant' do
-          it_behaves_like "unloaded constant hiding", "X"
-        end
-
-        context 'for an unloaded nested constant' do
-          it_behaves_like "unloaded constant hiding", "X::Y"
-        end
-
-        it 'can be hidden multiple times but still restores the original value properly' do
-          orig_value = TestClass
-          hide_const("TestClass")
-          hide_const("TestClass")
-
-          reset_rspec_mocks
-          expect(TestClass).to be(orig_value)
-        end
-
-        it 'allows a constant to be hidden, then stubbed, restoring it to its original value properly' do
-          orig_value = TOP_LEVEL_VALUE_CONST
-
-          hide_const("TOP_LEVEL_VALUE_CONST")
-          expect(recursive_const_defined?("TOP_LEVEL_VALUE_CONST")).to be_falsey
-
-          stub_const("TOP_LEVEL_VALUE_CONST", 12345)
-          expect(TOP_LEVEL_VALUE_CONST).to eq 12345
-
-          reset_rspec_mocks
-          expect(TOP_LEVEL_VALUE_CONST).to eq orig_value
-        end
-      end
-
-      describe "#stub_const" do
-        context "for a loaded constant nested in a module that redefines `send`" do
-          it_behaves_like "loaded constant stubbing", "TestClassThatDefinesSend::C"
-        end
-
-        context 'for a loaded unnested constant' do
-          it_behaves_like "loaded constant stubbing", "TestClass"
-
-          it 'can be stubbed multiple times but still restores the original value properly' do
-            orig_value = TestClass
-            stub1, stub2 = Module.new, Module.new
-            stub_const("TestClass", stub1)
-            stub_const("TestClass", stub2)
-
-            reset_rspec_mocks
-            expect(TestClass).to be(orig_value)
-          end
-
-          it 'allows nested constants to be transferred to a stub module' do
-            tc_nested = TestClass::Nested
-            stub = Module.new
-            stub_const("TestClass", stub, :transfer_nested_constants => true)
-            expect(stub::M).to eq(:m)
-            expect(stub::N).to eq(:n)
-            expect(stub::Nested).to be(tc_nested)
-          end
-
-          it 'does not transfer nested constants that are inherited from a superclass' do
-            stub = Module.new
-            stub_const("TestSubClass", stub, :transfer_nested_constants => true)
-            expect(stub::P).to eq(:p)
-            expect(defined?(stub::M)).to be_falsey
-            expect(defined?(stub::N)).to be_falsey
-          end
-
-          it 'raises an error when asked to transfer a nested inherited constant' do
-            original_tsc = TestSubClass
-
-            expect {
-              stub_const("TestSubClass", Module.new, :transfer_nested_constants => [:M])
-            }.to raise_error(ArgumentError)
-
-            expect(TestSubClass).to be(original_tsc)
-          end
-
-          it 'allows nested constants to be selectively transferred to a stub module' do
-            stub = Module.new
-            stub_const("TestClass", stub, :transfer_nested_constants => [:M, :N])
-            expect(stub::M).to eq(:m)
-            expect(stub::N).to eq(:n)
-            expect(defined?(stub::Nested)).to be_falsey
-          end
-
-          it 'raises an error if asked to transfer nested constants but given an object that does not support them' do
-            original_tc = TestClass
-            stub = Object.new
-            expect {
-              stub_const("TestClass", stub, :transfer_nested_constants => true)
-            }.to raise_error(ArgumentError)
-
-            expect(TestClass).to be(original_tc)
-
-            expect {
-              stub_const("TestClass", stub, :transfer_nested_constants => [:M])
-            }.to raise_error(ArgumentError)
-
-            expect(TestClass).to be(original_tc)
-          end
-
-          it 'raises an error if asked to transfer nested constants on a constant that does not support nested constants' do
-            stub = Module.new
-            expect {
-              stub_const("TOP_LEVEL_VALUE_CONST", stub, :transfer_nested_constants => true)
-            }.to raise_error(ArgumentError)
-
-            expect(TOP_LEVEL_VALUE_CONST).to eq(7)
-
-            expect {
-              stub_const("TOP_LEVEL_VALUE_CONST", stub, :transfer_nested_constants => [:M])
-            }.to raise_error(ArgumentError)
-
-            expect(TOP_LEVEL_VALUE_CONST).to eq(7)
-          end
-
-          it 'raises an error if asked to transfer a nested constant that is not defined' do
-            original_tc = TestClass
-            expect(defined?(TestClass::V)).to be_falsey
-            stub = Module.new
-
-            expect {
-              stub_const("TestClass", stub, :transfer_nested_constants => [:V])
-            }.to raise_error(/cannot transfer nested constant.*V/i)
-
-            expect(TestClass).to be(original_tc)
-          end
-
-          describe 'with global transfer_nested_constant option set' do
-            include_context "with isolated configuration"
-
-            before do
-              RSpec::Mocks.configuration.transfer_nested_constants = true
-            end
-
-            it 'allows nested constants to be transferred to a stub module' do
-              tc_nested = TestClass::Nested
-              stub = Module.new
-              stub_const("TestClass", stub)
-              expect(stub::M).to eq(:m)
-              expect(stub::N).to eq(:n)
-              expect(stub::Nested).to be(tc_nested)
-            end
-          end
-
-        end
-
-        context 'for a loaded nested constant' do
-          it_behaves_like "loaded constant stubbing", "TestClass::Nested"
-        end
-
-        context 'for a loaded constant prefixed with ::' do
-          it_behaves_like 'loaded constant stubbing', "::TestClass"
-        end
-
-        context 'for an unloaded constant prefixed with ::' do
-          it_behaves_like 'unloaded constant stubbing', "::SomeUndefinedConst"
-        end
-
-        context "for an unloaded constant nested in a module that redefines `send`" do
-          it_behaves_like 'unloaded constant stubbing', "TestClassThatDefinesSend::SomeUndefinedConst"
-        end
-
-        context 'for an unloaded constant with nested name that matches a top-level constant' do
-          it_behaves_like "unloaded constant stubbing", "TestClass::Hash"
-        end
-
-        context 'for a loaded deeply nested constant' do
-          it_behaves_like "loaded constant stubbing", "TestClass::Nested::NestedEvenMore"
-        end
-
-        context 'for an unloaded unnested constant' do
-          it_behaves_like "unloaded constant stubbing", "X"
-        end
-
-        context 'for an unloaded nested constant' do
-          it_behaves_like "unloaded constant stubbing", "X::Y"
-
-          it 'removes the root constant when rspec clears its mocks' do
-            expect(defined?(X)).to be_falsey
-            stub_const("X::Y", 7)
-            reset_rspec_mocks
-            expect(defined?(X)).to be_falsey
-          end
-        end
-
-        context 'for an unloaded deeply nested constant' do
-          it_behaves_like "unloaded constant stubbing", "X::Y::Z"
-
-          it 'removes the root constant when rspec clears its mocks' do
-            expect(defined?(X)).to be_falsey
-            stub_const("X::Y::Z", 7)
-            reset_rspec_mocks
-            expect(defined?(X)).to be_falsey
-          end
-        end
-
-        context 'for an unloaded constant nested within a loaded constant' do
-          it_behaves_like "unloaded constant stubbing", "TestClass::X"
-
-          it 'removes the unloaded constant but leaves the loaded constant when rspec resets its mocks' do
-            expect(defined?(TestClass)).to be_truthy
-            expect(defined?(TestClass::X)).to be_falsey
-            stub_const("TestClass::X", 7)
-            reset_rspec_mocks
-            expect(defined?(TestClass)).to be_truthy
-            expect(defined?(TestClass::X)).to be_falsey
-          end
-
-          it 'raises a helpful error if it cannot be stubbed due to an intermediary constant that is not a module' do
-            expect(TestClass::M).to be_a(Symbol)
-            expect { stub_const("TestClass::M::X", 5) }.to raise_error(/cannot stub/i)
-          end
-        end
-
-        context 'for an unloaded constant nested deeply within a deeply nested loaded constant' do
-          it_behaves_like "unloaded constant stubbing", "TestClass::Nested::NestedEvenMore::X::Y::Z"
-
-          it 'removes the first unloaded constant but leaves the loaded nested constant when rspec resets its mocks' do
-            expect(defined?(TestClass::Nested::NestedEvenMore)).to be_truthy
-            expect(defined?(TestClass::Nested::NestedEvenMore::X)).to be_falsey
-            stub_const("TestClass::Nested::NestedEvenMore::X::Y::Z", 7)
-            reset_rspec_mocks
-            expect(defined?(TestClass::Nested::NestedEvenMore)).to be_truthy
-            expect(defined?(TestClass::Nested::NestedEvenMore::X)).to be_falsey
-          end
-        end
-      end
-    end
-
-    describe Constant do
-      describe ".original" do
-        context 'for a previously defined unstubbed constant' do
-          let(:const) { Constant.original("TestClass::M") }
-
-          it("exposes its name")                    { expect(const.name).to eq("TestClass::M") }
-          it("indicates it was previously defined") { expect(const).to be_previously_defined }
-          it("indicates it has not been mutated")   { expect(const).not_to be_mutated }
-          it("indicates it has not been stubbed")   { expect(const).not_to be_stubbed }
-          it("indicates it has not been hidden")    { expect(const).not_to be_hidden }
-          it("exposes its original value")          { expect(const.original_value).to eq(:m) }
-        end
-
-        context 'for a previously defined stubbed constant' do
-          before { stub_const("TestClass::M", :other) }
-          let(:const) { Constant.original("TestClass::M") }
-
-          it("exposes its name")                    { expect(const.name).to eq("TestClass::M") }
-          it("indicates it was previously defined") { expect(const).to be_previously_defined }
-          it("indicates it has been mutated")       { expect(const).to be_mutated }
-          it("indicates it has been stubbed")       { expect(const).to be_stubbed }
-          it("indicates it has not been hidden")    { expect(const).not_to be_hidden }
-          it("exposes its original value")          { expect(const.original_value).to eq(:m) }
-        end
-
-        context 'for a previously undefined stubbed constant' do
-          before { stub_const("TestClass::Undefined", :other) }
-          let(:const) { Constant.original("TestClass::Undefined") }
-
-          it("exposes its name")                        { expect(const.name).to eq("TestClass::Undefined") }
-          it("indicates it was not previously defined") { expect(const).not_to be_previously_defined }
-          it("indicates it has been mutated")           { expect(const).to be_mutated }
-          it("indicates it has been stubbed")           { expect(const).to be_stubbed }
-          it("indicates it has not been hidden")        { expect(const).not_to be_hidden }
-          it("returns nil for the original value")      { expect(const.original_value).to be_nil }
-        end
-
-        context 'for a previously undefined parent of a stubbed constant' do
-          before { stub_const("TestClass::UndefinedModule::Undefined", :other) }
-          let(:const) { Constant.original("TestClass::UndefinedModule") }
-
-          it("exposes its name")                        { expect(const.name).to eq("TestClass::UndefinedModule") }
-          it("indicates it was not previously defined") { expect(const).not_to be_previously_defined }
-          it("indicates it has been mutated")           { expect(const).to be_mutated }
-          it("indicates it has been stubbed")           { expect(const).to be_stubbed }
-          it("indicates it has not been hidden")        { expect(const).not_to be_hidden }
-          it("returns nil for the original value")      { expect(const.original_value).to be_nil }
-        end
-
-        context 'for a previously undefined unstubbed constant' do
-          let(:const) { Constant.original("TestClass::Undefined") }
-
-          it("exposes its name")                        { expect(const.name).to eq("TestClass::Undefined") }
-          it("indicates it was not previously defined") { expect(const).not_to be_previously_defined }
-          it("indicates it has not been mutated")       { expect(const).not_to be_mutated }
-          it("indicates it has not been stubbed")       { expect(const).not_to be_stubbed }
-          it("indicates it has not been hidden")        { expect(const).not_to be_hidden }
-          it("returns nil for the original value")      { expect(const.original_value).to be_nil }
-        end
-
-        context 'for a previously defined constant that has been stubbed twice' do
-          before { stub_const("TestClass::M", 1) }
-          before { stub_const("TestClass::M", 2) }
-          let(:const) { Constant.original("TestClass::M") }
-
-          it("exposes its name")                    { expect(const.name).to eq("TestClass::M") }
-          it("indicates it was previously defined") { expect(const).to be_previously_defined }
-          it("indicates it has been mutated")       { expect(const).to be_mutated }
-          it("indicates it has been stubbed")       { expect(const).to be_stubbed }
-          it("indicates it has not been hidden")    { expect(const).not_to be_hidden }
-          it("exposes its original value")          { expect(const.original_value).to eq(:m) }
-        end
-
-        context 'for a previously undefined constant that has been stubbed twice' do
-          before { stub_const("TestClass::Undefined", 1) }
-          before { stub_const("TestClass::Undefined", 2) }
-          let(:const) { Constant.original("TestClass::Undefined") }
-
-          it("exposes its name")                        { expect(const.name).to eq("TestClass::Undefined") }
-          it("indicates it was not previously defined") { expect(const).not_to be_previously_defined }
-          it("indicates it has been mutated")           { expect(const).to be_mutated }
-          it("indicates it has been stubbed")           { expect(const).to be_stubbed }
-          it("indicates it has not been hidden")        { expect(const).not_to be_hidden }
-          it("returns nil for the original value")      { expect(const.original_value).to be_nil }
-        end
-
-        context 'for a previously undefined hidden constant' do
-          before { hide_const("SomeUndefinedConst") }
-          let(:const) { Constant.original("SomeUndefinedConst") }
-
-          it("exposes its name")                      { expect(const.name).to eq("SomeUndefinedConst") }
-          it("indicates it was previously undefined") { expect(const).not_to be_previously_defined }
-          it("indicates it has not been mutated")     { expect(const).not_to be_mutated }
-          it("indicates it has not not been stubbed") { expect(const).not_to be_stubbed }
-          it("indicates it has not been hidden")      { expect(const).not_to be_hidden }
-          it("returns nil for the original value")    { expect(const.original_value).to be_nil }
-        end
-
-        context 'for a previously defined hidden constant' do
-          before { hide_const("TestClass::M") }
-          let(:const) { Constant.original("TestClass::M") }
-
-          it("exposes its name")                    { expect(const.name).to eq("TestClass::M") }
-          it("indicates it was previously defined") { expect(const).to be_previously_defined }
-          it("indicates it has been mutated")       { expect(const).to be_mutated }
-          it("indicates it has not been stubbed")   { expect(const).not_to be_stubbed }
-          it("indicates it has been hidden")        { expect(const).to be_hidden }
-          it("exposes its original value")          { expect(const.original_value).to eq(:m) }
-        end
-
-        context 'for a previously defined constant that has been hidden twice' do
-          before { hide_const("TestClass::M") }
-          before { hide_const("TestClass::M") }
-          let(:const) { Constant.original("TestClass::M") }
-
-          it("exposes its name")                    { expect(const.name).to eq("TestClass::M") }
-          it("indicates it was previously defined") { expect(const).to be_previously_defined }
-          it("indicates it has been mutated")       { expect(const).to be_mutated }
-          it("indicates it has not been stubbed")   { expect(const).not_to be_stubbed }
-          it("indicates it has been hidden")        { expect(const).to be_hidden }
-          it("exposes its original value")          { expect(const.original_value).to eq(:m) }
-        end
-      end
-    end
-  end
-end