eqq 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0645f6178f68b0a105efa1bcf389bd3c0b1f056cd94a6c6684b0d18bc9284f8
-  data.tar.gz: a93f3a7df8098fbb1e7bdb61b5ad36c29a67e4471e563c63bb562b7896cfa60d
+  metadata.gz: becfb749a93e73ea402265899e57d3deea45bf0eb457a29a66eafa03965b1572
+  data.tar.gz: 3f6578bd2f0b3334369834ff1f344b4b033318172586a9324496027a057507a0
 SHA512:
-  metadata.gz: a5d02720dfa28fc5aefed2907008e14e76dc00fd087eb83eb6c89bbf8c976b0258410d554592fc1368938bfcda8e96efc99ae2a811f285dfba33b210bf795ba5
-  data.tar.gz: e8077c6bd4ab3c5e363abeaa5154dca3bf8154140a73f75d238883cefe92855fb8da843ba46037c12ffb9bc710b9449b1d121a6e2119dc774520bd237f71d564
+  metadata.gz: 3d76a45da1f1e181d77b6f9cbfc6f80d88af6abed0782b1da92f6562934bf551c2f55e5691be7108d0acf0521562a042bb5cba6f54f9846af78b7ba4031d35fb
+  data.tar.gz: 2ec4137407dfaf6b4189255532e59669798ac9ed57be8e6ecdb07c31525d132b9246da9d9fd6b98975e31b712e002e2693f523acf285d172df1b13c7c46617d5

data/README.md

@@ -12,7 +12,7 @@ Require Ruby 2.6 or later
 Add below code into your Gemfile
 
 ```ruby
-gem 'eqq', '>= 0.0.6', '< 0.1.0'
+gem 'eqq', '>= 0.0.7', '< 0.1.0'
 ```
 
 ### Overview
@@ -24,7 +24,7 @@ require 'eqq'
 [42, nil, true, false, '', 0].grep(Eqq.BOOLEAN) #=> [true, false]
 [42, [], {}, 'string', Object.new, nil].grep(Eqq.CAN(:to_h)) #=> [[], {}, nil]
 
-pattern = Eqq.define do
+pattern = Eqq.build do
   OR(AND(Float, 20..50), Integer)
 end
 
@@ -107,6 +107,7 @@ Reuse as you wish!
 * SAME(object) - Product returns `true` when matched with `#equal?`
 * SEND(name, pattern) - Basically provided for Enumerable
 * BOOLEAN() - Product returns `true` when matched to `true` or `false`
+* NIL() - Product returns `true` when matched to `nil` (Not consider `nil?`)
 * ANYTHING() - Product returns `true`, always `true`
 * NEVER() - Product returns `false`, always `false`
 * XOR(pattern1, pattern2) - Product returns `true` when matched one of the pattern, when matched both returns `false`
@@ -137,7 +138,7 @@ end
 
 When you felt annoy to write `Eqq` in many place, some ways exist.
 
-* `Eqq.define(&block)` - In the block scope, all builder methods can be used without receiver
+* `Eqq.build(&block)` - In the block scope, all builder methods can be used without receiver
 * `extend Eqq::Buildable` - In the class/module, all builders can be used as class methods
 * `include Eqq::Buildable` - In the class/module, all builders can be used as instance methods
 

data/lib/eqq.rb

@@ -35,17 +35,24 @@ module Eqq
 
     # @api private
     def satisfy?(object)
-      (Proc === object) && object.lambda? && (object.arity == 1)
+      (Proc === object) && object.lambda? && (object.arity == 1) && object.respond_to?(:inspect)
     end
 
-    # @return [#===]
-    # @raise [InvalidProductError] if the return value is invalid as a pattern object
-    def define(&block)
+    # @return [Proc]
+    # @raise [InvalidProductError] if the return value is not looks to be built with builders
+    def build(&block)
+      raise ArgumentError, 'might be mis used the `Eqq.build` in your code' unless block
+
       pattern = DSLScope.new.instance_exec(&block)
-      raise InvalidProductError unless satisfy?(pattern)
+      raise InvalidProductError, 'might be mis used the `Eqq.build` in your code' unless satisfy?(pattern)
 
       pattern
     end
+
+    # @deprecated Use {build} instead. This will be dropped since `0.1.0`
+    def define(&block)
+      build(&block)
+    end
   end
 end
 
@@ -57,5 +64,5 @@ module Eqq
   class DSLScope
     include Buildable
   end
-  private_constant :DSLScope
+  private_constant(:DSLScope)
 end

data/lib/eqq/buildable.rb

@@ -256,37 +256,46 @@ module Eqq
       product
     end
 
-    ANYTHING = ->_v { true }
-    define_inspect_on(ANYTHING, name: 'ANYTHING', arguments: [])
-    private_constant :ANYTHING
+    EQQ_BUILTIN_ANYTHING = ->_v { true }
+    define_inspect_on(EQQ_BUILTIN_ANYTHING, name: 'ANYTHING', arguments: [])
 
     # Product returns `true`, always `true`
     #
     # @return [Proc]
     def ANYTHING
-      ANYTHING
+      EQQ_BUILTIN_ANYTHING
     end
 
-    NEVER = ->_v { false }
-    define_inspect_on(NEVER, name: 'NEVER', arguments: [])
-    private_constant :NEVER
+    EQQ_BUILTIN_NEVER = ->_v { false }
+    define_inspect_on(EQQ_BUILTIN_NEVER, name: 'NEVER', arguments: [])
 
     # Product returns `false`, always `false`
     #
     # @return [Proc]
     def NEVER
-      NEVER
+      EQQ_BUILTIN_NEVER
     end
 
-    BOOLEAN = ->v { true.equal?(v) || false.equal?(v) }
-    define_inspect_on(BOOLEAN, name: 'BOOLEAN', arguments: [])
-    private_constant :BOOLEAN
+    EQQ_BUILTIN_BOOLEAN = ->v { true.equal?(v) || false.equal?(v) }
+    define_inspect_on(EQQ_BUILTIN_BOOLEAN, name: 'BOOLEAN', arguments: [])
 
     # Product returns `true` when matched to `true` or `false`
     #
     # @return [Proc]
     def BOOLEAN
-      BOOLEAN
+      EQQ_BUILTIN_BOOLEAN
     end
+
+    EQQ_BUILTIN_NIL = ->v { nil.equal?(v) }
+    define_inspect_on(EQQ_BUILTIN_NIL, name: 'NIL', arguments: [])
+
+    # Product returns `true` when matched to `nil` (Not consider `nil?`)
+    #
+    # @return [Proc]
+    def NIL
+      EQQ_BUILTIN_NIL
+    end
+
+    private_constant(:EQQ_BUILTIN_ANYTHING, :EQQ_BUILTIN_NEVER, :EQQ_BUILTIN_BOOLEAN, :EQQ_BUILTIN_NIL)
   end
 end

data/lib/eqq/version.rb

@@ -3,5 +3,5 @@
 
 module Eqq
   # This will be same as latest published gem version
-  VERSION = '0.0.6'
+  VERSION = '0.0.7'
 end

data/sig/eqq.rbs

@@ -17,13 +17,16 @@ module Eqq
     type product = patternable_lambda & _Inspectable
 
     # A private constant. Should not be used in your code.
-    ANYTHING: product
+    EQQ_BUILTIN_ANYTHING: product
 
     # A private constant. Should not be used in your code.
-    NEVER: product
+    EQQ_BUILTIN_NEVER: product
 
     # A private constant. Should not be used in your code.
-    BOOLEAN: product
+    EQQ_BUILTIN_BOOLEAN: product
+
+    # A private constant. Should not be used in your code.
+    EQQ_BUILTIN_NIL: product
 
     # A private API. Should not be used in your code.
     def self.safe_inspect_for: (untyped object)-> String
@@ -78,6 +81,9 @@ module Eqq
 
     # Product returns `true` when matched to `true` or `false`
     def BOOLEAN: () -> product
+
+    # Product returns `true` when matched to `nil` (Not consider `nil?`)
+    def NIL: () -> product
   end
 
   extend Buildable
@@ -108,5 +114,8 @@ module Eqq
   def self.satisfy?: (untyped object) -> bool
 
   # In the block scope, all builder methods can be used without receiver
+  def self.build:  { () -> _Patternable } -> _Patternable
+
+  # Alias of `build`. But deperecated. Do not use in your code anymore.
   def self.define:  { () -> _Patternable } -> _Patternable
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eqq
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Kenichi Kamiya