hashery 1.5.0 → 2.0.0

data/test/helper.rb

@@ -0,0 +1,8 @@
+require 'lemon'
+require 'ae'
+require 'ae/legacy' # bacause imitation BasicObject sucks
+require 'ae/pry'
+
+require 'hashery'
+
+include Hashery

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hashery
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 2.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -15,22 +15,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-11 00:00:00.000000000 Z
+date: 2012-06-19 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: blankslate
-  requirement: &26633440 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: *26633440
 - !ruby/object:Gem::Dependency
   name: detroit
-  requirement: &26632080 !ruby/object:Gem::Requirement
+  requirement: &19204020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -38,10 +27,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *26632080
+  version_requirements: *19204020
 - !ruby/object:Gem::Dependency
   name: qed
-  requirement: &26631260 !ruby/object:Gem::Requirement
+  requirement: &19203280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -49,10 +38,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *26631260
+  version_requirements: *19203280
 - !ruby/object:Gem::Dependency
   name: lemon
-  requirement: &26630620 !ruby/object:Gem::Requirement
+  requirement: &19222540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -60,84 +49,64 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *26630620
-description: ! 'The Hashery is a collection of Hash-like classes, spun-off from the
-  original
+  version_requirements: *19222540
+description: ! 'The Hashery is a tight collection of Hash-like classes. Included among
+  its many
+
+  offerings are the auto-sorting Dictionary class, the efficient LRUHash, the
 
-  Ruby Facets library. Included are the widely used OrderedHash, the related but
+  flexible OpenHash and the convenient KeyHash. Nearly every class is a subclass
 
-  more featured Dictionary class, a number of open classes, similiar to the
+  of the CRUDHash which defines a CRUD model on top of Ruby''s standard Hash
 
-  standard OpenStruct and a few variations on the standard Hash.'
+  making it a snap to subclass and augment to fit any specific use case.'
 email:
 - transfire@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
+- LICENSE.txt
+- NOTICE.txt
 - HISTORY.rdoc
+- DEMO.rdoc
 - README.rdoc
-- QED.rdoc
-- COPYING.rdoc
 files:
 - .ruby
 - .yardopts
 - lib/hashery/association.rb
-- lib/hashery/basic_object.rb
-- lib/hashery/basic_struct.rb
-- lib/hashery/basicobject.rb
-- lib/hashery/basicstruct.rb
 - lib/hashery/casting_hash.rb
-- lib/hashery/castinghash.rb
 - lib/hashery/core_ext.rb
+- lib/hashery/crud_hash.rb
 - lib/hashery/dictionary.rb
 - lib/hashery/fuzzy_hash.rb
-- lib/hashery/fuzzyhash.rb
-- lib/hashery/ini.rb
+- lib/hashery/ini_hash.rb
 - lib/hashery/key_hash.rb
-- lib/hashery/keyhash.rb
 - lib/hashery/linked_list.rb
-- lib/hashery/linkedlist.rb
 - lib/hashery/lru_hash.rb
-- lib/hashery/lruhash.rb
-- lib/hashery/memoizer.rb
 - lib/hashery/open_cascade.rb
 - lib/hashery/open_hash.rb
-- lib/hashery/open_object.rb
-- lib/hashery/opencascade.rb
-- lib/hashery/openhash.rb
-- lib/hashery/openobject.rb
 - lib/hashery/ordered_hash.rb
-- lib/hashery/orderedhash.rb
-- lib/hashery/ostructable.rb
+- lib/hashery/path_hash.rb
 - lib/hashery/property_hash.rb
-- lib/hashery/propertyhash.rb
 - lib/hashery/query_hash.rb
-- lib/hashery/queryhash.rb
 - lib/hashery/stash.rb
 - lib/hashery/static_hash.rb
-- lib/hashery/statichash.rb
 - lib/hashery.rb
 - lib/hashery.yml
-- qed/01_openhash.rdoc
-- qed/02_queryhash.rdoc
-- qed/03_castinghash.rdoc
-- qed/04_statichash.rdoc
-- qed/05_association.rdoc
-- qed/06_opencascade.rdoc
-- qed/07_fuzzyhash.rdoc
-- qed/08_properyhash.rdoc
-- qed/09_ostructable.rdoc
-- qed/applique/ae.rb
 - test/case_association.rb
-- test/case_basicstruct.rb
 - test/case_dictionary.rb
-- test/case_keyhash.rb
-- test/case_opencascade.rb
-- test/case_openhash.rb
+- test/case_key_hash.rb
+- test/case_lru_hash.rb
+- test/case_open_cascade.rb
+- test/case_open_hash.rb
+- test/case_query_hash.rb
+- test/helper.rb
 - HISTORY.rdoc
+- DEMO.rdoc
+- LICENSE.txt
 - README.rdoc
-- QED.rdoc
-- COPYING.rdoc
+- NOTICE.txt
+- Config.rb
 homepage: http://rubyworks.github.com/hashery
 licenses:
 - BSD-2-Clause
@@ -145,6 +114,7 @@ post_install_message:
 rdoc_options: []
 require_paths:
 - lib
+- alt
 required_ruby_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -159,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Facets-bread collection of Hash-like classes.

data/COPYING.rdoc

@@ -1,45 +0,0 @@
-= COPYRIGHT NOTICES
-
-== Hashery
-
-Copyright:: (c) 2009 Thomas Sawyer, Rubyworks
-License:: BSD-2-Clause
-Website:: http://rubyworks.github.com/hashery
-
-    Copyright (c) 2009 Thomas Sawyer, Rubyworks
-
-    Redistribution and use in source and binary forms, with or without modification, are
-    permitted provided that the following conditions are met:
-
-       1. Redistributions of source code must retain the above copyright notice, this list of
-          conditions and the following disclaimer.
-
-       2. Redistributions in binary form must reproduce the above copyright notice, this list
-          of conditions and the following disclaimer in the documentation and/or other materials
-          provided with the distribution.
-
-    THIS SOFTWARE IS PROVIDED BY Thomas Sawyer ``AS IS'' AND ANY EXPRESS OR IMPLIED
-    WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
-    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Thomas Sawyer OR
-    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-    ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
-    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-    The views and conclusions contained in the software and documentation are those of the
-    authors and should not be interpreted as representing official policies, either expressed
-    or implied, of Thomas Sawyer.
-
-== BasicObject
-
-Copyright:: (c) 2004 Jim Weirich
-Website:: http://rake.rubyforge.org
-
-BasicObject class is a variation of Jim Weirich's BlankSlate class.
-
-    BlankSlate
-    Copyright 2004 by Jim Weirich (jim@weirichhouse.org).
-    All rights reserved.
-

data/lib/hashery/basic_object.rb

@@ -1,74 +0,0 @@
-# Facets' BasicObject is an implementation of Jim Weirich's BlankSlate.
-#
-# BlankSlate
-# Copyright 2004 by Jim Weirich (jim@weirichhouse.org).
-# All rights reserved.
-#
-# Since Ruby 1.9 has a BasicObject class this will of course be
-# deprecated as 1.9 goes mainstream.
-
-unless defined? BasicObject  # in case it already exists!
-
-  # BasicObject provides an abstract base class with no predefined
-  # methods (except for <tt>\_\_send__</tt> and <tt>\_\_id__</tt>).
-  # BlankSlate is useful as a base class when writing classes that
-  # depend upon <tt>method_missing</tt> (e.g. dynamic proxies).
-  class BasicObject
-    class << self
-      # Hide the method named +name+ in the BlankSlate class.  Don't
-      # hide +instance_eval+ or any method beginning with "__".
-      #
-      # According to 1.9.1 it should have only these methods:
-      #
-      # * #__send__
-      # * #instance_eval
-      # * #instance_exec
-      # * #equal?
-      # * #==
-      # * #!
-      # * #!=
-      # * respond_to?
-      #
-      # Seems to me it should have #__id__ too.
-      def hide(name)
-        undef_method name if
-          instance_methods.include?(name.to_s) and
-          name !~ /^(__|respond_to\?|instance_eval$|instance_exec$|equal\?$|\=\=$)/
-      end
-    end
-    instance_methods.each{ |m| hide(m) }
-  end
-
-  # Since Ruby is very dynamic, methods added to the ancestors of
-  # BlankSlate <em>after BlankSlate is defined</em> will show up in the
-  # list of available BlankSlate methods.  We handle this by defining a
-  # hook in the Object and Kernel classes that will hide any defined
-  module Kernel #:nodoc:
-    class << self
-      alias_method :basic_object_method_added, :method_added
-
-      # Detect method additions to Kernel and remove them in the
-      # BlankSlate class.
-      def method_added(name)
-        basic_object_method_added(name)
-        return if self != Kernel
-        BasicObject.hide(name)
-      end
-    end
-  end
-
-  class Object #:nodoc:
-    class << self
-      alias_method :basic_object_method_added, :method_added
-
-      # Detect method additions to Object and remove them in the
-      # BlankSlate class.
-      def method_added(name)
-        basic_object_method_added(name)
-        return if self != Object
-        BasicObject.hide(name)
-      end
-    end
-  end
-
-end

data/lib/hashery/basic_struct.rb

@@ -1,288 +0,0 @@
-unless defined?(BasicObject)
-  require 'blankslate'
-  BasicObject = BlankSlate
-end
-
-# = BasicStruct
-#
-# BasicStruct is very similar to Ruby's own OpenStruct, but it offers some
-# advantages. With OpenStruct, slots with the same name as predefined
-# Object methods cannot be used. With BasicStruct, almost any slot can be
-# defined. BasicStruct is a subclass of BasicObject to ensure all method
-# slots, except those that are absolutely essential, are open for use.
-#
-#--
-# If you wish to pass a BasicStruct to a routine that normal takes a Hash,
-# but are uncertain it can handle the distictions properly you can convert
-# easily to a Hash using #as_hash! and the result will automatically be
-# converted back to an BasicStruct on return.
-#
-#   o = BasicStruct.new(:a=>1,:b=>2)
-#   o.as_hash!{ |h| h.update(:a=>6) }
-#   o #=> #<BasicObject {:a=>6,:b=>2}>
-#++
-#
-# Unlike a Hash, all BasicStruct's keys are symbols and all keys are converted
-# to such using #to_sym on the fly.
-
-class BasicStruct < BasicObject
-
-  #PUBLIC_METHODS = /(^__|^instance_|^object_|^\W|^as$|^send$|^class$|\?$)/
-  #protected(*public_instance_methods.select{ |m| m !~ PUBLIC_METHODS })
-
-  def self.[](hash=nil)
-    new(hash)
-  end
-
-  # Inititalizer for BasicObject is slightly different than that of Hash.
-  # It does not take a default parameter, but an initial priming Hash,
-  # like OpenStruct. The initializer can still take a default block
-  # however. To set the default value use <code>#default!(value)</code>.
-  #
-  #   BasicObject.new(:a=>1).default!(0)
-  #
-  def initialize(hash=nil, &yld)
-    @table = ::Hash.new(&yld)
-    if hash
-      hash.each{ |k,v| store(k,v) }
-    end
-  end
-
-  #
-  def initialize_copy(orig)
-    orig.each{ |k,v| store(k,v) }
-  end
-
-  # Object inspection.
-  # TODO: Need to get __class__ and __id__ in hex form.
-  def inspect
-    #@table.inspect
-    hexid = __id__
-    klass = "BasicObject" # __class__
-    "#<#{klass}:#{hexid} #{@table.inspect}>"
-  end
-
-  # Convert to an associative array.
-  def to_a
-    @table.to_a
-  end
-
-  #
-  def to_h
-    @table.dup
-  end
-
-  #
-  def to_hash
-    @table.dup
-  end
-
-  #
-  def to_basicstruct
-    self
-  end
-
-  # Convert to an assignment procedure.
-  def to_proc(response=false)
-    hash = @table
-    if response
-      ::Proc.new do |o|
-        hash.each do |k,v|
-          o.__send__("#{k}=", v) rescue nil
-        end
-      end
-    else
-      ::Proc.new do |o|
-        hash.each{ |k,v| o.__send__("#{k}=", v) }
-      end
-    end
-  end
-
-  # NOT SURE ABOUT THIS
-  def as_hash
-    @table
-  end
-
-  # Is a given +key+ defined?
-  def key?(key)
-    @table.key?(key.to_sym)
-  end
-
-  #
-  def is_a?(klass)
-    return true if klass == ::Hash  # TODO: Is this wise? How to fake a subclass?
-    return true if klass == ::BasicObject
-    false
-  end
-
-  # Iterate over each key-value pair.
-  def each(&yld)
-    @table.each(&yld)
-  end
-
-  # Set the default value.
-  def default!(default)
-    @table.default = default
-  end
-
-  # Check equality.
-  def ==( other )
-    case other
-    when ::BasicStruct
-      @table == other.as_hash
-    when ::Hash
-      @table == other
-    else
-      if other.respond_to?(:to_hash)
-        @table == other.to_hash
-      else
-        false
-      end
-    end
-  end
-
-  #
-  def eql?( other )
-    case other
-    when ::BasicStruct
-      @table.eql?(other.as_hash)
-    else
-      false
-    end
-  end
-
-  #
-  def <<(x)
-    case x
-    when ::Hash
-      @table.update(x)
-    when ::Array
-      x.each_slice(2) do |(k,v)|
-        @table[k] = v
-      end
-    end
-  end
-
-  #
-  def []=(key, value)
-    @table[key.to_sym] = value
-  end
-
-  #
-  def [](key)
-    @table[key.to_sym]
-  end
-
-  #
-  def merge!(other)
-    BasicObject.new(@table.merge!(other))
-  end
-
-  #
-  def update!(other)
-    @table.update(other)
-    self
-  end
-
-  #
-  def respond_to?(key)
-    key?(key)
-  end
-
-  # NOTE: These were protected, why?
-
-  #
-  def store(k, v)
-    @table.store(k.to_sym, v)
-  end
-
-  #
-  def fetch(k, *d, &b)
-    @table.fetch(k.to_sym, *d, &b)
-  end
-
-  protected
-
-    #def as_hash!
-    #  Functor.new do |op,*a,&b|
-    #    result = @table.__send__(op,*a,&b)
-    #    case result
-    #    when Hash
-    #      BasicObject.new(result)
-    #    else
-    #      result
-    #    end
-    #  end
-    #end
-
-    #def define_slot(key, value=nil)
-    #  @table[key.to_sym] = value
-    #end
-
-    #def protect_slot( key )
-    #  (class << self; self; end).class_eval {
-    #    protected key rescue nil
-    # }
-    #end
-
-    def method_missing(sym, *args, &blk)
-      type = sym.to_s[-1,1]
-      key  = sym.to_s.sub(/[=?!]$/,'').to_sym
-      case type
-      when '='
-        store(key, args[0])
-      when '!'
-        @table.__send__(key, *args, &blk)
-      #  if key?(key)
-      #    fetch(key)
-      #  else
-      #    store(key, BasicObject.new)
-      #  end
-      when '?'
-        fetch(key)
-      else
-        fetch(key)
-      end
-    end
-
-end
-
-# Core Extensions
-
-class Hash
-  # Convert a Hash into a BasicStruct.
-  def to_basicstruct
-    BasicStruct[self]
-  end
-end
-
-=begin
-class NilClass
-  # Nil converts to an empty BasicObject.
-  def to_basicstruct
-    BasicObject.new
-  end
-end
-
-class Proc
-  # Translates a Proc into an BasicObject. By droping an BasicObject into
-  # the Proc, the resulting assignments incured as the procedure is
-  # evaluated produce the BasicObject. This technique is simlar to that
-  # of MethodProbe.
-  #
-  #   p = lambda { |x|
-  #     x.word = "Hello"
-  #   }
-  #   o = p.to_basicstruct
-  #   o.word #=> "Hello"
-  #
-  # NOTE The Proc must have an arity of one --no more and no less.
-  def to_basicstruct
-    raise ArgumentError, 'bad arity for converting Proc to basicstruct' if arity != 1
-    o = BasicObject.new
-    self.call( o )
-    o
-  end
-end
-=end
-