gorillib 0.1.11 → 0.4.0pre

data/notes/fancy_hashes_and_receivers.textile

@@ -1,120 +0,0 @@
-
-* gorillib/hashlike
-* gorillib/hashlike/slice
-* gorillib/hashlike/deep_dup
-* gorillib/hashlike/
-* gorillib/hashlike/hashlike_via_accessors
-* gorillib/struct/acts_as_hash
-* gorillib/struct/iterates_as_hash
-
-
-
-h4. acts_as_hash
-
-* []=           associates key with value
-* []            retrieves value associated with given key
-* delete        removes that key and its association
-* keys          enumeration of all keys having associations.
-
-
-* check for compatibility/semantics of Enumerable
-* has_key?      true if an association exists for the given key.
-
-h4. hashlike
-
-Want chokepoints:
-
-keys
-  - each, each_pair
-    - each_value
-    - reject!
-      - delete_if
-      - reject
-    - select!
-      - keep_if
-  - each_key
-  - key
-  - has_key?
-    - values_at
-  - length, size
-  - empty?
-  
-
-* each          keys.each{|k|   yield [k, self[k]] } ; self
-
-* has_key?      keys.include?(k)
-* length        keys.length
-* size          alias for length
-* empty?        keys.empty?
-
-* each_pair     alias for each
-* each_key      keys.each{|k|   yield  k }
-* each_value         each{|k,v| yield  v }
-* key           keys.find{|k|    self[k] == val }
-* values_at     in_keys.each{|k| self[k] if has_key?(k) }
-* values        [].tap{|arr| each{|k,v| arr << v      } }
-* to_hash       {}.tap{|hsh| each{|k,v| hsh[k] = v    } }
-
-* has_value?    keys.any?{|k|    self[k] == val }
-* value?        alias for has_value?
-* include?      alias for has_key?
-* key?          alias for has_key?
-* member?       alias for has_key?
-
-* update        other_hash.each{|k,v| self[k] = (block_given? && has_key?(k) ? yield(k,v,self[k]) : v) }
-* merge!        update
-* merge         dup.merge!
-
-* reject!       chgd = false ; each{|k,v| if  yield(k,v) then delete(k); chgd = true ; end } chgd ? self : nil
-* select!       chgd = false ; each{|k,v| if !yield(k,v) then delete(k); chgd = true ; end } chgd ? self : nil
-* delete_if:    reject! ; return self
-* keep_if:      select! ; return self
-* reject:       self.dup.delete_if
-
-* fetch         [] if has_key? else default else yield else raise KeyError
-* clear         each_key{|k| delete(k) }
-
-* invert        to_hash.invert
-
-
-
-   #all?, #any?, #chunk, #collect, #collect_concat, #count, #cycle, #detect,
-   #drop, #drop_while, #each_cons, #each_entry, #each_slice,
-   #each_with_index, #each_with_object, #entries, #find, #find_all,
-   #find_index, #first, #flat_map, #grep, #group_by, #inject, #map, #max,
-   #max_by, #min, #min_by, #minmax, #minmax_by, #none?, #one?, #partition,
-   #reduce, #reverse_each, #slice_before, #sort, #sort_by, #take,
-   #take_while, #zip
-
-As opposed to hash, does *not* define
-
-  default, default=, default_proc, default_proc=,
-  replace, rehash, compare_by_identity compare_by_identity?,
-  shift, flatten,
-
-h4. Configliere::DeepHash -- a magic hash
-
-  - only allows handles as keys (only things that can be turned into symbols are interesting)
-  - indifferent access
-  - deep access, via the dotted hash
-
-* FancyHash
-
-* *gorillib/hash/compact*         compact, compact!, compact_blank, compact_blank!
-* *gorrilib/hash/deep_compact*    deep_compact, deep_compact!
-* *gorrilib/hash/deep_merge*      deep_merge, deep_merge!
-* *gorillib/hash/keys*            stringify_keys, stringify_keys!, symbolize_keys, symbolize_keys!, assert_valid_keys
-* *gorillib/hash/reverse_merge*   reverse_merge, reverse_merge!
-* *gorillib/hash/tree_merge*      tree_merge, tree_merge!
-* *gorillib/hash/slice*           slice, slice!, extract!
-* *gorillib/hash/zip*             Hash.zip
-
-* Receiver
-
-
-===========================================================================
-===========================================================================
-
-
-?>   [  :store, :delete, :keys, :each, :each_key, :each_value, :has_key?,  :include?, :key?, :member?, :has_value?, :value?, :fetch, :length, :empty?, :to_hash, :values, :values_at, :merge, :update, :key, :invert, :reject!, :select!, :delete_if, :keep_if, :reject, :clear, :assoc, :rassoc].each{|m| puts `ri 'Hash##{m}'` }
-

data/notes/hash_rdocs.textile

@@ -1,97 +0,0 @@
-
-# == Hashlike ==
-#
-# == ActsAsHash ==
-#
-# Uses accessors and instance variables to provide
-# * :[key]        calls the getter <tt>send(key)</tt>
-# * :[key]= val   calls the setter <tt>send("key=", val)</tt>
-# * :delete       removes the instance variable, calls unset!
-# * :keys         all instance variables
-#
-# == Hashlike::Slice        ==
-# == Hashlike::Keys         ==
-# == Hashlike::Compact      ==
-# == Hashlike::DeepCompact  ==
-# == Hashlike::DeepMerge    ==
-# == Hashlike::TreeMerge    ==
-# == Hashlike::ReverseMerge ==
-# == Hashlike::Zip          ==
-# == Hashlike::DeepKeys     ==
-
-
-# Hashlike#each
-
-
-# Hashlike#each_key
-
-
-# Hashlike#each_value
-
-
-# Hashlike#has_key?
-
-
-# Hashlike#include?
-# Hashlike#key?
-# Hashlike#member?
-
-# Hashlike#has_value?
-# Hashlike#value?
-
-
-# Hashlike#fetch
-
-
-# Hashlike#length
-
-
-# Hashlike#empty?
-
-
-# Hashlike#to_hash
-
-
-# Hashlike#values
-
-
-# Hashlike#values_at
-
-
-# Hashlike#key
-
-
-# Hashlike#invert
-
-
-# Hashlike#delete_if
-
-
-# Hashlike#reject!
-
-
-# Hashlike#reject
-
-
-# Hashlike#keep_if
-
-
-# Hashlike#select!
-
-
-# Hashlike#clear
-
-
-# Hashlike#assoc
-
-
-# Hashlike#rassoc
-
-
-# Hashlike#flatten
-
-
-# Hashlike#update
-
-
-# Hashlike#merge

data/spec/array/average_spec.rb

@@ -1,24 +0,0 @@
-require File.expand_path('../spec_helper', File.dirname(__FILE__))
-require 'gorillib/array/average'
-
-describe Array do
-  describe '#average' do
-    context 'on non-float array element' do
-      it 'raises error' do
-        expect { [0.0, :b, 1.0].average }.should raise_error(ArgumentError)
-      end
-    end
-
-    context 'with empty' do
-      it 'returns nil' do
-        [].average.should be_nil
-      end
-    end
-
-    context 'given a numerical array' do
-      it 'returns the average of the elements' do
-        (1..10).to_a.average.should == 5.5
-      end
-    end
-  end
-end

data/spec/array/sorted_median_spec.rb

@@ -1,18 +0,0 @@
-require File.expand_path('../spec_helper', File.dirname(__FILE__))
-require 'gorillib/array/sorted_median'
-
-describe Array do
-  describe '#sorted_median' do
-    context 'with empty' do
-      it 'returns nil' do
-        [].sorted_median.should be_nil
-      end
-    end
-
-    context 'given any array' do
-      it 'returns the middle element of odd-sized arrays' do
-        ("a".."y").to_a.sorted_median.should == "m"
-      end
-    end
-  end
-end

data/spec/array/sorted_percentile_spec.rb

@@ -1,24 +0,0 @@
-require File.expand_path('../spec_helper', File.dirname(__FILE__))
-require 'gorillib/array/sorted_percentile'
-
-describe Array do
-  describe '#sorted_percentile' do
-    context 'with empty' do
-      it 'returns nil' do
-        [].sorted_percentile(0.0).should be_nil
-      end
-    end
-
-    context 'given any array' do
-      it 'returns the element closest to the given percentile' do
-        ("a".."y").to_a.sorted_percentile(  0.0).should == "a"
-        ("a".."y").to_a.sorted_percentile( 50.0).should == "m"
-        ("a".."y").to_a.sorted_percentile(100.0).should == "y"
-      end
-    end
-
-    # (Please do not define behavior for two elements equally close to
-    # a given percentile.)
-
-  end
-end

data/spec/array/sorted_sample_spec.rb

@@ -1,28 +0,0 @@
-require File.expand_path('../spec_helper', File.dirname(__FILE__))
-require 'gorillib/array/sorted_sample'
-
-describe Array do
-  describe '#sorted_median' do
-    context 'with empty' do
-      it 'returns an empty array' do
-        [].sorted_sample(1).should be_empty
-      end
-    end
-
-    context 'given an undersized array' do
-      it 'does not return the same element more than once' do
-        ("a".."z").to_a.sorted_sample(27).should == ("a".."z").to_a
-      end
-    end
-
-    context 'given any array' do
-      it ('returns a sample of the given size as close to evenly ' \
-          'distributed over the array as possible') do
-        sample = (1..100).to_a.sorted_sample(26)
-        deltas = sample[0..-2].zip(sample[1..-1]).map{|a,b| b-a}
-        deltas.max.should <= 4
-        deltas.min.should >= 3
-      end
-    end
-  end
-end

data/spec/dsl_object_spec.rb

@@ -1,99 +0,0 @@
-require 'spec_helper'
-require 'gorillib/dsl_object'
-
-
-describe DslObject do
-  let(:test_property) { :yo_momma }
-  let(:attrs)         { { test_property => "is so fat" } }
-
-  after(:each) do
-    DslObject.send(:remove_method, test_property) if DslObject.method_defined? test_property
-    DslObject.properties = {}
-  end
-
-  context DslObject, ".new" do
-    subject { DslObject.new(attrs) }
-
-    it "transforms an attribute hash given as a constructor argument into properties" do
-      subject.to_hash.should include attrs
-      subject.should respond_to test_property
-    end
-  end
-
-  context DslObject, ".property" do
-    subject { DslObject.new(attrs) }    
-    
-    it "defines a method on a DslObject instance" do
-      DslObject.property(test_property)
-      subject.should respond_to test_property
-    end
-    
-    it "allows a default return value to be established for a property" do
-      DslObject.property(test_property, :default => "is so fat")
-      subject.send(test_property).should  == "is so fat"
-    end
-    
-    let(:existing_method) { :class }
-    it "does not allow a property to override an existing method" do
-      DslObject.property(existing_method, :default => "override")
-      subject.send(existing_method).should_not == "override"
-      subject.should_not be_instance_variable_defined("@" + existing_method.to_s)
-    end
-  end
-
-  context DslObject, "#configure" do
-    let(:dsl_object) { DslObject.new }
-    subject          { double :context_obj, :delegate => dsl_object }
-    
-    it "delegates the configure block to the DslObject instance" do
-      dsl_object.should_receive(test_property)
-      subject.should_not_receive(test_property)
-      subject.delegate.configure { yo_momma "is so fat" }
-    end
-  end
-
-  context DslObject, "#to_s" do
-    subject { DslObject.new(attrs) }
-    
-    it "prints to the screen with its class name and properties" do
-      subject.to_s.should =~ /#{subject.class}.*#{attrs}/
-    end
-  end
-
-  context DslObject, "#set" do
-    subject { DslObject.new(attrs) }
-
-    it "sets a property correctly" do
-      subject.set(test_property, "is so dumb")
-      subject.to_hash.should include(test_property => "is so dumb" )
-    end
-  end
-
-  context DslObject, "#get" do
-    subject { DslObject.new(attrs) }    
-
-    it "returns a property correctly" do
-      subject.get(test_property).should == "is so fat"
-    end
-  end
-
-  context DslObject, "#set?" do
-    subject { DslObject.new(attrs) }    
-    
-    it "correctly determines if a property is set" do
-      subject.set?(test_property).should be_true
-      subject.set?(:not_set).should be_false
-    end
-  end
-
-  context DslObject, "#unset!" do
-    subject { DslObject.new(attrs) }    
-    
-    it "unsets a property" do
-      subject.unset!(test_property)
-      subject.set?(test_property).should be_false
-    end
-  end
-end
-
-