peterpunk-mhash 0.0.8

data/History.txt

@@ -0,0 +1,30 @@
+=== 0.0.9 / 2008-09-01
+
+* Rename the class to Mhash to avoid Merb Mash class conflict.
+
+=== 0.0.5 / 2008-04-29
+
+* [bugfix] Mashes do not infinite loop when initialized with another Mash.
+
+=== 0.0.4 / 2008-04-25
+
+* Setting up for GitHub gem hosting instead of Rubyforge.
+
+=== 0.0.3 / 2008-04-19
+
+* [] no longer defaults to a new Mash, will return nil if
+* Attribute-esque method names will yield the default value if not set
+* Hash extended with #to_mash and #stringify_keys
+* Added #dup and #deep_merge
+* Aliased the default Hash methods so they are still accessible
+* Cleaned up the recursive conversion process
+
+=== 0.0.2 / 2008-04-12
+
+* Added bang(!) method support
+* No longer automatically multi-level assigning
+* Hash conversion now calls methods instead of []= to allow for overrides
+
+=== 0.0.1 / 2008-04-12
+
+* Initial release

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/mhash.rb
+spec/mhash_spec.rb
+spec/spec_helper.rb

data/README.txt

@@ -0,0 +1,69 @@
+= Mhash (Mocking Hash)
+
+http://github.com/mbleigh/mhash
+
+== DESCRIPTION:
+
+Mhash is an extended Hash that gives simple pseudo-object functionality
+that can be built from hashes and easily extended. It is designed to
+be used in RESTful API libraries to provide easy object-like access 
+to JSON and XML parsed hashes.
+
+== SYNOPSIS:
+  
+  mhash = Mhash.new
+  mhash.name? # => false
+  mhash.name # => nil
+  mhash.name = "My Mhash"
+  mhash.name # => "My Mhash"
+  mhash.name? # => true
+  mhash.inspect # => <Mhash name="My Mhash">
+  
+  mhash = Mhash.new
+  # use bang methods for multi-level assignment
+  mhash.author!.name = "Michael Bleigh"
+  mhash.author # => <Mhash name="Michael Bleigh">
+
+== INSTALL:
+
+Gem:
+
+Mhash is hosted on the GitHub gem repository, so if you haven't already:
+
+  gem sources -a http://gems.github.com/  
+  sudo gem install mbleigh-mhash
+  
+Git:
+
+  git clone git://github.com/mbleigh/mhash.git
+  
+== RESOURCES
+
+If you encounter any problems or have ideas for new features 
+please report them at the Lighthouse project for Mhash: 
+
+http://mbleigh.lighthouseapp.com/projects/10112-mash
+
+== LICENSE:
+
+Copyright (c) 2008 Michael Bleigh (http://mbleigh.com/) 
+and Intridea Inc. (http://intridea.com/), released under the MIT license
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rubygems'
+require './lib/mhash.rb'
+require 'spec/rake/spectask'
+
+desc "Run specs."
+Spec::Rake::SpecTask.new("spec") do |t|
+  t.spec_files = "spec/*_spec.rb"
+end

data/lib/mhash.rb

@@ -0,0 +1,228 @@
+# Mhash allows you to create pseudo-objects that have method-like
+# accessors for hash keys. This is useful for such implementations
+# as an API-accessing library that wants to fake robust objects
+# without the overhead of actually doing so. Think of it as OpenStruct
+# with some additional goodies.
+#
+# A Mhash will look at the methods you pass it and perform operations
+# based on the following rules:
+# 
+# * No punctuation: Returns the value of the hash for that key, or nil if none exists.
+# * Assignment (<tt>=</tt>): Sets the attribute of the given method name.
+# * Existence (<tt>?</tt>): Returns true or false depending on whether that key has been set.
+# * Bang (<tt>!</tt>): Forces the existence of this key, used for deep Mhashes. Think of it as "touch" for mhashes.
+#
+# == Basic Example
+#    
+#   mhash = Mhash.new
+#   mhash.name? # => false
+#   mhash.name = "Bob"
+#   mhash.name # => "Bob"
+#   mhash.name? # => true
+#
+# == Hash Conversion  Example
+#   
+#   hash = {:a => {:b => 23, :d => {:e => "abc"}}, :f => [{:g => 44, :h => 29}, 12]}
+#   mhash = Mhash.new(hash)
+#   mhash.a.b # => 23
+#   mhash.a.d.e # => "abc"
+#   mhash.f.first.g # => 44
+#   mhash.f.last # => 12
+#
+# == Bang Example
+#
+#   mhash = Mhash.new
+#   mhash.author # => nil
+#   mhash.author! # => <Mhash>
+#   
+#   mhash = Mhash.new
+#   mhash.author!.name = "Michael Bleigh"
+#   mhash.author # => <Mhash name="Michael Bleigh">
+#
+class Mhash < Hash
+  # If you pass in an existing hash, it will
+  # convert it to a Mhash including recursively
+  # descending into arrays and hashes, converting
+  # them as well.
+  def initialize(source_hash = nil, &blk)
+    deep_update(source_hash) if source_hash
+    super(&blk)
+  end
+  
+  class << self; alias [] new; end
+
+  def id #:nodoc:
+    self["id"] ? self["id"] : super
+  end
+  
+  # Borrowed from Merb's Mhash object.
+  #
+  # ==== Parameters
+  # key<Object>:: The default value for the mhash. Defaults to nil.
+  #
+  # ==== Alternatives
+  # If key is a Symbol and it is a key in the mhash, then the default value will
+  # be set to the value matching the key.
+  def default(key = nil) 
+    if key.is_a?(Symbol) && key?(key) 
+      self[key] 
+    else 
+      key ? super : super()
+    end 
+  end
+  
+  alias_method :regular_reader, :[]
+  alias_method :regular_writer, :[]=
+  
+  # Retrieves an attribute set in the Mhash. Will convert
+  # any key passed in to a string before retrieving.
+  def [](key)
+    key = convert_key(key)
+    regular_reader(key)
+  end
+  
+  # Sets an attribute in the Mhash. Key will be converted to
+  # a string before it is set.
+  def []=(key,value) #:nodoc:
+    key = convert_key(key)
+    regular_writer(key,convert_value(value))
+  end
+  
+  # This is the bang method reader, it will return a new Mhash
+  # if there isn't a value already assigned to the key requested.
+  def initializing_reader(key)
+    return self[key] if key?(key)
+    self[key] = Mhash.new
+  end
+  
+  alias_method :regular_dup, :dup  
+  # Duplicates the current mhash as a new mhash.
+  def dup
+    Mhash.new(self)
+  end
+  
+  alias_method :picky_key?, :key?
+  def key?(key)
+    picky_key?(convert_key(key))
+  end
+  
+  alias_method :regular_inspect, :inspect  
+  # Prints out a pretty object-like string of the
+  # defined attributes.
+  def inspect
+    ret = "<#{self.class.to_s}"
+    keys.sort.each do |key|
+      ret << " #{key}=#{self[key].inspect}"
+    end
+    ret << ">"
+    ret
+  end
+  alias_method :to_s, :inspect
+  
+  # Performs a deep_update on a duplicate of the
+  # current mhash.
+  def deep_merge(other_hash)
+    dup.deep_merge!(other_hash)
+  end
+  
+  # Recursively merges this mhash with the passed
+  # in hash, merging each hash in the hierarchy.
+  def deep_update(other_hash)
+    other_hash = other_hash.to_hash if other_hash.is_a?(Mhash)
+    other_hash = other_hash.stringify_keys
+    other_hash.each_pair do |k,v|
+      k = convert_key(k)
+      self[k] = self[k].to_mhash if self[k].is_a?(Hash) unless self[k].is_a?(Mhash)
+      if self[k].is_a?(Hash) && other_hash[k].is_a?(Hash)
+        self[k] = self[k].deep_merge(other_hash[k]).dup
+      else
+        self.send(k + "=", convert_value(other_hash[k],true))
+      end
+    end
+  end
+  alias_method :deep_merge!, :deep_update
+  
+  # ==== Parameters
+  # other_hash<Hash>::
+  # A hash to update values in the mhash with. Keys will be
+  # stringified and Hashes will be converted to Mhashes.
+  #
+  # ==== Returns
+  # Mhash:: The updated mhash.
+  def update(other_hash)
+    other_hash.each_pair do |key, value|
+      if respond_to?(convert_key(key) + "=")
+        self.send(convert_key(key) + "=", convert_value(value))
+      else
+        regular_writer(convert_key(key), convert_value(value))
+      end
+    end
+    self
+  end
+  alias_method :merge!, :update
+  
+  # Converts a mhash back to a hash (with stringified keys)
+  def to_hash
+    Hash.new(default).merge(self)
+  end
+  
+  def method_missing(method_name, *args) #:nodoc:
+    if (match = method_name.to_s.match(/(.*)=$/)) && args.size == 1
+      self[match[1]] = args.first
+    elsif (match = method_name.to_s.match(/(.*)\?$/)) && args.size == 0
+      key?(match[1])
+    elsif (match = method_name.to_s.match(/(.*)!$/)) && args.size == 0
+      initializing_reader(match[1])
+    elsif key?(method_name)
+      self[method_name]
+    elsif match = method_name.to_s.match(/^([a-z][a-z0-9A-Z_]+)$/)
+      default(method_name)
+    else
+      super
+    end
+  end
+  
+  protected
+  
+  def convert_key(key) #:nodoc:
+    key.to_s
+  end
+  
+  def convert_value(value, dup=false) #:nodoc:
+    case value
+      when Hash
+        value = value.dup if value.is_a?(Mhash) && dup
+        value.is_a?(Mhash) ? value : value.to_mhash
+      when Array
+        value.collect{ |e| convert_value(e) }
+      else
+        value
+    end
+  end
+end
+
+class Hash
+  # Returns a new Mhash initialized from this Hash.
+  def to_mhash
+    mhash = Mhash.new(self)
+    mhash.default = default
+    mhash
+  end
+  
+  # Returns a duplicate of the current hash with
+  # all of the keys converted to strings.
+  def stringify_keys
+    dup.stringify_keys!
+  end
+  
+  # Converts all of the keys to strings
+  def stringify_keys!
+    keys.each{|k| 
+      v = delete(k)
+      self[k.to_s] = v
+      v.stringify_keys! if v.is_a?(Hash)
+      v.each{|p| p.stringify_keys! if p.is_a?(Hash)} if v.is_a?(Array)
+    }
+    self
+  end
+end

data/mhash.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name = "mhash"
+  s.version = "0.0.8"
+  s.date = "2008-07-22"
+  s.summary = "An extended Hash that gives simple pseudo-object functionality that can be built from hashes and easily extended"  
+  s.email = "michael@intridea.com"
+  s.homepage = "http://github.com/peterpunk/mhash"
+  s.summary = "Mhash is an extended Hash that gives simple pseudo-object functionality that can be built from hashes and easily extended"  
+  s.has_rdoc = true
+  s.authors = ["Michael Bleigh"]
+  s.files = ["History.txt", "Manifest.txt", "README.txt", "Rakefile", "mhash.gemspec", "lib/mhash.rb", "spec/mhash_spec.rb","spec/spec_helper.rb"]
+  s.rdoc_options = ["--main", "README.txt"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+end

data/spec/mhash_spec.rb

@@ -0,0 +1,139 @@
+require File.join(File.dirname(__FILE__),"..","lib","mhash")
+require File.join(File.dirname(__FILE__),"spec_helper")
+
+describe Mhash do
+  before(:each) do
+    @mhash = Mhash.new
+  end
+  
+  it "should inherit from hash" do
+    @mhash.is_a?(Hash).should be_true
+  end
+  
+  it "should be able to set hash values through method= calls" do
+    @mhash.test = "abc"
+    @mhash["test"].should == "abc"
+  end
+  
+  it "should be able to retrieve set values through method calls" do
+    @mhash["test"] = "abc"
+    @mhash.test.should == "abc"
+  end
+  
+  it "should test for already set values when passed a ? method" do
+    @mhash.test?.should be_false
+    @mhash.test = "abc"
+    @mhash.test?.should be_true
+  end
+  
+  it "should make all [] and []= into strings for consistency" do
+    @mhash["abc"] = 123
+    @mhash.key?('abc').should be_true
+    @mhash["abc"].should == 123
+  end
+  
+  it "should have a to_s that is identical to its inspect" do
+    @mhash.abc = 123
+    @mhash.to_s.should == @mhash.inspect
+  end
+  
+  it "should return nil instead of raising an error for attribute-esque method calls" do
+    @mhash.abc.should be_nil
+  end
+  
+  it "should return a Mash when passed a bang method to a non-existenct key" do
+    @mhash.abc!.is_a?(Mhash).should be_true
+  end
+  
+  it "should return the existing value when passed a bang method for an existing key" do
+    @mhash.name = "Bob"
+    @mhash.name!.should == "Bob"
+  end
+  
+  it "#initializing_reader should return a Mhash when passed a non-existent key" do
+    @mhash.initializing_reader(:abc).is_a?(Mhash).should be_true
+  end
+  
+  it "should allow for multi-level assignment through bang methods" do
+    @mhash.author!.name = "Michael Bleigh"
+    @mhash.author.should == Mhash.new(:name => "Michael Bleigh")
+    @mhash.author!.website!.url = "http://www.mbleigh.com/"
+    @mhash.author.website.should == Mhash.new(:url => "http://www.mbleigh.com/")
+  end
+  
+  it "#deep_update should recursively mhash mhashes and hashes together" do
+    @mhash.first_name = "Michael"
+    @mhash.last_name = "Bleigh"
+    @mhash.details = {:email => "michael@asf.com"}.to_mhash
+    @mhash.deep_update({:details => {:email => "michael@intridea.com"}})
+    @mhash.details.email.should == "michael@intridea.com"
+  end
+  
+  it "should convert hash assignments into mhashes" do
+    @mhash.details = {:email => 'randy@asf.com', :address => {:state => 'TX'} }
+    @mhash.details.email.should == 'randy@asf.com'
+    @mhash.details.address.state.should == 'TX'
+  end
+  
+  context "#initialize" do
+    it "should convert an existing hash to a Mhash" do
+      converted = Mhash.new({:abc => 123, :name => "Bob"})
+      converted.abc.should == 123
+      converted.name.should == "Bob"
+    end
+  
+    it "should convert hashes recursively into mhashes" do
+      converted = Mhash.new({:a => {:b => 1, :c => {:d => 23}}})
+      converted.a.is_a?(Mhash).should be_true
+      converted.a.b.should == 1
+      converted.a.c.d.should == 23
+    end
+  
+    it "should convert hashes in arrays into mhashes" do
+      converted = Mhash.new({:a => [{:b => 12}, 23]})
+      converted.a.first.b.should == 12
+      converted.a.last.should == 23
+    end
+    
+    it "should convert an existing Mhash into a Mhash" do
+      initial = Mhash.new(:name => 'randy', :address => {:state => 'TX'})
+      copy = Mhash.new(initial)
+      initial.name.should == copy.name      
+      initial.object_id.should_not == copy.object_id
+      copy.address.state.should == 'TX'
+      copy.address.state = 'MI'
+      initial.address.state.should == 'TX'
+      copy.address.object_id.should_not == initial.address.object_id
+    end
+    
+    it "should accept a default block" do
+      initial = Mhash.new { |h,i| h[i] = []}
+      initial.default_proc.should_not be_nil
+      initial.default.should be_nil
+      initial.test.should == []
+      initial.test?.should be_true
+    end
+  end
+end
+
+describe Hash do
+  it "should be convertible to a Mhash" do
+    mhash = {:some => "hash"}.to_mhash
+    mhash.is_a?(Mhash).should be_true
+    mhash.some.should == "hash"
+  end
+  
+  it "#stringify_keys! should turn all keys into strings" do
+    hash = {:a => "hey", 123 => "bob"}
+    hash.stringify_keys!
+    hash.should == {"a" => "hey", "123" => "bob"}
+  end
+  
+  it "#stringify_keys should return a hash with stringified keys" do
+    hash = {:a => "hey", 123 => "bob"}
+    stringified_hash = hash.stringify_keys
+    hash.should == {:a => "hey", 123 => "bob"}
+    stringified_hash.should == {"a" => "hey", "123" => "bob"}
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__),"..","lib","mhash")

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: peterpunk-mhash
+version: !ruby/object:Gem::Version 
+  version: 0.0.8
+platform: ruby
+authors: 
+- Michael Bleigh
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-22 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: michael@intridea.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- mhash.gemspec
+- lib/mhash.rb
+- spec/mhash_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/peterpunk/mhash
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Mhash is an extended Hash that gives simple pseudo-object functionality that can be built from hashes and easily extended
+test_files: []
+