mocha 0.5.6 → 3.1.0

data/RELEASE

@@ -1,188 +0,0 @@
-= 0.5.5 (r167)
-
-- Renamed Matches parameter matcher to RegexpMatches for clarity.
-- Added noframes tag to rdoc index to assist Google.
-
-= 0.5.4 (r166)
-
-- Added matches parameter matcher for matching regular expressions.
-
-= 0.5.3 (r165)
-
-- Attempt to fix packaging problems by switching to newer version (1.15.1) of gnutar and setting COPY_EXTENDED_ATTRIBUTES_DISABLE environment variable.
-- Removed unused ExpectationSequenceError exception.
-- Added instance_of and kind_of parameter matchers.
-- Added Google Webmaster meta tag to rdoc template header.
-- Put Google Webmaster meta tag in the right header i.e. the one for the index page.
-
-= 0.5.2 (r159)
-
-- Fix bug 11885 - "never doesn't work with stub_everything" submitted by Alexander Lang. In fixing this bug, also fixed undiscoverd bug where expected & actual invocation counts were being incorrectly reported which seems to have been introduced when fixes were added for invocation dispatch (see MockedMethodDispatchAcceptanceTest).
-- Previously when an expectation did not allow more invocations, it was treated as not matching. Now we prefer matching expectations which allow more invocations, but still match expectations which cannot allow more invocations. I think this may be overcomplicating things, but let's see how it goes.
-
-= 0.5.1 (r149)
-
-- Fixed bug #11583 "Mocha 0.5.0 throwing unexpected warnings". Also switched on ruby warning for all rake test tasks. Fixed majority of warnings, but some left to fix.
-
-= 0.5.0 (r147)
-
-- Parameter Matchers - I’ve added a few Hamcrest-style parameter matchers which are designed to be used inside Expectation#with. The following matchers are currently available: anything(), includes(), has_key(), has_value(), has_entry(), all_of() & any_of(). More to follow soon. The idea is eventually to get rid of the nasty parameter_block option on Expectation#with.
-
-  object = mock()
-  object.expects(:method).with(has_key('key_1'))
-  object.method('key_1' => 1, 'key_2' => 2)
-  # no verification error raised
-
-  object = mock()
-  object.expects(:method).with(has_key('key_1'))
-  object.method('key_2' => 2)
-  # verification error raised, because method was not called with Hash containing key: 'key_1'
-
-- Values Returned and Exceptions Raised on Consecutive Invocations - Allow multiple calls to Expectation#returns and Expectation#raises to build up a sequence of responses to invocations on the mock. Added syntactic sugar method Expectation#then to allow more readable expectations.
-
-  object = mock()
-  object.stubs(:method).returns(1, 2).then.raises(Exception).then.returns(4)
-  object.method # => 1
-  object.method # => 2
-  object.method # => raises exception of class Exception
-  object.method # => 4
-
-- Yields on Consecutive Invocations - Allow multiple calls to yields on single expectation to allow yield parameters to be specified for consecutive invocations.
-
-  object = mock()
-  object.stubs(:method).yields(1, 2).then.yields(3)
-  object.method { |*values| p values } # => [1, 2]
-  object.method { |*values| p values } # => [3]
-
-- Multiple Yields on Single Invocation - Added Expectation#multiple_yields to allow a mocked or stubbed method to yield multiple times for a single invocation.
-
-  object = mock()
-  object.stubs(:method).multiple_yields([1, 2], [3])
-  object.method { |*values| p values } # => [1, 2] # => [3]
-
-- Invocation Dispatch - Expectations were already being matched in reverse order i.e. the most recently defined one was being found first. This is still the case, but we now stop matching an expectation when its maximum number of expected invocations is reached. c.f. JMock v1. A stub will never stop matching by default. Hopefully this means we can soon get rid of the need to pass a Proc to Expectation#returns.
-
-  object = mock()
-  object.stubs(:method).returns(2)
-  object.expects(:method).once.returns(1)
-  object.method # => 1
-  object.method # => 2
-  object.method # => 2
-  # no verification error raised
-
-  # The following should still work...
-
-  Time.stubs(:now).returns(Time.parse('Mon Jan 01 00:00:00 UTC 2007'))
-  Time.now # => Mon Jan 01 00:00:00 UTC 2007
-  Time.stubs(:now).returns(Time.parse('Thu Feb 01 00:00:00 UTC 2007'))
-  Time.now # => Thu Feb 01 00:00:00 UTC 2007
-  
-- Deprecate passing an instance of Proc to Expectation#returns.
-- Explicitly include all Rakefile dependencies in project.
-- Fixed old Stubba example.
-- Fix so that it is possible for a stubbed method to raise an Interrupt exception without a message in Ruby 1.8.6
-- Added responds_like and quacks_like.
-- Capture standard object methods before Mocha adds any.
-- Added Expectation#once method to make interface less surprising.
-- Use Rake::TestTask to run tests. Created three separate tasks to run unit, integration & acceptance tests. Split inspect_test into one file per TestCase. Deleted superfluous all_tests file.
-- Fiddled with mocha_inspect and tests to give more sensible results on x86 platform.
-- Fixed bug #7834 "infinite_range.rb makes incorrect assumption about to_f" logged by James Moore.
-
-= 0.4.0 (r92)
-
-- Allow naming of mocks (patch from Chris Roos).
-- Specify multiple return values for consecutive calls.
-- Improved consistency of expectation error messages.
-- Allow mocking of Object instance methods e.g. kind_of?, type.
-- Provide aliased versions of #expects and #stubs to allow mocking of these methods.
-- Added at_least, at_most, at_most_once methods to expectation.
-- Allow expects and stubs to take a hash of method and return values.
-- Eliminate warning: "instance variable @yield not initialized" (patch from Xavier Shay).
-- Restore instance methods on partial mocks (patch from Chris Roos).
-- Allow stubbing of a method with non-word characters in its name (patch from Paul Battley).
-- Removed coupling to Test::Unit.
-- Allow specified exception instance to be raised (patch from Chris Roos).
-- Make mock object_id appear in hex like normal Ruby inspect (patch from Paul Battley).
-- Fix path to object.rb in rdoc rake task (patch from Tomas Pospisek).
-- Reverse order in which expectations are matched, so that last expectation is matched first. This allows e.g. a call to #stubs to be effectively overridden by a call to #expects (patch from Tobias Lutke).
-- Stubba & SmartTestCase modules incorporated into Mocha module so only need to require 'mocha' - no longer need to require 'stubba'.
-- AutoMocha removed.
-
-= 0.3.3
-
-- Quick bug fix to restore instance methods on partial mocks (for Kevin Clark).
-
-= 0.3.2
-
-- Examples added.
-
-= 0.3.1
-
-- Dual licensing with MIT license added.
-
-= 0.3.0
-
-* Rails plugin.
-* Auto-verify for expectations on concrete classes.
-* Include each expectation verification in the test result assertion count.
-* Filter out noise from assertion backtraces.
-* Point assertion backtrace to line where failing expectation was created.
-* New yields method for expectations.
-* Create stubs which stub all method calls.
-* Mocks now respond_to? expected methods.
-
-= 0.2.1
-
-* Rename MochaAcceptanceTest::Rover#move method to avoid conflict with Rake (in Ruby 1.8.4 only?)
-
-= 0.2.0
-
-* Small change to SetupAndTeardown#teardown_stubs suggested by Luke Redpath (http://www.lukeredpath.co.uk) to allow use of Stubba with RSpec (http://rspec.rubyforge.org).
-* Reorganized directory structure and extracted addition of setup and teardown methods into SmartTestCase mini-library.
-* Addition of auto-verify for Mocha (but not Stubba). This means there is more significance in the choice of expects or stubs in that any expects on a mock will automatically get verified.
-
-So instead of...
-
-  wotsit = Mocha.new
-  wotsit.expects(:thingummy).with(5).returns(10)
-  doobrey = Doobrey.new(wotsit)
-  doobrey.hoojamaflip
-  wotsit.verify
-
-you need to do...
-
-  wotsit = mock()
-  wotsit.expects(:thingummy).with(5).returns(10)
-  doobrey = Doobrey.new(wotsit)
-  doobrey.hoojamaflip
-  # no need to verify
-
-There are also shortcuts as follows...
-
-instead of...
-
-  wotsit = Mocha.new
-  wotsit.expects(:thingummy).returns(10)
-  wotsit.expects(:summat).returns(25)
-
-you can have...
-
-  wotsit = mock(:thingummy => 5, :summat => 25)
-
-and instead of...
-
-  wotsit = Mocha.new
-  wotsit.stubs(:thingummy).returns(10)
-  wotsit.stubs(:summat).returns(25)
-
-you can have...
-
-  wotsit = stub(:thingummy => 5, :summat => 25)
-
-= 0.1.2
-
-* Minor tweaks
-
-= 0.1.1
-
-* Initial release.

data/examples/misc.rb

@@ -1,44 +0,0 @@
-require 'test/unit'
-require 'rubygems'
-require 'mocha'
-
-class MiscExampleTest < Test::Unit::TestCase
-  
-  def test_mocking_a_class_method
-    product = Product.new
-    Product.expects(:find).with(1).returns(product)
-    assert_equal product, Product.find(1)
-  end
-
-  def test_mocking_an_instance_method_on_a_real_object
-    product = Product.new
-    product.expects(:save).returns(true)
-    assert product.save
-  end
-
-  def test_stubbing_instance_methods_on_real_objects
-    prices = [stub(:pence => 1000), stub(:pence => 2000)]
-    product = Product.new
-    product.stubs(:prices).returns(prices)
-    assert_equal [1000, 2000], product.prices.collect {|p| p.pence}
-  end
-
-  def test_stubbing_an_instance_method_on_all_instances_of_a_class
-    Product.any_instance.stubs(:name).returns('stubbed_name')
-    product = Product.new
-    assert_equal 'stubbed_name', product.name
-  end
-
-  def test_traditional_mocking
-    object = mock()
-    object.expects(:expected_method).with(:p1, :p2).returns(:result)
-    assert_equal :result, object.expected_method(:p1, :p2)
-  end
-
-  def test_shortcuts
-    object = stub(:method1 => :result1, :method2 => :result2)
-    assert_equal :result1, object.method1
-    assert_equal :result2, object.method2
-  end
-  
-end

data/examples/mocha.rb

@@ -1,26 +0,0 @@
-class Enterprise
-
-  def initialize(dilithium)
-    @dilithium = dilithium
-  end
-
-  def go(warp_factor)
-    warp_factor.times { @dilithium.nuke(:anti_matter) }
-  end
-
-end
-
-require 'test/unit'
-require 'rubygems'
-require 'mocha'
-
-class EnterpriseTest < Test::Unit::TestCase
-
-  def test_should_boldly_go
-    dilithium = mock()
-    dilithium.expects(:nuke).with(:anti_matter).at_least_once  # auto-verified at end of test
-    enterprise = Enterprise.new(dilithium)
-    enterprise.go(2)
-  end
-
-end

data/examples/stubba.rb

@@ -1,65 +0,0 @@
-class Order
-
-  attr_accessor :shipped_on
-
-  def total_cost
-    line_items.inject(0) { |total, line_item| total + line_item.price } + shipping_cost
-  end
-
-  def total_weight
-    line_items.inject(0) { |total, line_item| total + line_item.weight }
-  end
-
-  def shipping_cost
-    total_weight * 5 + 10
-  end
-
-  class << self
-
-    def find_all
-      # Database.connection.execute('select * from orders...
-    end
-  
-    def number_shipped_since(date)
-      find_all.select { |order| order.shipped_on > date }.length
-    end
-
-    def unshipped_value
-      find_all.inject(0) { |total, order| order.shipped_on ? total : total + order.total_cost }
-    end
-
-  end
-
-end
-
-require 'test/unit'
-require 'rubygems'
-require 'mocha'
-
-class OrderTest < Test::Unit::TestCase
-
-  # illustrates stubbing instance method
-  def test_should_calculate_shipping_cost_based_on_total_weight
-    order = Order.new
-    order.stubs(:total_weight).returns(10)
-    assert_equal 60, order.shipping_cost
-  end
-
-  # illustrates stubbing class method
-  def test_should_count_number_of_orders_shipped_after_specified_date
-    now = Time.now; week_in_secs = 7 * 24 * 60 * 60
-    order_1 = Order.new; order_1.shipped_on = now - 1 * week_in_secs
-    order_2 = Order.new; order_2.shipped_on = now - 3 * week_in_secs
-    Order.stubs(:find_all).returns([order_1, order_2])
-    assert_equal 1, Order.number_shipped_since(now - 2 * week_in_secs)
-  end
-
-  # illustrates stubbing instance method for all instances of a class
-  def test_should_calculate_value_of_unshipped_orders
-    Order.stubs(:find_all).returns([Order.new, Order.new, Order.new])
-    Order.any_instance.stubs(:shipped_on).returns(nil)
-    Order.any_instance.stubs(:total_cost).returns(10)
-    assert_equal 30, Order.unshipped_value
-  end
-
-end

data/lib/mocha/auto_verify.rb

@@ -1,118 +0,0 @@
-require 'mocha/mock'
-require 'mocha/sequence'
-
-module Mocha # :nodoc:
-  
-  # Methods added to TestCase allowing creation of traditional mock objects.
-  #
-  # Mocks created this way will have their expectations automatically verified at the end of the test.
-  #
-  # See Mock for methods on mock objects.
-  module AutoVerify
-  
-    def mocks # :nodoc:
-      @mocks ||= []
-    end
-  
-    def reset_mocks # :nodoc:
-      @mocks = nil
-    end
-    
-    # :call-seq: mock(name, &block) -> mock object
-    #            mock(expected_methods = {}, &block) -> mock object
-    #            mock(name, expected_methods = {}, &block) -> mock object
-    #
-    # Creates a mock object.
-    #
-    # +name+ is a +String+ identifier for the mock object.
-    #
-    # +expected_methods+ is a +Hash+ with expected method name symbols as keys and corresponding return values as values.
-    #
-    # +block+ is a block to be evaluated against the mock object instance, giving an alernative way to set up expectations & stubs.
-    #
-    # Note that (contrary to expectations set up by #stub) these expectations <b>must</b> be fulfilled during the test.
-    #   def test_product
-    #     product = mock('ipod_product', :manufacturer => 'ipod', :price => 100)
-    #     assert_equal 'ipod', product.manufacturer
-    #     assert_equal 100, product.price
-    #     # an error will be raised unless both Product#manufacturer and Product#price have been called
-    #   end 
-    def mock(*arguments, &block)
-      name = arguments.shift if arguments.first.is_a?(String)
-      expectations = arguments.shift || {}
-      mock = Mock.new(name, &block)
-      mock.expects(expectations)
-      mocks << mock
-      mock
-    end
-  
-    # :call-seq: stub(name, &block) -> mock object
-    #            stub(stubbed_methods = {}, &block) -> mock object
-    #            stub(name, stubbed_methods = {}, &block) -> mock object
-    #
-    # Creates a mock object.
-    #
-    # +name+ is a +String+ identifier for the mock object.
-    #
-    # +stubbed_methods+ is a +Hash+ with stubbed method name symbols as keys and corresponding return values as values.
-    #
-    # +block+ is a block to be evaluated against the mock object instance, giving an alernative way to set up expectations & stubs.
-    #
-    # Note that (contrary to expectations set up by #mock) these expectations <b>need not</b> be fulfilled during the test.
-    #   def test_product
-    #     product = stub('ipod_product', :manufacturer => 'ipod', :price => 100)
-    #     assert_equal 'ipod', product.manufacturer
-    #     assert_equal 100, product.price
-    #     # an error will not be raised even if Product#manufacturer and Product#price have not been called
-    #   end
-    def stub(*arguments, &block)
-      name = arguments.shift if arguments.first.is_a?(String)
-      expectations = arguments.shift || {}
-      stub = Mock.new(name, &block)
-      stub.stubs(expectations)
-      mocks << stub
-      stub
-    end
-  
-    # :call-seq: stub_everything(name, &block) -> mock object
-    #            stub_everything(stubbed_methods = {}, &block) -> mock object
-    #            stub_everything(name, stubbed_methods = {}, &block) -> mock object
-    #
-    # Creates a mock object that accepts calls to any method.
-    #
-    # By default it will return +nil+ for any method call.
-    #
-    # +block+ is a block to be evaluated against the mock object instance, giving an alernative way to set up expectations & stubs.
-    #
-    # +name+ and +stubbed_methods+ work in the same way as for #stub.
-    #   def test_product
-    #     product = stub_everything('ipod_product', :price => 100)
-    #     assert_nil product.manufacturer
-    #     assert_nil product.any_old_method
-    #     assert_equal 100, product.price
-    #   end
-    def stub_everything(*arguments, &block)
-      name = arguments.shift if arguments.first.is_a?(String)
-      expectations = arguments.shift || {}
-      stub = Mock.new(name, &block)
-      stub.stub_everything
-      stub.stubs(expectations)
-      mocks << stub
-      stub
-    end
-    
-    def verify_mocks # :nodoc:
-      mocks.each { |mock| mock.verify { yield if block_given? } }
-    end
-
-    def teardown_mocks # :nodoc:
-      reset_mocks
-    end
-    
-    def sequence(name) # :nodoc:
-      Sequence.new(name)
-    end
-  
-  end
-  
-end

data/lib/mocha/class_method.rb

@@ -1,66 +0,0 @@
-require 'mocha/metaclass'
-
-module Mocha
-
-  class ClassMethod
-  
-    attr_reader :stubbee, :method
-   
-    def initialize(stubbee, method)
-      @stubbee, @method = stubbee, method
-    end
-  
-    def stub
-      hide_original_method
-      define_new_method
-    end
-  
-    def unstub
-      remove_new_method
-      restore_original_method
-      stubbee.reset_mocha
-    end
-    
-    def mock
-      stubbee.mocha
-    end
-  
-    def hide_original_method
-      stubbee.__metaclass__.class_eval "alias_method :#{hidden_method}, :#{method}" if stubbee.__metaclass__.method_defined?(method)
-    end
-  
-    def define_new_method
-      stubbee.__metaclass__.class_eval "def #{method}(*args, &block); mocha.method_missing(:#{method}, *args, &block); end"
-    end
-  
-    def remove_new_method
-      stubbee.__metaclass__.class_eval "remove_method :#{method}"
-    end
-  
-    def restore_original_method
-      stubbee.__metaclass__.class_eval "alias_method :#{method}, :#{hidden_method}; remove_method :#{hidden_method}" if stubbee.__metaclass__.method_defined?(hidden_method)
-    end
-  
-    def hidden_method
-      if RUBY_VERSION < '1.9'
-        method_name = method.to_s.gsub(/\W/) { |s| "_substituted_character_#{s[0]}_" }
-      else
-        method_name = method.to_s.gsub(/\W/) { |s| "_substituted_character_#{s.ord}_" }
-      end
-      "__stubba__#{method_name}__stubba__"
-    end  
-  
-    def eql?(other)
-      return false unless (other.class == self.class)
-      (stubbee == other.stubbee) and (method == other.method)
-    end
-  
-    alias_method :==, :eql?
-  
-    def to_s
-      "#{stubbee}.#{method}"
-    end
-
-  end
-  
-end

data/lib/mocha/infinite_range.rb

@@ -1,25 +0,0 @@
-class Range
-  
-  def self.at_least(minimum_value)
-    Range.new(minimum_value, infinite)
-  end
-  
-  def self.at_most(maximum_value)
-    Range.new(-infinite, maximum_value, false)
-  end
-  
-  def self.infinite
-    1/0.0
-  end
-  
-  def mocha_inspect
-    if first.respond_to?(:to_f) and first.to_f.infinite? then
-      return "at most #{last}"
-    elsif last.respond_to?(:to_f) and last.to_f.infinite? then
-      return "at least #{first}"
-    else
-      to_s
-    end
-  end
-  
-end

data/lib/mocha/is_a.rb

@@ -1,9 +0,0 @@
-class Object
-
-  # :stopdoc:
-
-  alias_method :__is_a__, :is_a?
-
-  # :startdoc:
-  
-end

data/lib/mocha/metaclass.rb

@@ -1,7 +0,0 @@
-class Object
-  
-  def __metaclass__
-    class << self; self; end
-  end
-
-end

data/lib/mocha/missing_expectation.rb

@@ -1,17 +0,0 @@
-require 'mocha/expectation'
-
-module Mocha # :nodoc:
-  
-  class MissingExpectation < Expectation # :nodoc:
-
-    def verify
-      message = error_message(0, 1)
-      similar_expectations = @mock.expectations.similar(@method_matcher.expected_method_name)
-      method_signatures = similar_expectations.map { |expectation| expectation.method_signature }
-      message << "\nSimilar expectations:\n#{method_signatures.join("\n")}" unless method_signatures.empty?
-      raise ExpectationError.new(message, backtrace)
-    end
-
-  end
-
-end

data/lib/mocha/multiple_yields.rb

@@ -1,20 +0,0 @@
-module Mocha # :nodoc:
-  
-  class MultipleYields # :nodoc:
-    
-    attr_reader :parameter_groups
-    
-    def initialize(*parameter_groups)
-      @parameter_groups = parameter_groups
-    end
-    
-    def each
-      @parameter_groups.each do |parameter_group|
-        yield(parameter_group)
-      end
-    end
-    
-  end
-  
-end
-    

data/lib/mocha/no_yields.rb

@@ -1,11 +0,0 @@
-module Mocha # :nodoc:
-  
-  class NoYields # :nodoc:
-    
-    def each
-    end
-    
-  end
-  
-end
-