mocha 0.4.0 → 0.5.0

data/lib/mocha/parameter_matchers/anything.rb

@@ -0,0 +1,30 @@
+module Mocha
+  
+  module ParameterMatchers
+
+    # :call-seq: anything -> parameter_matcher
+    #
+    # Matches any object.
+    #   object = mock()
+    #   object.expects(:method_1).with(anything)
+    #   object.method_1('foo')
+    #   # no error raised
+    def anything
+      Anything.new
+    end
+    
+    class Anything # :nodoc:
+    
+      def ==(parameter)
+        return true
+      end
+      
+      def mocha_inspect
+        "anything"
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/mocha/parameter_matchers/has_entry.rb

@@ -0,0 +1,39 @@
+module Mocha
+  
+  module ParameterMatchers
+
+    # :call-seq: has_entry(key, value) -> parameter_matcher
+    #
+    # Matches +Hash+ containing entry with +key+ and +value+.
+    #   object = mock()
+    #   object.expects(:method_1).with(has_entry('key_1', 1))
+    #   object.method_1('key_1' => 1, 'key_2' => 2)
+    #   # no error raised
+    #
+    #   object = mock()
+    #   object.expects(:method_1).with(has_entry('key_1', 1))
+    #   object.method_1('key_1' => 2, 'key_2' => 1)
+    #   # error raised, because method_1 was not called with Hash containing entry: 'key_1' => 1
+    def has_entry(key, value)
+      HasEntry.new(key, value)
+    end
+
+    class HasEntry # :nodoc:
+      
+      def initialize(key, value)
+        @key, @value = key, value
+      end
+      
+      def ==(parameter)
+        parameter[@key] == @value
+      end
+      
+      def mocha_inspect
+        "has_entry(#{@key.mocha_inspect}, #{@value.mocha_inspect})"
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/mocha/parameter_matchers/has_key.rb

@@ -0,0 +1,39 @@
+module Mocha
+  
+  module ParameterMatchers
+
+    # :call-seq: has_key(key) -> parameter_matcher
+    #
+    # Matches +Hash+ containing +key+.
+    #   object = mock()
+    #   object.expects(:method_1).with(has_key('key_1'))
+    #   object.method_1('key_1' => 1, 'key_2' => 2)
+    #   # no error raised
+    #
+    #   object = mock()
+    #   object.expects(:method_1).with(has_key('key_1'))
+    #   object.method_1('key_2' => 2)
+    #   # error raised, because method_1 was not called with Hash containing key: 'key_1'
+    def has_key(key)
+      HasKey.new(key)
+    end
+
+    class HasKey # :nodoc:
+      
+      def initialize(key)
+        @key = key
+      end
+      
+      def ==(parameter)
+        parameter.keys.include?(@key)
+      end
+      
+      def mocha_inspect
+        "has_key(#{@key.mocha_inspect})"
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/mocha/parameter_matchers/has_value.rb

@@ -0,0 +1,39 @@
+module Mocha
+  
+  module ParameterMatchers
+
+    # :call-seq: has_value(value) -> parameter_matcher
+    #
+    # Matches +Hash+ containing +value+.
+    #   object = mock()
+    #   object.expects(:method_1).with(has_value(1))
+    #   object.method_1('key_1' => 1, 'key_2' => 2)
+    #   # no error raised
+    #
+    #   object = mock()
+    #   object.expects(:method_1).with(has_value(1))
+    #   object.method_1('key_2' => 2)
+    #   # error raised, because method_1 was not called with Hash containing value: 1
+    def has_value(value)
+      HasValue.new(value)
+    end
+
+    class HasValue # :nodoc:
+      
+      def initialize(value)
+        @value = value
+      end
+      
+      def ==(parameter)
+        parameter.values.include?(@value)
+      end
+      
+      def mocha_inspect
+        "has_value(#{@value.mocha_inspect})"
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/mocha/parameter_matchers/includes.rb

@@ -0,0 +1,37 @@
+module Mocha
+  
+  module ParameterMatchers
+
+    # :call-seq: includes(item) -> parameter_matcher
+    #
+    # Matches any object that responds true to include?(item)
+    #   object = mock()
+    #   object.expects(:method_1).with(includes('foo'))
+    #   object.method_1(['foo', 'bar'])
+    #   # no error raised
+    #
+    #   object.method_1(['baz'])
+    #   # error raised, because ['baz'] does not include 'foo'.
+    def includes(item)
+      Includes.new(item)
+    end
+
+    class Includes # :nodoc:
+
+      def initialize(item)
+        @item = item
+      end
+
+      def ==(parameter)
+        return parameter.include?(@item)
+      end
+
+      def mocha_inspect
+        "includes(#{@item.mocha_inspect})"
+      end
+
+    end
+
+  end
+  
+end

data/lib/mocha/return_values.rb

@@ -0,0 +1,31 @@
+require 'mocha/single_return_value'
+
+module Mocha # :nodoc:
+  
+  class ReturnValues # :nodoc:
+    
+    def self.build(*values)
+      new(*values.map { |value| SingleReturnValue.new(value) })
+    end
+    
+    attr_accessor :values
+    
+    def initialize(*values)
+      @values = values
+    end
+    
+    def next
+      case @values.size
+      when 0: nil
+      when 1: @values.first.evaluate
+      else @values.shift.evaluate
+      end
+    end
+    
+    def +(other)
+      self.class.new(*(@values + other.values))
+    end
+    
+  end
+  
+end

data/lib/mocha/single_return_value.rb

@@ -0,0 +1,24 @@
+require 'mocha/is_a'
+require 'mocha/deprecation'
+
+module Mocha # :nodoc:
+  
+  class SingleReturnValue # :nodoc:
+    
+    def initialize(value)
+      @value = value
+    end
+    
+    def evaluate
+      if @value.__is_a__(Proc) then
+        message = 'use of Expectation#returns with instance of Proc - see Expectation#returns RDoc for alternatives'
+        Deprecation.warning(message)
+        @value.call
+      else
+        @value
+      end
+    end
+    
+  end
+  
+end

data/lib/mocha/single_yield.rb

@@ -0,0 +1,18 @@
+module Mocha # :nodoc:
+  
+  class SingleYield # :nodoc:
+    
+    attr_reader :parameters
+    
+    def initialize(*parameters)
+      @parameters = parameters
+    end
+    
+    def each
+      yield(@parameters)
+    end
+    
+  end
+  
+end
+    

data/lib/mocha/standalone.rb

@@ -1,4 +1,5 @@
 require 'mocha/auto_verify'
+require 'mocha/parameter_matchers'
 require 'mocha/setup_and_teardown'
 
 module Mocha
@@ -6,6 +7,7 @@ module Mocha
   module Standalone
     
     include AutoVerify
+    include ParameterMatchers
     include SetupAndTeardown
     
     def mocha_setup

data/lib/mocha/stub.rb

@@ -0,0 +1,18 @@
+require 'mocha/expectation'
+
+module Mocha # :nodoc:
+
+  class Stub < Expectation # :nodoc:
+
+    def initialize(mock, method_name, backtrace = nil)
+      super
+      @expected_count = Range.at_least(0)
+    end
+    
+    def verify
+      true
+    end
+
+  end
+
+end

data/lib/mocha/yield_parameters.rb

@@ -0,0 +1,31 @@
+require 'mocha/no_yields'
+require 'mocha/single_yield'
+require 'mocha/multiple_yields'
+
+module Mocha # :nodoc:
+  
+  class YieldParameters # :nodoc:
+    
+    def initialize
+      @parameter_groups = []
+    end
+    
+    def next_invocation
+      case @parameter_groups.size
+      when 0: NoYields.new
+      when 1: @parameter_groups.first
+      else @parameter_groups.shift
+      end
+    end
+    
+    def add(*parameters)
+      @parameter_groups << SingleYield.new(*parameters)
+    end
+    
+    def multiple_add(*parameter_groups)
+      @parameter_groups << MultipleYields.new(*parameter_groups)
+    end
+    
+  end
+  
+end

data/test/{mocha_acceptance_test.rb → acceptance/mocha_acceptance_test.rb}

@@ -1,4 +1,4 @@
-require 'test_helper'
+require File.join(File.dirname(__FILE__), "..", "test_helper")
 require 'mocha'
 
 class MochaAcceptanceTest < Test::Unit::TestCase

data/test/acceptance/mocked_methods_dispatch_acceptance_test.rb

@@ -0,0 +1,72 @@
+require File.join(File.dirname(__FILE__), "..", "test_helper")
+require 'mocha'
+require 'test_runner'
+
+class MockedMethodDispatchAcceptanceTest < Test::Unit::TestCase
+
+  include TestRunner
+
+  def test_should_find_latest_matching_expectation
+    test_result = run_test do
+      mock = mock()
+      mock.stubs(:method).returns(1)
+      mock.stubs(:method).returns(2)
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should_find_latest_expectation_which_has_not_stopped_matching
+    test_result = run_test do
+      mock = mock()
+      mock.stubs(:method).returns(1)
+      mock.stubs(:method).once.returns(2)
+      assert_equal 2, mock.method
+      assert_equal 1, mock.method
+      assert_equal 1, mock.method
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should_keep_finding_later_stub_and_so_never_satisfy_earlier_expectation
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).returns(1)
+      mock.stubs(:method).returns(2)
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+    end
+    assert_failed(test_result)
+  end
+
+  def test_should_find_later_expectation_until_it_stops_matching_then_find_earlier_stub
+    test_result = run_test do
+      mock = mock()
+      mock.stubs(:method).returns(1)
+      mock.expects(:method).returns(2)
+      assert_equal 2, mock.method
+      assert_equal 1, mock.method
+      assert_equal 1, mock.method
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should
+    # flunk
+    test_result = run_test do
+      mock = mock()
+      mock.stubs(:method).returns(1)
+      mock.stubs(:method).times(2..3).returns(2)
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+      assert_equal 2, mock.method
+      assert_equal 1, mock.method
+      assert_equal 1, mock.method
+    end
+    assert_passed(test_result)
+  end
+
+end

data/test/acceptance/parameter_matcher_acceptance_test.rb

@@ -0,0 +1,63 @@
+require File.join(File.dirname(__FILE__), "..", "test_helper")
+require 'mocha'
+require 'test_runner'
+
+class ParameterMatcherAcceptanceTest < Test::Unit::TestCase
+  
+  include TestRunner
+
+  def test_should_match_hash_parameter_with_specified_key
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_key(:key_1))
+      mock.method(:key_1 => 'value_1', :key_2 => 'value_2')
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should_not_match_hash_parameter_with_specified_key
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_key(:key_1))
+      mock.method(:key_2 => 'value_2')
+    end
+    assert_failed(test_result)
+  end
+  
+  def test_should_match_hash_parameter_with_specified_value
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_value('value_1'))
+      mock.method(:key_1 => 'value_1', :key_2 => 'value_2')
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should_not_match_hash_parameter_with_specified_value
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_value('value_1'))
+      mock.method(:key_2 => 'value_2')
+    end
+    assert_failed(test_result)
+  end
+  
+  def test_should_match_hash_parameter_with_specified_entry
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_entry(:key_1, 'value_1'))
+      mock.method(:key_1 => 'value_1', :key_2 => 'value_2')
+    end
+    assert_passed(test_result)
+  end
+
+  def test_should_not_match_hash_parameter_with_specified_entry
+    test_result = run_test do
+      mock = mock()
+      mock.expects(:method).with(has_entry(:key_1, 'value_2'))
+      mock.method(:key_1 => 'value_1', :key_2 => 'value_2')
+    end
+    assert_failed(test_result)
+  end
+  
+end