mocha 0.5.6 → 3.1.0

data/lib/mocha/stubbed_method.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'ruby2_keywords'
+require 'mocha/ruby_version'
+
+module Mocha
+  class StubbedMethod
+    class PrependedModule < Module
+    end
+
+    attr_reader :stubba_object, :method_name
+
+    def initialize(stubba_object, method_name)
+      @stubba_object = stubba_object
+      @original_method = nil
+      @original_visibility = nil
+      @method_name = method_name.to_sym
+    end
+
+    def stub
+      hide_original_method
+      define_new_method
+    end
+
+    def unstub
+      remove_new_method
+      mock.unstub(method_name.to_sym)
+      return if mock.any_expectations?
+
+      reset_mocha
+    end
+
+    def mock
+      stubbee.mocha
+    end
+
+    def reset_mocha
+      stubbee.reset_mocha
+    end
+
+    def hide_original_method
+      return unless original_method_owner.__method_exists__?(method_name)
+
+      store_original_method_visibility
+      use_prepended_module_for_stub_method
+    end
+
+    def define_new_method
+      self_in_scope = self
+      method_name_in_scope = method_name
+      stub_method_owner.send(:define_method, method_name) do |*args, &block|
+        self_in_scope.mock.handle_method_call(method_name_in_scope, args, block)
+      end
+      stub_method_owner.send(:ruby2_keywords, method_name)
+      retain_original_visibility(stub_method_owner)
+    end
+
+    def remove_new_method
+      stub_method_owner.send(:remove_method, method_name)
+    end
+
+    def matches?(other)
+      return false unless other.instance_of?(self.class)
+
+      (stubba_object.object_id == other.stubba_object.object_id) && # rubocop:disable Lint/IdentityComparison
+        (method_name == other.method_name)
+    end
+
+    alias_method :==, :eql?
+
+    def to_s
+      "#{stubba_object}.#{method_name}"
+    end
+
+    private
+
+    def retain_original_visibility(method_owner)
+      return unless @original_visibility
+
+      Module.instance_method(@original_visibility).bind(method_owner).call(method_name)
+    end
+
+    def store_original_method_visibility
+      @original_visibility = original_method_owner.__method_visibility__(method_name)
+    end
+
+    def use_prepended_module_for_stub_method
+      @stub_method_owner = PrependedModule.new
+      original_method_owner.__send__ :prepend, @stub_method_owner
+    end
+
+    def stub_method_owner
+      @stub_method_owner ||= original_method_owner
+    end
+  end
+end

data/lib/mocha/stubbing_error.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'mocha/error_with_filtered_backtrace'
+
+module Mocha
+  # Exception raised when stubbing a particular method is not allowed.
+  #
+  # @see Configuration.prevent
+  class StubbingError < ErrorWithFilteredBacktrace; end
+end

data/lib/mocha/test_unit.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'mocha/integration/test_unit'
+
+unless Mocha::Integration::TestUnit.activate
+  raise "Test::Unit must be loaded *before* `require 'mocha/test_unit'`."
+end

data/lib/mocha/thrower.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Mocha
+  class Thrower
+    def initialize(tag, object = nil)
+      @tag = tag
+      @object = object
+    end
+
+    def evaluate(invocation)
+      invocation.threw(@tag, @object)
+      throw @tag, @object
+    end
+  end
+end

data/lib/mocha/thrown_object.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Mocha
+  class ThrownObject
+    def initialize(tag, value = nil)
+      @tag = tag
+      @value = value
+    end
+
+    def mocha_inspect
+      "threw (#{@tag.mocha_inspect}, #{@value.mocha_inspect})"
+    end
+  end
+end

data/lib/mocha/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Mocha
+  VERSION = '3.1.0'
+end

data/lib/mocha/yield_parameters.rb

@@ -1,31 +1,23 @@
-require 'mocha/no_yields'
-require 'mocha/single_yield'
-require 'mocha/multiple_yields'
+# frozen_string_literal: true
 
-module Mocha # :nodoc:
-  
-  class YieldParameters # :nodoc:
-    
+module Mocha
+  class YieldParameters
     def initialize
       @parameter_groups = []
     end
-    
+
     def next_invocation
       case @parameter_groups.length
-      when 0; NoYields.new
-      when 1; @parameter_groups.first
+      when 0 then []
+      when 1 then @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)
+
+    def add(*parameter_groups)
+      @parameter_groups << parameter_groups.map do |pg|
+        pg.is_a?(Array) ? pg : [pg]
+      end
     end
-    
   end
-  
-end
+end

data/lib/mocha.rb

@@ -1,19 +1,21 @@
-require 'mocha_standalone'
-require 'mocha/test_case_adapter'
+# frozen_string_literal: true
 
-require 'test/unit/testcase'
+require 'mocha/version'
 
-module Test
-
-  module Unit
-
-    class TestCase
-  
-      include Mocha::Standalone
-      include Mocha::TestCaseAdapter
-      
-    end
-
-  end
-
-end
+# Mocha's top level namespace, which also provides the ability to {.configure configure} Mocha's behavior.
+#
+# Methods in the {API} are directly available in +Test::Unit::TestCase+, +Minitest::Unit::TestCase+.
+#
+# The mock creation methods are {API#mock mock}, {API#stub stub} and {API#stub_everything stub_everything}, all of which return a {Mock}
+#
+# A {Mock} {Mock#expects expects} or {Mock#stubs stubs} a method, which sets up (returns) an {Expectation}.
+#
+# An {Expectation} can be further qualified through its {Expectation fluent interface}.
+#
+# {ParameterMatchers} for {Expectation#with} restrict the parameter values which will match the {Expectation}.
+#
+# Adapters in {Integration} provide built-in support for +Minitest+ and +Test::Unit+.
+#
+# Integration {Hooks} enable support for other test frameworks.
+module Mocha
+end

data/mocha.gemspec

@@ -0,0 +1,40 @@
+lib = File.expand_path('../lib/', __FILE__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+require 'mocha/version'
+
+DESCRIPTION =
+  'A library for mocking and stubbing with a unified, simple and readable syntax ' \
+  'for both full & partial mocking. Built-in support for Minitest and Test::Unit. ' \
+  'Supported by many other test frameworks, e.g. RSpec.'.freeze
+
+Gem::Specification.new do |s|
+  s.name = 'mocha'
+  s.version = Mocha::VERSION
+  s.licenses = ['MIT', 'BSD-2-Clause']
+  s.required_ruby_version = '>= 2.2'
+
+  s.authors = ['James Mead']
+  s.description = DESCRIPTION
+  s.email = 'mocha-developer@googlegroups.com'
+
+  s.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(docs|test)/}) }
+  end
+  s.files.delete('.circleci/config.yml')
+  s.files.delete('.gitignore')
+
+  s.homepage = 'https://mocha.jamesmead.org'
+  s.require_paths = ['lib']
+  s.summary = 'Mocking and stubbing library'
+  s.metadata = {
+    'bug_tracker_uri' => 'https://github.com/freerange/mocha/issues',
+    'changelog_uri' => 'https://github.com/freerange/mocha/blob/main/RELEASE.md',
+    'documentation_uri' => 'https://mocha.jamesmead.org/',
+    'funding_uri' => 'https://github.com/sponsors/floehopper',
+    'homepage_uri' => s.homepage,
+    'source_code_uri' => 'https://github.com/freerange/mocha',
+    'rubygems_mfa_required' => 'true'
+  }
+
+  s.add_dependency 'ruby2_keywords', '>= 0.0.5'
+end

metadata

@@ -1,181 +1,165 @@
---- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
+--- !ruby/object:Gem::Specification
 name: mocha
-version: !ruby/object:Gem::Version 
-  version: 0.5.6
-date: 2007-12-23 00:00:00 +00:00
-summary: Mocking and stubbing library
-require_paths: 
-- lib
-email: mocha-developer@rubyforge.org
-homepage: http://mocha.rubyforge.org
-rubyforge_project: mocha
-description: Mocking and stubbing library with JMock/SchMock syntax, which allows mocking and stubbing of methods on real (non-mock) classes.
-autorequire: mocha
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+version: !ruby/object:Gem::Version
+  version: 3.1.0
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
-authors: 
+authors:
 - James Mead
-files: 
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby2_keywords
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+description: A library for mocking and stubbing with a unified, simple and readable
+  syntax for both full & partial mocking. Built-in support for Minitest and Test::Unit.
+  Supported by many other test frameworks, e.g. RSpec.
+email: mocha-developer@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gemtest"
+- ".github/FUNDING.yml"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".yardopts"
+- CONTRIBUTING.md
+- COPYING.md
+- Gemfile
+- MIT-LICENSE.md
+- README.md
+- RELEASE.md
+- Rakefile
+- gemfiles/Gemfile.minitest.latest
+- gemfiles/Gemfile.rubocop
+- gemfiles/Gemfile.test-unit.latest
+- lib/mocha.rb
 - lib/mocha/any_instance_method.rb
-- lib/mocha/auto_verify.rb
+- lib/mocha/any_instance_receiver.rb
+- lib/mocha/api.rb
+- lib/mocha/argument_iterator.rb
+- lib/mocha/backtrace_filter.rb
+- lib/mocha/block_matchers.rb
+- lib/mocha/cardinality.rb
 - lib/mocha/central.rb
-- lib/mocha/class_method.rb
+- lib/mocha/change_state_side_effect.rb
+- lib/mocha/class_methods.rb
+- lib/mocha/configuration.rb
+- lib/mocha/default_name.rb
+- lib/mocha/default_receiver.rb
 - lib/mocha/deprecation.rb
+- lib/mocha/detection/minitest.rb
+- lib/mocha/detection/test_unit.rb
+- lib/mocha/error_with_filtered_backtrace.rb
 - lib/mocha/exception_raiser.rb
 - lib/mocha/expectation.rb
 - lib/mocha/expectation_error.rb
+- lib/mocha/expectation_error_factory.rb
 - lib/mocha/expectation_list.rb
-- lib/mocha/infinite_range.rb
+- lib/mocha/hooks.rb
+- lib/mocha/ignoring_warning.rb
+- lib/mocha/impersonating_any_instance_name.rb
+- lib/mocha/impersonating_name.rb
+- lib/mocha/in_state_ordering_constraint.rb
 - lib/mocha/inspect.rb
 - lib/mocha/instance_method.rb
-- lib/mocha/is_a.rb
-- lib/mocha/metaclass.rb
+- lib/mocha/integration.rb
+- lib/mocha/integration/assertion_counter.rb
+- lib/mocha/integration/minitest.rb
+- lib/mocha/integration/minitest/adapter.rb
+- lib/mocha/integration/monkey_patcher.rb
+- lib/mocha/integration/test_unit.rb
+- lib/mocha/integration/test_unit/adapter.rb
+- lib/mocha/invocation.rb
+- lib/mocha/logger.rb
+- lib/mocha/macos_version.rb
 - lib/mocha/method_matcher.rb
-- lib/mocha/missing_expectation.rb
+- lib/mocha/minitest.rb
 - lib/mocha/mock.rb
-- lib/mocha/multiple_yields.rb
-- lib/mocha/no_yields.rb
-- lib/mocha/object.rb
+- lib/mocha/mockery.rb
+- lib/mocha/name.rb
+- lib/mocha/not_initialized_error.rb
+- lib/mocha/object_methods.rb
+- lib/mocha/object_receiver.rb
+- lib/mocha/parameter_matchers.rb
 - lib/mocha/parameter_matchers/all_of.rb
 - lib/mocha/parameter_matchers/any_of.rb
 - lib/mocha/parameter_matchers/any_parameters.rb
 - lib/mocha/parameter_matchers/anything.rb
-- lib/mocha/parameter_matchers/base.rb
+- lib/mocha/parameter_matchers/base_methods.rb
 - lib/mocha/parameter_matchers/equals.rb
+- lib/mocha/parameter_matchers/equivalent_uri.rb
 - lib/mocha/parameter_matchers/has_entries.rb
 - lib/mocha/parameter_matchers/has_entry.rb
 - lib/mocha/parameter_matchers/has_key.rb
+- lib/mocha/parameter_matchers/has_keys.rb
 - lib/mocha/parameter_matchers/has_value.rb
 - lib/mocha/parameter_matchers/includes.rb
+- lib/mocha/parameter_matchers/instance_methods.rb
 - lib/mocha/parameter_matchers/instance_of.rb
 - lib/mocha/parameter_matchers/is_a.rb
 - lib/mocha/parameter_matchers/kind_of.rb
 - lib/mocha/parameter_matchers/not.rb
-- lib/mocha/parameter_matchers/object.rb
 - lib/mocha/parameter_matchers/optionally.rb
+- lib/mocha/parameter_matchers/positional_or_keyword_hash.rb
 - lib/mocha/parameter_matchers/regexp_matches.rb
-- lib/mocha/parameter_matchers.rb
+- lib/mocha/parameter_matchers/responds_with.rb
+- lib/mocha/parameter_matchers/yaml_equivalent.rb
 - lib/mocha/parameters_matcher.rb
-- lib/mocha/pretty_parameters.rb
+- lib/mocha/raised_exception.rb
 - lib/mocha/return_values.rb
+- lib/mocha/ruby_version.rb
 - lib/mocha/sequence.rb
-- lib/mocha/setup_and_teardown.rb
 - lib/mocha/single_return_value.rb
-- lib/mocha/single_yield.rb
-- lib/mocha/standalone.rb
-- lib/mocha/stub.rb
-- lib/mocha/test_case_adapter.rb
+- lib/mocha/state_machine.rb
+- lib/mocha/stubbed_method.rb
+- lib/mocha/stubbing_error.rb
+- lib/mocha/test_unit.rb
+- lib/mocha/thrower.rb
+- lib/mocha/thrown_object.rb
+- lib/mocha/version.rb
 - lib/mocha/yield_parameters.rb
-- lib/mocha.rb
-- lib/mocha_standalone.rb
-- lib/stubba.rb
-- test/acceptance/expected_invocation_count_acceptance_test.rb
-- test/acceptance/mocha_acceptance_test.rb
-- test/acceptance/mock_with_initializer_block_acceptance_test.rb
-- test/acceptance/mocked_methods_dispatch_acceptance_test.rb
-- test/acceptance/optional_parameters_acceptance_test.rb
-- test/acceptance/parameter_matcher_acceptance_test.rb
-- test/acceptance/partial_mocks_acceptance_test.rb
-- test/acceptance/sequence_acceptance_test.rb
-- test/acceptance/standalone_acceptance_test.rb
-- test/acceptance/stubba_acceptance_test.rb
-- test/active_record_test_case.rb
-- test/deprecation_disabler.rb
-- test/execution_point.rb
-- test/integration/mocha_test_result_integration_test.rb
-- test/integration/stubba_integration_test.rb
-- test/integration/stubba_test_result_integration_test.rb
-- test/method_definer.rb
-- test/test_helper.rb
-- test/test_runner.rb
-- test/unit/any_instance_method_test.rb
-- test/unit/array_inspect_test.rb
-- test/unit/auto_verify_test.rb
-- test/unit/central_test.rb
-- test/unit/class_method_test.rb
-- test/unit/date_time_inspect_test.rb
-- test/unit/expectation_error_test.rb
-- test/unit/expectation_list_test.rb
-- test/unit/expectation_raiser_test.rb
-- test/unit/expectation_test.rb
-- test/unit/hash_inspect_test.rb
-- test/unit/infinite_range_test.rb
-- test/unit/metaclass_test.rb
-- test/unit/method_matcher_test.rb
-- test/unit/missing_expectation_test.rb
-- test/unit/mock_test.rb
-- test/unit/multiple_yields_test.rb
-- test/unit/no_yield_test.rb
-- test/unit/object_inspect_test.rb
-- test/unit/object_test.rb
-- test/unit/parameter_matchers/all_of_test.rb
-- test/unit/parameter_matchers/any_of_test.rb
-- test/unit/parameter_matchers/anything_test.rb
-- test/unit/parameter_matchers/has_entries_test.rb
-- test/unit/parameter_matchers/has_entry_test.rb
-- test/unit/parameter_matchers/has_key_test.rb
-- test/unit/parameter_matchers/has_value_test.rb
-- test/unit/parameter_matchers/includes_test.rb
-- test/unit/parameter_matchers/instance_of_test.rb
-- test/unit/parameter_matchers/is_a_test.rb
-- test/unit/parameter_matchers/kind_of_test.rb
-- test/unit/parameter_matchers/not_test.rb
-- test/unit/parameter_matchers/regexp_matches_test.rb
-- test/unit/parameter_matchers/stub_matcher.rb
-- test/unit/parameters_matcher_test.rb
-- test/unit/return_values_test.rb
-- test/unit/sequence_test.rb
-- test/unit/setup_and_teardown_test.rb
-- test/unit/single_return_value_test.rb
-- test/unit/single_yield_test.rb
-- test/unit/string_inspect_test.rb
-- test/unit/stub_test.rb
-- test/unit/yield_parameters_test.rb
-- examples/misc.rb
-- examples/mocha.rb
-- examples/stubba.rb
-- COPYING
-- MIT-LICENSE
-- Rakefile
-- README
-- RELEASE
-test_files: []
-
-rdoc_options: 
-- --title
-- Mocha
-- --main
-- README
-- --line-numbers
-extra_rdoc_files: 
-- README
-- COPYING
-executables: []
-
-extensions: []
-
+- mocha.gemspec
+homepage: https://mocha.jamesmead.org
+licenses:
+- MIT
+- BSD-2-Clause
+metadata:
+  bug_tracker_uri: https://github.com/freerange/mocha/issues
+  changelog_uri: https://github.com/freerange/mocha/blob/main/RELEASE.md
+  documentation_uri: https://mocha.jamesmead.org/
+  funding_uri: https://github.com/sponsors/floehopper
+  homepage_uri: https://mocha.jamesmead.org
+  source_code_uri: https://github.com/freerange/mocha
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rake
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">"
-      - !ruby/object:Gem::Version 
-        version: 0.0.0
-    version: 
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Mocking and stubbing library
+test_files: []

data/COPYING

@@ -1,3 +0,0 @@
-Copyright Revieworld Ltd. 2006
-
-You may use, copy and redistribute this library under the same terms as Ruby itself (see http://www.ruby-lang.org/en/LICENSE.txt) or under the MIT license (see MIT-LICENSE file).

data/README

@@ -1,35 +0,0 @@
-= Mocha
-
-Mocha is a library for mocking and stubbing using a syntax like that of JMock[http://www.jmock.org], and SchMock[http://rubyforge.org/projects/schmock]. Most commonly Mocha is used in conjunction with Test::Unit[http://www.ruby-doc.org/core/classes/Test/Unit.html], but it can be used in other contexts.
-
-One of its main advantages is that it allows you to mock and stub methods on _real_ (non-mock) classes and instances. You can for example stub ActiveRecord[http://api.rubyonrails.com/classes/ActiveRecord/Base.html] instance methods like +create+, +save+, +destroy+ and even class methods like +find+ to avoid hitting the database in unit tests.
-
-Mocha provides a unified, simple and readable syntax for both traditional mocking and for mocking with _real_ objects.
-
-Mocha has been harvested from projects at Reevoo[http://www.reevoo.com] by me (James[http://blog.floehopper.org]) and my colleagues Ben[http://www.reevoo.com/blogs/bengriffiths], Chris[http://blog.seagul.co.uk] and Paul[http://po-ru.com]. Mocha is in use on real-world Rails[http://www.rubyonrails.org] projects.
-
-== Download and Installation
-
-Install the gem with the following command...
-
-  $ gem install mocha
- 
-Or install the Rails[http://www.rubyonrails.org] plugin...
-
-  $ script/plugin install svn://rubyforge.org/var/svn/mocha/trunk
-
-Or download Mocha from here - http://rubyforge.org/projects/mocha
-
-== Examples
-
-* Quick Start - {Usage Examples}[link:examples/misc.html]
-* Traditional mocking - {Star Trek Example}[link:examples/mocha.html]
-* Setting expectations on real classes - {Order Example}[link:examples/stubba.html]
-* More examples on {Floehopper's Blog}[http://blog.floehopper.org]
-* {Mailing List Archives}[http://rubyforge.org/pipermail/mocha-developer/]
-
-== License
-
-Copyright Revieworld Ltd. 2006
-
-You may use, copy and redistribute this library under the same terms as {Ruby itself}[http://www.ruby-lang.org/en/LICENSE.txt] or under the {MIT license}[http://mocha.rubyforge.org/files/MIT-LICENSE.html].