matchi 1.0.6 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cd50716f5824ade60354692ac37487dbd8e27472fb7fde7d4aab4d1ce95b9ca
-  data.tar.gz: bd1c131caf2e3812e34e1265a75b5cf2d274168646739b65116b3ba90516ee7a
+  metadata.gz: fbd646c1f880291334b1f98426cfdedab736a2f87bbb44e149e81bcb5f8affce
+  data.tar.gz: 9e285052b96848df8be1c22c2033032d2dcbe143ac4d84fa26e9e61b42ac8ee4
 SHA512:
-  metadata.gz: ba8f7453990d61caa22ece7510a78a9183d5a92da5fcc7661f6b61f8369c69b3a8cd597ec91bc367159808b6099d6c5644adba4c0ab510b31d213457b308bc60
-  data.tar.gz: a0175c66fa876e7819034586a0d9491300733015aeb405587a875f7829407d75d8d6bc0cab1cb00e7f9c1c9a66bc4d818897f75c439d573b5ce0c50fa7ef8076
+  metadata.gz: d81a615fca3627cf424226c015e63ab09419be15059b83e926afa3d99819153ced25afca5adfe1421d85bbffcaf4048f2c36531b14b6a9f4920a1f7edf9efd61
+  data.tar.gz: e80cd7a69eef70a3ca0fc80bb4bf94468c14de22a9309d4bf736ea050e5feeeadf69216eadddc6e4ee678c08ccf64949729a3ef830ed9e1b4b3ca3d5ba23d0f7

data/LICENSE.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2019 Cyril Kato
+Copyright (c) 2015-2021 Cyril Kato
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,30 +1,19 @@
 # Matchi
 
-[![Build Status](https://api.travis-ci.org/fixrb/matchi.svg?branch=master)][travis]
+[![Build Status](https://api.travis-ci.org/fixrb/matchi.svg?branch=main)][travis]
 [![Code Climate](https://codeclimate.com/github/fixrb/matchi/badges/gpa.svg)][codeclimate]
 [![Gem Version](https://badge.fury.io/rb/matchi.svg)][gem]
-[![Inline docs](https://inch-ci.org/github/fixrb/matchi.svg?branch=master)][inchpages]
+[![Inline docs](https://inch-ci.org/github/fixrb/matchi.svg?branch=main)][inchpages]
 [![Documentation](https://img.shields.io/:yard-docs-38c800.svg)][rubydoc]
 
-> Collection of expectation matchers for Ruby.
-
-## Contact
-
-* Home page: https://github.com/fixrb/matchi
-* Bugs/issues: https://github.com/fixrb/matchi/issues
-
-## Rubies
-
-* [MRI](https://www.ruby-lang.org/)
-* [Rubinius](https://rubinius.com/)
-* [JRuby](https://www.jruby.org/)
+> Collection of expectation matchers for Ruby 🤹
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'matchi'
+gem "matchi"
 ```
 
 And then execute:
@@ -42,49 +31,49 @@ Or install it yourself as:
 **Equivalence** matcher:
 
 ```ruby
-eql = Matchi::Matchers::Eql::Matcher.new('foo')
-eql.matches? { 'foo' } # => true
+eql = Matchi::Matcher::Eql.new("foo")
+eql.matches? { "foo" } # => true
 ```
 
 **Identity** matcher:
 
 ```ruby
-equal = Matchi::Matchers::Equal::Matcher.new(:foo)
+equal = Matchi::Matcher::Equal.new(:foo)
 equal.matches? { :foo } # => true
 ```
 
 **Regular expressions** matcher:
 
 ```ruby
-match = Matchi::Matchers::Match::Matcher.new(/^foo$/)
-match.matches? { 'foo' } # => true
+match = Matchi::Matcher::Match.new(/^foo$/)
+match.matches? { "foo" } # => true
 ```
 
 **Expecting errors** matcher:
 
 ```ruby
-raise_exception = Matchi::Matchers::RaiseException::Matcher.new(NameError)
+raise_exception = Matchi::Matcher::RaiseException.new(NameError)
 raise_exception.matches? { Boom } # => true
 ```
 
 **Truth** matcher:
 
 ```ruby
-be_true = Matchi::Matchers::BeTrue::Matcher.new
+be_true = Matchi::Matcher::BeTrue.new
 be_true.matches? { true } # => true
 ```
 
 **Untruth** matcher:
 
 ```ruby
-be_false = Matchi::Matchers::BeFalse::Matcher.new
+be_false = Matchi::Matcher::BeFalse.new
 be_false.matches? { false } # => true
 ```
 
 **Nil** matcher:
 
 ```ruby
-be_nil = Matchi::Matchers::BeNil::Matcher.new
+be_nil = Matchi::Matcher::BeNil.new
 be_nil.matches? { nil } # => true
 ```
 
@@ -96,55 +85,35 @@ A **Be the answer** matcher:
 
 ```ruby
 module Matchi
-  module Matchers
-    module BeTheAnswer
-      class Matcher
-        def matches?
-          42.equal? yield
-        end
-
-        def to_s
-          'be_the_answer'
-        end
-
-        def to_h
-          { BeTheAnswer: [] }
-        end
+  module Matcher
+    class BeTheAnswer < ::Matchi::Matcher::Base
+      def matches?
+        42.equal?(yield)
       end
     end
   end
 end
 
-be_the_answer = Matchi::Matchers::BeTheAnswer::Matcher.new
+be_the_answer = Matchi::Matcher::BeTheAnswer.new
 be_the_answer.matches? { 42 } # => true
 ```
 
 A **Be prime** matcher:
 
 ```ruby
-require 'prime'
+require "prime"
 
 module Matchi
-  module Matchers
-    module BePrime
-      class Matcher
-        def matches?
-          Prime.prime? yield
-        end
-
-        def to_s
-          'be_prime'
-        end
-
-        def to_h
-          { BePrime: [] }
-        end
+  module Matcher
+    class BePrime < ::Matchi::Matcher::Base
+      def matches?
+        Prime.prime?(yield)
       end
     end
   end
 end
 
-be_prime = Matchi::Matchers::BePrime::Matcher.new
+be_prime = Matchi::Matcher::BePrime.new
 be_prime.matches? { 42 } # => false
 ```
 
@@ -152,70 +121,48 @@ A **Start with** matcher:
 
 ```ruby
 module Matchi
-  module Matchers
-    module StartWith
-      class Matcher
-        def initialize(expected)
-          @expected = expected
-        end
-
-        def matches?
-          !Regexp.new("^#{@expected}").match(yield).nil?
-        end
-
-        def to_s
-          'start_with'
-        end
-
-        def to_h
-          { StartWith: [@expected] }
-        end
+  module Matcher
+    class StartWith < ::Matchi::Matcher::Base
+      def initialize(expected)
+        super()
+        @expected = expected
+      end
+
+      def matches?
+        Regexp.new(/\A#{expected}/).match?(yield)
       end
     end
   end
 end
 
-start_with = Matchi::Matchers::StartWith::Matcher.new('foo')
-start_with.matches? { 'foobar' } # => true
+start_with = Matchi::Matcher::StartWith.new("foo")
+start_with.matches? { "foobar" } # => true
 ```
 
-## Security
-
-As a basic form of security __Matchi__ provides a set of SHA512 checksums for
-every Gem release.  These checksums can be found in the `checksum/` directory.
-Although these checksums do not prevent malicious users from tampering with a
-built Gem they can be used for basic integrity verification purposes.
-
-The checksum of a file can be checked using the `sha512sum` command.  For
-example:
+## Contact
 
-    $ sha512sum pkg/matchi-0.0.1.gem
-    548d9f669ded4e622182791a5390aaceae0bf2e557b0864f05a842b0be2c65e10e1fb8499f49a3b9efd0e8eaeb691351b1c670d6316ce49965a99683b1071389  pkg/matchi-0.0.1.gem
+* Home page: https://github.com/fixrb/matchi
+* Bugs/issues: https://github.com/fixrb/matchi/issues
 
 ## Versioning
 
 __Matchi__ follows [Semantic Versioning 2.0](https://semver.org/).
 
-## Contributing
+## License
 
-1. [Fork it](https://github.com/fixrb/matchi/fork)
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+The [gem](https://rubygems.org/gems/matchi) is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-## License
+***
 
-See `LICENSE.md` file.
+<p>
+  This project is sponsored by:<br />
+  <a href="https://sashite.com/"><img
+    src="https://github.com/fixrb/matchi/raw/main/img/sashite.png"
+    alt="Sashite" /></a>
+</p>
 
 [gem]: https://rubygems.org/gems/matchi
 [travis]: https://travis-ci.org/fixrb/matchi
 [codeclimate]: https://codeclimate.com/github/fixrb/matchi
 [inchpages]: https://inch-ci.org/github/fixrb/matchi
 [rubydoc]: https://rubydoc.info/gems/matchi/frames
-
-***
-
-This project is sponsored by:
-
-[![Sashite](https://pbs.twimg.com/profile_images/618485028322975744/PZ9qPuI__400x400.png)](https://sashite.com/)

data/lib/matchi.rb

@@ -4,4 +4,4 @@
 module Matchi
 end
 
-require_relative File.join('matchi', 'matchers')
+require_relative File.join("matchi", "matcher")

data/lib/matchi/helper.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "matcher"
+
+module Matchi
+  # Collection of helper methods.
+  module Helper
+    ::Matchi::Matcher.constants.each do |matcher_const|
+      next if matcher_const.equal?(:Base)
+
+      matcher_klass = ::Matchi::Matcher.const_get(matcher_const)
+
+      # Define a method for the given matcher.
+      #
+      # @example Given the `Matchi::Matchers::Equal::Matcher` matcher, its
+      #   method would be:
+      #
+      #   def equal(expected)
+      #     Matchi::Matchers::Equal::Matcher.new(expected)
+      #   end
+      #
+      # @return [#matches?] The matcher.
+      define_method(matcher_klass.to_sym) do |*args|
+        matcher_klass.new(*args)
+      end
+    end
+  end
+end

data/lib/matchi/matcher.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Matchi
+  # Collection of matcher classes.
+  module Matcher
+  end
+end
+
+Dir[File.join(File.dirname(__FILE__), "matcher", "*.rb")].each do |fname|
+  require_relative fname
+end

data/lib/matchi/matcher/base.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Matchi
+  module Matcher
+    # Abstract matcher class.
+    class Base
+      # @return [Symbol] A symbol identifying the matcher.
+      def self.to_sym
+        name.delete_prefix("Matchi::Matcher::")
+            .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+            .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+            .downcase
+            .to_sym
+      end
+
+      # @return [#object_id] Any value to give to the matcher.
+      attr_reader :expected
+
+      # A string containing a human-readable representation of the matcher.
+      #
+      # @return [String] The human-readable representation of the matcher.
+      def inspect
+        "#{self.class}(#{expected&.inspect})"
+      end
+
+      # Abstract matcher class.
+      #
+      # @raise [NotImplementedError] Override me inside a matcher.
+      def matches?
+        raise ::NotImplementedError, "matcher MUST respond to this method."
+      end
+
+      # Returns a string representing the matcher.
+      #
+      # @example The readable definition of a FooBar matcher.
+      #   matcher = Matchi::Matcher::FooBar.new(42)
+      #   matcher.to_s # => "foo_bar 42"
+      #
+      # @return [String] A string representing the matcher.
+      def to_s
+        [self.class.to_sym, expected&.inspect].compact.join(" ")
+      end
+    end
+  end
+end

data/lib/matchi/matcher/be_false.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Matchi
+  module Matcher
+    # **Untruth** matcher.
+    class BeFalse < ::Matchi::Matcher::Base
+      # Boolean comparison between the actual value and the expected value.
+      #
+      # @example Is it false?
+      #   be_false = Matchi::Matcher::BeFalse.new
+      #   be_false.matches? { false } # => true
+      #
+      # @yieldreturn [#object_id] The actual value to compare to the expected
+      #   one.
+      #
+      # @return [Boolean] Comparison between actual and expected values.
+      def matches?(*, **)
+        false.equal?(yield)
+      end
+    end
+  end
+end

data/lib/matchi/matcher/be_nil.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Matchi
+  module Matcher
+    # **Nil** matcher.
+    class BeNil < ::Matchi::Matcher::Base
+      # Boolean comparison between the actual value and the expected value.
+      #
+      # @example Is it nil?
+      #   be_nil = Matchi::Matcher::BeNil.new
+      #   be_nil.matches? { nil } # => true
+      #
+      # @yieldreturn [#object_id] The actual value to compare to the expected
+      #   one.
+      #
+      # @return [Boolean] Comparison between actual and expected values.
+      def matches?(*, **)
+        nil.equal?(yield)
+      end
+    end
+  end
+end

data/lib/matchi/matcher/be_true.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Matchi
+  module Matcher
+    # **Truth** matcher.
+    class BeTrue < ::Matchi::Matcher::Base
+      # Boolean comparison between the actual value and the expected value.
+      #
+      # @example Is it true?
+      #   be_true = Matchi::Matcher::BeTrue.new
+      #   be_true.matches? { true } # => true
+      #
+      # @yieldreturn [#object_id] The actual value to compare to the expected
+      #   one.
+      #
+      # @return [Boolean] Comparison between actual and expected values.
+      def matches?(*, **)
+        true.equal?(yield)
+      end
+    end
+  end
+end