hamstar 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab040a250a4325cf3681baf92ff97430166dbecb
-  data.tar.gz: 1d7031c670edffa37f16fda7c9e47f0b70b39f75
+  metadata.gz: 080ce403676cf58160a805b76098674a414b20e2
+  data.tar.gz: 875e04443ada66d1eb1cc79f07117cb2e1d71bc4
 SHA512:
-  metadata.gz: 232b3941196abc177f5586ea0e52f4c64b46543639a3a429b2fd36925a317deac862327d5fa35f639f4c1d5d1fbf3e54df28332adddbb4c98fb4cf2ec9f184b0
-  data.tar.gz: 6aa7d473b7bae0b839d9f58cd3846eef3f0eb03660b36218705573dd55920762d4cb956db3469574be3a45a9f2f2d75094494c821ac27b5b5703f3462beab528
+  metadata.gz: 88bd7039e6d77342821c2965757d52c353d187cc0254032bc307a0868bcecb4edcdbe276187840f4634eaaf94d94afd092cddeec650f8b4386c19c845cb10634
+  data.tar.gz: 3a96805cba6afd746d3b152157b1f11a0052669353db4d2c708effd3f7cfa98c4a008369692532841db985258ec5d0df0b97c6543497f49c8c8f0424bda469cb

data/README.md

@@ -2,8 +2,8 @@
 
 `Hamstar.update_having` is a `module_function` that works just like [Hamster update_in()](https://github.com/hamstergem/hamster#transformations) but with three additional ways to select container elements:
 
-1. the associative selector denoted by an array containing a key and a value e.g. `[:name,'Chris']`
-2. the Kleene star operator denoted by '*'
+1. the Kleene star operator denoted by `'*'`
+2. the associative selector denoted by an array containing a key and a value e.g. `[:name,'Chris']` your values will be compared to this one using the case comparison operator `===` so you can use Strings or regexps or other things that define `===` (such as classes and Ranges)
 3. generalized `Proc`-based matching e.g. you can supply a lambda directly in the path specification
 
 ## Installation
@@ -53,10 +53,17 @@ Hamstar.update_having( x, [:name,'Pat'],:name){|name| 'Patsy'}
 => Hamster::Vector[Hamster::Hash[:name => "Chris", :hobbies => Hamster::Vector["clarinet"]], Hamster::Hash[:name => "Patsy", :hobbies => Hamster::Vector["bird watching", "rugby"]]]
 ```
 
-Finally, you can use a `Proc` as a matcher. Here's an example that supplies a lambda inline:
+Note that your values will be compared to the second element of the pair using the case comparison operator `===`. That means you can use a Regexp there (or any other object that defines `===`) e.g.:
 
 ```ruby
-Hamstar.update_having( x, ->(k,v){v[:name] == 'Pat'},:name){|name| 'Patsy'}
+Hamstar.update_having( x, [:name,/P/],:name){|name| name+'sy'}
+=> (same result as before)
+```
+
+Finally, if none of the options given above work for you, you can use an arbitrary `Proc` as a matcher. Here's an example that supplies a lambda inline:
+
+```ruby
+Hamstar.update_having( x, ->(k,v){k.odd?},:name){|name| 'Patsy'}
  => Hamster::Vector[Hamster::Hash[:name => "Chris", :hobbies => Hamster::Vector["clarinet"]], Hamster::Hash[:name => "Patsy", :hobbies => Hamster::Vector["bird watching", "rugby"]]]
 ```
 

data/lib/hamstar.rb

@@ -15,7 +15,7 @@ module Hamstar
     matcher = match_path[0]
     case matcher
     when KLEENE_STAR; match ->(k,v){true}, c, *match_path, &block
-    when Array, Hamster::Vector; match ->(k,v){key,value=matcher; v[key] == value}, c, *match_path, &block
+    when Array, Hamster::Vector; match ->(k,v){key,value=matcher; value === v[key]}, c, *match_path, &block
     when Proc; match matcher, c, *match_path, &block
     else
       if match_path.size == 1
@@ -32,7 +32,7 @@ module Hamstar
     mp_rest = Hamster.from(match_path)[1..-1] # drop first expr
     c.each_pair do |key,value|
       if matcher.call key, value
-        mp = mp_rest.unshift key # put key where assoc was
+        mp = mp_rest.unshift key # put key where expr was
         c = update_having c, *mp, &block
       end
     end

data/lib/hamstar/version.rb

@@ -1,3 +1,3 @@
 module Hamstar
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/spec/hamstar_spec.rb

@@ -19,9 +19,12 @@ RSpec.describe Hamstar do
     [ [{a:1},{a:2}],['*',:a],  ->(v){v+1}, [{a:2},{a:3}], 'Hash inside Vector']
   ]
 
+  cph = [{name:'Chris'},{name:'Pat'}]
+  addsy = ->(name){name+'sy'}
   examples_associative = [
-    [ [{name:'Chris'},{name:'Pat'}],  [[:name,'Pat'],:name],->(name){name+'sy'}, [{name:'Chris'},{name:'Patsy'}],  'match a Hash'],
-    [ [[:name,'Chris'],[:name,'Pat']],[[1,'Pat'],1],        ->(name){name+'sy'}, [[:name,'Chris'],[:name,'Patsy']],'match a Vector']
+    [ cph,             [[:name,'Pat'],:name],        addsy, [{name:'Chris'},{name:'Patsy'}],  'match a Hash'],
+    [ [[:name,'Chris'],[:name,'Pat']],[[1,'Pat'],1], addsy, [[:name,'Chris'],[:name,'Patsy']],'match a Vector'],
+    [ cph,             [[:name,/P/],:name],          addsy, [{name:'Chris'},{name:'Patsy'}],  'match a Hash w/ a regexp']
   ]
 
   examples_function_match = [

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hamstar
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Bill Burcham
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-03 00:00:00.000000000 Z
+date: 2015-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hamster