hesh 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f5f07e54c97be55a6c8da62fc4f23c1390586a4830498f104d1ff5eb47d72aa
-  data.tar.gz: 823b42dfcdaf654f21dd8add2e6fb97b45e5e0d1eea72a5e09eb4fa4e69d1836
+  metadata.gz: 51993aff5492c29105b73ec622942f5f827da21e1c8f2c8bbebf0c4c52707878
+  data.tar.gz: 3a7796f89cc9806cb576f0120c67ec86560587ea12d6b55040ab63538c35bbcb
 SHA512:
-  metadata.gz: d9509dd0909fdfa13744facf7918eb611c96ccec274d76c0c74364a86581cf248e3812177fbf79ba564f2fb0e34e149da4f84d841896800241847db37af3ca5b
-  data.tar.gz: 784df8f49a27f83405dfeff657ffb8e1b07e50f08b2e1906a621bc892ab71b9b271f7c632ade98a6d9a7d82f5f73e3c0d8a0591418cd41303c496294e9550387
+  metadata.gz: b096afaddb9863fbb9cb08feeb37c920a1f00e41b3931672a3cadb1e26a19278e1ee1c9653063afc59e31a3bc845eea881c6be9c49b86a87442cac5fce814149
+  data.tar.gz: bd4d3db10f5aff1754fa2821b096973e7c9ee07cfde296cf1d1a9a697076e8be6e934fe9d21edc559820ca0dd11c91c1d1c45c15dc240b2262dc63eb6c832eb6

data/.gitignore

@@ -9,3 +9,4 @@
 
 # rspec failure tracking
 .rspec_status
+*.gem

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hesh (0.0.1)
+    hesh (0.0.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -23,9 +23,28 @@ Hesh.count_from(%w(a a a b b b b c c))
 # Inverts the relation of a hash
 Hesh.invert_relation({ 1 => %w(a b), 2 => %w(b c), 3 => %w(a c) })
 => { "a" => [1, 3], "b" => [1, 2], "c" => [2, 3] }
+
+# Merges and sums together values
+Hesh.merge_sum({ a: 1 }, { a: 2 }, { a: 3 })
+=> { a: 6 }
+
+# Merges and joins together arrays
+Hesh.merge_join({ a: [1,2,3] }, { a: [4] })
+=> { a: [1, 2, 3, 4] }
+
+# Merges with a function
+Hesh.merge_with({ a: [1,2,3] }, { a: [1,4] }) { |k, o, n| o - n }
+=> { a: [2, 3] }
+
+# Merges deep!
+a = { a: { b: { c: 1, d: 2 } } }
+b = { a: { b: { c: 4, d: 3 }, x: 4 } }
+
+Hesh.merge_deep(a, b) { |k,o,n| o + n }
+=> { a: { b: { c: 5,  d: 5 },  x: 4 } }
 ```
 
-More examples to come later
+More examples to come later, the rspec tests have the most fun in them.
 
 ## Installation
 

data/lib/hesh/version.rb

@@ -1,3 +1,3 @@
 class Hesh
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/hesh.rb

@@ -5,6 +5,9 @@ class Hesh
   # you happen to give it!
   IDENTITY_FN = -> v { v }
 
+  # We prefer the new and shiny here, yes we do.
+  PREFER_NEW_FN = -> k, o, n { n }
+
   def initialize
     raise 'Why no no no, hesh is not to be made! Not yet!'
   end
@@ -63,5 +66,60 @@ class Hesh
         vs.each { |v| h[v] << k }
       }
     end
+
+    # Merges a series of hashes and sums their values
+    #
+    # @param *hashes [Array[Hash]]
+    #   Collection of hashes
+    #
+    # @return [Hash[Any, Integer]]
+    #   Summed hash
+    def merge_sum(*hashes)
+      hashes.reduce(Hash.new(0), &merges { |k, o, n| o + n })
+    end
+
+    # Merges a series of hashes and joins their values
+    #
+    # @param *hashes [Array[Hash]]
+    #   Collection of hashes
+    #
+    # @return [Hash[Any, Array]]
+    #   Joined hash
+    def merge_join(*hashes)
+      hashes.reduce(Hesh.of_array, &merges { |k, o, n| o + n })
+    end
+
+    # Merges a series of hashes with a function
+    #
+    # @param *hashes [Array[Hash]]
+    #   Collection of hashes
+    #
+    # @return [Hash[Any, Any]]
+    #   Merged hash
+    def merge_with(*hashes, &fn)
+      hashes.reduce({}, &merges(&fn))
+    end
+
+    # Merges a series of hashes infintely deep with a function
+    #
+    # @param *hashes [Array[Hash]]
+    #   Collection of hashes
+    #
+    # @param &fn [Proc]
+    #   Function for joining values, defaults to preferring newest value
+    #
+    # @return [Hash[Any, Any]]
+    #   Joined hash
+    def merge_deep(*hashes, &fn)
+      fn ||= PREFER_NEW_FN
+
+      hashes.reduce({}, &merges { |k, o, n|
+        o.is_a?(Hash) ? merge_deep(o, n, &fn) : fn[k, o, n]
+      })
+    end
+
+    private def merges(&fn)
+      -> a, b { a.merge(b, &fn) }
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hesh
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Brandon Weaver