hash_selectors 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6f465f6bc5e31b99b2176ff434d1f9cff6a1f7a6
-  data.tar.gz: 148130fcfc88301609302815eb212e9648010c83
+  metadata.gz: c54e88d54866fd6a2b4f084d3e07cd8bf79cad9a
+  data.tar.gz: 64124d0bc34c1beca634a2a5791b441f64bba35a
 SHA512:
-  metadata.gz: 7c70c25c510e5f0dde0cfee605a23f5cd733d8438d91235d9d9bbf14f31a631d9819be0cd0068113e7f694218feba63ff9cf462fd57562e55858a4970e7cf5d7
-  data.tar.gz: a35bcaf8270fe29a219322e88144b391681488ceee3927dc21343fa4a14af0e34d1642e19002626ac8fcc051818ef8d5e04732bc1022beda0b73ad8a3ea4e816
+  metadata.gz: d2ab23a176b61a530f96e8d36d62e45084504a8e14402d8c7e96a22f3cb4275823503a04c540aff93c3a0a56f27d47bf4a276305c6fcd9dc395f39a46f7ab443
+  data.tar.gz: 8ff3671d090084ae55b0f3151632de1703a99f0fb89a4fc996504b7af1c06cd874b38110cbc7e31c241067581de750060247b21c75607a0248845a0a905ed14b

data/README.md

@@ -2,3 +2,18 @@ hash-selectors
 ==============
 
 A small set of select methods for Ruby Hashes
+
+# select_by...
+{a: 1, b: 2, c: 3}.select_by_keys :a, :b # returns {a: 1, b: 2}
+
+{a: 1, b: 2, c: 3}.select_by_values 1, 3 # returns {a: 1, c: 3}
+
+# reject_by...
+{a: 1, b: 2, c: 3}.reject_by_keys :c  # returns {a: 1, b: 2}
+
+{a: 1, b: 2, c: 3}.reject_by_values 2 # returns {a: 1, c: 3}
+
+# partition_by...
+{a: 1, b: 2, c: 3}.partition_by_keys :a, :b # returns [{a: 1, b: 2}, {c: 3}]
+
+{a: 1, b: 2, c: 3}.partition_by_values 1, 3 # returns [{a: 1, c: 3}, {b: 2}]

data/lib/hash_selectors.rb

@@ -2,6 +2,46 @@
 # Automatically mixed-in to Hash on load.
 module HashSelectors
 
+  # @example
+  #   {a: 1, b: 2, c: 3}.partition_by_keys :a, :b # returns [{a: 1, b: 2}, {c: 3}]
+  #
+  # @param [Glob of any type] ks
+  # @return [Hash] Partitioned results based on whether keys are included within the *ks* argument.
+  def partition_by_keys(*ks)
+    ### OPTIMIZE: Simple partition with the block results in nested Arrays. Investigate.
+    blk = lambda { |k,v| ks.include?(k) }
+    [select(&blk), reject(&blk)]
+  end
+
+  # @example
+  #   {a: 1, b: 2, c: 3}.partition_by_values 2, 3 # returns [{b: 2, c: 3}, {a: 1}]
+  #
+  # @param [Glob of any type] vs
+  # @return [Hash] Partitioned results based on whether values are included within the *vs* argument.
+  def partition_by_values(*vs)
+    ### OPTIMIZE: Simple partition with the block results in nested Arrays. Investigate.
+    blk = lambda { |k,v| vs.include?(v) }
+    [select(&blk), reject(&blk)]
+  end
+
+  # @example
+  #   {a: 1, b: 2, c: 3}.reject_by_keys :a, :b # returns {c: 3}
+  #
+  # @param [Glob of any type] ks
+  # @return [Hash] That subset of the Hash whose keys are not found within the *ks* argument.
+  def reject_by_keys(*ks)
+    reject { |k,v| ks.include?(k) }
+  end
+
+  # @example
+  #   {a: 1, b: 2, c: 3}.reject_by_values 2, 3 # returns {a: 1}
+  #
+  # @param [Glob of any type] vs
+  # @return [Hash] That subset of the Hash whose values are not found within the *vs* argument.
+  def reject_by_values(*vs)
+    reject { |k,v| vs.include?(v) }
+  end
+
   # @example
   #   {a: 1, b: 2, c: 3}.select_by_keys :a, :b # returns {a: 1, b: 2}
   #

data/spec/hash_selectors_spec.rb

@@ -7,6 +7,62 @@ RSpec.describe HashSelectors do
 
   ### INSTANCE METHODS
 
+  describe "#partition_by_keys" do
+    context "assuming a Hash: {a: 1, b: 2, c: {c2: [:d, :e]}}" do
+      let(:the_hash) { {a: 1, b: 2, c: {c2: [:d, :e]}} }
+      context "and given :a, :d" do
+        subject { the_hash.partition_by_keys :a, :d }
+        it { is_expected.to eq([{a: 1}, {b: 2, c: {c2: [:d, :e]}}]) }
+      end
+      context "and given :a, :b" do
+        subject { the_hash.partition_by_keys :a, :b }
+        it { is_expected.to eq([{a: 1, b: 2}, {c: {c2: [:d, :e]}}]) }
+      end
+      context "and given :b, :c" do
+        subject { the_hash.partition_by_keys :b, :c }
+        it { is_expected.to eq([{b: 2, c: {c2: [:d, :e]}}, {a: 1}]) }
+      end
+    end
+  end
+
+  describe "#partition_by_values" do
+    context "assuming a Hash: {a: 1, b: 2, c: {c2: [:d, :e]}}" do
+      let(:the_hash) { {a: 1, b: 2, c: {c2: [:d, :e]}} }
+      context "and given 1, 2" do
+        subject { the_hash.partition_by_values 1, 2 }
+        it { is_expected.to eq([{a: 1, b: 2}, {c: {c2: [:d, :e]}}]) }
+      end
+    end
+  end
+
+  describe "#reject_by_keys" do
+    context "assuming a Hash: {a: 1, b: 2, c: {c2: [:d, :e]}}" do
+      let(:the_hash) { {a: 1, b: 2, c: {c2: [:d, :e]}} }
+      context "and given :a, :d" do
+        subject { the_hash.reject_by_keys :a, :d }
+        it { is_expected.to eq({b: 2, c: {c2: [:d, :e]}}) }
+      end
+      context "and given :a, :b" do
+        subject { the_hash.reject_by_keys :a, :b }
+        it { is_expected.to eq({c: {c2: [:d, :e]}}) }
+      end
+      context "and given :b, :c" do
+        subject { the_hash.reject_by_keys :b, :c }
+        it { is_expected.to eq({a: 1}) }
+      end
+    end
+  end
+
+  describe "#reject_by_values" do
+    context "assuming a Hash: {a: 1, b: 2, c: {c2: [:d, :e]}}" do
+      let(:the_hash) { {a: 1, b: 2, c: {c2: [:d, :e]}} }
+      context "and given 1, 2" do
+        subject { the_hash.reject_by_values 1, 2 }
+        it { is_expected.to eq({c: {c2: [:d, :e]}}) }
+      end
+    end
+  end
+
   describe "#select_by_keys" do
     context "assuming a Hash: {a: 1, b: 2, c: {c2: [:d, :e]}}" do
       let(:the_hash) { {a: 1, b: 2, c: {c2: [:d, :e]}} }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hash_selectors
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Kevin C. Baird
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-11 00:00:00.000000000 Z
+date: 2014-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec