matchi 2.2.1 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43879fd564f4fe9dfab4116b3e59e452edd5e700dd4cd0f71164965214a17f47
-  data.tar.gz: c4f2eda14d387063449b71e42ea80af8a61888a676b986106c40062735c19342
+  metadata.gz: 96a52462a574281d4d485558a112fec5cef2e00f1fb90c13987407c18302887c
+  data.tar.gz: 00511b2878ebc9bbe2deb07f888944c9b2e2f2cebf9d8a78d1fe40e1a2b923c7
 SHA512:
-  metadata.gz: fd575e3e83c363e04d34ea37ed2f66cb5d7a84dfb63c4b18752347ad105bea9074a0c1489a598a9904295d06e5bf051d5126a0d785231ca9df2762f188db7c1d
-  data.tar.gz: b9e90e939b96c10c27796d58577e2c8db4269233e689bb17e1845526da2c5e83668b1608a478ffdec4321d7852750eec9f21b92bd5f4932d6190a85caa11c491
+  metadata.gz: d368cf94df8ebbfe50b7d5ffd521653853096cd7c36c1c23093916899d0f2524ccf3f3526495cc37e043af571b0df68652c406e7effb033c8d2e92c661dd2b4a
+  data.tar.gz: 5646d8c021cc964041af44412aefab04cc27ebbaa51ddf381b81b43577f233be8f4621735000f1ef7b63e759d80cf51e67c8c802ace3634e2174f72ee8b4ab9f

data/README.md

@@ -102,6 +102,13 @@ be_an_instance_of = Matchi::Matcher::BeAnInstanceOf.new(:String)
 be_an_instance_of.matches? { "foo" } # => true
 ```
 
+**Satisfy** matcher:
+
+```ruby
+satisfy = Matchi::Matcher::Satisfy.new { |value| value == 42 }
+satisfy.matches? { 42 } # => true
+```
+
 ### Custom matchers
 
 Custom matchers can easily be defined for expressing expectations.

data/lib/matchi/matcher/satisfy.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Matchi
+  module Matcher
+    # *Satisfy* matcher.
+    class Satisfy < ::Matchi::Matcher::Base
+      # Initialize the matcher with a block.
+      #
+      # @example The number 42 matcher.
+      #   Matchi::Matcher::Satisfy.new { |value| value == 42 }
+      #
+      # @param block [Proc] A block of code.
+      def initialize(&block)
+        super()
+        @expected = block
+      end
+
+      # (see Base#inspect)
+      def inspect
+        "#{self.class}(&block)"
+      end
+
+      # Boolean comparison between the actual value and the expected value.
+      #
+      # @example Is it equal to 42
+      #   equal = Matchi::Matcher::Satisfy.new { |value| value == 42 }
+      #   equal.matches? { 42 } # => true
+      #
+      # @yieldreturn [#object_id] The actual value to compare to the expected
+      #   one.
+      #
+      # @return [Boolean] Comparison between actual and expected values.
+      def matches?(*, **)
+        expected.call(yield)
+      end
+
+      # (see Base#to_s)
+      def to_s
+        "#{self.class.to_sym} &block"
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: matchi
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.3.0
 platform: ruby
 authors:
 - Cyril Kato
@@ -142,6 +142,7 @@ files:
 - lib/matchi/matcher/equal.rb
 - lib/matchi/matcher/match.rb
 - lib/matchi/matcher/raise_exception.rb
+- lib/matchi/matcher/satisfy.rb
 homepage: https://github.com/fixrb/matchi
 licenses:
 - MIT