matchi 2.4.0 → 3.0.0

data/lib/matchi/matcher/change/by_at_least.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require_relative File.join("..", "base")
-
-module Matchi
-  module Matcher
-    class Change
-      # *Change by at least* matcher.
-      class ByAtLeast < ::Matchi::Matcher::Base
-        # Returns a symbol identifying the matcher.
-        def self.to_sym
-          :change
-        end
-
-        # Initialize the matcher with an object.
-        #
-        # @example The change by at least 1 matcher.
-        #   object = []
-        #   Matchi::Matcher::Change::ByAtLeast.new(1) { object.length }
-        #
-        # @param expected [#object_id]  An expected delta.
-        # @param state    [Proc]        A block of code to execute to get the
-        #   state of the object.
-        def initialize(expected, &state)
-          super()
-          @expected = expected
-          @state    = state
-        end
-
-        # Boolean comparison on the expected change by comparing the value
-        # before and after the code execution.
-        #
-        # @example
-        #   object = []
-        #   change = Matchi::Matcher::Change::ByAtLeast.new(1) { object.length }
-        #   change.matches? { object << "foo" } # => true
-        #
-        # @yieldreturn [#object_id] The block of code to execute.
-        #
-        # @return [Boolean] Comparison between the value before and after the
-        #   code execution.
-        def matches?(*, **)
-          value_before = @state.call
-          yield
-          value_after = @state.call
-
-          expected <= (value_after - value_before)
-        end
-
-        # (see Base#to_s)
-        def to_s
-          "change by at least #{expected.inspect}"
-        end
-      end
-    end
-  end
-end

data/lib/matchi/matcher/change/by_at_most.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require_relative File.join("..", "base")
-
-module Matchi
-  module Matcher
-    class Change
-      # *Change by at most* matcher.
-      class ByAtMost < ::Matchi::Matcher::Base
-        # Returns a symbol identifying the matcher.
-        def self.to_sym
-          :change
-        end
-
-        # Initialize the matcher with an object.
-        #
-        # @example The change by at most 1 matcher.
-        #   object = []
-        #   Matchi::Matcher::Change::ByAtMost.new(1) { object.length }
-        #
-        # @param expected [#object_id]  An expected delta.
-        # @param state    [Proc]        A block of code to execute to get the
-        #   state of the object.
-        def initialize(expected, &state)
-          super()
-          @expected = expected
-          @state    = state
-        end
-
-        # Boolean comparison on the expected change by comparing the value
-        # before and after the code execution.
-        #
-        # @example
-        #   object = []
-        #   change = Matchi::Matcher::Change::ByAtMost.new(1) { object.length }
-        #   change.matches? { object << "foo" } # => true
-        #
-        # @yieldreturn [#object_id] The block of code to execute.
-        #
-        # @return [Boolean] Comparison between the value before and after the
-        #   code execution.
-        def matches?(*, **)
-          value_before = @state.call
-          yield
-          value_after = @state.call
-
-          expected >= (value_after - value_before)
-        end
-
-        # (see Base#to_s)
-        def to_s
-          "change by at most #{expected.inspect}"
-        end
-      end
-    end
-  end
-end

data/lib/matchi/matcher/change/from.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require_relative File.join("from", "to")
-
-module Matchi
-  module Matcher
-    class Change
-      # *Change from to* wrapper.
-      class From
-        # Initialize the matcher with an object.
-        #
-        # @example The change from "foo" to "FOO" matcher.
-        #   object = "foo"
-        #   Matchi::Matcher::Change::From.new("foo").to("FOO") { object.to_s }
-        #
-        # @param expected [#object_id]  An expected initial value.
-        # @param state    [Proc]        A block of code to execute to get the
-        #   state of the object.
-        def initialize(expected, &state)
-          @expected = expected
-          @state    = state
-        end
-
-        # Specifies the new value to expect.
-        #
-        # @param expected_new_value [#object_id] The new value to expect.
-        #
-        # @return [#matches?] A *change from to* matcher.
-        def to(expected_new_value)
-          To.new(@expected, expected_new_value, &@state)
-        end
-      end
-    end
-  end
-end

data/lib/matchi/matcher/change/from/to.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-require_relative File.join("..", "..", "base")
-
-module Matchi
-  module Matcher
-    class Change
-      class From
-        # *Change from to* matcher.
-        class To < ::Matchi::Matcher::Base
-          # Returns a symbol identifying the matcher.
-          def self.to_sym
-            :change
-          end
-
-          # Initialize the matcher with an object.
-          #
-          # @example The change from "foo" to "FOO" matcher.
-          #   object = "foo"
-          #   Matchi::Matcher::Change::From::To.new("foo", "FOO") { object.to_s }
-          #
-          # @param expected_init      [#object_id] An expected initial value.
-          # @param expected_new_value [#object_id] An expected new value.
-          # @param state              [Proc]       A block of code to execute to
-          #   get the state of the object.
-          def initialize(expected_init, expected_new_value, &state)
-            super()
-            @expected_init  = expected_init
-            @expected       = expected_new_value
-            @state          = state
-          end
-
-          # (see Base#inspect)
-          def inspect
-            "Matchi::Matcher::Change::From(#{@expected_init.inspect})::To(#{expected.inspect})"
-          end
-
-          # Boolean comparison on the expected change by comparing the value
-          # before and after the code execution.
-          #
-          # @example
-          #   object = "foo"
-          #   change = Matchi::Matcher::Change::To.new("FOO") { object.to_s }
-          #   change.matches? { object.upcase! } # => true
-          #
-          # @yieldreturn [#object_id] The block of code to execute.
-          #
-          # @return [Boolean] Comparison between the value before and after the
-          #   code execution.
-          def matches?(*, **)
-            value_before = @state.call
-            return false unless @expected_init == value_before
-
-            yield
-            value_after = @state.call
-
-            expected == value_after
-          end
-
-          # (see Base#to_s)
-          def to_s
-            "change from #{@expected_init.inspect} to #{expected.inspect}"
-          end
-        end
-      end
-    end
-  end
-end

data/lib/matchi/matcher/change/to.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-require_relative File.join("..", "base")
-
-module Matchi
-  module Matcher
-    class Change
-      # *Change to* matcher.
-      class To < ::Matchi::Matcher::Base
-        # Returns a symbol identifying the matcher.
-        def self.to_sym
-          :change
-        end
-
-        # Initialize the matcher with an object.
-        #
-        # @example The change to "FOO" matcher.
-        #   object = "foo"
-        #   Matchi::Matcher::Change::To.new("FOO") { object.to_s }
-        #
-        # @param expected [#object_id]  An expected result value.
-        # @param state    [Proc]        A block of code to execute to get the
-        #   state of the object.
-        def initialize(expected, &state)
-          super()
-          @expected = expected
-          @state    = state
-        end
-
-        # Boolean comparison on the expected change by comparing the value
-        # before and after the code execution.
-        #
-        # @example
-        #   object = "foo"
-        #   change = Matchi::Matcher::Change::To.new("FOO") { object.to_s }
-        #   change.matches? { object.upcase! } # => true
-        #
-        # @yieldreturn [#object_id] The block of code to execute.
-        #
-        # @return [Boolean] Comparison between the value before and after the
-        #   code execution.
-        def matches?(*, **)
-          yield
-          value_after = @state.call
-
-          expected == value_after
-        end
-
-        # (see Base#to_s)
-        def to_s
-          "change to #{expected.inspect}"
-        end
-      end
-    end
-  end
-end

data/lib/matchi/matcher/eql.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Matchi
-  module Matcher
-    # *Equivalence* matcher.
-    class Eql < ::Matchi::Matcher::Base
-      # Initialize the matcher with an object.
-      #
-      # @example The string "foo" matcher.
-      #   Matchi::Matcher::Eql.new("foo")
-      #
-      # @param expected [#eql?] An expected equivalent object.
-      def initialize(expected)
-        super()
-        @expected = expected
-      end
-
-      # Boolean comparison between the actual value and the expected value.
-      #
-      # @example Is it equivalent to "foo"?
-      #   eql = Matchi::Matcher::Eql.new("foo")
-      #   eql.matches? { "foo" } # => true
-      #
-      # @yieldreturn [#object_id] The actual value to compare to the expected
-      #   one.
-      #
-      # @return [Boolean] Comparison between actual and expected values.
-      def matches?(*, **)
-        expected.eql?(yield)
-      end
-    end
-  end
-end

data/lib/matchi/matcher/equal.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Matchi
-  module Matcher
-    # *Identity* matcher.
-    class Equal < ::Matchi::Matcher::Base
-      # Initialize the matcher with an object.
-      #
-      # @example The number 42 matcher.
-      #   Matchi::Matcher::Equal.new(42)
-      #
-      # @param expected [#equal?] An expected object.
-      def initialize(expected)
-        super()
-        @expected = expected
-      end
-
-      # Boolean comparison between the actual value and the expected value.
-      #
-      # @example Is it equal to :foo?
-      #   equal = Matchi::Matcher::Equal.new(:foo)
-      #   equal.matches? { :foo } # => true
-      #
-      # @yieldreturn [#object_id] The actual value to compare to the expected
-      #   one.
-      #
-      # @return [Boolean] Comparison between actual and expected values.
-      def matches?(*, **)
-        expected.equal?(yield)
-      end
-    end
-  end
-end

data/lib/matchi/matcher/match.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Matchi
-  module Matcher
-    # *Regular expressions* matcher.
-    class Match < ::Matchi::Matcher::Base
-      # Initialize the matcher with an instance of Regexp.
-      #
-      # @example Username matcher.
-      #   Matchi::Matcher::Match.new(/^[a-z0-9_-]{3,16}$/)
-      #
-      # @param expected [#match] A regular expression.
-      def initialize(expected)
-        super()
-        @expected = expected
-      end
-
-      # Boolean comparison between the actual value and the expected value.
-      #
-      # @example Is it matching /^foo$/ regex?
-      #   match = Matchi::Matcher::Match.new(/^foo$/)
-      #   match.matches? { "foo" } # => true
-      #
-      # @yieldreturn [#object_id] The actual value to compare to the expected
-      #   one.
-      #
-      # @return [Boolean] Comparison between actual and expected values.
-      def matches?(*, **)
-        expected.match?(yield)
-      end
-    end
-  end
-end

data/lib/matchi/matcher/raise_exception.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Matchi
-  module Matcher
-    # *Expecting errors* matcher.
-    class RaiseException < ::Matchi::Matcher::Base
-      # Initialize the matcher with a descendant of class Exception.
-      #
-      # @example Divided by 0 matcher.
-      #   Matchi::Matcher::RaiseException.new(ZeroDivisionError)
-      #
-      # @param expected [Exception] The class of the expected exception.
-      def initialize(expected)
-        super()
-        @expected = expected
-      end
-
-      # Boolean comparison between the actual value and the expected value.
-      #
-      # @example Is it raising NameError?
-      #   matcher = Matchi::Matcher::RaiseException.new(NameError)
-      #   matcher.matches? { Boom } # => true
-      #
-      # @yieldreturn [#object_id] The actual value to compare to the expected
-      #   one.
-      #
-      # @return [Boolean] Comparison between actual and expected values.
-      def matches?(*, **)
-        yield
-      rescue expected => _e
-        true
-      else
-        false
-      end
-    end
-  end
-end

data/lib/matchi/matcher/satisfy.rb

@@ -1,45 +0,0 @@
-# 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