constrain 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b497524127f01a38cc3c6f4061e91e0cad65b587538d57f69b194a550d46bf1
-  data.tar.gz: 95cff0709eb06ab088fee635c5629de99d16f521f9d24ea0a603ddb4d0968780
+  metadata.gz: ff3fb59b6d713b01843aa67e4e90855e58f99b1fcffa8ff27ae66b53987d9672
+  data.tar.gz: 98237076729ee99035e1af426308f12ef36963879950287f107486ae0485e061
 SHA512:
-  metadata.gz: f843d4f4b653ab255f52d9c5188b3d9d72c0170e0f4af4522404e4d993b97f6629b0b61c665a9cc47f3fc89a22ca7f7beb9efd68dfdae186c5d1502b320004d7
-  data.tar.gz: 70654e57d920e7f13a92394d57f7b5ddff2529ebe346507de201f47ce9aad77beef17992419dea84f1ba795b4de7d8443a65d3250b9a46298f8b1896d43dbeb4
+  metadata.gz: 533a2c7486903550fa42c3f349417130a8dd69642adf6d2e27599bd9f5e4b6be3fca0dcfcc58370cf4d64169952e06df5a0ad76603d424741f0c7846301f66ac
+  data.tar.gz: 95ee72d76e6ccfdd7faffd971214ecc6b171ab1a58debfd5a6a043a0764e8f154a910a7086399363a4bc88e94406a7a048f5efa32cadf5c1d8ded2e1725fcc37

data/lib/constrain/version.rb

@@ -1,3 +1,3 @@
 module Constrain
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

data/lib/constrain.rb

@@ -3,8 +3,12 @@ require "constrain/version"
 module Constrain
   # Raised if types doesn't match a class expression
   class MatchError < StandardError
-    def initialize(value, exprs, message: nil, unwind: 0)
-      super message || "Expected #{value.inspect} to match #{Constrain.fmt_exprs(exprs)}"
+    def initialize(value, exprs, message: nil, unwind: 0, not_argument: false, not_value: nil)
+      if not_argument
+        super message || "Expected #{value.inspect} to not equal #{not_value.inspect}"
+      else
+        super message || "Expected #{value.inspect} to match #{Constrain.fmt_exprs(exprs)}"
+      end
     end
   end
 
@@ -12,17 +16,6 @@ module Constrain
     base.extend ClassMethods
   end
 
-  # See Constrain.constrain
-  def constrain(value, *exprs)
-    Constrain.do_constrain(value, *exprs)
-  end
-
-  # Like #constrain but returns true/false to indicate the result instead of
-  # raising an exception
-  def constrain?(value, *exprs)
-    Constrain.do_constrain?(value, *exprs)
-  end
-
   # :call-seq:
   #   constrain(value, *class-expressions, unwind: 0)
   #   constrain(value, *values, unwind: 0)
@@ -31,38 +24,41 @@ module Constrain
   # ArgumentError if the expression is invalid and a Constrain::MatchError if
   # the value doesn't match. The exception's backtrace skips :unwind number of
   # entries
-  def self.constrain(value, *exprs)
-    do_constrain(value, *exprs)
+  def self.constrain(value, *exprs, **opts)
+    do_constrain(value, *exprs, **opts)
   end
 
-  # Return true if the value matches the class expression. Raises a
-  # ArgumentError if the expression is invalid
-  def self.constrain?(value, *exprs)
-    do_constrain?(value, *exprs)
+  # See Constrain.constrain
+  def constrain(...) = Constrain.do_constrain(...)
+
+  # Like #constrain but returns true/false to indicate the result instead of
+  # raising an exception
+  def self.constrain?(value, *exprs, **opts)
+    do_constrain?(value, *exprs, **opts)
   end
 
+  # See Constrain.constrain?
+  def constrain?(...) = Constrain.do_constrain?(...)
+
   module ClassMethods
     # See Constrain.constrain
-    def constrain(*args) 
-
-    Constrain.do_constrain(*args) end
+    def constrain(...) Constrain.do_constrain(...) end
 
     # See Constrain.constrain?
-    def constrain?(*args) Constrain.do_constrain?(*args) end
+    def constrain?(...) Constrain.do_constrain?(...) end
   end
 
+  # :call-seq:
+  #   do_constrain(value, *exprs, unwind: 0, message: nil, not: nil)
+  #
   # unwind is automatically incremented by one because ::do_constrain is always
   # called from one of the other constrain methods
   #
-  def self.do_constrain(value, *exprs)
-    if exprs.last.is_a?(Hash)
-      unwind = (exprs.last.delete(:unwind) || 0) + 1
-      message = exprs.last.delete(:message)
-      !exprs.last.empty? or exprs.pop # Remove option hash if empty
-    else
-      unwind = 1
-      message = nil
-    end
+  def self.do_constrain(value, *exprs, unwind: 0, message: nil, **opts)
+    opts.keys.empty? || opts.keys == [:not] or raise ArgumentError
+    unwind += 1
+    not_argument = opts.key?(:not)
+    not_value = opts[:not]
     
     begin
       if exprs.empty?
@@ -71,6 +67,10 @@ module Constrain
         exprs.any? { |expr| Constrain.do_constrain_value?(value, expr) } or 
             raise MatchError.new(value, exprs, message: message, unwind: unwind)
       end
+      !not_argument || value != not_value or 
+          raise MatchError.new(
+              value, exprs, message: message, unwind: unwind, not_argument: true, not_value: not_value)
+        
     rescue ArgumentError, Constrain::MatchError => ex
       ex.set_backtrace(caller[1 + unwind..-1])
       raise
@@ -78,11 +78,13 @@ module Constrain
     value
   end
 
-  def self.do_constrain?(value, *exprs)
+  def self.do_constrain?(...)
     begin
-      !exprs.empty? or raise ArgumentError, "Empty constraint"
-      exprs.any? { |expr| Constrain.do_constrain_value?(value, expr) }
+      do_constrain(...)
+    rescue MatchError
+      return false
     end
+    true
   end
 
   def self.do_constrain_value?(value, expr)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: constrain
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-09-17 00:00:00.000000000 Z
+date: 2023-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simplecov