rspec-matcher 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2692798d25d46df0b76f619de32069e12838fc2d
-  data.tar.gz: 67d773c64e7ad7b9d52c6f66d99278764886908e
+  metadata.gz: c7d9326b4509b1a13c2eeaa608dacc8af2129505
+  data.tar.gz: 66740b04f4576b8f1a042635e6b83ff34d20238c
 SHA512:
-  metadata.gz: d007950a729f60b3af87dac44b2adfe43167b6acc90039d3265d5dab8716a32e9b00305173302d4a59c96a349a8cb5337d56bd4adb4695b820062ce7d21b6524
-  data.tar.gz: 34a27ebf1ef52db458c50665bc650a6f89a235a7b9624fd8458afda197fa3f24a13ac85139f6b687a5b3629ee378fd5471b918bcb2d05d087f3c718cfd194242
+  metadata.gz: 972bf6776f9cedb65749f0a635e75237d855a28179f1337c02cb84c602d211c992e0f2ef68307ae375ebe4e54d0308329807073de2fb189725fb6295cffe72d8
+  data.tar.gz: d87f887352ca0badf3d903331a541ae0bd0b59516c2a84c3c6818119460e242ae8bead6852349ea9f87a93b8f8d09fe9f97ce090541eeb1b31194b66b460f2ef

data/.yardopts

@@ -1 +1,3 @@
 --markup markdown
+--private
+--protected

data/README.md

@@ -55,7 +55,7 @@ Add the following to your Gemfile:
     gem "rspec-matcher"
 
 # Usage
-[API Reference](http://www.rubydoc.info/gems/rspec-matcher/0.1.1/RSpec/Matcher)
+[API Reference](http://www.rubydoc.info/gems/rspec-matcher/RSpec/Matcher)
 
     class BeNilMatcher
       include RSpec::Matcher

data/lib/rspec/matcher.rb

@@ -1,6 +1,7 @@
 require "rspec/matcher/identity"
 require "active_support/concern"
 
+# Does not monkey patch but is inside RSpec namespace.
 module RSpec
   # Provides minimal interface for creating RSpec Matchers.
   #
@@ -44,36 +45,45 @@ module RSpec
     # @api private
     # Used to let user define initialize
     module PrependedMethods #:nodoc:
-      # Stores expected and passes all args to super
+      # Stores expected and options then passes remaining args to super
       # @api private
       # @param [any] expected stored as expected and not passed to custom initializer
+      # @param [Hash] options stored by calling setter methods
       # @param [any] args... passed to custom initializer
       # @param [Proc] block passed to custom initializer
-      def initialize expected = UNDEFINED, *args, &block
+      def initialize expected = UNDEFINED, options = {}, *args, &block
         self.expected = expected
+        options.to_a.each do |option|
+          key, value = option
+          send("#{key}=", value)
+        end
         super(*args, &block)
       end
     end
 
     # Methods added as class method to includer
     module ClassMethods
-      # Registers this matcher in RSpec.
+      # Registers this matcher in RSpec. Optionally sets options via setter
+      # methods on initialize.
       # @example
       #   class BeNil
       #     include RSpec::Matcher
       #     register_as "be_nil"
+      #     register_as "be_empty", empty: true
       #     #...
       #   end
       #
-      #   expect(actual).to be_nil
+      #   expect(nil).to be_nil
+      #   expect([]).to be_empty
       #
+      # @note self.empty = true is called on initialize
       # @param [String] name what to register this matcher as
       # @return [void]
-      def register_as name
+      def register_as name, options = {}
         s = self
         m = Module.new do
-          define_method name do |*args, &block|
-            s.new(*args, &block)
+          define_method name do |expected = UNDEFINED, *args, &block|
+            s.new(expected, options, *args, &block)
           end
         end
 
@@ -87,9 +97,14 @@ module RSpec
     # Hides RSpec internal api
     def matches? actual
       self.actual = actual
-      return match if method(:match).arity == 0
 
-      match actual
+      catch(:resolution) do
+        if method(:match).arity == 0
+          match
+        else
+          match actual
+        end
+      end
     end
 
     # @method actual
@@ -113,9 +128,10 @@ module RSpec
       raise "not implemented"
     end
 
-    # Describes what this matcher does for composable matchers.
+    # Describes what this matcher does.
     # @example be an string with X length
     # @example match X regex
+    # @note for composable matchers
     # @note raises by default
     # @return [String]
     def description
@@ -154,5 +170,23 @@ module RSpec
     def supports_block_expectations?
       false
     end
+
+    private
+
+    # @api public
+    # Stops evaluation and tells RSpec there was a match.
+    # @throw :resolution
+    # @return [void]
+    def resolve_expectation
+      throw :resolution, true
+    end
+
+    # @api public
+    # Stops evaluation and tells RSpec there wasn't a match.
+    # @throw :resolution
+    # @return [void]
+    def reject_expectation
+      throw :resolution, false
+    end
   end
 end

data/lib/rspec/matcher/identity.rb

@@ -12,7 +12,7 @@ module RSpec
       end
 
       def self.version
-        "0.1.1"
+        "0.1.2"
       end
 
       def self.version_label

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-matcher
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Pooyan Khosravi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-07 00:00:00.000000000 Z
+date: 2016-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport