Last Modified
2010-09-08 20:18:01 +0900
Requires

Description

Mash 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 Mash will look at the methods you pass it and perform operations based on the following rules:

Basic Example

   
  mash = Mash.new
  mash.name? # => false
  mash.name = "Bob"
  mash.name # => "Bob"
  mash.name? # => true

Hash Conversion Example

  
  hash = {:a => {:b => 23, :d => {:e => "abc"}}, :f => [{:g => 44, :h => 29}, 12]}
  mash = Mash.new(hash)
  mash.a.b # => 23
  mash.a.d.e # => "abc"
  mash.f.first.g # => 44
  mash.f.last # => 12

Bang Example

  mash = Mash.new
  mash.author # => nil
  mash.author! # => <Mash>
  
  mash = Mash.new
  mash.author!.name = "Michael Bleigh"
  mash.author # => <Mash name="Michael Bleigh">