putio 0.0.1.pre

data/development/ruby/1.8/gems/hashie-0.4.0/lib/hashie/mash.rb

@@ -0,0 +1,178 @@
+require 'hashie/hash'
+
+module Hashie
+  # 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:
+  #
+  # * 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 Mashes. Think of it as "touch" for mashes.
+  #
+  # == 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">
+  #
+  class Mash < Hashie::Hash
+    include Hashie::PrettyInspect
+    alias_method :to_s, :inspect
+
+    # If you pass in an existing hash, it will
+    # convert it to a Mash including recursively
+    # descending into arrays and hashes, converting
+    # them as well.
+    def initialize(source_hash = nil, default = nil, &blk)
+      deep_update(source_hash) if source_hash
+      default ? super(default) : super(&blk)
+    end
+
+    class << self; alias [] new; end
+
+    def id #:nodoc:
+      key?("id") ? self["id"] : super
+    end
+
+    alias_method :regular_reader, :[]
+    alias_method :regular_writer, :[]=
+
+    # Retrieves an attribute set in the Mash. Will convert
+    # any key passed in to a string before retrieving.
+    def [](key)
+      regular_reader(convert_key(key))
+    end
+
+    # Sets an attribute in the Mash. Key will be converted to
+    # a string before it is set, and Hashes will be converted
+    # into Mashes for nesting purposes.
+    def []=(key,value) #:nodoc:
+      regular_writer(convert_key(key), convert_value(value))
+    end
+
+    # This is the bang method reader, it will return a new Mash
+    # if there isn't a value already assigned to the key requested.
+    def initializing_reader(key)
+      ck = convert_key(key)
+      regular_writer(ck, self.class.new) unless key?(ck)
+      regular_reader(ck)
+    end
+
+    alias_method :regular_dup, :dup
+    # Duplicates the current mash as a new mash.
+    def dup
+      self.class.new(self, self.default)
+    end
+
+    def key?(key)
+      super(convert_key(key))
+    end
+
+    # Performs a deep_update on a duplicate of the
+    # current mash.
+    def deep_merge(other_hash)
+      dup.deep_update(other_hash)
+    end
+    alias_method :merge, :deep_merge
+
+    # Recursively merges this mash with the passed
+    # in hash, merging each hash in the hierarchy.
+    def deep_update(other_hash)
+      other_hash.each_pair do |k,v|
+        key = convert_key(k)
+        if regular_reader(key).is_a?(Mash) and v.is_a?(::Hash)
+          regular_reader(key).deep_update(v)
+        else
+          regular_writer(key, convert_value(v, true))
+        end
+      end
+      self
+    end
+    alias_method :deep_merge!, :deep_update
+    alias_method :update, :deep_update
+    alias_method :merge!, :update
+
+    # Performs a shallow_update on a duplicate of the current mash
+    def shallow_merge(other_hash)
+      dup.shallow_update(other_hash)
+    end
+
+    # Merges (non-recursively) the hash from the argument,
+    # changing the receiving hash
+    def shallow_update(other_hash)
+      other_hash.each_pair do |k,v|
+        regular_writer(convert_key(k), convert_value(v, true))
+      end
+      self
+    end
+
+   # Will return true if the Mash has had a key
+   # set in addition to normal respond_to? functionality.
+   def respond_to?(method_name)
+     return true if key?(method_name)
+     super
+   end
+   
+   def method_missing(method_name, *args, &blk)
+     return self[method_name] if key?(method_name)
+     match = method_name.to_s.match(/(.*?)([?=!]?)$/)
+     case match[2]
+     when "="
+       self[match[1]] = args.first
+     when "?"
+       !!self[match[1]]
+     when "!"
+       initializing_reader(match[1])
+     else
+       default(method_name, *args, &blk)
+     end
+   end
+
+    protected
+
+    def convert_key(key) #:nodoc:
+      key.to_s
+    end
+
+    def convert_value(val, duping=false) #:nodoc:
+      case val
+        when self.class
+          val.dup
+        when ::Hash
+          val = val.dup if duping
+          self.class.new(val)
+        when Array
+          val.collect{ |e| convert_value(e) }
+        else
+          val
+      end
+    end
+  end
+end

data/development/ruby/1.8/gems/hashie-0.4.0/lib/hashie/trash.rb

@@ -0,0 +1,55 @@
+require 'hashie/dash'
+
+module Hashie
+  # A Trash is a 'translated' Dash where the keys can be remapped from a source
+  # hash.
+  #
+  # Trashes are useful when you need to read data from another application,
+  # such as a Java api, where the keys are named differently from how we would
+  # in Ruby.
+  class Trash < Hashie::Dash
+
+    # Defines a property on the Trash. Options are as follows:
+    #
+    # * <tt>:default</tt> - Specify a default value for this property, to be
+    # returned before a value is set on the property in a new Dash.
+    # * <tt>:from</tt> - Specify the original key name that will be write only.
+    def self.property(property_name, options = {})
+      super
+
+      if options[:from]
+        translations << options[:from].to_sym
+        class_eval <<-RUBY
+          def #{options[:from]}=(val)
+            self[:#{property_name}] = val
+          end
+        RUBY
+      end
+    end
+
+    # Set a value on the Dash in a Hash-like way. Only works
+    # on pre-existing properties.
+    def []=(property, value)
+      if self.class.translations.include? property.to_sym
+        send("#{property}=", value)
+      elsif property_exists? property
+        super
+      end
+    end
+
+    private
+
+    def self.translations
+      @translations ||= []
+    end
+
+    # Raises an NoMethodError if the property doesn't exist
+    #
+    def property_exists?(property)
+      unless self.class.property?(property.to_sym)
+        raise NoMethodError, "The property '#{property}' is not defined for this Trash."
+      end
+      true
+    end
+  end
+end

data/development/ruby/1.8/gems/hashie-0.4.0/lib/hashie.rb

@@ -0,0 +1,9 @@
+module Hashie
+  autoload :HashExtensions, 'hashie/hash_extensions'
+  autoload :PrettyInspect, 'hashie/hash_extensions'  
+  autoload :Hash, 'hashie/hash'
+  autoload :Trash, 'hashie/trash'
+  autoload :Mash, 'hashie/mash'
+  autoload :Dash, 'hashie/dash'
+  autoload :Clash, 'hashie/clash'
+end

data/development/ruby/1.8/gems/hashie-0.4.0/spec/hashie/clash_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe Hashie::Clash do
+  before do
+    @c = Hashie::Clash.new
+  end
+  
+  it 'should be able to set an attribute via method_missing' do
+    @c.foo('bar')
+    @c[:foo].should == 'bar'
+  end
+  
+  it 'should be able to set multiple attributes' do
+    @c.foo('bar').baz('wok')
+    @c.should == {:foo => 'bar', :baz => 'wok'}
+  end
+  
+  it 'should convert multiple arguments into an array' do
+    @c.foo(1, 2, 3)
+    @c[:foo].should == [1,2,3]
+  end
+  
+  it 'should be able to use bang notation to create a new Clash on a key' do
+    @c.foo!
+    @c[:foo].should be_kind_of(Hashie::Clash)
+  end
+  
+  it 'should be able to chain onto the new Clash when using bang notation' do
+    @c.foo!.bar('abc').baz(123)
+    @c.should == {:foo => {:bar => 'abc', :baz => 123}}
+  end
+  
+  it 'should be able to jump back up to the parent in the chain with #_end!' do
+    @c.foo!.bar('abc')._end!.baz(123)
+    @c.should == {:foo => {:bar => 'abc'}, :baz => 123}
+  end
+  
+  it 'should merge rather than replace existing keys' do
+    @c.where(:abc => 'def').where(:hgi => 123)
+    @c.should == {:where => {:abc => 'def', :hgi => 123}}
+  end
+end

data/development/ruby/1.8/gems/hashie-0.4.0/spec/hashie/dash_spec.rb

@@ -0,0 +1,156 @@
+require 'spec_helper'
+
+Hashie::Hash.class_eval do
+  def self.inherited(klass)
+    klass.instance_variable_set('@inheritance_test', true)
+  end
+end
+
+class DashTest < Hashie::Dash
+  property :first_name
+  property :email
+  property :count, :default => 0
+end
+
+class Subclassed < DashTest
+  property :last_name
+end
+
+describe DashTest do
+  
+  it('subclasses Hashie::Hash') { should respond_to(:to_mash) }
+  
+  its(:to_s) { should == '<#DashTest count=0>' }
+  
+  it 'lists all set properties in inspect' do
+    subject.first_name = 'Bob'
+    subject.email = 'bob@example.com'
+    subject.inspect.should == '<#DashTest count=0 email="bob@example.com" first_name="Bob">'
+  end
+  
+  its(:count) { should be_zero }
+
+  it { should respond_to(:first_name) }
+  it { should respond_to(:first_name=) }
+  it { should_not respond_to(:nonexistent) }
+  
+  it 'errors out for a non-existent property' do
+    lambda { subject['nonexistent'] }.should raise_error(NoMethodError)
+  end
+
+  context 'writing to properties' do
+    it 'fails writing to a non-existent property using []=' do
+      lambda { subject['nonexistent'] = 123 }.should raise_error(NoMethodError)
+    end
+
+    it 'works for an existing property using []=' do
+      subject['first_name'] = 'Bob'
+      subject['first_name'].should == 'Bob'
+      subject[:first_name].should == 'Bob'
+    end
+
+    it 'works for an existing property using a method call' do
+      subject.first_name = 'Franklin'
+      subject.first_name.should == 'Franklin'
+    end
+  end
+
+  describe '.new' do
+    it 'fails with non-existent properties' do
+      lambda { described_class.new(:bork => '') }.should raise_error(NoMethodError)
+    end
+
+    it 'should set properties that it is able to' do
+      obj = described_class.new :first_name => 'Michael'
+      obj.first_name.should == 'Michael'
+    end
+    
+    it 'accepts nil' do
+      lambda { described_class.new(nil) }.should_not raise_error
+    end
+    
+    it 'accepts block to define a global default' do
+      obj = described_class.new { |hash, key| key.to_s.upcase }
+      obj.first_name.should == 'FIRST_NAME'
+      obj.count.should be_zero
+    end
+  end
+  
+  describe 'properties' do
+    it 'lists defined properties' do
+      described_class.properties.should == Set.new([:first_name, :email, :count])
+    end
+    
+    it 'checks if a property exists' do
+      described_class.property?('first_name').should be_true
+      described_class.property?(:first_name).should be_true
+    end
+    
+    it 'doesnt include property from subclass' do
+      described_class.property?(:last_name).should be_false
+    end
+    
+    it 'lists declared defaults' do
+      described_class.defaults.should == { :count => 0 }
+    end
+  end
+end
+
+describe Hashie::Dash, 'inheritance' do
+  before do
+    @top = Class.new(Hashie::Dash)
+    @middle = Class.new(@top)
+    @bottom = Class.new(@middle)
+  end
+  
+  it 'reports empty properties when nothing defined' do
+    @top.properties.should be_empty
+    @top.defaults.should be_empty
+  end
+  
+  it 'inherits properties downwards' do
+    @top.property :echo
+    @middle.properties.should include(:echo)
+    @bottom.properties.should include(:echo)
+  end
+  
+  it 'doesnt inherit properties upwards' do
+    @middle.property :echo
+    @top.properties.should_not include(:echo)
+    @bottom.properties.should include(:echo)
+  end
+  
+  it 'allows overriding a default on an existing property' do
+    @top.property :echo
+    @middle.property :echo, :default => 123
+    @bottom.properties.to_a.should == [:echo]
+    @bottom.new.echo.should == 123
+  end
+  
+  it 'allows clearing an existing default' do
+    @top.property :echo
+    @middle.property :echo, :default => 123
+    @bottom.property :echo
+    @bottom.properties.to_a.should == [:echo]
+    @bottom.new.echo.should be_nil
+  end
+end
+
+describe Subclassed do
+  
+  its(:count) { should be_zero }
+
+  it { should respond_to(:first_name) }
+  it { should respond_to(:first_name=) }
+  it { should respond_to(:last_name) }
+  it { should respond_to(:last_name=) }
+  
+  it 'has one additional property' do
+    described_class.property?(:last_name).should be_true
+  end
+  
+  it "didn't override superclass inheritance logic" do
+    described_class.instance_variable_get('@inheritance_test').should be_true
+  end
+  
+end

data/development/ruby/1.8/gems/hashie-0.4.0/spec/hashie/hash_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Hash do
+  it "should be convertible to a Hashie::Mash" do
+    mash = Hashie::Hash[:some => "hash"].to_mash
+    mash.is_a?(Hashie::Mash).should be_true
+    mash.some.should == "hash"
+  end
+  
+  it "#stringify_keys! should turn all keys into strings" do
+    hash = Hashie::Hash[:a => "hey", 123 => "bob"]
+    hash.stringify_keys!
+    hash.should == Hashie::Hash["a" => "hey", "123" => "bob"]
+  end
+  
+  it "#stringify_keys should return a hash with stringified keys" do
+    hash = Hashie::Hash[:a => "hey", 123 => "bob"]
+    stringified_hash = hash.stringify_keys
+    hash.should == Hashie::Hash[:a => "hey", 123 => "bob"]
+    stringified_hash.should == Hashie::Hash["a" => "hey", "123" => "bob"]
+  end
+end

data/development/ruby/1.8/gems/hashie-0.4.0/spec/hashie/mash_spec.rb

@@ -0,0 +1,241 @@
+require 'spec_helper'
+
+describe Hashie::Mash do
+  before(:each) do
+    @mash = Hashie::Mash.new
+  end
+
+  it "should inherit from hash" do
+    @mash.is_a?(Hash).should be_true
+  end
+
+  it "should be able to set hash values through method= calls" do
+    @mash.test = "abc"
+    @mash["test"].should == "abc"
+  end
+
+  it "should be able to retrieve set values through method calls" do
+    @mash["test"] = "abc"
+    @mash.test.should == "abc"
+  end
+
+  it "should test for already set values when passed a ? method" do
+    @mash.test?.should be_false
+    @mash.test = "abc"
+    @mash.test?.should be_true
+  end
+  
+  it "should return false on a ? method if a value has been set to nil or false" do
+    @mash.test = nil
+    @mash.should_not be_test
+    @mash.test = false
+    @mash.should_not be_test
+  end
+
+  it "should make all [] and []= into strings for consistency" do
+    @mash["abc"] = 123
+    @mash.key?('abc').should be_true
+    @mash["abc"].should == 123
+  end
+
+  it "should have a to_s that is identical to its inspect" do
+    @mash.abc = 123
+    @mash.to_s.should == @mash.inspect
+  end
+
+  it "should return nil instead of raising an error for attribute-esque method calls" do
+    @mash.abc.should be_nil
+  end
+
+  it "should return a Hashie::Mash when passed a bang method to a non-existenct key" do
+    @mash.abc!.is_a?(Hashie::Mash).should be_true
+  end
+
+  it "should return the existing value when passed a bang method for an existing key" do
+    @mash.name = "Bob"
+    @mash.name!.should == "Bob"
+  end
+
+  it "#initializing_reader should return a Hashie::Mash when passed a non-existent key" do
+    @mash.initializing_reader(:abc).is_a?(Hashie::Mash).should be_true
+  end
+
+  it "should allow for multi-level assignment through bang methods" do
+    @mash.author!.name = "Michael Bleigh"
+    @mash.author.should == Hashie::Mash.new(:name => "Michael Bleigh")
+    @mash.author!.website!.url = "http://www.mbleigh.com/"
+    @mash.author.website.should == Hashie::Mash.new(:url => "http://www.mbleigh.com/")
+  end
+
+  context "updating" do
+    subject {
+      described_class.new :first_name => "Michael", :last_name => "Bleigh",
+        :details => {:email => "michael@asf.com", :address => "Nowhere road"}
+    }
+
+    describe "#deep_update" do
+      it "should recursively Hashie::Mash Hashie::Mashes and hashes together" do
+        subject.deep_update(:details => {:email => "michael@intridea.com", :city => "Imagineton"})
+        subject.first_name.should == "Michael"
+        subject.details.email.should == "michael@intridea.com"
+        subject.details.address.should == "Nowhere road"
+        subject.details.city.should == "Imagineton"
+      end
+  
+      it "should make #update deep by default" do
+        subject.update(:details => {:address => "Fake street"}).should eql(subject)
+        subject.details.address.should == "Fake street"
+        subject.details.email.should == "michael@asf.com"
+      end
+    
+      it "should clone before a #deep_merge" do
+        duped = subject.deep_merge(:details => {:address => "Fake street"})
+        duped.should_not eql(subject)
+        duped.details.address.should == "Fake street"
+        subject.details.address.should == "Nowhere road"
+        duped.details.email.should == "michael@asf.com"
+      end
+    
+      it "regular #merge should be deep" do
+        duped = subject.merge(:details => {:email => "michael@intridea.com"})
+        duped.should_not eql(subject)
+        duped.details.email.should == "michael@intridea.com"
+        duped.details.address.should == "Nowhere road"
+      end
+    end
+
+    describe "shallow update" do
+      it "should shallowly Hashie::Mash Hashie::Mashes and hashes together" do
+        subject.shallow_update(:details => {
+          :email => "michael@intridea.com", :city => "Imagineton"
+        }).should eql(subject)
+        
+        subject.first_name.should == "Michael"
+        subject.details.email.should == "michael@intridea.com"
+        subject.details.address.should be_nil
+        subject.details.city.should == "Imagineton"
+      end
+  
+      it "should clone before a #regular_merge" do
+        duped = subject.shallow_merge(:details => {:address => "Fake street"})
+        duped.should_not eql(subject)
+      end
+    
+      it "regular merge should be shallow" do
+        duped = subject.shallow_merge(:details => {:address => "Fake street"})
+        duped.details.address.should == "Fake street"
+        subject.details.address.should == "Nowhere road"
+        duped.details.email.should be_nil
+      end
+    end
+  end
+
+  it "should convert hash assignments into Hashie::Mashes" do
+    @mash.details = {:email => 'randy@asf.com', :address => {:state => 'TX'} }
+    @mash.details.email.should == 'randy@asf.com'
+    @mash.details.address.state.should == 'TX'
+  end
+
+  it "should not convert the type of Hashie::Mashes childs to Hashie::Mash" do
+    class MyMash < Hashie::Mash
+    end
+
+    record = MyMash.new
+    record.son = MyMash.new
+    record.son.class.should == MyMash
+  end
+  
+  it "should not change the class of Mashes when converted" do
+    class SubMash < Hashie::Mash
+    end
+    
+    record = Hashie::Mash.new
+    son = SubMash.new
+    record['submash'] = son
+    record['submash'].should be_kind_of(SubMash)
+  end
+  
+  it "should respect the class when passed a bang method for a non-existent key" do
+    record = Hashie::Mash.new
+    record.non_existent!.should be_kind_of(Hashie::Mash)
+    
+    class SubMash < Hashie::Mash
+    end
+    
+    son = SubMash.new
+    son.non_existent!.should be_kind_of(SubMash)
+  end
+  
+  it "should respect the class when converting the value" do
+    record = Hashie::Mash.new
+    record.details = Hashie::Mash.new({:email => "randy@asf.com"})
+    record.details.should be_kind_of(Hashie::Mash)
+    
+    class SubMash < Hashie::Mash
+    end
+    
+    son = SubMash.new
+    son.details = Hashie::Mash.new({:email => "randyjr@asf.com"})
+    son.details.should be_kind_of(SubMash)
+  end
+  
+  describe '#respond_to?' do
+    it 'should respond to a normal method' do
+      Hashie::Mash.new.should be_respond_to(:key?)
+    end
+    
+    it 'should respond to a set key' do
+      Hashie::Mash.new(:abc => 'def').should be_respond_to(:abc)
+    end
+  end
+
+  context "#initialize" do
+    it "should convert an existing hash to a Hashie::Mash" do
+      converted = Hashie::Mash.new({:abc => 123, :name => "Bob"})
+      converted.abc.should == 123
+      converted.name.should == "Bob"
+    end
+
+    it "should convert hashes recursively into Hashie::Mashes" do
+      converted = Hashie::Mash.new({:a => {:b => 1, :c => {:d => 23}}})
+      converted.a.is_a?(Hashie::Mash).should be_true
+      converted.a.b.should == 1
+      converted.a.c.d.should == 23
+    end
+
+    it "should convert hashes in arrays into Hashie::Mashes" do
+      converted = Hashie::Mash.new({:a => [{:b => 12}, 23]})
+      converted.a.first.b.should == 12
+      converted.a.last.should == 23
+    end
+
+    it "should convert an existing Hashie::Mash into a Hashie::Mash" do
+      initial = Hashie::Mash.new(:name => 'randy', :address => {:state => 'TX'})
+      copy = Hashie::Mash.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 = Hashie::Mash.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
+
+    describe "to_json" do
+
+      it "should render to_json" do
+        @mash.foo = :bar
+        @mash.bar = {"homer" => "simpson"}
+        expected = {"foo" => "bar", "bar" => {"homer" => "simpson"}}
+        JSON.parse(@mash.to_json).should == expected
+      end
+    end
+  end
+end