skn_utils 5.5.0 → 5.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9a78df2df5ed11a61cea3d00b0f3543295e3ce5b
-  data.tar.gz: eb021f9d1f707e8e08411b542b05959061322d25
+  metadata.gz: 2822f2d8bb83e07b5b099fe277285948dc0e687f
+  data.tar.gz: 28ae0ca8c94fbc7998ce696d3424345976588ff8
 SHA512:
-  metadata.gz: 0ee33852c9675b13b64a8beb22fdd26fa6afd09994ee4809e4d2fc84bbc46201f469f9b715f4a7ba2291abadd3f5de36f6d98d257c3cc1f085b29f4f7c316374
-  data.tar.gz: d7ff622a8c1dc13ab5a0438c08b5f9f0e5fc04f32c989bcc8ab32d8d08243cae69c1cd6ce985c0a7871b7784f56a181d6ed6ab8879282e9c139588cbd4112f95
+  metadata.gz: 951ff479251217472626d4e8c4dca4bf8e40d59be6606ecefc7ee21b9eb5150f2ff080a9edb8e02b003d2d5cc59cca194cd63a57fc8b5c19dd36a6f4fe334671
+  data.tar.gz: a7919693b23911d56a4c3411e5f8c89e62142921a507ecae61357d49e8f7a4eda5e1df65ecf0abf1516f4d3c47fead9820568d1fb2aeaf95972c83f3cfa58f36

data/README.md

@@ -323,6 +323,10 @@ There are many more use cases for Ruby's Hash that this gem just makes easier to
             
             same_instance = SknContainer.resolve(:the_instance)
 
+      * Testing Support:
+          - #substitute(...) allows you to mock an existing entry. #substitute is an alias for #register_mock              
+          - #restore! clears all mocked entries.  #restore! is an alias for #unregister_mock!
+
 
 ## Public Methods: SknUtils::ConcurrentJobs ONLY
     `ConcurrentJobs` behaves as a concurrent thread pool by using Concurrent::Promise from the `concurrent-ruby` gem. 

data/lib/skn_registry.rb

@@ -73,9 +73,8 @@ class SknRegistry < Concurrent::Hash
     attr_reader :item, :options
 
     def initialize(item, options = {})
-      @item, @options = item, {
-          call: item.is_a?(::Proc)
-      }.merge(options)
+      @item    = item
+      @options = { call: item.is_a?(::Proc) }.merge(options)
     end
 
     # Determine if call is required, without changing original values
@@ -96,18 +95,19 @@ class SknRegistry < Concurrent::Hash
   def initialize(&block)
     super
     block.call(self) if block_given?
+    @__substitutes = {}
   end
 
   # public instance methods
   def register(key, contents = nil, options = {}, &block)
     if block_given?
       item = block
-      options = contents if contents.is_a?(::Hash)
+      options.merge!(contents) if contents.is_a?(::Hash)
     else
       item = contents
     end
 
-    self[key] = Content.new(item, options)
+    self.store( key, Content.new(item, options) )
 
     self # enable chaining
   end
@@ -116,4 +116,22 @@ class SknRegistry < Concurrent::Hash
     self[key]&.call(render_proc)
   end
 
+  def register_mock(key, contents = nil, options = {}, &block)
+    if member?(key)
+      @__substitutes.store(key, self.delete(key) )
+    end
+
+    register(key, contents, options, &block)
+  end
+  alias_method :substitute, :register_mock
+
+  def unregister_mocks!
+    @__substitutes.keys.each do |k|
+      self[k] = @__substitutes.delete(k)
+    end
+
+    nil
+  end
+  alias_method :restore!, :unregister_mocks!
+
 end

data/lib/skn_utils/core_extensions.rb

@@ -4,6 +4,7 @@
 # File: ./lib/skn_utils/core_extensions.rb  --
 # -- from: Rails 4.1 ActiveSupport:lib/active_support/core_ext/object/blank.rb
 # -- Ref: https://6ftdan.com/allyourdev/2015/01/20/refinements-over-monkey-patching/
+# -- Ref: https://medium.com/rubycademy/the-complete-guide-to-create-a-copy-of-an-object-in-ruby-part-ii-cd28a99d58d9
 
 module SknUtils
   module CoreObjectExtensions
@@ -53,6 +54,15 @@ module SknUtils
         def presence
           self if present?
         end
+
+        def duplicable?
+          true
+        end
+
+        def deep_dup
+          duplicable? ? dup : self
+        end
+
       end
 
       class ::NilClass
@@ -96,6 +106,10 @@ module SknUtils
         #
         # @return [true, false]
         alias_method :blank?, :empty?
+
+        def deep_dup
+          map(&:deep_dup)
+        end
       end
 
       class ::Hash
@@ -106,6 +120,19 @@ module SknUtils
         #
         # @return [true, false]
         alias_method :blank?, :empty?
+
+        def deep_dup
+          hash = dup
+          each_pair do |key, value|
+            if key.frozen? && ::String === key
+              hash[key] = value.deep_dup
+            else
+              hash.delete(key)
+              hash[key.deep_dup] = value.deep_dup
+            end
+          end
+          hash
+        end
       end
 
       class ::String

data/lib/skn_utils/version.rb

@@ -4,7 +4,7 @@
 module SknUtils
   class Version
     MAJOR = 5
-    MINOR = 5
+    MINOR = 6
     PATCH = 0
 
     def self.to_s

data/spec/lib/skn_utils/registry_spec.rb

@@ -127,4 +127,26 @@ describe SknRegistry, "IoC Lite Container class." do
     end
   end
 
+
+  context "When used for testing " do
+
+    it "#register_mock Registers a temporary mock." do
+      services.register_mock(:service_c, "Testing" )
+
+      expect(services.resolve(:service_c)).to eq "Testing"
+      services.restore!
+    end
+
+    it "#unregister_mocks! Remove all mocks and restores previous entries if present." do
+      original = services.resolve(:service_c)
+      services.substitute(:service_c, "Testing")
+      expect(services.resolve(:service_c)).to eq "Testing"
+
+      services.unregister_mocks!
+
+      services.resolve(:service_c)
+      expect(services.resolve(:service_c)).to eq original
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: skn_utils
 version: !ruby/object:Gem::Version
-  version: 5.5.0
+  version: 5.6.0
 platform: ruby
 authors:
 - James Scott Jr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-25 00:00:00.000000000 Z
+date: 2019-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: deep_merge