mocha 2.7.0 → 3.0.0.pre.rc.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36441d2fc56cc4d162b3f1e790c6add3c70eebac844ec6e6b275ef1b6e5f268c
-  data.tar.gz: b63504e88684874b3609b91096bcd90d18f31639b3d32ba95e36f48e8fc67ecf
+  metadata.gz: e64d5427fb1829eee6958310ca322357d6fc0a8fa0d7856ea6b616edbf326c45
+  data.tar.gz: 052c4fc645bb95c2f09f9d66e1ef6a9025aea478b90accd1fc932de0151f684b
 SHA512:
-  metadata.gz: 43c0128284d592878e833404f53f95a3c64bfeca18c85f7f94313b475566f98dc0993ed2b41a9d5118c1b4aabbb99e8848510d7aa3b4afa55804d67c0dd25658
-  data.tar.gz: d9b9785fbf25b80552a7f25e649a5e3ce08ef628c82a1dd36bccf260867156a4ac2c6cf1726e720c6ed8d836a8a1aa0e2441e29e869e65c244ac0c51f93c9423
+  metadata.gz: efd275f6eb30e58383bc67037953e8f02ffa0d0d9ca920ec492267184fe6f3ac8a4765b074d39d8d3b1de38d1e11a374262e3e4a4a3b3e7ee7877f8aba0529b0
+  data.tar.gz: 22b0a2331dc25358032dd83823de41c884a752eb69e80b21befc1d79f931cee4dcc13cf5d40f04bddc3e9ef894b1d2168b90daf3fc89935ed0cd85b41e1b3611

data/.rubocop.yml

@@ -1,7 +1,22 @@
+require:
+  - rubocop-rake
+
 inherit_from: .rubocop_todo.yml
 
+inherit_mode:
+  merge:
+    - Include
+
 AllCops:
-  TargetRubyVersion: 2.2 # closest to required_ruby_version of '>= 2.1'
+  TargetRubyVersion: 2.2
+
+  Include:
+    - '**/Gemfile.*'
+
+  Exclude:
+    - '**/Gemfile*.lock'
+
+  NewCops: enable
 
 # Even the reference in the documentation suggests that you should prefer
 # `alias_method` vs `alias`, so I don't understand why that isn't the default.
@@ -50,9 +65,58 @@ Layout/AccessModifierIndentation:
   Enabled: false
 
 # Allow long comment lines, e.g. YARD documentation
-Metrics/LineLength:
-  IgnoredPatterns: ['\A\s*#']
+Layout/LineLength:
+  AllowedPatterns: ['\A\s*#']
 
 # It's not possible to set TargetRubyVersion to Ruby < v2.2
 Gemspec/RequiredRubyVersion:
   Enabled: false
+
+# It can be useful to violate this cop in tests in order to be more explicit
+Lint/UselessTimes:
+  Exclude:
+    - 'test/**/*.rb'
+
+# It can be useful to violate this cop in tests
+Lint/EmptyClass:
+  Exclude:
+    - 'test/**/*.rb'
+
+# It can be useful to violate this cop in tests when testing methods that accept a block
+Lint/EmptyBlock:
+  Exclude:
+    - 'test/**/*.rb'
+
+# There are a mix of styles in the tests and so I don't think it's worth enforcing for now
+Naming/VariableNumber:
+  Exclude:
+    - 'test/**/*.rb'
+
+# These methods from Ruby core are legitimately overridden in the tests
+Style/OptionalBooleanParameter:
+  AllowedMethods:
+    - respond_to?
+    - public_methods
+    - protected_methods
+    - private_methods
+    - public_instance_methods
+    - protected_instance_methods
+    - private_instance_methods
+
+# This cop is useful for required environment variables, but not for optional ones
+Style/FetchEnvVar:
+  AllowedVars:
+    - MOCHA_RUN_INTEGRATION_TESTS
+
+Naming/FileName:
+  ExpectMatchingDefinition: true
+  CheckDefinitionPathHierarchyRoots:
+    - test/unit
+    - test/acceptance
+  Exclude:
+    - lib/mocha/version.rb
+    - lib/mocha/minitest.rb
+    - lib/mocha/test_unit.rb
+    - lib/mocha/ruby_version.rb
+    - lib/mocha/macos_version.rb
+    - test/test_helper.rb

data/.rubocop_todo.yml

@@ -1,27 +1,39 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2019-11-16 18:15:36 +0000 using RuboCop version 0.58.2.
+# on 2025-01-03 14:37:32 UTC using RuboCop version 1.69.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 57
+# Offense count: 34
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 26
+  Max: 27
 
-# Offense count: 23
-# Configuration parameters: CountComments.
+# Offense count: 28
+# Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 366
+  Max: 381
 
-# Offense count: 172
-# Configuration parameters: CountComments.
+# Offense count: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 9
+
+# Offense count: 200
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 31
+  Max: 27
+
+# Offense count: 3
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 10
 
-# Offense count: 545
-# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# Offense count: 68
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
-Metrics/LineLength:
-  Max: 180
+Layout/LineLength:
+  Max: 173

data/Gemfile

@@ -2,34 +2,18 @@ source 'https://rubygems.org'
 
 gemspec
 
-# rubocop:disable Bundler/DuplicatedGem
-if RUBY_VERSION < '2.2'
-  gem 'rake', '~> 12.3.3'
-else
+group :development do
+  gem 'introspection', '~> 0.0.1'
+  gem 'minitest'
   gem 'rake'
-end
-# rubocop:enable Bundler/DuplicatedGem
 
-gem 'introspection', '~> 0.0.1'
-
-# Avoid breaking change in psych v4 (https://bugs.ruby-lang.org/issues/17866)
-if RUBY_VERSION >= '3.1.0'
-  gem 'psych', '< 4'
-end
+  if RUBY_ENGINE == 'jruby'
+    # Workaround for https://github.com/jruby/jruby/issues/8488
+    gem 'jar-dependencies', '~> 0.4.1'
+  end
 
-if RUBY_VERSION >= '2.2.0'
-  # No test libraries in standard library
-  gem 'minitest'
-end
-if RUBY_VERSION >= '2.2.0'
-  gem 'jaro_winkler', '>= 1.5.5'
-  gem 'rubocop', '> 0.56', '<= 0.58.2'
-end
-if RUBY_ENGINE == 'jruby'
-  # Workaround for https://github.com/jruby/jruby/issues/8488
-  gem 'jar-dependencies', '~> 0.4.1'
-end
-if ENV['MOCHA_GENERATE_DOCS']
-  gem 'redcarpet'
-  gem 'yard'
+  if ENV['MOCHA_GENERATE_DOCS']
+    gem 'redcarpet'
+    gem 'yard'
+  end
 end

data/README.md

@@ -8,6 +8,7 @@
 * Supported by many other test frameworks.
 
 ### Intended Usage
+
 Mocha is intended to be used in unit tests for the [Mock Object](http://xunitpatterns.com/Mock%20Object.html) or [Test Stub](http://xunitpatterns.com/Test%20Stub.html) types of [Test Double](http://xunitpatterns.com/Test%20Double.html), not the [Fake Object](http://xunitpatterns.com/Fake%20Object.html) or [Test Spy](http://xunitpatterns.com/Test%20Spy.html) types. Although it would be possible to extend Mocha to allow the implementation of fakes and spies, we have chosen to keep it focused on mocks and stubs.
 
 ### Installation
@@ -291,10 +292,9 @@ If you want, Mocha can generate a warning or raise an exception when:
 
 See the [documentation](https://mocha.jamesmead.org/Mocha/Configuration.html) for `Mocha::Configuration` for further details.
 
-##### MOCHA_OPTIONS
-`MOCHA_OPTIONS` is an environment variable whose value can be set to a comma-separated list, so that we can specify multiple options e.g. `MOCHA_OPTIONS=debug,use_test_unit_gem`.
-Only the following values are currently recognized and have an effect:
-* `debug`: Enables a debug mode which will output backtraces for each deprecation warning. This is useful for finding where in the test suite the deprecated calls are.
+### Debugging
+
+Mocha provides some extra output to help with debugging when the standard Ruby debug option (`-d`) is set.
 
 ### Semantic versioning
 

data/RELEASE.md

@@ -1,5 +1,50 @@
 # Release Notes
 
+## 3.0.0-rc.1
+
+### External changes
+
+* Improvements to docs for cardinality-related methods (#700)
+* Drop support for Ruby v2.1 (#628 & #695)
+* Improve gemspec description (#692 & #696)
+* Remove docs for `use_test_unit_gem` option (eaf03493)
+* Correct docs for `MOCHA_OPTIONS` "debug" value (69ef41c0)
+* Use built-in Ruby debug option vs custom module (#714 & #715)
+* Enable strict keyword argument matching by default in Ruby >= v3 (#697 & #718)
+* Use Ruby v1.9 Hash syntax in `Hash#mocha_inspect` used in failure messages (#651 & #719)
+* Improve `#mocha_inspect` for empty keyword argument `Hash` (#588 & #720) - thanks to @herwinw for reporting
+* Improve error if `Mockery.teardown` called before `Mockery.setup` (#611, #646 & #721) - thanks to @riniculous for reporting
+* Freeze string literals (#722)
+* Remove support for running tests with Minitest < v5 (#727)
+* Allow keyword arguments to match an expectation expecting *only* positional arguments (#593 & #732) - thanks to @seandilda
+for reporting
+
+### Internal changes
+
+* Add `Expectation#thrice` (#701) - thanks to @andrewn617
+* Add `base64` to Gemfile for Ruby >= v3.3.0 to avoid warning (8c49314c & a76330d6)
+* Include custom Gemfiles in Rubocop linting (04063f0d)
+* Use ruby:3.4.0-rc1 vs ruby:3.4.0-preview2 in CI in preparation for the Ruby v3.4 release (b2127407)
+* Add `ostruct` to Gemfile for Ruby >= v3.4.0 to avoid warning (2b05e09e)
+* Add Ruby v3.4 to CI build matrix (#708)
+* Fix Ruby v3.4 warnings in ObjectInspectTest (#709 & #710)
+* Rubocop-related improvements (#702 & #705)
+* Consistently use development group in Gemfiles (#706 & #716)
+* Add missing requires for 'mocha/ruby_version' (7f99db69)
+* Convert `ParameterMatchers::Base` class -> module (#712 & #723)
+* Enable `ExpectMatchingDefinition` option on `Naming/FileName` cop (#726)
+* Remove duplicate `DefaultReceiverTest` (39d99954)
+* Improvements to keyword argument matching tests (#730)
+* Improvements to keyword argument matcher unit test (#731)
+
+## 2.7.1
+
+### External changes
+
+* Deprecate `Configuration#stubbing_method_on_nil=` (#694)
+* Indicate when parameter matcher logic is defined by block passed to `Expectation#with` (#698, b30e4434)
+* Improve documentation for `Expectation#with`, especially when it is passed a block (#698, #682, #606 & #681)
+
 ## 2.7.0
 
 ### External changes

data/Rakefile

@@ -6,9 +6,10 @@ require 'bundler/setup'
 
 require 'rake/testtask'
 begin
-  # Only available with default Gemfile and in Ruby >= v2.2
+  # Only available with `gemfiles/Gemfile.rubocop`
   require 'rubocop/rake_task'
-rescue LoadError # rubocop:disable Lint/HandleExceptions
+rescue LoadError
+  warn "Unable to load 'rubocop/rake_task', but continuing anyway" if $DEBUG
 end
 
 desc 'Run all linters and tests'
@@ -81,6 +82,7 @@ namespace 'test' do # rubocop:disable Metrics/BlockLength
   end
 end
 
+desc 'Run linters'
 task 'lint' do
   if defined?(RuboCop::RakeTask)
     RuboCop::RakeTask.new
@@ -90,7 +92,6 @@ task 'lint' do
   end
 end
 
-# rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
 def benchmark_test_case(klass, iterations)
   require 'benchmark'
   require 'mocha/detection/minitest'
@@ -119,8 +120,6 @@ def benchmark_test_case(klass, iterations)
     Benchmark.realtime { iterations.times { Test::Unit::UI::Console::TestRunner.run(klass, @silent_option) } }
   end
 end
-# rubocop:enable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
-
 if ENV['MOCHA_GENERATE_DOCS']
   require 'yard'
 
@@ -134,10 +133,12 @@ if ENV['MOCHA_GENERATE_DOCS']
     task.options = ['--title', "Mocha #{Mocha::VERSION}", '--fail-on-warning']
   end
 
+  desc 'Ensure custom domain remains in place for docs on GitHub Pages'
   task 'checkout_docs_cname' do
     `git checkout docs/CNAME`
   end
 
+  desc 'Ensure custom JavaScript files remain in place for docs on GitHub Pages'
   task 'checkout_docs_js' do
     `git checkout docs/js/app.js`
     `git checkout docs/js/jquery.js`

data/gemfiles/Gemfile.minitest.latest

@@ -1,8 +1,8 @@
 source 'https://rubygems.org'
 
-gemspec :path=>"../"
+gemspec path: '../'
 
 group :development do
-  gem "rake"
-  gem "minitest"
+  gem 'rake'
+  gem 'minitest'
 end

data/gemfiles/Gemfile.rubocop

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec path: '../'
+
+group :development do
+  gem 'rake'
+  gem 'rubocop'
+  gem 'rubocop-rake'
+end

data/gemfiles/Gemfile.test-unit.latest

@@ -1,8 +1,8 @@
 source 'https://rubygems.org'
 
-gemspec :path=>"../"
+gemspec path: '../'
 
 group :development do
-  gem "rake"
-  gem "test-unit"
+  gem 'rake'
+  gem 'test-unit'
 end

data/lib/mocha/any_instance_method.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'mocha/stubbed_method'
 
 module Mocha

data/lib/mocha/any_instance_receiver.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Mocha
+  class AnyInstanceReceiver
+    def initialize(klass)
+      @klass = klass
+    end
+
+    def mocks
+      klass = @klass
+      mocks = []
+      while klass
+        mocha = klass.any_instance.mocha(instantiate: false)
+        mocks << mocha if mocha
+        klass = klass.superclass
+      end
+      mocks
+    end
+  end
+end

data/lib/mocha/api.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'mocha/ruby_version'
 require 'mocha/parameter_matchers'
 require 'mocha/hooks'
@@ -37,8 +39,8 @@ module Mocha
 
     # @private
     def self.included(_mod)
-      Object.send(:include, Mocha::ObjectMethods)
-      Class.send(:include, Mocha::ClassMethods)
+      Object.include Mocha::ObjectMethods
+      Class.include Mocha::ClassMethods
     end
 
     # @private

data/lib/mocha/argument_iterator.rb

@@ -1,16 +1,16 @@
+# frozen_string_literal: true
+
 module Mocha
   class ArgumentIterator
     def initialize(argument)
       @argument = argument
     end
 
-    def each
+    def each(&block)
       if @argument.is_a?(Hash)
-        @argument.each do |method_name, return_value|
-          yield method_name, return_value
-        end
+        @argument.each(&block)
       else
-        yield @argument
+        block.call(@argument)
       end
     end
   end

data/lib/mocha/backtrace_filter.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Mocha
   class BacktraceFilter
     LIB_DIRECTORY = File.expand_path(File.join(File.dirname(__FILE__), '..')) + File::SEPARATOR

data/lib/mocha/{block_matcher.rb → block_matchers.rb}

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Mocha
   module BlockMatchers
     class OptionalBlock

data/lib/mocha/cardinality.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Mocha
   class Cardinality
     INFINITY = 1 / 0.0
@@ -58,7 +60,6 @@ module Mocha
       @invocations.any? || maximum.zero?
     end
 
-    # rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
     def anticipated_times
       if allowed_any_number_of_times?
         'allowed any number of times'
@@ -74,7 +75,6 @@ module Mocha
         "expected between #{required} and #{count(maximum)}"
       end
     end
-    # rubocop:enable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
 
     def invoked_times
       "invoked #{count(@invocations.size)}"

data/lib/mocha/central.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Mocha
   class Central
     class Null < self
@@ -23,12 +25,14 @@ module Mocha
 
     def stub(method)
       return if stubba_methods.detect { |m| m.matches?(method) }
+
       method.stub
       stubba_methods.push(method)
     end
 
     def unstub(method)
       return unless (existing = stubba_methods.detect { |m| m.matches?(method) })
+
       existing.unstub
       stubba_methods.delete(existing)
     end

data/lib/mocha/change_state_side_effect.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Mocha
   class ChangeStateSideEffect
     def initialize(state)

data/lib/mocha/class_methods.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'mocha/mockery'
 require 'mocha/any_instance_method'
 
@@ -10,7 +12,7 @@ module Mocha
         @stubba_object = klass
       end
 
-      def mocha(instantiate = true)
+      def mocha(instantiate: true)
         if instantiate
           @mocha ||= Mocha::Mockery.instance.mock_impersonating_any_instance_of(@stubba_object)
         else
@@ -46,17 +48,16 @@ module Mocha
       if frozen?
         raise StubbingError.new("can't stub method on frozen object: #{mocha_inspect}.any_instance", caller)
       end
+
       @any_instance ||= AnyInstance.new(self)
     end
 
     # @private
-    # rubocop:disable Metrics/CyclomaticComplexity
-    def __method_visibility__(method, include_public_methods = true)
+    def __method_visibility__(method, include_public_methods: true)
       (include_public_methods && public_method_defined?(method) && :public) ||
         (protected_method_defined?(method) && :protected) ||
         (private_method_defined?(method) && :private)
     end
-    # rubocop:enable Metrics/CyclomaticComplexity
     alias_method :__method_exists__?, :__method_visibility__
   end
 end

data/lib/mocha/configuration.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 require 'mocha/ruby_version'
+require 'mocha/deprecation'
 
 module Mocha
   # Allows setting of configuration options. See {Configuration} for the available options.
@@ -13,7 +16,6 @@ module Mocha
   #   Mocha.configure do |c|
   #     c.stubbing_method_unnecessarily = :prevent
   #     c.stubbing_method_on_non_mock_object = :warn
-  #     c.stubbing_method_on_nil = :allow
   #   end
   #
   def self.configure
@@ -33,7 +35,6 @@ module Mocha
   #   Mocha.configure do |c|
   #     c.stubbing_method_unnecessarily = :prevent
   #     c.stubbing_method_on_non_mock_object = :warn
-  #     c.stubbing_method_on_nil = :allow
   #   end
   #
   class Configuration
@@ -43,9 +44,8 @@ module Mocha
       stubbing_method_on_non_mock_object: :allow,
       stubbing_non_existent_method: :allow,
       stubbing_non_public_method: :allow,
-      stubbing_method_on_nil: :prevent,
       display_matching_invocations_on_failure: false,
-      strict_keyword_argument_matching: false
+      strict_keyword_argument_matching: Mocha::RUBY_V30_PLUS
     }.freeze
 
     attr_reader :options
@@ -195,27 +195,6 @@ module Mocha
       @options[:stubbing_non_public_method]
     end
 
-    # Configure whether stubbing methods on the +nil+ object is allowed.
-    #
-    # This is usually done accidentally, but there might be rare cases where it is intended.
-    #
-    # This option only works for Ruby < v2.2.0. In later versions of Ruby +nil+ is frozen and so a {StubbingError} will be raised if you attempt to stub a method on +nil+.
-    #
-    # When +value+ is +:allow+, do nothing.
-    # When +value+ is +:warn+, display a warning.
-    # When +value+ is +:prevent+, raise a {StubbingError}. This is the default.
-    #
-    # @param [Symbol] value one of +:allow+, +:warn+, +:prevent+.
-    #
-    def stubbing_method_on_nil=(value)
-      @options[:stubbing_method_on_nil] = value
-    end
-
-    # @private
-    def stubbing_method_on_nil
-      @options[:stubbing_method_on_nil]
-    end
-
     # Display matching invocations alongside expectations on Mocha-related test failure.
     #
     # @param [Boolean] value +true+ to enable display of matching invocations; disabled by default.
@@ -252,17 +231,21 @@ module Mocha
 
     # Perform strict keyword argument comparison. Only supported in Ruby >= v2.7.
     #
-    # When this option is set to +false+ a positional +Hash+ and a set of keyword arguments are treated the same during comparison, which can lead to misleading passing tests in Ruby >= v3.0 (see examples below). However, a deprecation warning will be displayed if a positional +Hash+ matches a set of keyword arguments or vice versa. This is because {#strict_keyword_argument_matching=} will default to +true+ in the future.
+    # When this option is set to +false+ a positional +Hash+ and a set of keyword arguments are treated the same during comparison, which can lead to misleading passing tests in Ruby >= v3.0 (see examples below). However, a deprecation warning will be displayed if a positional +Hash+ matches a set of keyword arguments or vice versa.
     #
     # For more details on keyword arguments in Ruby v3, refer to {https://www.ruby-lang.org/en/news/2019/12/12/separation-of-positional-and-keyword-arguments-in-ruby-3-0 this article}.
     #
     # Note that +Hash+-related matchers such as {ParameterMatchers#has_value} or {ParameterMatchers#has_key} will still treat a positional +Hash+ and a set of keyword arguments the same, so misleading passing tests are still possible when they are used.
     #
-    # This configuration option is +false+ by default to enable gradual adoption, but will be +true+ by default in the future.
+    # This configuration option is +false+ by default in Ruby v2.7 to enable gradual adoption, but +true+ by default in Ruby >= v3.0.
     #
-    # @param [Boolean] value +true+ to enable strict keyword argument matching; +false+ by default.
+    # @param [Boolean] value +true+ to enable strict keyword argument matching.
     #
-    # @example Loose keyword argument matching (default)
+    # @example Loose keyword argument matching (default in Ruby v2.7)
+    #
+    #   Mocha.configure do |c|
+    #     c.strict_keyword_argument_matching = false
+    #   end
     #
     #   class Example
     #     def foo(a, bar:); end
@@ -273,7 +256,7 @@ module Mocha
     #   example.foo('a', { bar: 'b' })
     #   # This passes the test, but would result in an ArgumentError in practice
     #
-    # @example Strict keyword argument matching
+    # @example Strict keyword argument matching (default in Ruby >= v3.0)
     #
     #   Mocha.configure do |c|
     #     c.strict_keyword_argument_matching = true
@@ -289,6 +272,7 @@ module Mocha
     #   # This now fails as expected
     def strict_keyword_argument_matching=(value)
       raise 'Strict keyword argument matching requires Ruby 2.7 and above.' unless Mocha::RUBY_V27_PLUS
+
       @options[:strict_keyword_argument_matching] = value
     end
 
@@ -311,9 +295,9 @@ module Mocha
       # @param [Hash] temporary_options the configuration options to apply for the duration of the block.
       # @yield block during which the configuration change will be in force.
       #
-      # @example Temporarily allow stubbing of +nil+
-      #   Mocha::Configuration.override(stubbing_method_on_nil: :allow) do
-      #     nil.stubs(:foo)
+      # @example Temporarily prevent stubbing of non-mock object
+      #   Mocha::Configuration.override(stubbing_method_on_non_mock_object: :prevent) do
+      #     123.stubs(:to_s).returns('456')
       #   end
       def override(temporary_options)
         original_configuration = configuration
@@ -335,7 +319,7 @@ module Mocha
         if block_given?
           temporarily_change_config action, new_value, &block
         else
-          configuration.send("#{action}=".to_sym, new_value)
+          configuration.send(:"#{action}=", new_value)
         end
       end
 
@@ -343,7 +327,7 @@ module Mocha
       def temporarily_change_config(action, new_value)
         original_configuration = configuration
         new_configuration = configuration.dup
-        new_configuration.send("#{action}=".to_sym, new_value)
+        new_configuration.send(:"#{action}=", new_value)
         @configuration = new_configuration
         yield
       ensure