mocha 3.0.0.pre.rc.1 → 3.0.0.pre.rc.2

data/lib/mocha/parameter_matchers/kind_of.rb

@@ -1,35 +1,37 @@
 # frozen_string_literal: true
 
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 
 module Mocha
   module ParameterMatchers
-    # Matches any +Object+ that is a kind of +klass+.
-    #
-    # @param [Class] klass expected class.
-    # @return [KindOf] parameter matcher.
-    #
-    # @see Expectation#with
-    # @see Kernel#kind_of?
-    #
-    # @example Actual parameter is a kind of +Integer+.
-    #   object = mock()
-    #   object.expects(:method_1).with(kind_of(Integer))
-    #   object.method_1(99)
-    #   # no error raised
-    #
-    # @example Actual parameter is not a kind of +Integer+.
-    #   object = mock()
-    #   object.expects(:method_1).with(kind_of(Integer))
-    #   object.method_1('string')
-    #   # error raised, because method_1 was not called with a kind of Integer
-    def kind_of(klass)
-      KindOf.new(klass)
+    module Methods
+      # Matches any +Object+ that is a kind of +klass+.
+      #
+      # @param [Class] klass expected class.
+      # @return [KindOf] parameter matcher.
+      #
+      # @see Expectation#with
+      # @see Kernel#kind_of?
+      #
+      # @example Actual parameter is a kind of +Integer+.
+      #   object = mock()
+      #   object.expects(:method_1).with(kind_of(Integer))
+      #   object.method_1(99)
+      #   # no error raised
+      #
+      # @example Actual parameter is not a kind of +Integer+.
+      #   object = mock()
+      #   object.expects(:method_1).with(kind_of(Integer))
+      #   object.method_1('string')
+      #   # error raised, because method_1 was not called with a kind of Integer
+      def kind_of(klass)
+        KindOf.new(klass)
+      end
     end
 
     # Parameter matcher which matches when actual parameter is a kind of specified class.
     class KindOf
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(klass)

data/lib/mocha/parameter_matchers/not.rb

@@ -1,35 +1,37 @@
 # frozen_string_literal: true
 
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 
 module Mocha
   module ParameterMatchers
-    # Matches if +matcher+ does *not* match.
-    #
-    # @param [Base] matcher matcher whose logic to invert.
-    # @return [Not] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter does not include the value +1+.
-    #   object = mock()
-    #   object.expects(:method_1).with(Not(includes(1)))
-    #   object.method_1([0, 2, 3])
-    #   # no error raised
-    #
-    # @example Actual parameter does include the value +1+.
-    #   object = mock()
-    #   object.expects(:method_1).with(Not(includes(1)))
-    #   object.method_1([0, 1, 2, 3])
-    #   # error raised, because method_1 was not called with object not including 1
-    #
-    def Not(matcher) # rubocop:disable Naming/MethodName
-      Not.new(matcher)
+    module Methods
+      # Matches if +matcher+ does *not* match.
+      #
+      # @param [BaseMethods] matcher matcher whose logic to invert.
+      # @return [Not] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter does not include the value +1+.
+      #   object = mock()
+      #   object.expects(:method_1).with(Not(includes(1)))
+      #   object.method_1([0, 2, 3])
+      #   # no error raised
+      #
+      # @example Actual parameter does include the value +1+.
+      #   object = mock()
+      #   object.expects(:method_1).with(Not(includes(1)))
+      #   object.method_1([0, 1, 2, 3])
+      #   # error raised, because method_1 was not called with object not including 1
+      #
+      def Not(matcher) # rubocop:disable Naming/MethodName
+        Not.new(matcher)
+      end
     end
 
     # Parameter matcher which inverts the logic of the specified matcher using a logical NOT operation.
     class Not
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(matcher)

data/lib/mocha/parameter_matchers/optionally.rb

@@ -2,43 +2,45 @@
 
 module Mocha
   module ParameterMatchers
-    # Matches optional parameters if available.
-    #
-    # @param [*Array<Base>] matchers matchers for optional parameters.
-    # @return [Optionally] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Only the two required parameters are supplied and they both match their expected value.
-    #   object = mock()
-    #   object.expects(:method_1).with(1, 2, optionally(3, 4))
-    #   object.method_1(1, 2)
-    #   # no error raised
-    #
-    # @example Both required parameters and one of the optional parameters are supplied and they all match their expected value.
-    #   object = mock()
-    #   object.expects(:method_1).with(1, 2, optionally(3, 4))
-    #   object.method_1(1, 2, 3)
-    #   # no error raised
-    #
-    # @example Both required parameters and both of the optional parameters are supplied and they all match their expected value.
-    #   object = mock()
-    #   object.expects(:method_1).with(1, 2, optionally(3, 4))
-    #   object.method_1(1, 2, 3, 4)
-    #   # no error raised
-    #
-    # @example One of the actual optional parameters does not match the expected value.
-    #   object = mock()
-    #   object.expects(:method_1).with(1, 2, optionally(3, 4))
-    #   object.method_1(1, 2, 3, 5)
-    #   # error raised, because optional parameters did not match
-    def optionally(*matchers)
-      Optionally.new(*matchers)
+    module Methods
+      # Matches optional parameters if available.
+      #
+      # @param [*Array<BaseMethods>] matchers matchers for optional parameters.
+      # @return [Optionally] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Only the two required parameters are supplied and they both match their expected value.
+      #   object = mock()
+      #   object.expects(:method_1).with(1, 2, optionally(3, 4))
+      #   object.method_1(1, 2)
+      #   # no error raised
+      #
+      # @example Both required parameters and one of the optional parameters are supplied and they all match their expected value.
+      #   object = mock()
+      #   object.expects(:method_1).with(1, 2, optionally(3, 4))
+      #   object.method_1(1, 2, 3)
+      #   # no error raised
+      #
+      # @example Both required parameters and both of the optional parameters are supplied and they all match their expected value.
+      #   object = mock()
+      #   object.expects(:method_1).with(1, 2, optionally(3, 4))
+      #   object.method_1(1, 2, 3, 4)
+      #   # no error raised
+      #
+      # @example One of the actual optional parameters does not match the expected value.
+      #   object = mock()
+      #   object.expects(:method_1).with(1, 2, optionally(3, 4))
+      #   object.method_1(1, 2, 3, 5)
+      #   # error raised, because optional parameters did not match
+      def optionally(*matchers)
+        Optionally.new(*matchers)
+      end
     end
 
     # Parameter matcher which allows optional parameters to be specified.
     class Optionally
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(*parameters)

data/lib/mocha/parameter_matchers/positional_or_keyword_hash.rb

@@ -3,14 +3,14 @@
 require 'mocha/configuration'
 require 'mocha/deprecation'
 require 'mocha/ruby_version'
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 require 'mocha/parameter_matchers/has_entries'
 
 module Mocha
   module ParameterMatchers
     # @private
     class PositionalOrKeywordHash
-      include Base
+      include BaseMethods
 
       def initialize(expected_value, expectation, last_expected_value)
         @expected_value = expected_value

data/lib/mocha/parameter_matchers/regexp_matches.rb

@@ -1,35 +1,37 @@
 # frozen_string_literal: true
 
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 
 module Mocha
   module ParameterMatchers
-    # Matches any object that matches +regexp+.
-    #
-    # @param [Regexp] regexp regular expression to match.
-    # @return [RegexpMatches] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter is matched by specified regular expression.
-    #   object = mock()
-    #   object.expects(:method_1).with(regexp_matches(/e/))
-    #   object.method_1('hello')
-    #   # no error raised
-    #
-    # @example Actual parameter is not matched by specified regular expression.
-    #   object = mock()
-    #   object.expects(:method_1).with(regexp_matches(/a/))
-    #   object.method_1('hello')
-    #   # error raised, because method_1 was not called with a parameter that matched the
-    #   # regular expression
-    def regexp_matches(regexp)
-      RegexpMatches.new(regexp)
+    module Methods
+      # Matches any object that matches +regexp+.
+      #
+      # @param [Regexp] regexp regular expression to match.
+      # @return [RegexpMatches] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter is matched by specified regular expression.
+      #   object = mock()
+      #   object.expects(:method_1).with(regexp_matches(/e/))
+      #   object.method_1('hello')
+      #   # no error raised
+      #
+      # @example Actual parameter is not matched by specified regular expression.
+      #   object = mock()
+      #   object.expects(:method_1).with(regexp_matches(/a/))
+      #   object.method_1('hello')
+      #   # error raised, because method_1 was not called with a parameter that matched the
+      #   # regular expression
+      def regexp_matches(regexp)
+        RegexpMatches.new(regexp)
+      end
     end
 
     # Parameter matcher which matches if specified regular expression matches actual paramter.
     class RegexpMatches
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(regexp)

data/lib/mocha/parameter_matchers/responds_with.rb

@@ -1,63 +1,65 @@
 # frozen_string_literal: true
 
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 require 'mocha/parameter_matchers/all_of'
 require 'yaml'
 
 module Mocha
   module ParameterMatchers
-    # @overload def responds_with(message, result)
-    #   Matches any object that responds to +message+ with +result+. To put it another way, it tests the quack, not the duck.
-    #   @param [Symbol] message method to invoke.
-    #   @param [Object] result expected result of sending +message+.
-    # @overload def responds_with(messages_vs_results)
-    #   Matches any object that responds to all the messages with the corresponding results as specified by +messages_vs_results+.
-    #   @param [Hash<Symbol,Object>] messages_vs_results +Hash+ of messages vs results.
-    #   @raise [ArgumentError] if +messages_vs_results+ does not contain at least one entry.
-    #
-    # @return [RespondsWith] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter responds with "FOO" when :upcase is invoked.
-    #   object = mock()
-    #   object.expects(:method_1).with(responds_with(:upcase, "FOO"))
-    #   object.method_1("foo")
-    #   # no error raised, because "foo".upcase == "FOO"
-    #
-    # @example Actual parameter does not respond with "FOO" when :upcase is invoked.
-    #   object = mock()
-    #   object.expects(:method_1).with(responds_with(:upcase, "BAR"))
-    #   object.method_1("foo")
-    #   # error raised, because "foo".upcase != "BAR"
-    #
-    # @example Actual parameter responds with "FOO" when :upcase is invoked and "oof" when :reverse is invoked.
-    #   object = mock()
-    #   object.expects(:method_1).with(responds_with(upcase: "FOO", reverse: "oof"))
-    #   object.method_1("foo")
-    #   # no error raised, because "foo".upcase == "FOO" and "foo".reverse == "oof"
-    def responds_with(*options)
-      case options.length
-      when 0
-        raise ArgumentError, 'No arguments. Expecting at least one.'
-      when 1
-        option = options.first
-        raise ArgumentError, 'Argument is not a Hash.' unless option.is_a?(Hash)
-        raise ArgumentError, 'Argument has no entries.' if option.empty?
+    module Methods
+      # @overload def responds_with(message, result)
+      #   Matches any object that responds to +message+ with +result+. To put it another way, it tests the quack, not the duck.
+      #   @param [Symbol] message method to invoke.
+      #   @param [Object] result expected result of sending +message+.
+      # @overload def responds_with(messages_vs_results)
+      #   Matches any object that responds to all the messages with the corresponding results as specified by +messages_vs_results+.
+      #   @param [Hash<Symbol,Object>] messages_vs_results +Hash+ of messages vs results.
+      #   @raise [ArgumentError] if +messages_vs_results+ does not contain at least one entry.
+      #
+      # @return [RespondsWith] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter responds with "FOO" when :upcase is invoked.
+      #   object = mock()
+      #   object.expects(:method_1).with(responds_with(:upcase, "FOO"))
+      #   object.method_1("foo")
+      #   # no error raised, because "foo".upcase == "FOO"
+      #
+      # @example Actual parameter does not respond with "FOO" when :upcase is invoked.
+      #   object = mock()
+      #   object.expects(:method_1).with(responds_with(:upcase, "BAR"))
+      #   object.method_1("foo")
+      #   # error raised, because "foo".upcase != "BAR"
+      #
+      # @example Actual parameter responds with "FOO" when :upcase is invoked and "oof" when :reverse is invoked.
+      #   object = mock()
+      #   object.expects(:method_1).with(responds_with(upcase: "FOO", reverse: "oof"))
+      #   object.method_1("foo")
+      #   # no error raised, because "foo".upcase == "FOO" and "foo".reverse == "oof"
+      def responds_with(*options)
+        case options.length
+        when 0
+          raise ArgumentError, 'No arguments. Expecting at least one.'
+        when 1
+          option = options.first
+          raise ArgumentError, 'Argument is not a Hash.' unless option.is_a?(Hash)
+          raise ArgumentError, 'Argument has no entries.' if option.empty?
 
-        matchers = option.map { |message, result| RespondsWith.new(message, result) }
-        AllOf.new(*matchers)
-      when 2
-        message, result = options
-        RespondsWith.new(message, result)
-      else
-        raise ArgumentError, 'Too many arguments; use either a single argument (must be a Hash) or two arguments (a message and a result).'
+          matchers = option.map { |message, result| RespondsWith.new(message, result) }
+          AllOf.new(*matchers)
+        when 2
+          message, result = options
+          RespondsWith.new(message, result)
+        else
+          raise ArgumentError, 'Too many arguments; use either a single argument (must be a Hash) or two arguments (a message and a result).'
+        end
       end
     end
 
     # Parameter matcher which matches if actual parameter returns expected result when specified method is invoked.
     class RespondsWith
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(message, result)

data/lib/mocha/parameter_matchers/yaml_equivalent.rb

@@ -1,35 +1,37 @@
 # frozen_string_literal: true
 
-require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/base_methods'
 require 'yaml'
 
 module Mocha
   module ParameterMatchers
-    # Matches any YAML that represents the specified +object+
-    #
-    # @param [Object] object object whose YAML to compare.
-    # @return [YamlEquivalent] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter is YAML equivalent of specified +object+.
-    #   object = mock()
-    #   object.expects(:method_1).with(yaml_equivalent(1, 2, 3))
-    #   object.method_1("--- \n- 1\n- 2\n- 3\n")
-    #   # no error raised
-    #
-    # @example Actual parameter is not YAML equivalent of specified +object+.
-    #   object = mock()
-    #   object.expects(:method_1).with(yaml_equivalent(1, 2, 3))
-    #   object.method_1("--- \n- 1\n- 2\n")
-    #   # error raised, because method_1 was not called with YAML representing the specified Array
-    def yaml_equivalent(object)
-      YamlEquivalent.new(object)
+    module Methods
+      # Matches any YAML that represents the specified +object+
+      #
+      # @param [Object] object object whose YAML to compare.
+      # @return [YamlEquivalent] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter is YAML equivalent of specified +object+.
+      #   object = mock()
+      #   object.expects(:method_1).with(yaml_equivalent(1, 2, 3))
+      #   object.method_1("--- \n- 1\n- 2\n- 3\n")
+      #   # no error raised
+      #
+      # @example Actual parameter is not YAML equivalent of specified +object+.
+      #   object = mock()
+      #   object.expects(:method_1).with(yaml_equivalent(1, 2, 3))
+      #   object.method_1("--- \n- 1\n- 2\n")
+      #   # error raised, because method_1 was not called with YAML representing the specified Array
+      def yaml_equivalent(object)
+        YamlEquivalent.new(object)
+      end
     end
 
     # Parameter matcher which matches if actual parameter is YAML equivalent of specified object.
     class YamlEquivalent
-      include Base
+      include BaseMethods
 
       # @private
       def initialize(object)

data/lib/mocha/parameter_matchers.rb

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
 module Mocha
-  # Used as parameters for {Expectation#with} to restrict the parameter values which will match the expectation. Can be nested.
-  module ParameterMatchers; end
+  # Matcher classes used as parameters for {Expectation#with} to restrict the parameter values which will match the expectation. Can be nested. Build matcher instances in tests using methods in {Methods}, e.g. {Methods#includes}.
+  module ParameterMatchers
+    # These methods build instances of the {ParameterMatchers} classes which are used with {Expectation#with} to restrict the parameter values. Can be nested, e.g. see {Methods#all_of} examples.
+    module Methods; end
+  end
 end
 
 require 'mocha/parameter_matchers/instance_methods'

data/lib/mocha/state_machine.rb

@@ -83,7 +83,7 @@ module Mocha
     #
     # @param [String] unexpected_state_name name of unexpected state.
     # @return [StatePredicate] state predicate which, when queried, will indicate whether the {StateMachine} is *not* in the state specified by +unexpected_state_name+.
-    def is_not(unexpected_state_name) # rubocop:disable Naming/PredicateName
+    def is_not(unexpected_state_name) # rubocop:disable Naming/PredicatePrefix
       StatePredicate.new(self, unexpected_state_name, 'is not') { |current, given| current != given }
     end
 

data/lib/mocha/stubbed_method.rb

@@ -7,10 +7,10 @@ module Mocha
   class StubbedMethod
     PrependedModule = Class.new(Module)
 
-    attr_reader :stubbee, :method_name
+    attr_reader :stubba_object, :method_name
 
-    def initialize(stubbee, method_name)
-      @stubbee = stubbee
+    def initialize(stubba_object, method_name)
+      @stubba_object = stubba_object
       @original_method = nil
       @original_visibility = nil
       @method_name = method_name.to_sym
@@ -30,11 +30,11 @@ module Mocha
     end
 
     def mock
-      mock_owner.mocha
+      stubbee.mocha
     end
 
     def reset_mocha
-      mock_owner.reset_mocha
+      stubbee.reset_mocha
     end
 
     def hide_original_method
@@ -61,14 +61,14 @@ module Mocha
     def matches?(other)
       return false unless other.instance_of?(self.class)
 
-      (stubbee.object_id == other.stubbee.object_id) && # rubocop:disable Lint/IdentityComparison
+      (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
-      "#{stubbee}.#{method_name}"
+      "#{stubba_object}.#{method_name}"
     end
 
     private

data/lib/mocha/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mocha
-  VERSION = '3.0.0-rc.1'
+  VERSION = '3.0.0-rc.2'
 end

data/lib/mocha.rb

@@ -2,5 +2,20 @@
 
 require 'mocha/version'
 
+# 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

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mocha
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre.rc.1
+  version: 3.0.0.pre.rc.2
 platform: ruby
 authors:
 - James Mead
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-24 00:00:00.000000000 Z
+date: 2025-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby2_keywords
@@ -70,11 +71,13 @@ files:
 - lib/mocha/expectation_error_factory.rb
 - lib/mocha/expectation_list.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/integration.rb
 - lib/mocha/integration/assertion_counter.rb
 - lib/mocha/integration/minitest.rb
 - lib/mocha/integration/minitest/adapter.rb
@@ -97,7 +100,7 @@ files:
 - 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
@@ -143,6 +146,7 @@ metadata:
   homepage_uri: https://mocha.jamesmead.org
   source_code_uri: https://github.com/freerange/mocha
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -157,7 +161,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.5.3
+signing_key:
 specification_version: 4
 summary: Mocking and stubbing library
 test_files: []