mocha 2.7.0 → 2.8.0

data/lib/mocha/parameter_matchers/equivalent_uri.rb

@@ -1,33 +1,40 @@
 require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/deprecations'
 require 'uri'
 require 'cgi'
 
 module Mocha
   module ParameterMatchers
-    # Matches a URI without regard to the ordering of parameters in the query string.
-    #
-    # @param [String] uri URI to match.
-    # @return [EquivalentUri] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual URI is equivalent.
-    #   object = mock()
-    #   object.expects(:method_1).with(equivalent_uri('http://example.com/foo?a=1&b=2))
-    #   object.method_1('http://example.com/foo?b=2&a=1')
-    #   # no error raised
-    #
-    # @example Actual URI is not equivalent.
-    #   object = mock()
-    #   object.expects(:method_1).with(equivalent_uri('http://example.com/foo?a=1&b=2))
-    #   object.method_1('http://example.com/foo?a=1&b=3')
-    #   # error raised, because the query parameters were different
-    def equivalent_uri(uri)
-      EquivalentUri.new(uri)
+    module Methods
+      # Matches a URI without regard to the ordering of parameters in the query string.
+      #
+      # @param [String] uri URI to match.
+      # @return [EquivalentUri] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual URI is equivalent.
+      #   object = mock()
+      #   object.expects(:method_1).with(equivalent_uri('http://example.com/foo?a=1&b=2))
+      #   object.method_1('http://example.com/foo?b=2&a=1')
+      #   # no error raised
+      #
+      # @example Actual URI is not equivalent.
+      #   object = mock()
+      #   object.expects(:method_1).with(equivalent_uri('http://example.com/foo?a=1&b=2))
+      #   object.method_1('http://example.com/foo?a=1&b=3')
+      #   # error raised, because the query parameters were different
+      def equivalent_uri(uri)
+        EquivalentUri.new(uri)
+      end
     end
 
+    define_deprecated_matcher_method(:equivalent_uri)
+
     # Parameter matcher which matches URIs with equivalent query strings.
-    class EquivalentUri < Base
+    class EquivalentUri
+      include BaseMethods
+
       # @private
       def initialize(uri)
         @uri = URI.parse(uri)
@@ -53,5 +60,7 @@ module Mocha
         URI::Generic::COMPONENT.inject({}) { |h, k| h.merge(k => uri.__send__(k)) }.merge(query: query_hash)
       end
     end
+
+    provide_deprecated_access_to(:EquivalentUri)
   end
 end

data/lib/mocha/parameter_matchers/has_entries.rb

@@ -1,34 +1,41 @@
 require 'mocha/parameter_matchers/base'
 require 'mocha/parameter_matchers/all_of'
 require 'mocha/parameter_matchers/has_entry'
+require 'mocha/parameter_matchers/deprecations'
 
 module Mocha
   module ParameterMatchers
-    # Matches +Hash+ containing all +entries+.
-    #
-    # @param [Hash] entries expected +Hash+ entries.
-    # @return [HasEntries] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter contains all expected entries.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_entries('key_1' => 1, 'key_2' => 2))
-    #   object.method_1('key_1' => 1, 'key_2' => 2, 'key_3' => 3)
-    #   # no error raised
-    #
-    # @example Actual parameter does not contain all expected entries.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_entries('key_1' => 1, 'key_2' => 2))
-    #   object.method_1('key_1' => 1, 'key_2' => 99)
-    #   # error raised, because method_1 was not called with Hash containing entries: 'key_1' => 1, 'key_2' => 2
-    #
-    def has_entries(entries) # rubocop:disable Naming/PredicateName
-      HasEntries.new(entries)
+    module Methods
+      # Matches +Hash+ containing all +entries+.
+      #
+      # @param [Hash] entries expected +Hash+ entries.
+      # @return [HasEntries] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter contains all expected entries.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_entries('key_1' => 1, 'key_2' => 2))
+      #   object.method_1('key_1' => 1, 'key_2' => 2, 'key_3' => 3)
+      #   # no error raised
+      #
+      # @example Actual parameter does not contain all expected entries.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_entries('key_1' => 1, 'key_2' => 2))
+      #   object.method_1('key_1' => 1, 'key_2' => 99)
+      #   # error raised, because method_1 was not called with Hash containing entries: 'key_1' => 1, 'key_2' => 2
+      #
+      def has_entries(entries) # rubocop:disable Naming/PredicateName
+        HasEntries.new(entries)
+      end
     end
 
+    define_deprecated_matcher_method(:has_entries)
+
     # Parameter matcher which matches when actual parameter contains all expected +Hash+ entries.
-    class HasEntries < Base
+    class HasEntries
+      include BaseMethods
+
       # @private
       def initialize(entries, exact: false)
         @entries = entries
@@ -51,5 +58,7 @@ module Mocha
         @exact ? @entries.mocha_inspect : "has_entries(#{@entries.mocha_inspect})"
       end
     end
+
+    provide_deprecated_access_to(:HasEntries)
   end
 end

data/lib/mocha/parameter_matchers/has_entry.rb

@@ -1,61 +1,68 @@
 require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/deprecations'
 
 module Mocha
   module ParameterMatchers
-    # Matches +Hash+ containing entry with +key+ and +value+.
-    #
-    # @overload def has_entry(key, value)
-    #   @param [Object] key key for entry.
-    #   @param [Object] value value for entry.
-    # @overload def has_entry(single_entry_hash)
-    #   @param [Hash] single_entry_hash +Hash+ with single entry.
-    #   @raise [ArgumentError] if +single_entry_hash+ does not contain exactly one entry.
-    #
-    # @return [HasEntry] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter contains expected entry supplied as 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
-    #
-    # @example Actual parameter contains expected entry supplied as +Hash+ entry.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_entry('key_1' => 1))
-    #   object.method_1('key_1' => 1, 'key_2' => 2)
-    #   # no error raised
-    #
-    # @example Actual parameter does not contain expected entry supplied as key and value.
-    #   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
-    #
-    # @example Actual parameter does not contain expected entry supplied as +Hash+ entry.
-    #
-    #   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(*options) # rubocop:disable Naming/PredicateName
-      case options.length
-      when 0
-        raise ArgumentError, 'No arguments. Expecting at least one.'
-      when 1
-        key, value = parse_option(options[0])
-      when 2
-        key, value = options
-      else
-        raise ArgumentError, 'Too many arguments; use either a single argument (must be a Hash) or two arguments (a key and a value).'
+    module Methods
+      # Matches +Hash+ containing entry with +key+ and +value+.
+      #
+      # @overload def has_entry(key, value)
+      #   @param [Object] key key for entry.
+      #   @param [Object] value value for entry.
+      # @overload def has_entry(single_entry_hash)
+      #   @param [Hash] single_entry_hash +Hash+ with single entry.
+      #   @raise [ArgumentError] if +single_entry_hash+ does not contain exactly one entry.
+      #
+      # @return [HasEntry] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter contains expected entry supplied as 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
+      #
+      # @example Actual parameter contains expected entry supplied as +Hash+ entry.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_entry('key_1' => 1))
+      #   object.method_1('key_1' => 1, 'key_2' => 2)
+      #   # no error raised
+      #
+      # @example Actual parameter does not contain expected entry supplied as key and value.
+      #   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
+      #
+      # @example Actual parameter does not contain expected entry supplied as +Hash+ entry.
+      #
+      #   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(*options) # rubocop:disable Naming/PredicateName
+        case options.length
+        when 0
+          raise ArgumentError, 'No arguments. Expecting at least one.'
+        when 1
+          key, value = HasEntry.parse_option(options[0])
+        when 2
+          key, value = options
+        else
+          raise ArgumentError, 'Too many arguments; use either a single argument (must be a Hash) or two arguments (a key and a value).'
+        end
+        HasEntry.new(key, value)
       end
-      HasEntry.new(key, value)
     end
 
+    define_deprecated_matcher_method(:has_entry)
+
     # Parameter matcher which matches when actual parameter contains expected +Hash+ entry.
-    class HasEntry < Base
+    class HasEntry
+      include BaseMethods
+
       # @private
       def initialize(key, value)
         @key = key
@@ -74,25 +81,25 @@ module Mocha
       def mocha_inspect
         "has_entry(#{@key.mocha_inspect} => #{@value.mocha_inspect})"
       end
-    end
-
-    private
 
-    # @private
-    def parse_option(option)
-      case option
-      when Hash
-        case option.length
-        when 0
-          raise ArgumentError, 'Argument has no entries.'
-        when 1
-          option.first
+      # @private
+      def self.parse_option(option)
+        case option
+        when Hash
+          case option.length
+          when 0
+            raise ArgumentError, 'Argument has no entries.'
+          when 1
+            option.first
+          else
+            raise ArgumentError, 'Argument has multiple entries. Use Mocha::ParameterMatchers#has_entries instead.'
+          end
         else
-          raise ArgumentError, 'Argument has multiple entries. Use Mocha::ParameterMatchers#has_entries instead.'
+          raise ArgumentError, 'Argument is not a Hash.'
         end
-      else
-        raise ArgumentError, 'Argument is not a Hash.'
       end
     end
+
+    provide_deprecated_access_to(:HasEntry)
   end
 end

data/lib/mocha/parameter_matchers/has_key.rb

@@ -1,32 +1,39 @@
 require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/deprecations'
 
 module Mocha
   module ParameterMatchers
-    # Matches +Hash+ containing +key+.
-    #
-    # @param [Object] key expected key.
-    # @return [HasKey] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter contains entry with expected key.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_key('key_1'))
-    #   object.method_1('key_1' => 1, 'key_2' => 2)
-    #   # no error raised
-    #
-    # @example Actual parameter does not contain entry with expected key.
-    #   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) # rubocop:disable Naming/PredicateName
-      HasKey.new(key)
+    module Methods
+      # Matches +Hash+ containing +key+.
+      #
+      # @param [Object] key expected key.
+      # @return [HasKey] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter contains entry with expected key.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_key('key_1'))
+      #   object.method_1('key_1' => 1, 'key_2' => 2)
+      #   # no error raised
+      #
+      # @example Actual parameter does not contain entry with expected key.
+      #   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) # rubocop:disable Naming/PredicateName
+        HasKey.new(key)
+      end
     end
 
+    define_deprecated_matcher_method(:has_key)
+
     # Parameter matcher which matches when actual parameter contains +Hash+ entry with expected key.
-    class HasKey < Base
+    class HasKey
+      include BaseMethods
+
       # @private
       def initialize(key)
         @key = key
@@ -44,5 +51,7 @@ module Mocha
         "has_key(#{@key.mocha_inspect})"
       end
     end
+
+    provide_deprecated_access_to(:HasKey)
   end
 end

data/lib/mocha/parameter_matchers/has_keys.rb

@@ -1,32 +1,39 @@
 require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/deprecations'
 
 module Mocha
   module ParameterMatchers
-    # Matches +Hash+ containing +keys+.
-    #
-    # @param [*Array<Object>] keys expected keys.
-    # @return [HasKeys] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter contains entry with expected keys.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_keys(:key_1, :key_2))
-    #   object.method_1(:key_1 => 1, :key_2 => 2, :key_3 => 3)
-    #   # no error raised
-    #
-    # @example Actual parameter does not contain all expected keys.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_keys(:key_1, :key_2))
-    #   object.method_1(:key_2 => 2)
-    #   # error raised, because method_1 was not called with Hash containing key: :key_1
-    #
-    def has_keys(*keys) # rubocop:disable Naming/PredicateName
-      HasKeys.new(*keys)
+    module Methods
+      # Matches +Hash+ containing +keys+.
+      #
+      # @param [*Array<Object>] keys expected keys.
+      # @return [HasKeys] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter contains entry with expected keys.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_keys(:key_1, :key_2))
+      #   object.method_1(:key_1 => 1, :key_2 => 2, :key_3 => 3)
+      #   # no error raised
+      #
+      # @example Actual parameter does not contain all expected keys.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_keys(:key_1, :key_2))
+      #   object.method_1(:key_2 => 2)
+      #   # error raised, because method_1 was not called with Hash containing key: :key_1
+      #
+      def has_keys(*keys) # rubocop:disable Naming/PredicateName
+        HasKeys.new(*keys)
+      end
     end
 
+    define_deprecated_matcher_method(:has_keys)
+
     # Parameter matcher which matches when actual parameter contains +Hash+ with all expected keys.
-    class HasKeys < Base
+    class HasKeys
+      include BaseMethods
+
       # @private
       def initialize(*keys)
         raise ArgumentError, 'No arguments. Expecting at least one.' if keys.empty?
@@ -49,5 +56,7 @@ module Mocha
         "has_keys(#{@keys.mocha_inspect(false)})"
       end
     end
+
+    provide_deprecated_access_to(:HasKeys)
   end
 end

data/lib/mocha/parameter_matchers/has_value.rb

@@ -1,32 +1,39 @@
 require 'mocha/parameter_matchers/base'
+require 'mocha/parameter_matchers/deprecations'
 
 module Mocha
   module ParameterMatchers
-    # Matches +Hash+ containing +value+.
-    #
-    # @param [Object] value expected value.
-    # @return [HasValue] parameter matcher.
-    #
-    # @see Expectation#with
-    #
-    # @example Actual parameter contains entry with expected value.
-    #   object = mock()
-    #   object.expects(:method_1).with(has_value(1))
-    #   object.method_1('key_1' => 1, 'key_2' => 2)
-    #   # no error raised
-    #
-    # @example Actual parameter does not contain entry with expected value.
-    #   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) # rubocop:disable Naming/PredicateName
-      HasValue.new(value)
+    module Methods
+      # Matches +Hash+ containing +value+.
+      #
+      # @param [Object] value expected value.
+      # @return [HasValue] parameter matcher.
+      #
+      # @see Expectation#with
+      #
+      # @example Actual parameter contains entry with expected value.
+      #   object = mock()
+      #   object.expects(:method_1).with(has_value(1))
+      #   object.method_1('key_1' => 1, 'key_2' => 2)
+      #   # no error raised
+      #
+      # @example Actual parameter does not contain entry with expected value.
+      #   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) # rubocop:disable Naming/PredicateName
+        HasValue.new(value)
+      end
     end
 
+    define_deprecated_matcher_method(:has_value)
+
     # Parameter matcher which matches when actual parameter contains +Hash+ entry with expected value.
-    class HasValue < Base
+    class HasValue
+      include BaseMethods
+
       # @private
       def initialize(value)
         @value = value
@@ -44,5 +51,7 @@ module Mocha
         "has_value(#{@value.mocha_inspect})"
       end
     end
+
+    provide_deprecated_access_to(:HasValue)
   end
 end