creative_rails_utilities 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b64a37df9c84fef7bc29b96d589b9f475459ee59
-  data.tar.gz: 3ccfd498f0d7dcebfa4c896b859c5991dd93e1be
+  metadata.gz: 0aeba2d7261337d8ead0a8589484c3810e09f77d
+  data.tar.gz: 75c51fa09a75031047752e8dd7d4cf2993a6dd69
 SHA512:
-  metadata.gz: 3815e20f599be7cb52c502a898ecc5fc675cb80c39c736888cc48e5ae8e7aef70cb5e24f37e34028636d65ddebff3de8b7e9fbf68d27128861016c00db652d71
-  data.tar.gz: 372130b0d9e8070ef4005e63b604f6854d89d09315399d6f8ab1f5aab5df84daa68b9e97954989ce0f96bec5361288c8f22a01f110996d185bd90a0ec57b0f5b
+  metadata.gz: bcc93b4c92d8ea744b797a8b873380aebeff10e70635d062cc3f4f8a3feb977944f3cc6af06994368129cec73a45db9a9780758be3b10ee3073135b4589388f5
+  data.tar.gz: 21dc974ec4b821762f23c6827c8b88a7dc1f6995aa854a6b8d89c4e1356ad91ed7e1a9c8de7c85849ace8744bef406bc8dccfe5e250986cfdba5c4239cd94467

data/CHANGELOG.md

@@ -8,6 +8,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 -
 ```
 
+## [0.4.6] - 2016-12-06
+### Added
+- Hash.sum
+
 ## [0.4.5] - 2016-12-05
 ### Added
 - URI#merge

data/README.md

@@ -77,6 +77,27 @@ some_hash.fast_sort_keys #=> some_sorted_hash
 {}.populate_with_keys(min: 1, max: 3) #=> {1 => 0, 2 => 0, 3 => 0}
 ```
 
+__.sum(h1, h2)__
+```rb
+# use this to recursively sum-merge two hashes that have strictly numeric and hash-like values
+
+# Case 2 Sum arbitrary single depth hash
+h1 = {1 => 2, 2 => 3}
+h2 = {1 => 1, 3 => 2}
+sum = {1 => 3, 2 => 3, 3 => 2}
+
+# Case 2 Sum arbitrary two depth hash
+h1 = {1 => {a: 1, b: 2}, 2 => {a: 1, b: 2} }
+h2 = {1 => {a: 1, b: 1}, 3 => {a: 1, b: 2}  }
+sum = {1 => {a: 2, b: 3}, 2 => {a: 1, b: 2}, 3 => {a: 1, b: 2} }
+
+# Case 3 Sum arbitrary N depth hash
+h1 = {1 => 1, 2 => {a: 1, b: 2} }
+h2 = {2 => {a: 1, b: 1}, 3 => {x: {y: 1}}  }
+sum = {1 => 1, 2 => {a: 2, b: 3}, 3 => {x: {y: 1}} }
+
+```
+
 ##### Numeric
 
 ```ruby

data/lib/creative_rails_utilities/hash.rb

@@ -36,4 +36,38 @@ class Hash
   #   return result.fast_sort_keys
   # end
 
+  def self.sum(h1, h2)
+    # 1. take keys from both hashes
+    keys = (h1.keys + h2.keys).uniq
+
+    sum_hash = {}
+
+    # 2. loop over the keys, summing numerics and recursing into hash-like structures
+    keys.each do |key|
+      v1 = h1[key]
+      v2 = h2[key]
+
+      sum_value = if v1.respond_to?(:keys) && v2.respond_to?(:keys)
+        # O-1 recuring needed only if both are hash-like
+        sum(v1, v2)
+      elsif v1.present? && v2.blank?
+        # O-3a sum possibe because either is nil (one of the hashes does not have the key at all)
+        v1
+      elsif v1.blank? && v2.present?
+        # O-3b sum possibe because either is nil (one of the hashes does not have the key at all)
+        v2
+      elsif v1.respond_to?(:to_f) && v2.respond_to?(:to_f)
+        # O-2 sum possible because both numerics
+        v1 + v2
+      elsif v1.present? && v2.present? && (v1.respond_to?(:to_f) != v2.respond_to?(:to_f))
+        # 0-4 error because types mismatch
+        raise ArgumentError.new("Sorry, can not sum these hashes, there's value collision in '#{key}' keys")
+      end
+
+      sum_hash[key] = sum_value
+    end
+
+    return sum_hash
+  end
+
 end

data/lib/creative_rails_utilities/version.rb

@@ -1,3 +1,3 @@
 module CreativeRailsUtilities
-  VERSION = "0.4.5"
+  VERSION = "0.4.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: creative_rails_utilities
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Creative
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-12-05 00:00:00.000000000 Z
+date: 2016-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport