skn_utils 2.0.5 → 2.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b1dc55e64c570ca63ce385bbedae8052d9166603
-  data.tar.gz: a8e49bd524bbfebbb11ccb0cc1b6a21f3a0af8cd
+  metadata.gz: cefc06c3edeecb51df5198df7b9e66f7bd6436d9
+  data.tar.gz: cfcb3e42124bfc01175839f88ac54f97ce352b55
 SHA512:
-  metadata.gz: 75aa0eace6c9d4ac13f674b67a50724e37c7b18439f7cfa42aeeb6bfa676ac13d1136302e9833e986d5ebefaf833490746003e35ca8b965b4b80c5ce6a59d35d
-  data.tar.gz: 7009021f7d9aea4afd4a1c530ad0a5bfa1f6dd95d9501db230c21d0f53fd57c0c5158affde4f5a2dc4ca93b9fdb6d96c84a1c24f4cded6f58155bec34507e6ef
+  metadata.gz: 1668823c468aacec8b9dd450c0f7c3188370a48553b60285aa0aa7a66f50c2c6a29b54601b4ca75ec1f83cab30194d2ea927701f49e344ffdefbb2191b935946
+  data.tar.gz: 523243ed0ceedf0fa67cace2ba399a075918eaefcb21689089a9031929f51c3d9ca94aff6a5e6a8c847131ecf8de478a5ce3364eb07436b9477fe368c4d25531

data/README.md

@@ -25,14 +25,14 @@ into the input params key ':enable_serialization' set to true.  It defaults to f
 ### New Features
 --------------------------------
 
+    10/2016  V2.0.6  
+    Added an SknUtils::NullObject and SknUtils::nullable?(value) extracted from [Avdi Grimm's Confident Code](https://gist.github.com/jschoolcraft/979827)
+    The NullObject class has great all around utility, check out it's specs!        
+
     08/2016  V2.0.3  
     Added an exploritory ActionService class and RSpec test, triggered by reading [Kamil Lelonek](https://blog.lelonek.me/what-service-objects-are-not-7abef8aa2f99#.p64vudxq4)
     I don't support his approach, but the CreateTask class caught my attention as a Rubyist.        
 
-    02/2015  V2.0.2  
-    Added Jim Gay's Direction module, from his [Eastward Video](http://confreaks.tv/videos/rubyconf2014-eastward-ho-a-clear-path-through-ruby-with-oo)
-    which allows to use :command instead of :Forwardable to implement a portion of the 'Eastward' methodology.        
-
     12/2015  V2.0  
 	All references to ActiveRecord or Rails has been removed to allow use in non-Rails environments
     as a result serialization is done with standard Ruby Hash serialization methods; by first transforming

data/lib/skn_utils.rb

@@ -5,9 +5,10 @@ require 'skn_utils/generic_bean'
 require 'skn_utils/page_controls'
 require 'skn_utils/result_bean'
 require 'skn_utils/value_bean'
+require 'skn_utils/null_object'
 require 'skn_utils/exploring/commander'
 require 'skn_utils/exploring/action_service'
 
 module SknUtils
-  
+
 end

data/lib/skn_utils/null_object.rb

@@ -0,0 +1,29 @@
+#
+# lib/skn_utils/null_object.rb
+#
+module SknUtils
+
+  # From: https://github.com/avdi/cowsay
+  class NullObject
+    def initialize
+      @origin = caller.first
+    end
+
+    def __null_origin__
+      @origin
+    end
+
+    def method_missing(*args, &block)
+      self
+    end
+
+    def nil?
+      true
+    end
+  end
+
+  def self.nullable?(value)
+    value.nil? ? NullObject.new : value
+  end
+
+end

data/lib/skn_utils/version.rb

@@ -3,7 +3,7 @@ module SknUtils
   class Version
     MAJOR = 2
     MINOR = 0
-    PATCH = 5
+    PATCH = 6
 
     def self.to_s
       [MAJOR, MINOR, PATCH].join('.')

data/spec/lib/skn_utils/null_object_spec.rb

@@ -0,0 +1,30 @@
+##
+# spec/lib/skn_utils/null_object_spec.rb
+#
+
+RSpec.describe SknUtils::NullObject, "NullObject with Helpers " do
+
+  context "Null Object Operations" do
+    it "consumes any method called on it" do
+      expect(subject.any_method).to be_a(subject.class)
+    end
+
+    it "consumes the whole chain of methods called on it" do
+      expect(subject.any_method.chaining_methods).to be_a(subject.class)
+    end
+  end
+
+  context "Alternate #try() named #nullable?() " do
+    it "#nullable?(value) returns null object if value is nil" do
+      expect(SknUtils::nullable?(nil)).to be_a(subject.class)
+    end
+
+    it "#nullable?(value) consumes the whole chain of methods called on it if value is nil" do
+      expect(SknUtils::nullable?(nil).any_method.chaining_methods).to be_a(subject.class)
+    end
+    it "#nullable?(value) returns the value if valid" do
+      expect(SknUtils::nullable?({value: true})[:value]).to be true
+    end
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: skn_utils
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 2.0.6
 platform: ruby
 authors:
 - James Scott Jr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-16 00:00:00.000000000 Z
+date: 2016-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -97,6 +97,7 @@ files:
 - lib/skn_utils/exploring/configuration.rb
 - lib/skn_utils/generic_bean.rb
 - lib/skn_utils/nested_result_base.rb
+- lib/skn_utils/null_object.rb
 - lib/skn_utils/page_controls.rb
 - lib/skn_utils/result_bean.rb
 - lib/skn_utils/value_bean.rb
@@ -106,6 +107,7 @@ files:
 - spec/lib/skn_utils/exploring/commander_spec.rb
 - spec/lib/skn_utils/exploring/configuration_spec.rb
 - spec/lib/skn_utils/generic_bean_spec.rb
+- spec/lib/skn_utils/null_object_spec.rb
 - spec/lib/skn_utils/page_controls_spec.rb
 - spec/lib/skn_utils/result_bean_spec.rb
 - spec/lib/skn_utils/value_bean_spec.rb
@@ -145,6 +147,7 @@ test_files:
 - spec/lib/skn_utils/exploring/commander_spec.rb
 - spec/lib/skn_utils/exploring/configuration_spec.rb
 - spec/lib/skn_utils/generic_bean_spec.rb
+- spec/lib/skn_utils/null_object_spec.rb
 - spec/lib/skn_utils/page_controls_spec.rb
 - spec/lib/skn_utils/result_bean_spec.rb
 - spec/lib/skn_utils/value_bean_spec.rb