dxruby_rp5 0.0.1

data/spec/vendor/rspec-core-2.14.7/spec/rspec/core/memoized_helpers_spec.rb

@@ -0,0 +1,688 @@
+require 'spec_helper'
+
+module RSpec::Core
+  describe MemoizedHelpers do
+    before(:each) { RSpec.configuration.configure_expectation_framework }
+
+    def subject_value_for(describe_arg, &block)
+      group = ExampleGroup.describe(describe_arg, &block)
+      subject_value = nil
+      group.example { subject_value = subject }
+      group.run
+      subject_value
+    end
+
+    describe "implicit subject" do
+      describe "with a class" do
+        it "returns an instance of the class" do
+          expect(subject_value_for(Array)).to eq([])
+        end
+      end
+
+      describe "with a Module" do
+        it "returns the Module" do
+          expect(subject_value_for(Enumerable)).to eq(Enumerable)
+        end
+      end
+
+      describe "with a string" do
+        it "returns the string" do
+          expect(subject_value_for("Foo")).to eq("Foo")
+        end
+      end
+
+      describe "with a number" do
+        it "returns the number" do
+          expect(subject_value_for(15)).to eq(15)
+        end
+      end
+
+      it "can be overriden and super'd to from a nested group" do
+        outer_subject_value = inner_subject_value = nil
+
+        ExampleGroup.describe(Array) do
+          subject { super() << :parent_group }
+          example { outer_subject_value = subject }
+
+          context "nested" do
+            subject { super() << :child_group }
+            example { inner_subject_value = subject }
+          end
+        end.run
+
+        expect(outer_subject_value).to eq([:parent_group])
+        expect(inner_subject_value).to eq([:parent_group, :child_group])
+      end
+    end
+
+    describe "explicit subject" do
+      [false, nil].each do |falsy_value|
+        context "with a value of #{falsy_value.inspect}" do
+          it "is evaluated once per example" do
+            group = ExampleGroup.describe(Array)
+            group.before do
+              Object.should_receive(:this_question?).once.and_return(falsy_value)
+            end
+            group.subject do
+              Object.this_question?
+            end
+            group.example do
+              subject
+              subject
+            end
+            expect(group.run).to be_true, "expected subject block to be evaluated only once"
+          end
+        end
+      end
+
+      describe "defined in a top level group" do
+        it "replaces the implicit subject in that group" do
+          subject_value = subject_value_for(Array) do
+            subject { [1, 2, 3] }
+          end
+          expect(subject_value).to eq([1, 2, 3])
+        end
+      end
+
+      describe "defined in a top level group" do
+        let(:group) do
+          ExampleGroup.describe do
+            subject{ [4, 5, 6] }
+          end
+        end
+
+        it "is available in a nested group (subclass)" do
+          subject_value = nil
+          group.describe("I'm nested!") do
+            example { subject_value = subject }
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6])
+        end
+
+        it "is available in a doubly nested group (subclass)" do
+          subject_value = nil
+          group.describe("Nesting level 1") do
+            describe("Nesting level 2") do
+              example { subject_value = subject }
+            end
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6])
+        end
+
+        it "can be overriden and super'd to from a nested group" do
+          subject_value = nil
+          group.describe("Nested") do
+            subject { super() + [:override] }
+            example { subject_value = subject }
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6, :override])
+        end
+
+        context 'when referenced in a `before(:all)` hook' do
+          before do
+            expect(::RSpec).to respond_to(:warn_deprecation)
+            ::RSpec.stub(:warn_deprecation)
+          end
+
+          def define_and_run_group
+            values = { :reference_lines => [] }
+
+            ExampleGroup.describe do
+              subject { [1, 2] }
+              let(:list) { %w[ a b ] }
+
+              before(:all) do
+                subject << 3; values[:reference_lines] << __LINE__
+                values[:final_subject_value_in_before_all] = subject; values[:reference_lines] << __LINE__
+              end
+
+              example do
+                list << '1'
+                values[:list_in_ex_1] = list
+                values[:subject_value_in_example] = subject
+              end
+
+              example do
+                list << '2'
+                values[:list_in_ex_2] = list
+              end
+            end.run
+
+            values
+          end
+
+          it 'memoizes the value within the before(:all) hook' do
+            values = define_and_run_group
+            expect(values.fetch(:final_subject_value_in_before_all)).to eq([1, 2, 3])
+          end
+
+          it 'preserves the memoization into the individual examples' do
+            values = define_and_run_group
+            expect(values.fetch(:subject_value_in_example)).to eq([1, 2, 3])
+          end
+
+          it 'does not cause other lets to be shared across examples' do
+            values = define_and_run_group
+            expect(values.fetch(:list_in_ex_1)).to eq(%w[ a b 1 ])
+            expect(values.fetch(:list_in_ex_2)).to eq(%w[ a b 2 ])
+          end
+
+          it 'prints a warning since `subject` declarations are not intended to be used in :all hooks' do
+            msgs = []
+            ::RSpec.stub(:warn_deprecation) { |msg| msgs << msg }
+
+            values = define_and_run_group
+
+            expect(msgs).to include(*values[:reference_lines].map { |line|
+              match(/subject accessed.*#{__FILE__}:#{line}/m)
+            })
+          end
+        end
+      end
+
+      describe "with a name" do
+        it "defines a method that returns the memoized subject" do
+          list_value_1 = list_value_2 = subject_value_1 = subject_value_2 = nil
+
+          ExampleGroup.describe do
+            subject(:list) { [1, 2, 3] }
+            example do
+              list_value_1 = list
+              list_value_2 = list
+              subject_value_1 = subject
+              subject_value_2 = subject
+            end
+          end.run
+
+          expect(list_value_1).to eq([1, 2, 3])
+          expect(list_value_1).to equal(list_value_2)
+
+          expect(subject_value_1).to equal(subject_value_2)
+          expect(subject_value_1).to equal(list_value_1)
+        end
+
+        it "is referred from inside subject by the name" do
+          inner_subject_value = nil
+
+          ExampleGroup.describe do
+            subject(:list) { [1, 2, 3] }
+            describe 'first' do
+              subject(:first_element) { list.first }
+              example { inner_subject_value = subject }
+            end
+          end.run
+
+          expect(inner_subject_value).to eq(1)
+        end
+
+        it 'can continue to be referenced by the name even when an inner group redefines the subject' do
+          named_value = nil
+
+          ExampleGroup.describe do
+            subject(:named) { :outer }
+
+            describe "inner" do
+              subject { :inner }
+              example do
+                subject # so the inner subject method is run and memoized
+                named_value = self.named
+              end
+            end
+          end.run
+
+          expect(named_value).to eq(:outer)
+        end
+
+        it 'can continue to reference an inner subject after the outer subject name is referenced' do
+          subject_value = nil
+
+          ExampleGroup.describe do
+            subject(:named) { :outer }
+
+            describe "inner" do
+              subject { :inner }
+              example do
+                named # so the outer subject method is run and memoized
+                subject_value = self.subject
+              end
+            end
+          end.run
+
+          expect(subject_value).to eq(:inner)
+        end
+
+        it 'is not overriden when an inner group defines a new method with the same name' do
+          subject_value = nil
+
+          ExampleGroup.describe do
+            subject(:named) { :outer_subject }
+
+            describe "inner" do
+              let(:named) { :inner_named }
+              example { subject_value = self.subject }
+            end
+          end.run
+
+          expect(subject_value).to be(:outer_subject)
+        end
+
+        context 'when `super` is used' do
+          def should_raise_not_supported_error(&block)
+            ex = nil
+
+            ExampleGroup.describe do
+              let(:list) { ["a", "b", "c"] }
+              subject { [1, 2, 3] }
+
+              describe 'first' do
+                module_eval(&block) if block
+
+                subject(:list) { super().first(2) }
+                ex = example { subject }
+              end
+            end.run
+
+            expect(ex.execution_result[:status]).to eq("failed")
+            expect(ex.execution_result[:exception].message).to match(/super.*not supported/)
+          end
+
+          it 'raises a "not supported" error' do
+            should_raise_not_supported_error
+          end
+
+          context 'with a `let` definition before the named subject' do
+            it 'raises a "not supported" error' do
+              should_raise_not_supported_error do
+                # My first pass implementation worked unless there was a `let`
+                # declared before the named subject -- this let is in place to
+                # ensure that bug doesn't return.
+                let(:foo) { 3 }
+              end
+            end
+          end
+        end
+      end
+    end
+
+    context "using 'self' as an explicit subject" do
+      it "delegates matcher to the ExampleGroup" do
+        group = ExampleGroup.describe("group") do
+          subject { self }
+          def ok?; true; end
+          def not_ok?; false; end
+
+          it { should eq(self) }
+          it { should be_ok }
+          it { should_not be_not_ok }
+        end
+
+        expect(group.run).to be_true
+      end
+    end
+
+    describe "#its" do
+      subject do
+        Class.new do
+          def initialize
+            @call_count = 0
+          end
+
+          def call_count
+            @call_count += 1
+          end
+        end.new
+      end
+
+      context "with a call counter" do
+        its(:call_count) { should eq(1) }
+      end
+
+      context "with nil value" do
+        subject do
+          Class.new do
+            def nil_value
+              nil
+            end
+          end.new
+        end
+        its(:nil_value) { should be_nil }
+      end
+
+      context "with nested attributes" do
+        subject do
+          Class.new do
+            def name
+              "John"
+            end
+          end.new
+        end
+        its("name")            { should eq("John") }
+        its("name.size")       { should eq(4) }
+        its("name.size.class") { should eq(Fixnum) }
+      end
+
+      context "when it responds to #[]" do
+        subject do
+          Class.new do
+            def [](*objects)
+              objects.map do |object|
+                "#{object.class}: #{object.to_s}"
+              end.join("; ")
+            end
+
+            def name
+              "George"
+            end
+          end.new
+        end
+        its([:a]) { should eq("Symbol: a") }
+        its(['a']) { should eq("String: a") }
+        its([:b, 'c', 4]) { should eq("Symbol: b; String: c; Fixnum: 4") }
+        its(:name) { should eq("George") }
+        context "when referring to an attribute without the proper array syntax" do
+          context "it raises an error" do
+            its(:age) do
+              expect do
+                should eq(64)
+              end.to raise_error(NoMethodError)
+            end
+          end
+        end
+      end
+
+      context "when it does not respond to #[]" do
+        subject { Object.new }
+
+        context "it raises an error" do
+          its([:a]) do
+            expect do
+              should eq("Symbol: a")
+            end.to raise_error(NoMethodError)
+          end
+        end
+      end
+
+      context "calling and overriding super" do
+        it "calls to the subject defined in the parent group" do
+          group = ExampleGroup.describe(Array) do
+            subject { [1, 'a'] }
+
+            its(:last) { should eq("a") }
+
+            describe '.first' do
+              def subject; super().first; end
+
+              its(:next) { should eq(2) }
+            end
+          end
+
+          expect(group.run).to be_true
+        end
+      end
+
+      context "with nil subject" do
+        subject do
+          Class.new do
+            def initialize
+              @counter = -1
+            end
+            def nil_if_first_time
+              @counter += 1
+              @counter == 0 ? nil : true
+            end
+          end.new
+        end
+        its(:nil_if_first_time) { should be(nil) }
+      end
+
+      context "with false subject" do
+        subject do
+          Class.new do
+            def initialize
+              @counter = -1
+            end
+            def false_if_first_time
+              @counter += 1
+              @counter > 0
+            end
+          end.new
+        end
+        its(:false_if_first_time) { should be(false) }
+      end
+
+      describe 'accessing `subject` in `before` and `let`' do
+        subject { 'my subject' }
+        before { @subject_in_before = subject }
+        let(:subject_in_let) { subject }
+        let!(:eager_loaded_subject_in_let) { subject }
+
+        # These examples read weird, because we're actually
+        # specifying the behaviour of `its` itself
+        its(nil) { expect(subject).to eq('my subject') }
+        its(nil) { expect(@subject_in_before).to eq('my subject') }
+        its(nil) { expect(subject_in_let).to eq('my subject') }
+        its(nil) { expect(eager_loaded_subject_in_let).to eq('my subject') }
+      end
+    end
+
+    describe '#subject!' do
+      let(:prepared_array) { [1,2,3] }
+      subject! { prepared_array.pop }
+
+      it "evaluates subject before example" do
+        expect(prepared_array).to eq([1,2])
+      end
+
+      it "returns memoized value from first invocation" do
+        expect(subject).to eq(3)
+      end
+    end
+  end
+
+  describe "#let" do
+    let(:counter) do
+      Class.new do
+        def initialize
+          @count = 0
+        end
+        def count
+          @count += 1
+        end
+      end.new
+    end
+
+    let(:nil_value) do
+      @nil_value_count += 1
+      nil
+    end
+
+    it "generates an instance method" do
+      expect(counter.count).to eq(1)
+    end
+
+    it "caches the value" do
+      expect(counter.count).to eq(1)
+      expect(counter.count).to eq(2)
+    end
+
+    it "caches a nil value" do
+      @nil_value_count = 0
+      nil_value
+      nil_value
+
+      expect(@nil_value_count).to eq(1)
+    end
+
+    let(:regex_with_capture) { %r[RegexWithCapture(\d)] }
+
+    it 'does not pass the block up the ancestor chain' do
+      # Test for Ruby bug http://bugs.ruby-lang.org/issues/8059
+      expect("RegexWithCapture1".match(regex_with_capture)[1]).to eq('1')
+    end
+
+    it 'raises a useful error when called without a block' do
+      expect do
+        ExampleGroup.describe { let(:list) }
+      end.to raise_error(/#let or #subject called without a block/)
+    end
+
+    let(:a_value) { "a string" }
+
+    context 'when overriding let in a nested context' do
+      let(:a_value) { super() + " (modified)" }
+
+      it 'can use `super` to reference the parent context value' do
+        expect(a_value).to eq("a string (modified)")
+      end
+    end
+
+    context 'when the declaration uses `return`' do
+      let(:value) do
+        return :early_exit if @early_exit
+        :late_exit
+      end
+
+      it 'can exit the let declaration early' do
+        @early_exit = true
+        expect(value).to eq(:early_exit)
+      end
+
+      it 'can get past a conditional `return` statement' do
+        @early_exit = false
+        expect(value).to eq(:late_exit)
+      end
+    end
+
+    context 'when referenced in a `before(:all)` hook' do
+      before do
+        expect(::RSpec).to respond_to(:warn_deprecation)
+        ::RSpec.stub(:warn_deprecation)
+      end
+
+      def define_and_run_group
+        values = { :reference_lines => [] }
+
+        ExampleGroup.describe do
+          let(:list) { [1, 2] }
+          subject { %w[ a b ] }
+
+          before(:all) do
+            list << 3; values[:reference_lines] << __LINE__
+            values[:final_list_value_in_before_all] = list; values[:reference_lines] << __LINE__
+          end
+
+          example do
+            subject << "1"
+            values[:subject_in_ex_1] = subject
+            values[:list_value_in_example] = list
+          end
+
+          example do
+            subject << "2"
+            values[:subject_in_ex_2] = subject
+          end
+        end.run
+
+        values
+      end
+
+      it 'memoizes the value within the before(:all) hook' do
+        values = define_and_run_group
+        expect(values.fetch(:final_list_value_in_before_all)).to eq([1, 2, 3])
+      end
+
+      it 'preserves the memoized value into the examples' do
+        values = define_and_run_group
+        expect(values.fetch(:list_value_in_example)).to eq([1, 2, 3])
+      end
+
+      it 'does not cause the subject to be shared across examples' do
+        values = define_and_run_group
+        expect(values.fetch(:subject_in_ex_1)).to eq(%w[ a b 1 ])
+        expect(values.fetch(:subject_in_ex_2)).to eq(%w[ a b 2 ])
+      end
+
+      it 'prints a warning since `let` declarations are not intended to be used in :all hooks' do
+        msgs = []
+        ::RSpec.stub(:warn_deprecation) { |msg| msgs << msg }
+
+        values = define_and_run_group
+
+        expect(msgs).to include(*values[:reference_lines].map { |line|
+          match(/let declaration `list` accessed.*#{__FILE__}:#{line}/m)
+        })
+      end
+    end
+
+    context "when included modules have hooks that define memoized helpers" do
+      it "allows memoized helpers to override methods in previously included modules" do
+        group = ExampleGroup.describe do
+          include Module.new {
+            def self.included(m); m.let(:unrelated) { :unrelated }; end
+          }
+
+          include Module.new {
+            def hello_message; "Hello from module"; end
+          }
+
+          let(:hello_message) { "Hello from let" }
+        end
+
+        expect(group.new.hello_message).to eq("Hello from let")
+      end
+    end
+  end
+
+  describe "#let!" do
+    subject { [1,2,3] }
+    let!(:popped) { subject.pop }
+
+    it "evaluates the value non-lazily" do
+      expect(subject).to eq([1,2])
+    end
+
+    it "returns memoized value from first invocation" do
+      expect(popped).to eq(3)
+    end
+  end
+
+  describe 'using subject in before and let blocks' do
+    shared_examples_for 'a subject' do
+      let(:subject_id_in_let) { subject.object_id }
+      before { @subject_id_in_before = subject.object_id }
+
+      it 'should be memoized' do
+        expect(subject_id_in_let).to eq(@subject_id_in_before)
+      end
+
+      it { should eq(subject) }
+    end
+
+    describe Object do
+      context 'with implicit subject' do
+        it_should_behave_like 'a subject'
+      end
+
+      context 'with explicit subject' do
+        subject { Object.new }
+        it_should_behave_like 'a subject'
+      end
+
+      context 'with a constant subject'do
+        subject { 123 }
+        it_should_behave_like 'a subject'
+      end
+    end
+  end
+
+  describe 'Module#define_method' do
+    it 'is still a private method' do
+      a_module = Module.new
+      expect { a_module.define_method(:name) { "implementation" } }.to raise_error NoMethodError
+    end
+  end
+end
+