hm 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 546509d780fa20ac838d7cde7df190a5860df261
-  data.tar.gz: cd18bb35c606420e79056efebd703e5bd9c3962d
+  metadata.gz: 85ac2c1b29c041f8981babe3497828dbd74008c8
+  data.tar.gz: 96f500ecd4ef021b715600546817df1527520f4d
 SHA512:
-  metadata.gz: 16c5155264b15632a58896c8e8acd5e26ed10b579bc813e66b4256ae03bfd7ee61a1fd2d702cef0aeda82a9011e193618c4ab00f98c270ff293564d81da82523
-  data.tar.gz: fa1a5b8e97a2a27bb9ab97f156f33d43746301d8b236488c8ea669d7b19c7cffebc80a132cd3a8fb636d159d1940240f2cbaa371cead7b558eb45956f7dd5e95
+  metadata.gz: 3c4ca16a574f0ee40b33e1c7c2798143d1214afb454d3c151045e8777318d4e41f0cfbdbfc1f7ac8eafe5c365e630d78503bed91f6a25c6afb614f334858b203
+  data.tar.gz: 9123c53633102d932b602635afe18bf42e739ee4ab432a823ee909fd4126b6189497085077280673bfc97487e9880087a9561e1a54017c2e9ba286078dd04355

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Hm version history
 
+## 0.0.3 - Mar 8, 2018
+
+* `Hm#partition(list, of, keys)` to receive two hashes: with matching, and not matching keys;
+* `Hm#transform_values` now work without any keys/pathes passed (just transforming all "terminal" values).
+
 ## 0.0.2 - Feb 24, 2018
 
 * Some profiling and small optimizations;

data/lib/hm.rb

@@ -238,25 +238,30 @@ class Hm
   # Performs specified transformations on values of input sequence, limited only by specified
   # pathes.
   #
-  # @note
-  #   Unlike {#transform_keys}, this method does nothing when no pathes are passed (e.g. not runs
-  #   transformation on each value), because the semantic would be unclear. In our `:order` example,
-  #   list of all items is a value _too_, at `:items` key, so should it be also transformed?
+  # If no `pathes` are passed, all "terminal" values (e.g. not diggable) are yielded and transformed.
   #
   # @example
   #   order = {items: [{title: "Beef", price: 18.0}, {title: "Potato", price: 8.2}], total: 26.2}
   #   Hm(order).transform_values(%i[items * price], :total, &:to_s).to_h
   #   # => {:items=>[{:title=>"Beef", :price=>"18.0"}, {:title=>"Potato", :price=>"8.2"}], :total=>"26.2"}
+  #   Hm(order).transform_values(&:to_s).to_h
+  #   # => {:items=>[{:title=>"Beef", :price=>"18.0"}, {:title=>"Potato", :price=>"8.2"}], :total=>"26.2"}
   #
-  # @see #transform_values
+  # @see #transform_keys
   # @see #transform
   # @param pathes [Array] List of pathes (each being singular key, or array of keys, including
   #   `:*` wildcard) to look at.
   # @yieldparam value [Array] Current value to process.
   # @return [self]
   def transform_values(*pathes)
-    pathes.each do |path|
-      Algo.visit(@hash, path) { |at, pth, val| at[pth.last] = yield(val) }
+    if pathes.empty?
+      Algo.visit_all(@hash) do |at, pth, val|
+        at[pth.last] = yield(val) unless Dig.diggable?(val)
+      end
+    else
+      pathes.each do |path|
+        Algo.visit(@hash, path) { |at, pth, val| at[pth.last] = yield(val) }
+      end
     end
     self
   end
@@ -434,6 +439,30 @@ class Hm
     self
   end
 
+  # Split hash into two: the one with the substructure matching `pathes`, and the with thos that do
+  # not.
+  #
+  # @example
+  #   order = {items: [{title: "Beef", price: 18.0}, {title: "Potato", price: 8.2}], total: 26.2}
+  #   Hm(order).partition(%i[items * price], :total)
+  #   # => [
+  #   #  {:items=>[{:price=>18.0}, {:price=>8.2}], :total=>26.2},
+  #   #  {:items=>[{:title=>"Beef"}, {:title=>"Potato"}]}
+  #   # ]
+  #
+  # @param pathes [Array] List of pathes (each being singular key, or array of keys, including
+  #   `:*` wildcard) to look at.
+  # @yieldparam value [Array] Current value to process.
+  # @return [Array<Hash>] Two hashes
+  def partition(*pathes)
+    # FIXME: this implementation is naive, it performs 2 additional deep copies and 2 full cycles of
+    # visiting instead of just splitting existing data in one pass. It works, though
+    [
+      Hm(@hash).slice(*pathes).to_h,
+      Hm(@hash).except(*pathes).to_h
+    ]
+  end
+
   # Returns the result of all the processings inside the `Hm` object.
   #
   # Note, that you can pass an Array as a top-level structure to `Hm`, and in this case `to_h` will

data/lib/hm/version.rb

@@ -1,7 +1,7 @@
 class Hm
   MAJOR = 0
   MINOR = 0
-  PATCH = 2
+  PATCH = 3
   PRE = nil
   VERSION = [MAJOR, MINOR, PATCH, PRE].compact.join('.')
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hm
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Victor Shepelev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-24 00:00:00.000000000 Z
+date: 2018-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard