hash-zip 0.1.20170628

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3b0b1c5b98183dd893256d7d8c198cde2b3db20a
+  data.tar.gz: 7ae7a02a3dce79af2d4a491357b662c6239b7fc5
+SHA512:
+  metadata.gz: ac4ae7d21866bd55951aa50f84c6c8c07dc46f3c2425c7b36407141d852fbc37367d501be6799c39a4a246468fab85a7e573cd4b72293c0795f152180a00baaa
+  data.tar.gz: 6b8700e6c0477c08f24058c1c67f6e964cb720da9fbd948c0819cc1cb64b7e57532a0711999331e7d1c698f2e18de8cdcc0e053c9fe1fe9f46c0f5271a9c65f7

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/README.md

@@ -0,0 +1,29 @@
+Implements a much needed `Hash#zip` method.
+
+## Usage
+
+You can zip multiple Hashes. Keys in result will be keys in any of the inputs, and values will be Arrays with missing values padded by `nil`s.
+
+```ruby
+a = {x: 1, y: 2}
+b = {y: 3, z: 4}
+a.zip(b)
+# returns {x: [1, nil], y: [2, 3], z: [nil, 4]}
+```
+
+You can also use it with a block. In such case the return value is `nil`:
+
+```ruby
+a = {x: 1, y: 2}
+b = {y: 3, z: 4}
+a.zip(b) do |key, value_a, value_b|
+  p [key, value_a, value_b]
+  # Yields [:x, 1, nil]
+  #        [:y, 2, 3]
+  #        [:z, nil, 4]
+end
+```
+
+It works with more than one argument (`a.zip(b,c)`) as well as with zero arguments (`a.zip()`).
+
+If arguments are not `Hash`es, but accept `to_h`, they will be converted automatically before zipping.

data/Rakefile

@@ -0,0 +1,23 @@
+task "default" => "spec"
+task "test" => "spec"
+
+desc "Run tests"
+task "spec" do
+  system "rspec"
+end
+
+desc "Clean up"
+task "clean" do
+  system "trash hash-zip-*.gem"
+end
+
+desc "Build gem"
+task "gem:build" do
+  system "gem build hash-zip.gemspec"
+end
+
+desc "Upload gem"
+task "gem:push" => "gem:build" do
+  gem_file = Dir["hash-zip-*.gem"][-1] or raise "No gem found"
+  system "gem", "push", gem_file
+end

data/lib/hash-zip.rb

@@ -0,0 +1,26 @@
+# Enumerable#zip is nonsense when applied to Hashes
+class Hash
+  def zip(*args)
+    sources = [self]
+    args.each do |arg|
+      if arg.is_a?(Hash)
+        sources << arg
+      else
+        sources << arg.to_h
+      end
+    end
+    output_keys = sources.flat_map(&:keys).uniq
+    if block_given?
+      output_keys.each do |key|
+        yield(key, *sources.map{|source| source[key]})
+      end
+      nil
+    else
+      result = {}
+      output_keys.each do |key|
+        result[key] = sources.map{|source| source[key]}
+      end
+      result
+    end
+  end
+end

data/spec/hash_zip_spec.rb

@@ -0,0 +1,61 @@
+require "ostruct"
+
+describe "Hash#zip" do
+  it "zips itself" do
+    a = {x: 1,
+      y: 2, z: 3}
+    expect(a.zip).to eq({
+      x: [1], y: [2], z: [3]
+    })
+  end
+
+  it "zips two Hashes" do
+    a = {x: 1, y: 2, z: 3}
+    b = {x: 4, z: 5, w: 6}
+    expect(a.zip(b)).to eq({
+      x: [1,4], y: [2,nil], z: [3,5], w: [nil,6]
+    })
+  end
+
+  it "zips multiple Hashes, in source order" do
+    a = {a: 1, ab: 2, ac: 3, abc: 4 }
+    b = {b: 5, ab: 6, bc: 7, abc: 8 }
+    c = {c: 9, ac: 10, bc: 11, abc: 12 }
+    expect(a.zip(b, c)).to eq({
+      # All 7 cobinations
+      a:  [1,nil,nil],
+      b:  [nil,5,nil],
+      c:  [nil,nil,9],
+      ab: [2,6,nil],
+      ac: [3,nil,10],
+      bc: [nil,7,11],
+      abc: [4,8,12],
+    })
+    expect(a.zip(b, c).keys).to eq([
+      :a, :ab, :ac, :abc, :b, :bc, :c
+    ])
+  end
+
+  it "returns nil and yields for each item when passed a block" do
+    a = {x: 1, y: 2, z: 3}
+    b = {x: 4, z: 5, w: 6}
+    calls = []
+    expect(a.zip(b){|*args|
+      calls << args
+    }).to eq(nil)
+    expect(calls).to eq([
+      [:x, 1, 4],
+      [:y, 2, nil],
+      [:z, 3, 5],
+      [:w, nil, 6],
+    ])
+  end
+
+  it "converts other arguments to Hashes" do
+    a = {x: 1, y: 2, z: 3}
+    b = OpenStruct.new(x: 4, z: 5, w: 6)
+    expect(a.zip(b)).to eq({
+      x: [1,4], y: [2,nil], z: [3,5], w: [nil,6]
+    })
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require_relative "../lib/hash-zip"
+
+RSpec.configure do |config|
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: hash-zip
+version: !ruby/object:Gem::Version
+  version: 0.1.20170628
+platform: ruby
+authors:
+- Tomasz Wegrzanowski
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Zip two or more Hashes
+email: Tomasz.Wegrzanowski@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- README.md
+- Rakefile
+- lib/hash-zip.rb
+- spec/hash_zip_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/taw/hash-zip
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Hash#zip method
+test_files: []