kind 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db734da8b7d777098f049983dce40d7a0f36d6a6d9c61ade223275c5d023c22e
-  data.tar.gz: 0e1dea80ac9fdebdf2af1e0a6becd1aa970294906e5f5f8cd7c8836a9c4dc5f5
+  metadata.gz: 381c55689c9c4b8077f859e76370db5f7c5f17efabdb83fb2902a2e33d602c42
+  data.tar.gz: de00093039551f1b6020a9d3a6cac31890f8fa7edfa1af620d4e9b3af1264749
 SHA512:
-  metadata.gz: 96346a48789ccc9fcd7a0308eca390753bc3b8e397a048c7bb049929252214c7ba6d100ae17fb14a1e98595817120aa8c4900d57a4638bc8ee9494eb8682b259
-  data.tar.gz: 07410f5ec41a04cfaaaf660f1ad933e238efb1b2845b7e11c2ba69602c31bd69517ece4d3056c1e62b4c89faa04824344cdd8634ba593470c48b227bc7a9e8c8
+  metadata.gz: cc6b4078e770ab68a50b7435f6b9a174dbe555b47ba64e0cf1e523e3b3bd1a1e936aa7368251a7b9be7b9203a48d6ab37d415d908c2cfcca49311a9cf0d425a7
+  data.tar.gz: b3d64254b98c33836bc903132fb4ba7dd75fd501fb6ad9bc14f1d4ab3a92e45d95dc4c81ea7f91559d2e43f110c9c7ad7650394d0bed7a585d04d70b876685df

data/README.md

@@ -1,3 +1,4 @@
+![Ruby](https://img.shields.io/badge/ruby-2.2+-ruby.svg?colorA=99004d&colorB=cc0066)
 [![Gem](https://img.shields.io/gem/v/kind.svg?style=flat-square)](https://rubygems.org/gems/kind)
 [![Build Status](https://travis-ci.com/serradura/kind.svg?branch=master)](https://travis-ci.com/serradura/kind)
 
@@ -12,6 +13,7 @@ As a creator of Ruby gems, I have a common need that I have to handle in many of
 One of the goals of this project is to do simple type checking like `"some string".is_a?(String)`, but using a bunch of basic abstractions. So, after reading this README and realizing that you need something more robust, I recommend to you check out the [dry-types gem](https://dry-rb.org/gems/dry-types).
 
 ## Table of Contents <!-- omit in toc -->
+- [Required Ruby version](#required-ruby-version)
 - [Installation](#installation)
 - [Usage](#usage)
   - [Verifying the kind of some object](#verifying-the-kind-of-some-object)
@@ -26,6 +28,9 @@ One of the goals of this project is to do simple type checking like `"some strin
 - [License](#license)
 - [Code of Conduct](#code-of-conduct)
 
+## Required Ruby version
+> \>= 2.2.0
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -48,7 +53,7 @@ Or install it yourself as:
 
 ### Verifying the kind of some object
 
-By default, basic type verification is strict. So, when you perform `Kind.of.Hash(value)`, if the given value was a Hash it will be returned, but if it wasn't one, an error will be raised.
+By default, basic verifications are strict. So, when you perform `Kind.of.Hash(value)`, if the given value was a Hash, the value itself will be returned, but if it isn't the right type, an error will be raised.
 
 ```ruby
 Kind.of.Hash('')
@@ -66,6 +71,20 @@ Kind.of.Boolean(true)  # true
 Kind.of.Boolean(false) # false
 ```
 
+When the verified value is nil, it is possible to define a default value with the same type to be returned.
+
+```ruby
+value = nil
+
+Kind.of.Hash(value, or: {})
+# {}
+
+# ---
+
+Kind.of.Boolean(nil, or: true)
+# true
+```
+
 As an alternative syntax, you can use the `Kind::Of` instead of the method. e.g: `Kind::Of::Hash('')`
 
 But if you don't need a strict type verification, use the `.or_nil`method

data/lib/kind.rb

@@ -86,10 +86,12 @@ module Kind
     extend self
 
     KIND_OF = <<-RUBY
-      def self.%{name}(object = nil)
-        return Kind::Of::%{name} if object.nil?
+      def self.%{name}(object = nil, options = {})
+        default = options[:or]
 
-        Kind::Of.call(::%{name}, object)
+        return Kind::Of::%{name} if object.nil? && default.nil?
+
+        Kind::Of.call(::%{name}, object || default)
       end
     RUBY
 
@@ -143,12 +145,16 @@ module Kind
   module Of
     # -- Boolean
 
-    def self.Boolean(object = nil)
-      return Kind::Of::Boolean if object.nil?
+    def self.Boolean(object = nil, options = {})
+      default = options[:or]
+
+      return Kind::Of::Boolean if object.nil? && default.nil?
+
+      bool = object.nil? ? default : object
 
-      return object if object.is_a?(::TrueClass) || object.is_a?(::FalseClass)
+      return bool if bool.is_a?(::TrueClass) || bool.is_a?(::FalseClass)
 
-      raise Kind::Error.new('Boolean'.freeze, object)
+      raise Kind::Error.new('Boolean'.freeze, bool)
     end
 
     const_set(:Boolean, ::Class.new(Checker) do
@@ -163,17 +169,21 @@ module Kind
 
     # -- Lambda
 
-    def self.Lambda(object = nil)
-      return Kind::Of::Lambda if object.nil?
+    def self.Lambda(object = nil, options = {})
+      default = options[:or]
+
+      return Kind::Of::Lambda if object.nil? && default.nil?
+
+      func = object || default
 
-      return object if object.is_a?(::Proc) && object.lambda?
+      return func if func.is_a?(::Proc) && func.lambda?
 
-      raise Kind::Error.new('Lambda'.freeze, object)
+      raise Kind::Error.new('Lambda'.freeze, func)
     end
 
     const_set(:Lambda, ::Class.new(Checker) do
       def instance?(value)
-        value.is_a?(::Proc) && value.lambda?
+        value.is_a?(@type) && value.lambda?
       end
     end.new(::Proc).freeze)
   end

data/lib/kind/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kind
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kind
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-03 00:00:00.000000000 Z
+date: 2020-01-05 00:00:00.000000000 Z
 dependencies: []
 description: Basic type system for Ruby (free of dependencies).
 email: