cascading-configuration-array 1.0.0

data/lib/cascading-configuration-array/CascadingConfiguration/ConfigurationSettingsArray.rb

@@ -0,0 +1,21 @@
+
+module CascadingConfiguration::ConfigurationSettingsArray
+  
+  ###################
+  #  self.included  #
+  ###################
+
+  def self.included( class_or_module )
+    class_or_module.instance_eval do
+      include CascadingConfiguration::ConfigurationVariable
+      extend  CascadingConfiguration::ConfigurationSettingsArray
+      extend  CascadingConfiguration::ConfigurationSettingsArray::Accessors
+      extend  CascadingConfiguration::ConfigurationSettingsArray::ClassInstance
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+      unless is_a?( Class )
+        extend CascadingConfiguration::ConfigurationSettingsArray::ModuleInstance
+      end
+    end
+  end
+
+end

data/lib/cascading-configuration-array/CascadingConfiguration/ConfigurationSettingsArray/Accessors.rb

@@ -0,0 +1,41 @@
+
+module CascadingConfiguration::ConfigurationSettingsArray::Accessors
+
+  #######################################
+  #  define_configuration_array_setter  #
+  #######################################
+  
+  def define_configuration_array_setter( configuration_name )
+    [ self, eigenclass ].each do |klass_or_eigenclass|
+      klass_or_eigenclass.class_eval do
+        configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
+        define_method( configuration_setter_name ) do |array|
+          composite_array = composite_array_for_cascading_configuration( configuration_name )
+          # we want the array to supplant existing config
+          # clear the array (excludes everything explicitly)
+          composite_array.clear
+          # push array elements (removes anything excluded from exclude)
+          composite_array.push( *array )
+          return composite_array
+        end
+      end
+    end
+  end
+
+  #######################################
+  #  define_configuration_array_getter  #
+  #######################################
+  
+  def define_configuration_array_getter( configuration_name )
+    configuration_getter_name = configuration_name
+    [ self, eigenclass ].each do |klass_or_eigenclass|
+      klass_or_eigenclass.class_eval do
+        define_method( configuration_getter_name ) do
+          composite_array = composite_array_for_cascading_configuration( configuration_name )
+          return composite_array
+        end
+      end
+    end
+  end
+
+end

data/lib/cascading-configuration-array/CascadingConfiguration/ConfigurationSettingsArray/ClassInstance.rb

@@ -0,0 +1,17 @@
+
+module CascadingConfiguration::ConfigurationSettingsArray::ClassInstance
+
+  ##############################
+  #  attr_configuration_array  #
+  ##############################
+
+  def attr_configuration_array( *property_names )
+    property_names.each do |this_property_name|
+      # define configuration setter
+      define_configuration_array_setter( this_property_name )
+      # define configuration getter
+      define_configuration_array_getter( this_property_name )
+    end
+  end
+
+end

data/lib/cascading-configuration-array/CascadingConfiguration/ConfigurationSettingsArray/ModuleInstance.rb

@@ -0,0 +1,20 @@
+
+module CascadingConfiguration::ConfigurationSettingsArray::ModuleInstance
+  
+  ##############
+  #  included  #
+  ##############
+  
+  def included( class_or_module )
+    self_module = self
+    class_or_module.instance_eval do
+      include CascadingConfiguration::ConfigurationSettingsArray
+      # when we extend a module (which has happened if we got here)
+      # then we need to make sure when the module we are extending is included
+      # * CascadingConfiguration is included
+      # * the module we extended is used to extend the class/module that included
+      extend  self_module
+    end
+  end
+  
+end

data/lib/cascading-configuration-array/CascadingConfiguration/_private_/CascadingCompositeArray.rb

@@ -0,0 +1,57 @@
+
+class CascadingConfiguration::CascadingCompositeArray < Array
+  
+  ###########################################################################################################
+      private ###############################################################################################
+  ###########################################################################################################
+  
+  ########################################
+  #  update_self_as_cascading_composite  #
+  ########################################
+
+  def update_self_as_cascading_composite
+    # start fresh
+    super_clear
+    # add parent config
+    super_push( *@parent_composite_array ) if @parent_composite_array
+    # add additional local config
+    super_push( *@local_cascading_array )
+    # remove local exclude
+    super_delete( *@local_cascading_array.exclude_array ) unless @local_cascading_array.exclude_array.empty?
+    # notify children to update their composite status
+    update_child_composite_arrays
+    return self
+  end
+
+  ######################################
+  #  update_adding_composite_elements  #
+  ######################################
+
+  def update_adding_composite_elements( *elements_to_cascade )
+    super_push( *elements_to_cascade )
+    sort!.uniq!
+    update_child_composite_arrays
+  end
+
+  ########################################
+  #  update_removing_composite_elements  #
+  ########################################
+
+  def update_removing_composite_elements( *elements_to_exclude )
+    elements_to_exclude.each do |this_excluded_element|
+      super_delete( this_excluded_element )
+    end
+    update_child_composite_arrays
+  end
+
+  ###################################
+  #  update_child_composite_arrays  #
+  ###################################
+  
+  def update_child_composite_arrays
+    @child_composite_arrays.each do |this_composite_array|
+      this_composite_array.instance_eval { update_self_as_cascading_composite }
+    end
+  end
+  
+end

data/lib/cascading-configuration-array/CascadingConfiguration/_private_/ConfigurationArray.rb

@@ -0,0 +1,26 @@
+
+class CascadingConfiguration::ConfigurationArray < Array
+
+  ###########################################################################################################
+      private ###############################################################################################
+  ###########################################################################################################
+
+  ##########################
+  #  add_to_exclude_array  #
+  ##########################
+
+  def add_to_exclude_array( *elements )
+    @exclude_array += elements
+    @exclude_array.sort!.uniq!
+  end
+
+  ###############################
+  #  remove_from_exclude_array  #
+  ###############################
+
+  def remove_from_exclude_array( *elements )
+    @exclude_array -= elements
+    @exclude_array.sort!.uniq!
+  end
+  
+end

data/spec/CascadingConfiguration/CascadingCompositeArray_spec.rb

@@ -0,0 +1,519 @@
+
+require_relative '../../lib/cascading-configuration-array.rb'
+
+describe CascadingConfiguration::CascadingCompositeArray do
+
+  #########
+  #  []=  #
+  #########
+
+  it 'can add elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock01
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock01
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array[0] = :some_setting
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    cascading_composite_array[1] = :other_setting
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock01.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array[0] = :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting, :other_setting, :some_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock01sub1 < CascadingConfiguration::CascadingCompositeArray::Mock01
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock01sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array[0] = :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock01sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    cascading_composite_array[0] = :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting, :other_setting, :some_setting, :yet_another_setting ]
+  end
+  
+  ########
+  #  <<  #
+  ########
+  
+  it 'can add elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock02
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock02
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array << :some_setting
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    cascading_composite_array << :other_setting
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock02.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array << :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting, :other_setting, :some_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock02sub1 < CascadingConfiguration::CascadingCompositeArray::Mock02
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock02sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array << :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock02sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    cascading_composite_array << :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting, :other_setting, :some_setting, :yet_another_setting ]
+  end
+  
+  #######
+  #  +  #
+  #######
+
+  it 'can add elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock03
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock03
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array += :some_setting
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    cascading_composite_array += :other_setting
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock03.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting, :other_setting, :some_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock03sub1 < CascadingConfiguration::CascadingCompositeArray::Mock03
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock03sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock03sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    cascading_composite_array += :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting, :other_setting, :some_setting, :yet_another_setting ]
+  end
+
+  ############
+  #  concat  #
+  ############
+  
+  it 'can add elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock04
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock04
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.concat [ :some_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    cascading_composite_array.concat [ :other_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock04.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.concat [ :another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting, :other_setting, :some_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock04sub1 < CascadingConfiguration::CascadingCompositeArray::Mock04
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock04sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.concat [ :yet_another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock04sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    cascading_composite_array.concat [ :and_still_another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting, :other_setting, :some_setting, :yet_another_setting ]
+  end
+  
+  ##########
+  #  push  #
+  ##########
+  
+  it 'can add elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock05
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock05
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push :some_setting
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    cascading_composite_array.push :other_setting
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock05.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.push :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting, :other_setting, :some_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock05sub1 < CascadingConfiguration::CascadingCompositeArray::Mock05
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock05sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.push :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock05sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :other_setting, :some_setting, :yet_another_setting ]
+    cascading_composite_array.push :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting, :other_setting, :some_setting, :yet_another_setting ]
+  end
+  
+  #######
+  #  -  #
+  #######
+  
+  it 'can exclude elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock06
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock06
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array -= [ :other_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock06.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += [ :another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array -= [ :some_setting ]
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock06sub1 < CascadingConfiguration::CascadingCompositeArray::Mock06
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock06sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += [ :yet_another_setting ]
+    cascading_composite_array -= [ :some_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock06sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array += [ :and_still_another_setting ]
+    cascading_composite_array -= [ :yet_another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+
+  ############
+  #  delete  #
+  ############
+  
+  it 'can exclude elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock07
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock07
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.delete( :other_setting )
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock07.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += [ :another_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.delete( :some_setting )
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock07sub1 < CascadingConfiguration::CascadingCompositeArray::Mock07
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock07sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += [ :yet_another_setting ]
+    cascading_composite_array.delete( :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock07sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array += [ :and_still_another_setting ]
+    cascading_composite_array.delete( :yet_another_setting )
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+
+  #########
+  #  pop  #
+  #########
+  
+  it 'can pop the final element' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock08
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock08
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.pop.should == :some_setting
+    cascading_composite_array.local_cascading_array.should == [ :other_setting ]
+    cascading_composite_array.should == [ :other_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock08.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array += :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.pop.should == :other_setting
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock08sub1 < CascadingConfiguration::CascadingCompositeArray::Mock08
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock08sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.pop.should == :other_setting
+    cascading_composite_array.should == []
+    cascading_composite_array += :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock08sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array.pop.should == :yet_another_setting
+    cascading_composite_array.should == []
+    cascading_composite_array += :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+
+  ###########
+  #  shift  #
+  ###########
+  
+  it 'can shift the first element' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock09
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock09
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.shift
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock09.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.shift
+    cascading_composite_array.should == []
+    cascading_composite_array += :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock09sub1 < CascadingConfiguration::CascadingCompositeArray::Mock09
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock09sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.shift
+    cascading_composite_array.should == []
+    cascading_composite_array += :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock09sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array.shift
+    cascading_composite_array.should == []
+    cascading_composite_array += :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+
+  ############
+  #  slice!  #
+  ############
+  
+  it 'can slice elements' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock10
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock10
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.slice!( 0, 1 ).should == [ :other_setting ]
+    cascading_composite_array.local_cascading_array.should == [ :some_setting ]
+    cascading_composite_array.should == [ :some_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock10.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.slice!( 0, 1 ).should == [ :some_setting ]
+    cascading_composite_array.should == []
+    cascading_composite_array += :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock10sub1 < CascadingConfiguration::CascadingCompositeArray::Mock10
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock10sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.slice!( 0, 1 ).should == [ :some_setting ]
+    cascading_composite_array.should == []
+    cascading_composite_array += :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock10sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array.slice!( 0, 1 ).should == [ :yet_another_setting ]
+    cascading_composite_array.should == []
+    cascading_composite_array += :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+  
+  ###########
+  #  clear  #
+  ###########
+
+  it 'can clear, causing present elements to be excluded' do
+    # primary class
+    class CascadingConfiguration::CascadingCompositeArray::Mock11
+      include CascadingConfiguration::ConfigurationVariable
+      include CascadingConfiguration::CascadingCompositeArray::Instance
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock11
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.push( :other_setting, :some_setting )
+    cascading_composite_array.local_cascading_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.should == [ :other_setting, :some_setting ]
+    cascading_composite_array.clear
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == []
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock11.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.clear
+    cascading_composite_array.should == []
+    cascading_composite_array += :another_setting
+    cascading_composite_array.local_cascading_array.should == [ :another_setting ]
+    cascading_composite_array.should == [ :another_setting ]
+    # inheriting class
+    class CascadingConfiguration::CascadingCompositeArray::Mock11sub1 < CascadingConfiguration::CascadingCompositeArray::Mock11
+    end
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock11sub1
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.clear
+    cascading_composite_array.should == []
+    cascading_composite_array += :yet_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :yet_another_setting ]
+    cascading_composite_array.should == [ :yet_another_setting ]
+    # instance
+    working_instance = CascadingConfiguration::CascadingCompositeArray::Mock11sub1.new
+    cascading_composite_array = working_instance.composite_array_for_cascading_configuration( :some_configuration )
+    cascading_composite_array.local_cascading_array.should == []
+    cascading_composite_array.should == [ :yet_another_setting ]
+    cascading_composite_array.clear
+    cascading_composite_array.should == []
+    cascading_composite_array += :and_still_another_setting
+    cascading_composite_array.local_cascading_array.should == [ :and_still_another_setting ]
+    cascading_composite_array.should == [ :and_still_another_setting ]
+  end
+  
+end