cdt-utilities 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b4e8878b78d5eabb0daa6cffde78960045a0d1ce
-  data.tar.gz: 82254c3b751bb6545821b59124ee857ba4c586a3
+  metadata.gz: d31994b7b265eb116aae1d4bb165fbc81056f1a6
+  data.tar.gz: 480eae88438f78f20db84371671102a6a0d0526b
 SHA512:
-  metadata.gz: f691ee2fcf6446639552826ddf11d4ba6ef41fa61489c6a7678ca75fbcc077ea663c01a2a8ac854652fec08330f2e4d2c2fb2324b7bbea9768043acb4ed65c8f
-  data.tar.gz: 3ceca0564c007c4d01c3eb65625d685a22f64eb42b69e8ee6b498dad01c947e33e6087fb6001336281bef7887a9cc64f4a6a51171f29c5145b6a79a3ef629152
+  metadata.gz: df92b157c9a0aa4c33efc85ddc239b943fc31466fb1507f093cc63b74dcf9d232d7b964d3328182c98664960738abf3291ff4dff48f8faade7d15a87d05e4a9b
+  data.tar.gz: 4f9222d811c11f1d3daac3c0657606ebb20c74791db427c93d185cf5641a838c743c1ba4f28e65eb2a307f610d736b028cf148d91a9bd1138d5e8626df0122db

data/README.md

@@ -13,7 +13,7 @@ Some Ruby utilities.
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'cdt-utilities', "~> 0.3"
+gem 'cdt-utilities', "~> 0.4"
 ```
 
 And then execute:
@@ -81,24 +81,24 @@ require 'cdt/utilities'
 # or if you just want this utility
 require 'cdt/utilities/if-not-nil'
 
-CdT.if_nil(nil)   {7}      # Evaluates to 7
-CdT.if_nil(42)    {7}      # Evaluates to 42
+CdT.if_nil(nil)   { 7 }      # Evaluates to 7
+CdT.if_nil(42)    { 7 }      # Evaluates to 42
 
 
-CdT.if_not_nil(42)   { |object| object + 1}  # Evaluates to 43
-CdT.if_not_nil(nil)  { |object| object + 1}  # Evaluates to nil
+CdT.if_not_nil(42)   { |object| object + 1 }  # Evaluates to 43
+CdT.if_not_nil(nil)  { |object| object + 1 }  # Evaluates to nil
 
 # Evaluates to 43
 CdT.object 42,
-   if_not_nil: proc { |object| object + 1},
+   if_not_nil: proc { |object| object + 1 },
    if_nil:     proc { 7 }
 
 CdT.object 42,
-   if_not_nil: proc { |object| object + 1},
+   if_not_nil: proc { |object| object + 1 },
 
 # Evaluates to 7
 CdT.object nil,
-   if_not_nil: proc { |object| object + 1},
+   if_not_nil: proc { |object| object + 1 },
    if_nil:     proc { 7 }
 
 # Evaluates to 42
@@ -116,6 +116,38 @@ def customer_name(customer_id)
 end
 ```
 
+### CdT.undefined
+
+A singleton object that is identically different from all the other objects.
+
+Usually `nil` is used as an undefined value. However, sometimes `nil` is a valid value in some contexts, so a different object must be used as an undefined value.
+
+Examples:
+
+```ruby
+require 'cdt/utilities'
+# or if you just want this utility
+require 'cdt/utilities/undefined'
+
+def do_something(value = CdT.undefined)
+  if value == CdT.undefined
+    # ...
+  else
+    # ...
+  end
+end
+
+# you can also test the undefined value using
+
+def do_something(value = CdT.undefined)
+  if value.kind_of?(CdT::Undefined)
+    # ...
+  else
+    # ...
+  end
+end
+```
+
 ## Running the tests
 
 ```bash

data/lib/cdt/utilities.rb

@@ -1,4 +1,5 @@
 require_relative 'version'
 require_relative 'utilities/bind'
 require_relative 'utilities/subclass-responsibility'
-require_relative 'utilities/if-not-nil'
+require_relative 'utilities/if-not-nil'
+require_relative 'utilities/undefined'

data/lib/cdt/utilities/undefined.rb

@@ -0,0 +1,15 @@
+module CdT
+	class Undefined
+	end
+
+	# Do not use lazy initialization with ||= to avoid race conditions
+	def self.undefined()
+		@undefined
+	end
+
+	def self.set_undefined(object)
+		@undefined = object
+	end
+
+	set_undefined(CdT::Undefined.new)
+end

data/lib/cdt/version.rb

@@ -1,3 +1,3 @@
 module CdT
-	VERSION = "0.3.0"
+	VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cdt-utilities
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Martin Rubi
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-23 00:00:00.000000000 Z
+date: 2016-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,6 +58,7 @@ files:
 - lib/cdt/utilities/bind.rb
 - lib/cdt/utilities/if-not-nil.rb
 - lib/cdt/utilities/subclass-responsibility.rb
+- lib/cdt/utilities/undefined.rb
 - lib/cdt/version.rb
 homepage: https://github.com/cabeza-de-termo/ruby-utilities
 licenses:
@@ -79,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.6.3
 signing_key: 
 specification_version: 4
 summary: Ruby utilities. No monkey patching if possible.