opal-connect-rspec 0.5.0

data/rspec-mocks/spec/rspec/mocks/methods_spec.rb

@@ -0,0 +1,24 @@
+module RSpec
+  module Mocks
+    RSpec.describe "Methods added to every object" do
+      include_context "with syntax", :expect
+
+      def added_methods
+        host = Class.new
+        orig_instance_methods = host.instance_methods
+        Syntax.enable_should(host)
+        (host.instance_methods - orig_instance_methods).map(&:to_sym)
+      end
+
+      it 'limits the number of methods that get added to all objects' do
+        # If really necessary, you can add to this list, but long term,
+        # we are hoping to cut down on the number of methods added to all objects
+        expect(added_methods).to match_array([
+          :as_null_object, :null_object?,
+          :received_message?, :should_not_receive, :should_receive,
+          :stub, :stub_chain, :unstub
+        ])
+      end
+    end
+  end
+end

data/rspec-mocks/spec/rspec/mocks/mock_expectation_error_spec.rb

@@ -0,0 +1,20 @@
+module RSpec
+  module Mocks
+    RSpec.describe 'MockExpectationError' do
+
+      class Foo
+        def self.foo
+          bar
+        rescue StandardError
+        end
+      end
+
+      it 'is not caught by StandardError rescue blocks' do
+        expect(Foo).not_to receive(:bar)
+        expect {
+          Foo.foo
+        }.to raise_error(RSpec::Mocks::MockExpectationError)
+      end
+    end
+  end
+end

data/rspec-mocks/spec/rspec/mocks/mock_ordering_spec.rb

@@ -0,0 +1,112 @@
+module RSpec
+  module Mocks
+
+    RSpec.describe "ordering" do
+      before { @double = double("test double") }
+      after  { reset @double }
+
+      it "passes when messages are received in order" do
+        expect(@double).to receive(:one).ordered
+        expect(@double).to receive(:two).ordered
+        expect(@double).to receive(:three).ordered
+        @double.one
+        @double.two
+        @double.three
+      end
+
+      it "passes when messages are received in order" do
+        allow(@double).to receive(:something)
+        expect(@double).to receive(:one).ordered
+        expect(@double).to receive(:two).ordered
+        expect(@double).to receive(:three).at_least(:once).ordered
+        @double.one
+        @double.two
+        @double.three
+        @double.three
+      end
+
+      it "passes when messages are received in order across objects" do
+        a = double("a")
+        b = double("b")
+        expect(a).to receive(:one).ordered
+        expect(b).to receive(:two).ordered
+        expect(a).to receive(:three).ordered
+        a.one
+        b.two
+        a.three
+      end
+
+      it "fails when messages are received out of order (2nd message 1st)" do
+        expect(@double).to receive(:one).ordered
+        expect(@double).to receive(:two).ordered
+        expect {
+          @double.two
+        }.to raise_error(RSpec::Mocks::MockExpectationError, "Double \"test double\" received :two out of order")
+      end
+
+      it "fails when messages are received out of order (3rd message 1st)" do
+        expect(@double).to receive(:one).ordered
+        expect(@double).to receive(:two).ordered
+        expect(@double).to receive(:three).ordered
+        @double.one
+        expect {
+          @double.three
+        }.to raise_error(RSpec::Mocks::MockExpectationError, "Double \"test double\" received :three out of order")
+      end
+
+      it "fails when messages are received out of order (3rd message 2nd)" do
+        expect(@double).to receive(:one).ordered
+        expect(@double).to receive(:two).ordered
+        expect(@double).to receive(:three).ordered
+        @double.one
+        expect {
+          @double.three
+        }.to raise_error(RSpec::Mocks::MockExpectationError, "Double \"test double\" received :three out of order")
+      end
+
+      it "fails when messages are out of order across objects" do
+        a = double("test double")
+        b = double("another test double")
+        expect(a).to receive(:one).ordered
+        expect(b).to receive(:two).ordered
+        expect(a).to receive(:three).ordered
+        a.one
+        expect {
+          a.three
+        }.to raise_error(RSpec::Mocks::MockExpectationError, "Double \"test double\" received :three out of order")
+        reset a
+        reset b
+      end
+
+      it "ignores order of non ordered messages" do
+        expect(@double).to receive(:ignored_0)
+        expect(@double).to receive(:ordered_1).ordered
+        expect(@double).to receive(:ignored_1)
+        expect(@double).to receive(:ordered_2).ordered
+        expect(@double).to receive(:ignored_2)
+        expect(@double).to receive(:ignored_3)
+        expect(@double).to receive(:ordered_3).ordered
+        expect(@double).to receive(:ignored_4)
+        @double.ignored_3
+        @double.ordered_1
+        @double.ignored_0
+        @double.ordered_2
+        @double.ignored_4
+        @double.ignored_2
+        @double.ordered_3
+        @double.ignored_1
+        verify @double
+      end
+
+      it "supports duplicate messages" do
+        expect(@double).to receive(:a).ordered
+        expect(@double).to receive(:b).ordered
+        expect(@double).to receive(:a).ordered
+
+        @double.a
+        @double.b
+        @double.a
+      end
+    end
+  end
+end

data/rspec-mocks/spec/rspec/mocks/multiple_return_value_spec.rb

@@ -0,0 +1,130 @@
+module RSpec
+  module Mocks
+    RSpec.describe "a double stubbed with multiple return values" do
+      let(:a_double) { double }
+
+      before do
+        allow(a_double).to receive(:foo).and_return(:val_1, nil)
+      end
+
+      it 'can still set a message expectation with a single return value' do
+        expect(a_double).to receive(:foo).once.and_return(:val_1)
+        expect(a_double.foo).to eq(:val_1)
+      end
+    end
+
+    RSpec.describe "a message expectation with multiple return values and no specified count" do
+      before(:each) do
+        @double = double
+        @return_values = [1,2,3]
+        expect(@double).to receive(:do_something).and_return(@return_values[0],@return_values[1],@return_values[2])
+      end
+
+      it "returns values in order" do
+        expect(@double.do_something).to eq @return_values[0]
+        expect(@double.do_something).to eq @return_values[1]
+        expect(@double.do_something).to eq @return_values[2]
+        verify @double
+      end
+
+      it "falls back to a previously stubbed value" do
+        allow(@double).to receive_messages :do_something => :stub_result
+        expect(@double.do_something).to eq @return_values[0]
+        expect(@double.do_something).to eq @return_values[1]
+        expect(@double.do_something).to eq @return_values[2]
+        expect(@double.do_something).to eq :stub_result
+      end
+
+      it "fails when there are too few calls (if there is no stub)" do
+        @double.do_something
+        @double.do_something
+        expect { verify @double }.to raise_error
+      end
+
+      it "fails when there are too many calls (if there is no stub)" do
+        @double.do_something
+        @double.do_something
+        @double.do_something
+        @double.do_something
+        expect { verify @double }.to raise_error
+      end
+    end
+
+    RSpec.describe "a message expectation with multiple return values with a specified count equal to the number of values" do
+      before(:each) do
+        @double = double
+        @return_values = [1,2,3]
+        expect(@double).to receive(:do_something).exactly(3).times.and_return(@return_values[0], @return_values[1], @return_values[2])
+      end
+
+      it "returns values in order to consecutive calls" do
+        expect(@double.do_something).to eq @return_values[0]
+        expect(@double.do_something).to eq @return_values[1]
+        expect(@double.do_something).to eq @return_values[2]
+        verify @double
+      end
+    end
+
+    RSpec.describe "a message expectation with multiple return values specifying at_least less than the number of values" do
+      before(:each) do
+        @double = double
+        expect(@double).to receive(:do_something).at_least(:twice).with(no_args).and_return(11, 22)
+      end
+
+      it "uses the last return value for subsequent calls" do
+        expect(@double.do_something).to equal(11)
+        expect(@double.do_something).to equal(22)
+        expect(@double.do_something).to equal(22)
+        verify @double
+      end
+
+      it "fails when called less than the specified number" do
+        expect(@double.do_something).to equal(11)
+        expect { verify @double }.to raise_error(RSpec::Mocks::MockExpectationError)
+      end
+
+      context "when method is stubbed too" do
+        before { allow(@double).to receive(:do_something).and_return :stub_result }
+
+        it "uses the last value for subsequent calls" do
+          expect(@double.do_something).to equal(11)
+          expect(@double.do_something).to equal(22)
+          expect(@double.do_something).to equal(22)
+          verify @double
+        end
+
+        it "fails when called less than the specified number" do
+          expect(@double.do_something).to equal(11)
+          expect { verify @double }.to raise_error(RSpec::Mocks::MockExpectationError)
+        end
+      end
+    end
+
+    RSpec.describe "a message expectation with multiple return values with a specified count larger than the number of values" do
+      before(:each) do
+        @double = RSpec::Mocks::Double.new("double")
+        expect(@double).to receive(:do_something).exactly(3).times.and_return(11, 22)
+      end
+
+      it "uses the last return value for subsequent calls" do
+        expect(@double.do_something).to equal(11)
+        expect(@double.do_something).to equal(22)
+        expect(@double.do_something).to equal(22)
+        verify @double
+      end
+
+      it "fails when called less than the specified number" do
+        @double.do_something
+        @double.do_something
+        expect { verify @double }.to raise_error
+      end
+
+      it "fails fast when called greater than the specified number" do
+        @double.do_something
+        @double.do_something
+        @double.do_something
+        expect { @double.do_something }.to raise_error
+      end
+    end
+  end
+end

data/rspec-mocks/spec/rspec/mocks/mutate_const_spec.rb

@@ -0,0 +1,561 @@
+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
+    RSpec.describe "Constant Mutating" do
+      include RSpec::Support::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 "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 "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 "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 "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 'removes the transferred constants on reset' do
+            stub = Module.new
+            stub_const("TestClass", stub, :transfer_nested_constants => true)
+
+            expect {
+              reset_all
+            }.to change { stub.constants }.to([])
+          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
+
+            context "when stubbing a constant that is not a module or a class" do
+              it 'does not attempt to transfer constants' do
+                stub_const("TOP_LEVEL_VALUE_CONST", 4)
+                expect(TOP_LEVEL_VALUE_CONST).to eq(4)
+              end
+
+              it 'still raises an error when the `:transfer_nested_constants` option is provided' do
+                expect {
+                  stub_const("TOP_LEVEL_VALUE_CONST", 4, :transfer_nested_constants => true)
+                }.to raise_error(/cannot transfer nested constant/i)
+              end
+            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
+
+    RSpec.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