Add support for hash_including argument matcher

Author: wata727

lib/super_diff/rspec.rb

@@ -26,6 +26,12 @@ def self.a_hash_including_something?(value)
         value.expecteds.first.is_a?(::Hash)
     end
 
+    # HINT: `a_hash_including` is an alias of `include` in the rspec-expectations gem.
+    #       `hash_including` is an argument matcher in the rspec-mocks gem.
+    def self.hash_including_something?(value)
+      value.is_a?(::RSpec::Mocks::ArgumentMatchers::HashIncludingMatcher)
+    end
+
     def self.a_collection_including_something?(value)
       fuzzy_object?(value) &&
         value.respond_to?(:expecteds) &&

lib/super_diff/rspec/differs/hash_including.rb

@@ -3,8 +3,10 @@ module RSpec
     module Differs
       class HashIncluding < SuperDiff::Differs::Hash
         def self.applies_to?(expected, actual)
-          SuperDiff::RSpec.a_hash_including_something?(expected) &&
-            actual.is_a?(::Hash)
+          (
+            SuperDiff::RSpec.a_hash_including_something?(expected) ||
+            SuperDiff::RSpec.hash_including_something?(expected)
+          ) && actual.is_a?(::Hash)
         end
 
         private

lib/super_diff/rspec/object_inspection/inspectors/hash_including.rb

@@ -4,7 +4,7 @@ module ObjectInspection
       module Inspectors
         class HashIncluding < SuperDiff::ObjectInspection::Inspectors::Base
           def self.applies_to?(value)
-            SuperDiff::RSpec.a_hash_including_something?(value)
+            SuperDiff::RSpec.a_hash_including_something?(value) || SuperDiff::RSpec.hash_including_something?(value)
           end
 
           protected
@@ -13,9 +13,14 @@ def inspection_tree
             SuperDiff::ObjectInspection::InspectionTree.new do
               add_text "#<a hash including ("
 
-              nested do |aliased_matcher|
+              nested do |value|
+                hash = if SuperDiff::RSpec.a_hash_including_something?(value)
+                         value.expecteds.first
+                       else
+                         value.instance_variable_get(:@expected)
+                       end
                 insert_hash_inspection_of(
-                  aliased_matcher.expecteds.first,
+                  hash,
                   initial_break: nil,
                 )
               end

lib/super_diff/rspec/operation_tree_builders/hash_including.rb

@@ -3,12 +3,19 @@ module RSpec
     module OperationTreeBuilders
       class HashIncluding < SuperDiff::OperationTreeBuilders::Hash
         def self.applies_to?(expected, actual)
-          SuperDiff::RSpec.a_hash_including_something?(expected) &&
-            actual.is_a?(::Hash)
+          (
+            SuperDiff::RSpec.a_hash_including_something?(expected) ||
+            SuperDiff::RSpec.hash_including_something?(expected)
+          ) && actual.is_a?(::Hash)
         end
 
         def initialize(expected:, **rest)
-          super(expected: expected.expecteds.first, **rest)
+          hash = if SuperDiff::RSpec.a_hash_including_something?(expected)
+                   expected.expecteds.first
+                 else
+                   expected.instance_variable_get(:@expected)
+                 end
+          super(expected: hash, **rest)
         end
 
         private

spec/integration/rspec/match_matcher_spec.rb

@@ -341,6 +341,48 @@
     end
   end
 
+  # HINT: `a_hash_including` is an alias of `include` in the rspec-expectations gem.
+  #       `hash_including` is an argument matcher in the rspec-mocks gem.
+  context "when the expected value is `hash-including-<something>`, not `a-hash-including-<something>`" do
+    it "produces the correct failure message" do
+      as_both_colored_and_uncolored do |color_enabled|
+        snippet = <<~TEST.strip
+          expected = hash_including(city: "Hill Valley")
+          actual   = { city: "Burbank" }
+          expect(actual).to match(expected)
+        TEST
+        program = make_plain_test_program(
+          snippet,
+          color_enabled: color_enabled,
+        )
+
+        expected_output = build_expected_output(
+          color_enabled: color_enabled,
+          snippet: %|expect(actual).to match(expected)|,
+          expectation: proc {
+            line do
+              plain    %|Expected |
+              actual   %|{ city: "Burbank" }|
+              plain    %| to match |
+              expected %|#<a hash including (city: "Hill Valley")>|
+              plain    %|.|
+            end
+          },
+          diff: proc {
+            plain_line    %|  {|
+            expected_line %|-   city: "Hill Valley"|
+            actual_line   %|+   city: "Burbank"|
+            plain_line    %|  }|
+          },
+        )
+
+        expect(program).
+          to produce_output_when_run(expected_output).
+          in_color(color_enabled)
+      end
+    end
+  end
+
   context "when the expected value is a collection-including-<something>" do
     context "that is small" do
       it "produces the correct failure message when used in the positive" do