cascading-configuration-hash 2.0.3 → 2.1.0

data/README.md

@@ -197,7 +197,7 @@ end
 
   (The MIT License)
 
-  Copyright (c) 2011 Asher
+  Copyright (c) Asher
 
   Permission is hereby granted, free of charge, to any person obtaining
   a copy of this software and associated documentation files (the

data/README.rdoc

@@ -34,7 +34,7 @@ See README.md
 
   (The MIT License)
 
-  Copyright (c) 2011 Asher
+  Copyright (c) Asher
 
   Permission is hereby granted, free of charge, to any person obtaining
   a copy of this software and associated documentation files (the

data/lib/cascading-configuration-hash/CascadingConfiguration/Hash.rb

@@ -2,11 +2,52 @@
 module ::CascadingConfiguration::Hash
   
   # Configuration modules for storage of settings hashes
-  include ::CascadingConfiguration::Variable
+  include ::CascadingConfiguration::Inheritance
 
-  # Interface to declare configuration settings hashes
-  include ::CascadingConfiguration::Hash::Interface
+  #############################################
+  #  attr_configuration_unique_hash           #
+  #  attr_module_configuration_unique_hash    #
+  #  attr_local_configuration_unique_hash     #
+  #  attr_object_configuration_unique_hash    #
+  #  attr_instance_configuration_unique_hash  #
+  #############################################
 
-  extend ::CascadingConfiguration::Hash::ModuleSupportMethods
+  def attr_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+  def attr_module_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+  def attr_class_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+  def attr_local_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+  def attr_object_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+  def attr_instance_configuration_unique_hash( *configuration_names, & define_block ) ;; end
+
+  cch = self
+  ccv = ::CascadingConfiguration::Variable
+  ccm = ::CascadingConfiguration::Methods
+
+  setter_proc = ::Proc.new do |instance, configuration_name, value|
+    
+    return instance.__send__( configuration_name ).replace( value )
   
+  end
+  
+  getter_proc = ::Proc.new do |instance, configuration_name|
+
+    composite_hash = nil
+
+    if ccv.has_configuration_variable?( instance, configuration_name )
+      composite_hash = ccv.get_configuration_variable( instance, configuration_name )
+    else
+      parent_composite_hash = nil
+      if ancestor = ::CascadingConfiguration::Variable.ancestor( instance, configuration_name )
+        parent_composite_hash = ancestor.__send__( configuration_name )
+      end
+      composite_hash = ::CompositingHash.new( parent_composite_hash )
+      ccv.set_configuration_variable( instance, configuration_name, composite_hash )
+    end
+
+    return composite_hash
+    
+  end
+
+  ccm.declare_compositing_configuration_object( self, :hash, setter_proc, getter_proc )
+
 end

data/lib/cascading-configuration-hash.rb

@@ -1,4 +1,6 @@
 
+require 'compositing-hash'
+
 if $__cascading_configuration__spec__development
   require_relative '../../variable/lib/cascading-configuration-variable.rb'
 else
@@ -7,15 +9,7 @@ end
 
 module ::CascadingConfiguration
   module Hash
-    class CompositingHash < ::Hash
-    end
-    module Interface
-    end
   end
 end
 
-require_relative 'cascading-configuration-hash/_private_/CascadingConfiguration/Hash/CompositingHash.rb'
-require_relative 'cascading-configuration-hash/_private_/CascadingConfiguration/Hash/ModuleSupportMethods.rb'
-
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/Interface.rb'
 require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash.rb'

data/spec/CascadingConfiguration/Hash_spec.rb

@@ -216,11 +216,15 @@ describe CascadingConfiguration::Hash do
 
     module ::CascadingConfiguration::Hash::ConfigurationMockModule
       include CascadingConfiguration::Hash
-      attr_configuration_hash :some_hash do |hash, key, foreign_value|
-        if existing_value = hash[ key ]
-          hash[ key ] = foreign_value - existing_value
-        else
-          hash[ key ] = foreign_value
+      attr_configuration_hash :some_hash do
+        def merge!( other_hash )
+          other_hash.each do |key, foreign_value|
+            if existing_value = self[ key ]
+              self[ key ] = foreign_value - existing_value
+            else
+              self[ key ] = foreign_value
+            end          
+          end
         end
       end
       self.some_hash = { :one => 1, :two => 2 }
@@ -423,11 +427,15 @@ describe CascadingConfiguration::Hash do
 
     module ::CascadingConfiguration::Hash::ClassConfigurationMockModule
       include CascadingConfiguration::Hash
-      attr_configuration_hash :some_hash do |hash, key, foreign_value|
-        if existing_value = hash[ key ]
-          hash[ key ] = foreign_value - existing_value
-        else
-          hash[ key ] = foreign_value
+      attr_configuration_hash :some_hash do
+        def merge!( other_hash )
+          other_hash.each do |key, foreign_value|
+            if existing_value = self[ key ]
+              self[ key ] = foreign_value - existing_value
+            else
+              self[ key ] = foreign_value
+            end          
+          end
         end
       end
       self.some_hash = { :one => 1, :two => 2 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cascading-configuration-hash
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-04 00:00:00.000000000 Z
+date: 2012-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cascading-configuration-variable
-  requirement: &70317490911220 !ruby/object:Gem::Requirement
+  requirement: &70142939829480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,19 +21,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70317490911220
+  version_requirements: *70142939829480
 description: Provides :attr_configuration_hash.
 email: asher@ridiculouspower.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/cascading-configuration-hash/_private_/CascadingConfiguration/Hash/CompositingHash.rb
-- lib/cascading-configuration-hash/_private_/CascadingConfiguration/Hash/ModuleSupportMethods.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash/Interface.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/Hash.rb
 - lib/cascading-configuration-hash.rb
-- spec/_private_/CascadingConfiguration/Hash/CompositingHash_spec.rb
 - spec/CascadingConfiguration/Hash_spec.rb
 - README.md
 - README.rdoc
@@ -57,7 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: cascading-configuration-hash
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Support package for cascading-configuration.

data/lib/cascading-configuration-hash/CascadingConfiguration/Hash/Interface.rb

@@ -1,155 +0,0 @@
-
-module ::CascadingConfiguration::Hash::Interface
-
-  ######################
-  #  self.setter_proc  #
-  ######################
-
-  def self.setter_proc( configuration_name )
-
-    return Proc.new do |hash|
-
-      return ::CascadingConfiguration::Hash.
-               composite_hash_for_cascading_configuration( self, 
-                                                           configuration_name ).replace( hash )
-    
-    end
-
-  end
-
-  ######################
-  #  self.getter_proc  #
-  ######################
-
-  def self.getter_proc( configuration_name )
-
-    return Proc.new do
-
-      return ::CascadingConfiguration::Hash.
-               composite_hash_for_cascading_configuration( self, configuration_name )
-    
-    end
-
-  end
-
-  #############################
-  #  attr_configuration_hash  #
-  #############################
-
-  # defines configuration in class or module
-  # configuration cascades downward to instance including all classes or modules in-between
-  def attr_configuration_hash( *configuration_names, & compositing_block )
-    
-    configuration_names.each do |this_configuration_name|
-      if block_given?
-        ::CascadingConfiguration::Variable.set_compositing_proc( self, 
-                                                                 this_configuration_name,
-                                                                 compositing_block )
-      end
-    end
-
-    return ::CascadingConfiguration::Variable.
-             define_cascading_configuration( self, 
-                                             ::CascadingConfiguration::Hash::Interface, 
-                                             *configuration_names )
-
-  end
-
-  ####################################
-  #  attr_module_configuration_hash  #
-  ####################################
-
-  # defines configuration in class or module
-  # configuration cascades downward to last class or module
-  def attr_module_configuration_hash( *configuration_names, & compositing_block )
-    
-    configuration_names.each do |this_configuration_name|
-      if block_given?
-        ::CascadingConfiguration::Variable.set_compositing_proc( self, 
-                                                                 this_configuration_name,
-                                                                 compositing_block )
-      end
-    end
-
-    return ::CascadingConfiguration::Variable.
-             define_module_configuration( self, 
-                                          ::CascadingConfiguration::Hash::Interface, 
-                                          *configuration_names )
-
-  end
-  alias_method :attr_class_configuration_hash, :attr_module_configuration_hash
-
-  ###################################
-  #  attr_local_configuration_hash  #
-  ###################################
-
-  # defines configuration in present class or module context
-  # configuration does not cascade
-  def attr_local_configuration_hash( *configuration_names, & compositing_block )
-
-    ::CascadingConfiguration::Variable.create_local_instance_configuration_support_module( self )
-
-    configuration_names.each do |this_configuration_name|
-      if block_given?
-        ::CascadingConfiguration::Variable.set_compositing_proc( self, 
-                                                                 this_configuration_name,
-                                                                 compositing_block )
-      end
-    end
-
-    return ::CascadingConfiguration::Variable.
-             define_local_configuration( self, 
-                                         ::CascadingConfiguration::Hash::Interface, 
-                                         *configuration_names )
-
-  end
-
-  ####################################
-  #  attr_object_configuration_hash  #
-  ####################################
-
-  # defines configuration in present class or module context
-  # configuration does not cascade
-  def attr_object_configuration_hash( *configuration_names, & compositing_block )
-
-    ::CascadingConfiguration::Variable.create_local_instance_configuration_support_module( self )
-
-    configuration_names.each do |this_configuration_name|
-      if block_given?
-        ::CascadingConfiguration::Variable.set_compositing_proc( self, 
-                                                                 this_configuration_name,
-                                                                 compositing_block )
-      end
-    end
-    
-    return ::CascadingConfiguration::Variable.
-             define_object_configuration( self, 
-                                          ::CascadingConfiguration::Hash::Interface, 
-                                          *configuration_names )
-
-  end
-
-  ######################################
-  #  attr_instance_configuration_hash  #
-  ######################################
-
-  # defines configuration in present class or module context
-  # configuration does not cascade
-  def attr_instance_configuration_hash( *configuration_names, & compositing_block )
-
-    configuration_names.each do |this_configuration_name|
-      if block_given?
-        ::CascadingConfiguration::Variable.set_compositing_proc( self, 
-                                                                 this_configuration_name,
-                                                                 compositing_block )
-      end
-    end
-    
-    return ::CascadingConfiguration::Variable.
-             define_instance_configuration( self, 
-                                            ::CascadingConfiguration::Hash::Interface, 
-                                            *configuration_names )
-
-  end
-
-end

data/lib/cascading-configuration-hash/_private_/CascadingConfiguration/Hash/CompositingHash.rb

@@ -1,340 +0,0 @@
-
-class ::CascadingConfiguration::Hash::CompositingHash < ::Hash
-
-  ################
-  #  initialize  #
-  ################
-  
-  def initialize( configuration_instance, configuration_name )
-
-    @configuration_instance = configuration_instance    
-    @configuration_name = configuration_name
-
-    @replaced_parents = {}
-
-    # store self for sub composites
-    ::CascadingConfiguration::Variable.set_configuration_variable( configuration_instance, 
-                                                                   configuration_name, 
-                                                                   self )
-    
-    # get compositing proc if we have one
-    @compositing_proc = ::CascadingConfiguration::Variable.
-                          get_compositing_proc_searching_upward( configuration_instance, @configuration_name )
-    
-    # we may later have our own child composites that register with us
-    @sub_composite_hashes = [ ]
-
-    # if first ancestor can have a composite hash, 
-    # register self with it in case it gets updated in the future
-    if ancestor = ::CascadingConfiguration::Variable.ancestor( configuration_instance, 
-                                                               configuration_name )
-
-      @super_composite_hash = ::CascadingConfiguration::Variable.
-                                get_configuration_variable( ancestor, 
-                                                            configuration_name )
-
-      if @super_composite_hash.respond_to?( :register_sub_composite_hash )
-        @super_composite_hash.register_sub_composite_hash( self )
-        merge!( @super_composite_hash )
-      else
-        @super_composite_hash = nil
-      end
-
-    end
-
-  end
-
-  ###################################  Sub-Hash Management  #######################################
-
-  #################################
-  #  register_sub_composite_hash  #
-  #################################
-
-  def register_sub_composite_hash( sub_composite_hash )
-
-    @sub_composite_hashes.push( sub_composite_hash )
-
-    return self
-
-  end
-
-  ###################################
-  #  unregister_sub_composite_hash  #
-  ###################################
-
-  def unregister_sub_composite_hash( sub_composite_hash )
-
-    @sub_composite_hashes.delete( sub_composite_hash )
-
-    return self
-
-  end
-
-  #####################################  Self Management  ##########################################
-
-  #########
-  #  []=  #
-  #########
-
-  private
-    alias_method :non_cascading_store, :store
-  public
-  
-  def []=( key, object )
-
-    @replaced_parents[ key ] = true
-
-    non_cascading_store( key, object )
-
-    @sub_composite_hashes.each do |this_sub_hash|
-      this_sub_hash.instance_eval do
-        update_as_sub_hash_for_parent_store( key, object )
-      end
-    end
-    
-    return object
-
-  end
-  alias_method :store, :[]=
-
-  ############
-  #  delete  #
-  ############
-
-  private
-    alias_method :non_cascading_delete, :delete
-  public
-  
-  def delete( key )
-
-    @replaced_parents.delete( key )
-
-    object = non_cascading_delete( key )
-
-    @sub_composite_hashes.each do |this_sub_hash|
-      this_sub_hash.instance_eval do
-        update_as_sub_hash_for_parent_delete( key )
-      end
-    end
-
-    return object
-
-  end
-
-  ###############
-  #  delete_if  #
-  ###############
-
-  def delete_if
-
-    return to_enum unless block_given?
-
-    indexes = [ ]
-    
-    self.each do |this_key, this_object|
-      if yield( this_key, this_object )
-        delete( this_key )
-      end
-    end
-        
-    return self
-
-  end
-
-  #############
-  #  reject!  #
-  #############
-
-  def reject!
-
-    return to_enum unless block_given?
-    
-    return_value = nil
-    
-    self.each do |this_key, this_object|
-      if yield( this_key, this_object )
-        delete( this_key )
-        return_value = self
-      end
-    end
-    
-    return return_value
-
-  end
-
-  #############
-  #  keep_if  #
-  #############
-
-  def keep_if
-
-    return to_enum unless block_given?
-
-    indexes = [ ]
-    
-    self.each do |this_key, this_object|
-      unless yield( this_key, this_object )
-        delete( this_key )
-      end
-    end
-        
-    return self
-
-
-  end
-
-  #############
-  #  select!  #
-  #############
-
-  def select!
-
-    return to_enum unless block_given?
-    
-    return_value = nil
-    
-    self.each do |this_key, this_object|
-      unless yield( this_key, this_object )
-        delete( this_key )
-        return_value = self
-      end
-    end
-    
-    return return_value
-
-  end
-
-  ############
-  #  merge!  #
-  #  update  #
-  ############
-  
-  private
-    alias_method :non_cascading_merge!, :merge!
-  public
-
-  def merge!( other_hash )
-
-    other_hash.each do |this_key, this_object|
-      if @compositing_proc
-        self[ this_key ] = @compositing_proc.call( self, this_key, this_object )
-      else
-        self[ this_key ] = this_object
-      end
-    end
-
-    return self
-
-  end
-  alias_method :update, :merge!
-  
-  #############
-  #  replace  #
-  #############
-  
-  def replace( other_hash )
-
-    # clear current values
-    clear
-
-    # merge replacement settings
-    merge!( other_hash )
-
-    return self
-
-  end
-
-  ###########
-  #  shift  #
-  ###########
-  
-  def shift
-    
-    object = nil
-    
-    unless empty?
-      last_key = first[ 0 ]
-      object = delete( last_key )
-    end    
-
-    return [ last_key, object ]
-
-  end
-
-  ###########
-  #  clear  #
-  ###########
-  
-  def clear
-
-    keys.each do |this_key|
-      delete( this_key )
-    end
-
-    return self
-
-  end
-  
-  #############
-  #  freeze!  #
-  #############
-
-  # freezes configuration and prevents ancestors from changing this configuration in the future
-  def freeze!
-    
-    # unregister with parent composite so we don't get future updates from it
-    if @super_composite_hash
-      @super_composite_hash.unregister_sub_composite_hash( self )
-    end
-    
-    return self
-    
-  end
-
-  ##################################################################################################
-      private ######################################################################################
-  ##################################################################################################
-
-  #########################  Self-as-Sub Management for Parent Updates  ############################
-
-  #########################################
-  #  update_as_sub_hash_for_parent_store  #
-  #########################################
-
-  def update_as_sub_hash_for_parent_store( key, object )
-    
-    unless @replaced_parents[ key ]
-    
-      non_cascading_store( key, object )
-    
-      @sub_composite_hashes.each do |this_hash|
-        this_hash.instance_eval do
-          update_as_sub_hash_for_parent_store( key, object )
-        end
-      end
-    
-    end
-    
-  end
-
-  ##########################################
-  #  update_as_sub_hash_for_parent_delete  #
-  ##########################################
-
-  def update_as_sub_hash_for_parent_delete( key )
-    
-    unless @replaced_parents[ key ]
-    
-      non_cascading_delete( key )
-    
-      @sub_composite_hashes.each do |this_hash|
-        this_hash.instance_eval do
-          update_as_sub_hash_for_parent_delete( key )
-        end
-      end
-    
-    end
-    
-  end
-  
-end

data/lib/cascading-configuration-hash/_private_/CascadingConfiguration/Hash/ModuleSupportMethods.rb

@@ -1,22 +0,0 @@
-
-module ::CascadingConfiguration::Hash::ModuleSupportMethods
-
-  ################################################
-  #  composite_hash_for_cascading_configuration  #
-  ################################################
-
-  def composite_hash_for_cascading_configuration( configuration_instance, configuration_name )
-
-    composite_hash = nil
-
-    if ::CascadingConfiguration::Variable.has_configuration_variable?( configuration_instance, configuration_name )
-      composite_hash = ::CascadingConfiguration::Variable.get_configuration_variable( configuration_instance, configuration_name )
-    else
-      composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( configuration_instance, configuration_name )
-    end
-
-    return composite_hash
-
-  end
-
-end

data/spec/_private_/CascadingConfiguration/Hash/CompositingHash_spec.rb

@@ -1,411 +0,0 @@
-
-if $__cascading_configuration__spec__development
-  require_relative '../../../../lib/cascading-configuration-hash.rb'
-else
-  require 'cascading-configuration-hash'
-end
-
-describe CascadingConfiguration::Hash::CompositingHash do
-
-  before :all do
-
-    module ::CascadingConfiguration::Hash::CompositingHash::MockA
-      # needed for ccv ancestor determination
-      def self.some_configuration
-      end
-    end
-    module ::CascadingConfiguration::Hash::CompositingHash::MockB
-    end
-      
-    @configuration_instance = CascadingConfiguration::Hash::CompositingHash::MockA
-    @sub_configuration_instance = CascadingConfiguration::Hash::CompositingHash::MockB
-    
-    @configuration_name = :some_configuration
-
-    CascadingConfiguration::Variable.register_child_for_parent( @sub_configuration_instance, 
-                                                                @configuration_instance )
-    
-  end
-
-  ################
-  #  initialize  #
-  ################
-
-  it 'can add initialize with an ancestor, inheriting its values and linking to it as a child' do
-  
-    cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-
-    cascading_composite_hash.instance_variable_get( :@super_composite_hash ).should == nil
-    cascading_composite_hash.should == {}
-    cascading_composite_hash[ :A ] = 1
-    cascading_composite_hash[ :B ] = 2
-    cascading_composite_hash[ :C ] = 3
-    cascading_composite_hash[ :D ] = 4
-    cascading_composite_hash.should == { :A => 1,
-                                         :B => 2,
-                                         :C => 3,
-                                         :D => 4 }
-    
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-    sub_cascading_composite_hash.instance_variable_get( :@super_composite_hash ).should == cascading_composite_hash
-    sub_cascading_composite_hash.should == { :A => 1,
-                                             :B => 2,
-                                             :C => 3,
-                                             :D => 4 }
-
-  end
-
-  ##################################################################################################
-  #    private #####################################################################################
-  ##################################################################################################
-
-  #########################################
-  #  update_as_sub_hash_for_parent_store  #
-  #########################################
-
-  it 'can update for a parent store' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-    
-    sub_cascading_composite_hash.instance_eval do
-      update_as_sub_hash_for_parent_store( :A, 1 )
-      self.should == { :A => 1 }
-    end
-    
-  end
-
-  ##########################################
-  #  update_as_sub_hash_for_parent_delete  #
-  ##########################################
-
-  it 'can update for a parent delete' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-    
-    cascading_composite_hash[ :A ] = 1
-    cascading_composite_hash.should == { :A => 1 }
-    sub_cascading_composite_hash.should == { :A => 1 }
-
-    sub_cascading_composite_hash.instance_eval do
-      update_as_sub_hash_for_parent_delete( :A )
-      self.should == { }
-    end
-    
-  end
-
-  ##################################################################################################
-  #    public ######################################################################################
-  ##################################################################################################
-
-  #########
-  #  []=  #
-  #########
-
-  it 'can add elements' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-    
-    cascading_composite_hash[ :some_setting ] = :some_value
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting => :some_value }
-
-    cascading_composite_hash[ :other_setting ] = :some_value
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-
-    sub_cascading_composite_hash[ :yet_another_setting ] = :some_value
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting        => :some_value,
-                                             :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-
-    cascading_composite_hash.method( :[]= ).should == cascading_composite_hash.method( :store )
-    
-  end
-
-  ############
-  #  delete  #
-  ############
-
-  it 'can delete elements' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting   => :some_value }
-
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-
-    cascading_composite_hash.delete( :some_setting )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-
-    sub_cascading_composite_hash.delete( :other_setting )
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-  end
-
-  ###############
-  #  delete_if  #
-  ###############
-
-  it 'can delete elements with a block' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting => :some_value }
-
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-    cascading_composite_hash.delete_if do |key, value|
-      key == :some_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.delete_if do |key, value|
-      key == :other_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-
-  end
-
-  #############
-  #  reject!  #
-  #############
-
-  it 'can delete elements with a block' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting => :some_value }
-
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-    cascading_composite_hash.reject! do |key, value|
-      key == :some_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.reject! do |key, value|
-      key == :other_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-
-  end
-  
-  #############
-  #  keep_if  #
-  #############
-
-  it 'can keep elements with a block' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting => :some_value }
-
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-    cascading_composite_hash.keep_if do |key, value|
-      key != :some_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.keep_if do |key, value|
-      key != :other_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-
-  end
-
-  #############
-  #  select!  #
-  #############
-
-  it 'can keep elements with a block' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting => :some_value }
-
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :some_setting  => :some_value,
-                                             :other_setting => :some_value }
-    cascading_composite_hash.select! do |key, value|
-      key != :some_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.select! do |key, value|
-      key != :other_setting
-    end
-    cascading_composite_hash.should == { :other_setting => :some_value }
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-
-  end
-  
-  ############
-  #  merge!  #
-  #  update  #
-  ############
-  
-  it 'can merge from another hash' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.merge!( :some_setting => :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    cascading_composite_hash.merge!( :other_setting => :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-
-    sub_cascading_composite_hash.should == { :some_setting    => :some_value,
-                                             :other_setting   => :some_value }
-    sub_cascading_composite_hash.merge!( :yet_another_setting => :some_value )
-    sub_cascading_composite_hash.should == { :some_setting        => :some_value,
-                                             :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-
-  end
-  
-  #############
-  #  replace  #
-  #############
-  
-  it 'can replace existing elements with others' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.replace( :some_setting => :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    cascading_composite_hash.replace( :other_setting => :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.should == { :other_setting   => :some_value }
-    sub_cascading_composite_hash.replace( :yet_another_setting => :some_value )
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-
-  end
-
-  ###########
-  #  shift  #
-  ###########
-  
-  it 'can shift the first element' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    cascading_composite_hash.shift
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.should == { :other_setting   => :some_value }
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.shift
-    sub_cascading_composite_hash.should == { :yet_another_setting => :some_value }
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-  end
-
-  ###########
-  #  clear  #
-  ###########
-  
-  it 'can clear, causing present elements to be excluded' do
-
-    cascading_composite_hash = ::CascadingConfiguration::Hash::CompositingHash.new( @configuration_instance, @configuration_name )
-    sub_cascading_composite_hash = CascadingConfiguration::Hash::CompositingHash.new( @sub_configuration_instance, @configuration_name )
-
-    cascading_composite_hash.store( :some_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting => :some_value }
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :some_setting  => :some_value,
-                                         :other_setting => :some_value }
-    cascading_composite_hash.clear
-    cascading_composite_hash.should == { }
-    cascading_composite_hash.store( :other_setting, :some_value )
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-    sub_cascading_composite_hash.should == { :other_setting   => :some_value }
-    sub_cascading_composite_hash.store( :yet_another_setting, :some_value )
-    sub_cascading_composite_hash.should == { :other_setting       => :some_value,
-                                             :yet_another_setting => :some_value }
-    sub_cascading_composite_hash.clear
-    sub_cascading_composite_hash.should == { }
-    cascading_composite_hash.should == { :other_setting => :some_value }
-
-  end
-  
-end