hash-keys 1.0.0

data/Rakefile

@@ -0,0 +1,113 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}/version.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Custom tasks
+#
+#############################################################################
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  #replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/hash-keys.gemspec

@@ -0,0 +1,29 @@
+#$:.push File.expand_path("../lib", __FILE__)
+#require "hash-keys/version"
+
+Gem::Specification.new do |s|
+  s.name              = 'hash-keys'
+  s.version           = '1.0.0'
+  s.date              = '2011-09-14'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Lee Henson', 'Guy Boertje']
+  s.email       = ['lee.m.henson@gmail.com', 'guyboertje@gmail.com']
+  s.homepage    = ""
+  s.summary     = %q{}
+  s.description = %q{}
+  ## Leave this section as-is. It will be automatically generated from the
+  ## contents of your Git repository via the gemspec task. DO NOT REMOVE
+  ## THE MANIFEST COMMENTS, they are used as delimiters by the task.
+  # = MANIFEST =
+  s.files = %w[
+    Rakefile
+    hash-keys.gemspec
+    lib/hash-keys.rb
+    lib/hash-keys/version.rb
+  ]
+  # = MANIFEST =
+
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/hash-keys.rb

@@ -0,0 +1,133 @@
+module HashKeys
+  def has_keys?(*keys)
+    !keys.any? { |key| !self.has_key? key }
+  end
+end
+
+module HashKeysRmerge
+  # Recursive merge functions by Simone Carletti
+  # MIT License
+  # See: https://gist.github.com/6391
+  #
+  # Recursive version of Hash#merge!
+  #
+  # Adds the contents of +other_hash+ to +hsh+,
+  # merging entries in +hsh+ with duplicate keys with those from +other_hash+.
+  #
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  #
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge!(h2)   #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #
+  # Simply using Hash#merge! would return
+  #
+  #    h1.merge!(h2)    #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  #
+  def rmerge!(other_hash)
+    merge!(other_hash) do |key, oldval, newval|
+      oldval.class == self.class ? oldval.rmerge!(newval) : newval
+    end
+  end
+
+  #
+  # Recursive version of Hash#merge
+  #
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  #
+  # Compared with Hash#merge, this method provides a different approch
+  # for merging nasted hashes.
+  # If the value of a given key is an Hash and both +other_hash+ abd +hsh
+  # includes the same key, the value is merged instead replaced with
+  # +other_hash+ value.
+  #
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge(h2)    #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #
+  # Simply using Hash#merge would return
+  #
+  #    h1.merge(h2)     #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  #
+  def rmerge(other_hash)
+    r = {}
+    merge(other_hash) do |key, oldval, newval|
+      r[key] = oldval.class == self.class ? oldval.rmerge(newval) : newval
+    end
+  end
+end
+
+module HashKeysString
+  # Return a new hash with all keys converted to strings.
+  def stringify__keys
+    dup.stringify__keys!
+  end
+  alias_method :stringify_keys,  :stringify__keys
+
+  # Destructively convert all keys to strings.
+  def stringify__keys!
+    keys.each do |key|
+      self[key.to_s] = delete(key)
+    end
+    self
+  end
+  alias_method :stringify_keys!,  :stringify__keys!
+
+  def stringify__symbol__values!
+    keys.each do |key|
+      self[key] = self[key].to_s if self[key].is_a? Symbol
+    end
+    self
+  end
+  alias_method :stringify_symbol_values!,  :stringify__symbol__values!
+
+  def recursive__stringify__keys!
+    stringify_keys!
+    values.select{|v| v.is_a? Hash}.each{|h| h.recursive__stringify__keys!}
+    self
+  end
+  alias_method :recursive_stringify_keys!,  :recursive__stringify__keys!
+
+  def recursive__stringify__symbol__values!
+    stringify__symbol__values!
+    values.select{|v| v.is_a? Hash}.each{|h| h.recursive__stringify__symbol__values!}
+    self
+  end
+  alias_method :recursive_stringify_symbol_values!,  :recursive__stringify__symbol__values!
+end
+
+module HashKeysSymbol
+  # Return a new hash with all keys converted to symbols, as long as
+  # they respond to +to_sym+.
+  def symbolize__keys
+    dup.symbolize__keys!
+  end
+  alias_method :symbolize_keys,  :symbolize__keys
+  alias_method :to_options,  :symbolize__keys
+  # Destructively convert all keys to symbols, as long as they respond
+  # to +to_sym+.
+  def symbolize__keys!
+    keys.each do |key|
+      self[(key.to_sym rescue key) || key] = delete(key)
+    end
+    self
+  end
+  alias_method :symbolize_keys!, :symbolize__keys!
+  alias_method :to_options!, :symbolize__keys!
+
+  def recursive__symbolize__keys!
+    symbolize__keys!
+    values.select{|v| v.is_a? Hash}.each{|h| h.recursive__symbolize__keys!}
+    self
+  end
+  alias_method :recursive_symbolize_keys!,  :recursive__symbolize__keys!
+end
+
+Hash.send(:include, HashKeys) unless Hash.respond_to? :has_keys?
+Hash.send(:include, HashKeysRmerge) unless Hash.respond_to? :rmerge!
+Hash.send(:include, HashKeysString) unless Hash.respond_to? :stringify__keys!
+Hash.send(:include, HashKeysSymbol) unless Hash.respond_to? :symbolize__keys!

data/lib/hash-keys/version.rb

@@ -0,0 +1,3 @@
+module HashKeys
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: hash-keys
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Lee Henson
+- Guy Boertje
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-14 00:00:00.000000000 Z
+dependencies: []
+description: ''
+email:
+- lee.m.henson@gmail.com
+- guyboertje@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- hash-keys.gemspec
+- lib/hash-keys.rb
+- lib/hash-keys/version.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: ''
+test_files: []