rspec 0.7.5.1 → 0.8.0

data/spec/spec/mocks/mock_spec.rb

@@ -0,0 +1,407 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Mocks
+    context "a Mock expectation" do
+
+      setup do
+        @mock = Mock.new("test mock", :auto_verify => false)
+      end
+      
+      specify "should report line number of expectation of unreceived message" do
+        @mock.should_receive(:wont_happen).with("x", 3)
+        #NOTE - this test is quite ticklish because it specifies that
+        #the above statement appears on line 12 of this file.
+
+        begin
+          @mock.__verify
+          violated
+        rescue MockExpectationError => e
+          e.backtrace[0].should_match(/mock_spec\.rb:12/)
+        end
+    
+      end
+      
+      specify "should pass when not receiving message specified as not to be received" do
+        @mock.should_not_receive(:not_expected)
+        @mock.__verify
+      end
+
+      specify "should pass when receiving message specified as not to be received with different args" do
+        @mock.should_not_receive(:message).with("unwanted text")
+        @mock.should_receive(:message).with("other text")
+        @mock.message "other text"
+        @mock.__verify
+      end
+
+      specify "should fail when receiving message specified as not to be received" do
+        @mock.should_not_receive(:not_expected)
+        @mock.not_expected
+        begin
+          @mock.__verify
+          violated
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :not_expected with (any args) 0 times, but received it once"
+        end
+      end
+
+      specify "should fail when receiving message specified as not to be received with args" do
+        @mock.should_not_receive(:not_expected).with("unexpected text")
+        @mock.not_expected("unexpected text")
+        begin
+          @mock.__verify
+          violated
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :not_expected with (\"unexpected text\") 0 times, but received it once"
+        end
+      end
+
+      specify "should pass when receiving message specified as not to be received with wrong args" do
+        @mock.should_not_receive(:not_expected).with("unexpected text")
+        @mock.not_expected "really unexpected text"
+        @mock.__verify
+      end
+
+      specify "should allow block to calculate return values" do
+        @mock.should_receive(:something).with("a","b","c").and_return { |a,b,c| c+b+a }
+        @mock.something("a","b","c").should_eql "cba"
+        @mock.__verify
+      end
+
+      specify "should allow parameter as return value" do
+        @mock.should_receive(:something).with("a","b","c").and_return("booh")
+        @mock.something("a","b","c").should_eql "booh"
+        @mock.__verify
+      end
+
+      specify "should return nil if no return value set" do
+        @mock.should_receive(:something).with("a","b","c")
+        @mock.something("a","b","c").should be(nil)
+        @mock.__verify
+      end
+
+      specify "should raise exception if args dont match when method called" do
+        @mock.should_receive(:something).with("a","b","c").and_return("booh")
+        begin
+          @mock.something("a","d","c")
+          violated
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :something with (\"a\", \"b\", \"c\") but received it with (\"a\", \"d\", \"c\")"
+        end
+      end
+     
+      specify "should fail if unexpected method called" do
+        begin
+          @mock.something("a","b","c")
+          violated
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' received unexpected message :something with (\"a\", \"b\", \"c\")"
+        end
+      end
+  
+      specify "should use block for expectation if provided" do
+        @mock.should_receive(:something) do | a, b |
+          a.should_eql "a"
+          b.should_eql "b"
+          "booh"
+        end
+        @mock.something("a", "b").should_eql "booh"
+        @mock.__verify
+      end
+  
+      specify "should fail if expectation block fails" do
+        @mock.should_receive(:something) {| bool | bool.should be(true)}
+        begin
+          @mock.something false
+        rescue MockExpectationError => e
+          e.message.should_match /Mock 'test mock' received :something but passed block failed with: expected true, got false/
+        end
+      end
+  
+      specify "should fail when method defined as never is received" do
+        @mock.should_receive(:not_expected).never
+        begin
+          @mock.not_expected
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :not_expected 0 times, but received it 1 times"
+        end
+      end
+      
+      specify "should raise when told to" do
+        @mock.should_receive(:something).and_raise(RuntimeError)
+        lambda do
+          @mock.something
+        end.should_raise(RuntimeError)
+      end
+ 
+      specify "should raise passed an Exception instance" do
+        error = RuntimeError.new("error message")
+        @mock.should_receive(:something).and_raise(error)
+        begin
+          @mock.something
+        rescue RuntimeError => e
+          e.message.should_eql("error message")
+        end
+      end
+
+      specify "should raise RuntimeError with passed message" do
+        @mock.should_receive(:something).and_raise("error message")
+        begin
+          @mock.something
+        rescue RuntimeError => e
+          e.message.should_eql("error message")
+        end
+      end
+ 
+      specify "should not raise when told to if args dont match" do
+        @mock.should_receive(:something).with(2).and_raise(RuntimeError)
+        lambda do
+          @mock.something 1
+        end.should_raise(MockExpectationError)
+      end
+ 
+      specify "should throw when told to" do
+        @mock.should_receive(:something).and_throw(:blech)
+        lambda do
+          @mock.something
+        end.should_throw(:blech)
+      end
+
+      specify "should raise when explicit return and block constrained" do
+        lambda do
+          @mock.should_receive(:fruit) do |colour|
+            :strawberry
+          end.and_return :apple
+        end.should_raise(AmbiguousReturnError)
+      end
+      
+      specify "should ignore args on any args" do
+        @mock.should_receive(:something).at_least(:once).with(:any_args)
+        @mock.something
+        @mock.something 1
+        @mock.something "a", 2
+        @mock.something [], {}, "joe", 7
+        @mock.__verify
+      end
+      
+      specify "should fail on no args if any args received" do
+        @mock.should_receive(:something).with(:no_args)
+        begin
+          @mock.something 1
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :something with (no args) but received it with (1)"
+        end
+      end
+      
+      specify "should fail when args are expected but none are received" do
+        @mock.should_receive(:something).with(1)
+        begin
+          @mock.something
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' expected :something with (1) but received it with (no args)"
+        end
+      end
+
+      specify "should yield 0 args to blocks that take a variable number of arguments" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield
+        a = nil
+        @mock.yield_back {|*a|}
+        a.should_eql []
+        @mock.__verify
+      end
+
+      specify "should yield one arg to blocks that take a variable number of arguments" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield(99)
+        a = nil
+        @mock.yield_back {|*a|}
+        a.should_eql [99]
+        @mock.__verify
+      end
+
+      specify "should yield many args to blocks that take a variable number of arguments" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield(99, 27, "go")
+        a = nil
+        @mock.yield_back {|*a|}
+        a.should_eql [99, 27, "go"]
+        @mock.__verify
+      end
+
+      specify "should yield single value" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield(99)
+        a = nil
+        @mock.yield_back {|a|}
+        a.should_eql 99
+        @mock.__verify
+      end
+
+      specify "should yield two values" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield('wha', 'zup')
+        a, b = nil
+        @mock.yield_back {|a,b|}
+        a.should_eql 'wha'
+        b.should_eql 'zup'
+        @mock.__verify
+      end
+
+      specify "should fail when calling yielding method with wrong arity" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield('wha', 'zup')
+          begin
+          @mock.yield_back {|a|}
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' yielded |\"wha\", \"zup\"| to block with arity of 1"
+        end
+      end
+
+      specify "should fail when calling yielding method without block" do
+        @mock.should_receive(:yield_back).with(:no_args).once.and_yield('wha', 'zup')
+        begin
+          @mock.yield_back
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' asked to yield |\"wha\", \"zup\"| but no block was passed"
+        end
+      end
+      
+      specify "should be able to mock send" do
+        @mock.should_receive(:send).with(:any_args)
+        @mock.send 'hi'
+        @mock.__verify
+      end
+      
+      specify "should be able to raise from method calling yielding mock" do
+        @mock.should_receive(:yield_me).and_yield 44
+        
+        lambda do
+          @mock.yield_me do |x|
+            raise "Bang"
+          end
+        end.should_raise(StandardError)
+
+        @mock.__verify
+      end
+
+      specify "should clear expectations after verify" do
+        @mock.should_receive(:foobar)
+        @mock.foobar
+        @mock.__verify
+        begin
+          @mock.foobar
+        rescue MockExpectationError => e
+          e.message.should_eql "Mock 'test mock' received unexpected message :foobar with (no args)"
+        end
+      end
+      
+      specify "should verify if auto verify is set to true" do
+        reporter = Spec::Mocks::Mock.new("reporter", :null_object => true)
+        reporter.should_receive(:spec_finished) do |name, error, location|
+          error.to_s.should_match /expected :abcde with \(any args\) once, but received it 0 times/
+        end
+        Runner::Specification.new("spec") do
+          mock = Spec::Mocks::Mock.new("mock", :auto_verify => true)
+          mock.should_receive(:abcde)
+        end.run(reporter, nil, nil, nil, nil)
+        reporter.__verify
+      end
+
+      specify "should verify if auto verify not set explicitly" do
+        reporter = Spec::Mocks::Mock.new("reporter", :null_object => true)
+        reporter.should_receive(:spec_finished) do |name, error, location|
+          error.to_s.should_match /expected :abcde with \(any args\) once, but received it 0 times/
+        end
+        Runner::Specification.new("spec") do
+          mock = Spec::Mocks::Mock.new("mock")
+          mock.should_receive(:abcde)
+        end.run(reporter, nil, nil, nil, nil)
+        reporter.__verify
+      end
+
+      specify "should not verify if auto verify is set to false" do
+        reporter = Spec::Mocks::Mock.new("reporter", :null_object => true)
+        reporter.should_receive(:spec_finished) do |name, error, location|
+          error.should_be_nil
+        end
+        Runner::Specification.new("spec") do
+          mock = Spec::Mocks::Mock.new("mock", :auto_verify => false)
+          mock.should_receive(:abcde)
+        end.run(reporter, nil, nil, nil, nil)
+        reporter.__verify
+      end
+      
+      specify "should reset on __reset_mock_methods" do
+        mock = mock("this is a mock")
+        mock.should_receive(:blah)
+        mock.__reset_mock
+      end
+
+    end
+
+    context "a mock message receiving a block" do
+      setup do
+        @mock = mock("mock")
+        @calls = 0
+      end
+      
+      def add_call
+        @calls = @calls + 1
+      end
+      
+      specify "should call the block after #should_receive" do
+        @mock.should_receive(:foo) { add_call }
+
+        @mock.foo
+
+        @calls.should == 1
+      end
+
+      specify "should call the block after #once" do
+        @mock.should_receive(:foo).once { add_call }
+
+        @mock.foo
+
+        @calls.should == 1
+      end
+
+      specify "should call the block after #twice" do
+        @mock.should_receive(:foo).twice { add_call }
+
+        @mock.foo
+        @mock.foo
+
+        @calls.should == 2
+      end
+
+      specify "should call the block after #times" do
+        @mock.should_receive(:foo).exactly(10).times { add_call }
+        
+        (1..10).each { @mock.foo }
+
+        @calls.should == 10
+      end
+
+      specify "should call the block after #any_number_of_times" do
+        @mock.should_receive(:foo).any_number_of_times { add_call }
+        
+        (1..7).each { @mock.foo }
+
+        @calls.should == 7
+      end
+
+      specify "should call the block after #with" do
+        @mock.should_receive(:foo).with(:arg) { add_call }
+        
+        @mock.foo(:arg)
+
+        @calls.should == 1
+      end
+
+      specify "should call the block after #ordered" do
+        @mock.should_receive(:foo).ordered { add_call }
+        @mock.should_receive(:bar).ordered { add_call }
+        
+        @mock.foo
+        @mock.bar
+
+        @calls.should == 2
+      end
+    end
+  end
+end

data/spec/spec/mocks/multiple_return_value_spec.rb

@@ -0,0 +1,113 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Mocks
+    context "a Mock expectation with multiple return values and no specified count" do
+      setup do
+        @mock = Mock.new("mock")
+        @return_values = ["1",2,Object.new]
+        @mock.should_receive(:message).and_return(@return_values[0],@return_values[1],@return_values[2])
+      end
+      
+      specify "should return values in order to consecutive calls" do
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        @mock.message.should_eql @return_values[2]
+        @mock.__verify
+      end
+
+      specify "should complain when there are too few calls" do
+        third = Object.new
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it twice"
+      end
+
+      specify "should complain when there are too many calls" do
+        third = Object.new
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        @mock.message.should_eql @return_values[2]
+        @mock.message.should_eql @return_values[2]
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it 4 times"
+      end
+    end
+
+    context "a Mock expectation with multiple return values with a specified count equal to the number of values" do
+      setup do
+        @mock = Mock.new("mock")
+        @return_values = ["1",2,Object.new]
+        @mock.should_receive(:message).exactly(3).times.and_return(@return_values[0],@return_values[1],@return_values[2])
+      end
+
+      specify "should return values in order to consecutive calls" do
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        @mock.message.should_eql @return_values[2]
+        @mock.__verify
+      end
+
+      specify "should complain when there are too few calls" do
+        third = Object.new
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it twice"
+      end
+
+      specify "should complain when there are too many calls" do
+        third = Object.new
+        @mock.message.should_eql @return_values[0]
+        @mock.message.should_eql @return_values[1]
+        @mock.message.should_eql @return_values[2]
+        @mock.message.should_eql @return_values[2]
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it 4 times"
+      end
+    end
+
+    context "a Mock expectation with multiple return values specifying at_least less than the number of values" do
+      setup do
+        @mock = Mock.new("mock")
+        @mock.should_receive(:message).at_least(:twice).with(:no_args).and_return(11, 22)
+      end
+      
+      specify "should use last return value for subsequent calls" do
+        @mock.message.should equal(11)
+        @mock.message.should equal(22)
+        @mock.message.should equal(22)
+        @mock.__verify
+      end
+
+      specify "should fail when called less than the specified number" do
+        @mock.message.should equal(11)
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (no args) twice, but received it once"
+      end
+    end
+    context "a Mock expectation with multiple return values with a specified count larger than the number of values" do
+      setup do
+        @mock = Mock.new("mock")
+        @mock.should_receive(:message).exactly(3).times.and_return(11, 22)
+      end
+      
+      specify "should use last return value for subsequent calls" do
+        @mock.message.should equal(11)
+        @mock.message.should equal(22)
+        @mock.message.should equal(22)
+        @mock.__verify
+      end
+
+      specify "should fail when called less than the specified number" do
+        @mock.message.should equal(11)
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it once"
+      end
+
+      specify "should fail when called greater than the specified number" do
+        @mock.message.should equal(11)
+        @mock.message.should equal(22)
+        @mock.message.should equal(22)
+        @mock.message.should equal(22)
+        lambda { @mock.__verify }.should_raise MockExpectationError, "Mock 'mock' expected :message with (any args) 3 times, but received it 4 times"
+      end
+    end
+  end
+end
+