collapsium 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4eb75d59a4fd999a789ee4fb811263dea86b493
-  data.tar.gz: 15a3e7ff204d3268112e41a565d6d441d60db873
+  metadata.gz: a5f69b509b0b797408a7a7b49f205cf1664d9931
+  data.tar.gz: c8cddb20e60be62dcf7522ef8008e9d02a4c256b
 SHA512:
-  metadata.gz: 31d5e290424e9e75eda116508351e2ae7ff3873ba977257140bf1112532278f4eae00590e9974b351d84afa89b1e1943d7ed4b4f74705c2ae54d6538b948b71f
-  data.tar.gz: 395b15971c754dea2eea60d7ebd601691f02214e7eeb97fa25281626b84cdaf6b4ecbb40585ebbfd8daa3914aa770f28856c81de8d7543a3e43ce15b8d4bc5a2
+  metadata.gz: 5586fb4097ab338d3a2d2d4a55d3ae2bd91eebea7d2a02acbe49500c45da8b735922ea989b2f9fbaa4d0134d26308d4ead461a40b86fec99d1c901c81690bf95
+  data.tar.gz: f57e9dd8df1ee2013db148d3acc86a462d10701dbaf72276997ef3e2a10724c51cd663696745d604cf66069684318d7507e3987235ddb48fe476eb5f762dcf81

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    collapsium (0.5.0)
+    collapsium (0.5.1)
 
 GEM
   remote: https://rubygems.org/
@@ -30,7 +30,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.5.0)
     rspec-support (3.5.0)
-    rubocop (0.44.1)
+    rubocop (0.45.0)
       parser (>= 2.3.1.1, < 3.0)
       powerpack (~> 0.1)
       rainbow (>= 1.99.1, < 3.0)
@@ -54,7 +54,7 @@ DEPENDENCIES
   collapsium!
   rake (~> 11.3)
   rspec (~> 3.5)
-  rubocop (~> 0.44)
+  rubocop (~> 0.45)
   simplecov (~> 0.12)
   yard (~> 0.9)
 

data/README.md

@@ -1,5 +1,5 @@
 # collapsium
-*Provides various Hash extensions, and an UberHash class that uses them all.*
+*Provides various Hash and Array extensions, and an UberHash class that uses them all.*
 
 Ruby's Hash is a pretty nice class, but various extensions are commonly (or not
 so commonly) used to make it even more convenient. The most notable would
@@ -37,6 +37,10 @@ that is ActiveSupport...
   #   },
   # }
   ```
+- The `RecursiveDup` module provides a `#recursive_dup` function which `#dup`s
+  recursively.
+- The `RecursiveSort` module provides a `#recursive_sort` function which sorts
+  recursively.
 - The `PathedAccess` module provides a pathed access method to nested Hashes:
 
   ```ruby
@@ -44,5 +48,43 @@ that is ActiveSupport...
   x.extend(::Collapsium::PathedAccess)
   x["foo.bar"] # => 42
   ```
+- The `PrototypeMatch` module provides the ability to match nested structures
+  by prototype:
+
+  ```ruby
+  x = { "foo" => { "bar" => 42 } }
+  x.extend(::Collapsium::PrototypeMatch)
+  x.prototype_match("foo" => { "bar" => nil }}) # => true
+  ```
+
+  Prototypes can include values, in which case they need to match. Or they can
+  contain nil, in which case any value will match, but the associated key must
+  still exist in the receiver.
+- Finally, the `ViralCapabilities` module is included in many of the above,
+  and ensures that nested structures retain the capabilites of their parents:
+
+  ```ruby
+  x = { "foo" => { "bar" => 42 } }
+  x.extend(::Collapsium::PathedAccess)
+  x.path_prefix # => "." (part of PathedAccess)
+  x["foo"].path_prefix # => ".foo" (virally inherited)
+  ```
 
 Finally, the `UberHash` class just includes all of the above.
+
+- The `EnvironmentOverride` method allows you to override keys in a nested
+  structure with environment variables:
+
+  ```ruby
+  x = ::Collapsium::UberHash.new
+  x.extend(::Collapsium::EnvironmentOverride)
+
+  x["foo.bar"] = 42
+  ENV["FOO_BAR"] = "override"
+  x["foo.bar"] # => "override"
+  ```
+
+  Note that `EnvironmentOverride` is not included in `UberHash` by default.
+  It just messes with the predictability of the class too much. However, the
+  [collapsium-config](https://github.com/jfinkhaeuser/collapsium-config) gem
+  uses it extensively to provide easy overrides for configuration values.

data/collapsium.gemspec

@@ -35,7 +35,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.0'
 
   spec.add_development_dependency "bundler", "~> 1.12"
-  spec.add_development_dependency "rubocop", "~> 0.44"
+  spec.add_development_dependency "rubocop", "~> 0.45"
   spec.add_development_dependency "rake", "~> 11.3"
   spec.add_development_dependency "rspec", "~> 3.5"
   spec.add_development_dependency "simplecov", "~> 0.12"

data/lib/collapsium/version.rb

@@ -8,5 +8,5 @@
 #
 module Collapsium
   # The current release version
-  VERSION = "0.5.0".freeze
+  VERSION = "0.5.1".freeze
 end

data/lib/collapsium/viral_capabilities.rb

@@ -270,6 +270,9 @@ module Collapsium
             # rubocop:disable Lint/HandleExceptions
             begin
               klass = receiver.send(getter)
+              if klass.nil? or klass == NilClass
+                next
+              end
               if klass != default
                 return klass
               end

data/spec/viral_capabilities_spec.rb

@@ -80,6 +80,12 @@ module ViralityModule
   end
 end
 
+class RespondsToHashAncestor < Hash
+  def hash_ancestor
+    return nil
+  end
+end
+
 describe ::Collapsium::ViralCapabilities do
   context PrependedHash do
     let(:tester) do
@@ -272,4 +278,11 @@ describe ::Collapsium::ViralCapabilities do
       expect(tester[:bar][:bar].object_id).to eql innermost.object_id
     end
   end
+
+  context RespondsToHashAncestor do
+    it "can still be used virally" do
+      tester = PrependedHash.new
+      expect { tester.merge(RespondsToHashAncestor.new) }.not_to raise_error
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: collapsium
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Jens Finkhaeuser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-27 00:00:00.000000000 Z
+date: 2016-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.44'
+        version: '0.45'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.44'
+        version: '0.45'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement