constrain 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c76b91e6d73a1c5d2f7c44fc98f372f5b911c08e6a6d4203a3be646019aaa1a3
-  data.tar.gz: da85fb71b85da4e54913cb227a162c901ef3fe88c61d091e3489a63a3a97a9e5
+  metadata.gz: 2f6fc2db2a7997351f2df9185e2283863d53c53b806c2f888f0cba637530d62b
+  data.tar.gz: 96ecb2679c16da578365a499bdfe393dd4c9ff72e4121139b18b35d00102019f
 SHA512:
-  metadata.gz: 3db8dbbb8a0b2eb8d0c8de705b85533a630748f9e02c4e82f324c8f705d9f01d251b4d9b9866d977b71aaef4beb29f1834f1ff058728055ef545d77ece25a506
-  data.tar.gz: 52a2ec74e4709506d7be7813b48d5a7ece977dc7314d591db5830033f2e477cab39d2dc26129e7d0d27727f57966b0c0957faf5ba701ef9f6754ca16123f342a
+  metadata.gz: fdd94bbb07066064239fd7b137d06b7e43465b6c72b80dafc419d846956c11b23c87f2dab3c32fd3e0a27ea45aeafeb00c1bde712ffd61d33f0c53d90c700fdd
+  data.tar.gz: 8c4bce76f79ce7aa93743f7ea33b899ad19a17b3e590e1a2ec9204ec0cc51b33be3d756d070963e3f752326cc3021608b12023611b54c2b92c4f79e125e859a8

data/.ruby-version

@@ -1 +1 @@
-ruby-2.7.1
+ruby-3.1.2

data/README.md

@@ -47,16 +47,17 @@ have it available in all child classes
 
 ## Methods
 
-#### constrain(value, \*expressions, message = nil, unwind: 0)
+#### constrain(value, \*expressions, message: nil, unwind: 0)
 
 Return the given value if it matches at least one of the expressions and raise a
 Constrain::TypeError if not. The value is matched against the expressions using
 the #=== operator so anything you can put into the 'when' clause of a 'case'
 statement can be used. #constrain raise a Constrain::MatchError if the value
-doesn't match any expression 
+doesn't match any expression and an ArgumentError if there is a syntax error in
+the expression 
 
-The error message can be customized by added the message argument and a number
-of backtrace leves can be skipped by setting :unwind option. By default the
+The error message can be customized by adding the message option and a number
+of backtrace leves can be skipped using the :unwind option. By default the
 backtrace will refer to the point of the call of \#constrain. \#constrain
 raises a Constrain::Error exception if there is an error in the syntax of the
 class expression
@@ -65,9 +66,8 @@ class expression
 want an exception if the parameters doesn't match the expected, but because it
 returns the value if successful it can be used to check the validity of
 variables in expressions too, eg. `return constrain(result_of_complex_computation, Integer)` 
-to check the return value of a method
 
-#### Constrain.constrain(value, \*expressions, message = nil, unwind: 0)
+#### Constrain.constrain(value, \*expressions, message: nil, unwind: 0)
 
 Class method version of #constrain. It is automatically added to classes that
 include Constrain
@@ -77,8 +77,8 @@ include Constrain
 
 It matches value against the class expressions like #constrain but returns true
 or false as result. It is automatically added to classes that include
-Constrain. Constrain.constrain? raises a Constrain::Error exception if there
-is an error in the syntax of the class expression
+Constrain. Constrain.constrain? raises a ArgumentError exception if there
+is an error in the syntax of the expression
 
 
 ## Expressions

data/constrain.gemspec

@@ -27,7 +27,6 @@ Gem::Specification.new do |spec|
     Constrain works with ruby-2 (and maybe ruby-3)
   }
   spec.homepage      = "https://github.com/clrgit/constrain/"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
 

data/lib/constrain/version.rb

@@ -1,3 +1,3 @@
 module Constrain
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/constrain.rb

@@ -3,8 +3,8 @@ require "constrain/version"
 module Constrain
   # Raised if types doesn't match a class expression
   class MatchError < StandardError
-    def initialize(value, exprs, msg = nil, unwind: 0)
-      super msg || "Expected #{value.inspect} to match #{Constrain.fmt_exprs(exprs)}"
+    def initialize(value, exprs, message: nil, unwind: 0)
+      super message || "Expected #{value.inspect} to match #{Constrain.fmt_exprs(exprs)}"
     end
   end
 
@@ -28,7 +28,7 @@ module Constrain
   #   constrain(value, *values, unwind: 0)
   #
   # Check that value matches one of the class expressions. Raises a
-  # Constrain::ArgumentError if the expression is invalid and a Constrain::MatchError if
+  # 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)
@@ -36,14 +36,16 @@ module Constrain
   end
 
   # Return true if the value matches the class expression. Raises a
-  # Constrain::ArgumentError if the expression is invalid
+  # ArgumentError if the expression is invalid
   def self.constrain?(value, *exprs)
     do_constrain?(value, *exprs)
   end
 
   module ClassMethods
     # See Constrain.constrain
-    def constrain(*args) Constrain.do_constrain(*args) end
+    def constrain(*args) 
+
+    Constrain.do_constrain(*args) end
 
     # See Constrain.constrain?
     def constrain?(*args) Constrain.do_constrain?(*args) end
@@ -55,16 +57,17 @@ module Constrain
   def self.do_constrain(value, *exprs)
     if exprs.last.is_a?(Hash)
       unwind = (exprs.last.delete(:unwind) || 0) + 1
-      !exprs.last.empty? or exprs.pop
+      message = exprs.last.delete(:message)
+      !exprs.last.empty? or exprs.pop # Remove option hash if empty
     else
       unwind = 1
+      message = nil
     end
-    msg = exprs.pop if exprs.last.is_a?(String)
     
     begin
       !exprs.empty? or raise ArgumentError, "Empty constraint"
       exprs.any? { |expr| Constrain.do_constrain_value?(value, expr) } or 
-          raise MatchError.new(value, exprs, msg, unwind: unwind)
+          raise MatchError.new(value, exprs, message: message, unwind: unwind)
     rescue ArgumentError, Constrain::MatchError => ex
       ex.set_backtrace(caller[1 + unwind..-1])
       raise

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: constrain
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Claus Rasmussen
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-03 00:00:00.000000000 Z
+date: 2022-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simplecov
@@ -56,7 +56,7 @@ homepage: https://github.com/clrgit/constrain/
 licenses: []
 metadata:
   homepage_uri: https://github.com/clrgit/constrain/
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -64,15 +64,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.3.18
+signing_key:
 specification_version: 4
 summary: Dynamic in-file type checking
 test_files: []