cascading-configuration-array 1.1.3 → 1.1.4

data/spec/CascadingConfiguration/Array/Accessors_spec.rb

@@ -1,28 +0,0 @@
-
-require_relative '../../../lib/cascading-configuration-array.rb'
-
-describe CascadingConfiguration::Array::Accessors do
-
-  ###################################
-  #  define_cascading_array_setter  #
-  #  define_cascading_array_getter  #
-  ###################################
-
-  it 'can define a method to get and modify the configuration array' do
-    class CascadingConfiguration::Array::Mock
-      include CascadingConfiguration::Variable
-      extend  CascadingConfiguration::Array::Accessors
-      include CascadingConfiguration::Array::ObjectInstance
-      extend  CascadingConfiguration::Array::ClassInstance
-    end
-    # setter
-    CascadingConfiguration::Array::Mock.define_cascading_array_setter( :some_configuration )
-    CascadingConfiguration::Array::Mock.methods.include?( :some_configuration= ).should == true
-    CascadingConfiguration::Array::Mock.instance_methods.include?( :some_configuration= ).should == true
-    # getter
-    CascadingConfiguration::Array::Mock.define_cascading_array_getter( :some_configuration )
-    CascadingConfiguration::Array::Mock.methods.include?( :some_configuration ).should == true
-    CascadingConfiguration::Array::Mock.instance_methods.include?( :some_configuration ).should == true
-  end
-
-end

data/spec/CascadingConfiguration/Array_spec.rb

@@ -1,90 +0,0 @@
-
-require_relative '../../lib/cascading-configuration-array.rb'
-
-describe CascadingConfiguration::Array do
-  
-  ##############################
-  #  attr_configuration_array  #
-  ##############################
-  
-  it 'can define a configuration array, which is the primary interface' do
-
-    module CascadingConfiguration::Array::MockModule
-      include CascadingConfiguration::Array
-      attr_configuration_array :configuration_setting
-      configuration_setting.should == []
-      configuration_setting.push( :a_configuration )
-      configuration_setting.should == [ :a_configuration ]
-    end
-
-    module CascadingConfiguration::Array::MockModule2
-      include CascadingConfiguration::Array::MockModule
-      configuration_setting.should == [ :a_configuration ]
-      configuration_setting.push( :another_configuration )
-      configuration_setting.should == [ :a_configuration, :another_configuration ]
-    end
-    
-    module CascadingConfiguration::Array::MockModule3
-      include CascadingConfiguration::Array::MockModule2
-      configuration_setting.should == [ :a_configuration, :another_configuration ]
-    end
-    
-    class CascadingConfiguration::Array::MockClass
-      include CascadingConfiguration::Array::MockModule3
-      configuration_setting.should == [ :a_configuration, :another_configuration ]
-      configuration_setting.delete( :another_configuration )
-      configuration_setting.should == [ :a_configuration ]
-    end
-
-    object_instance_one = CascadingConfiguration::Array::MockClass.new
-    object_instance_one.configuration_setting.should == [ :a_configuration ]
-    object_instance_one.configuration_setting.push( :some_other_configuration )
-    object_instance_one.configuration_setting.should == [ :a_configuration, :some_other_configuration ]
-    
-    class CascadingConfiguration::Array::MockClassSub1 < CascadingConfiguration::Array::MockClass
-      configuration_setting.should == [ :a_configuration ]
-      configuration_setting.push( :another_configuration)
-      configuration_setting.should == [ :a_configuration, :another_configuration ]
-    end
-
-    object_instance_two = CascadingConfiguration::Array::MockClassSub1.new
-    object_instance_two.configuration_setting.should == [ :a_configuration, :another_configuration ]
-    object_instance_two.configuration_setting.push( :some_other_configuration )
-    object_instance_two.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
-
-    # change ancestor setting
-    CascadingConfiguration::Array::MockClass.configuration_setting.push( :a_yet_unused_configuration )
-    CascadingConfiguration::Array::MockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration ]
-    object_instance_one.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :some_other_configuration ]
-    CascadingConfiguration::Array::MockClassSub1.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration ]
-    object_instance_two.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
-    
-    # freeze ancestor setting
-    object_instance_one.configuration_setting.freeze!
-    object_instance_one.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :some_other_configuration ]
-    CascadingConfiguration::Array::MockClassSub1.configuration_setting.freeze!
-    CascadingConfiguration::Array::MockClassSub1.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration ]
-    CascadingConfiguration::Array::MockClass.configuration_setting.push( :non_cascading_configuration )
-    CascadingConfiguration::Array::MockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :non_cascading_configuration ]
-    object_instance_one.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :some_other_configuration ]
-    CascadingConfiguration::Array::MockClassSub1.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration ]
-    object_instance_two.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
-    
-    # test two
-    
-    module CascadingConfiguration::Array::MockModuleExtended
-      include CascadingConfiguration::Array
-      attr_configuration_array :configuration_setting
-      configuration_setting.should == []
-      configuration_setting.push( :a_configuration )
-      configuration_setting.should == [ :a_configuration ]
-    end
-
-    class CascadingConfiguration::Array::MockClassExtended
-      extend CascadingConfiguration::Array::MockModuleExtended
-      configuration_setting.should == [ :a_configuration ]
-    end
-    
-  end
-  
-end

data/spec/CascadingConfiguration/CompositingArray_spec.rb

@@ -1,519 +0,0 @@
-
-require_relative '../../lib/cascading-configuration-array.rb'
-
-describe CascadingConfiguration::CompositingArray do
-
-  #########
-  #  []=  #
-  #########
-
-  it 'can add elements' do
-    # primary class
-    class CascadingConfiguration::CompositingArray::Mock01
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock01sub1 < CascadingConfiguration::CompositingArray::Mock01
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock02
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock02sub1 < CascadingConfiguration::CompositingArray::Mock02
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock03
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock03sub1 < CascadingConfiguration::CompositingArray::Mock03
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock04
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock04sub1 < CascadingConfiguration::CompositingArray::Mock04
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock05
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock05sub1 < CascadingConfiguration::CompositingArray::Mock05
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock06
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock06sub1 < CascadingConfiguration::CompositingArray::Mock06
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock07
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock07sub1 < CascadingConfiguration::CompositingArray::Mock07
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock08
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock08sub1 < CascadingConfiguration::CompositingArray::Mock08
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock09
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock09sub1 < CascadingConfiguration::CompositingArray::Mock09
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock10
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock10sub1 < CascadingConfiguration::CompositingArray::Mock10
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock11
-      include CascadingConfiguration::Variable
-      include CascadingConfiguration::CompositingArray::Instance
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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::CompositingArray::Mock11sub1 < CascadingConfiguration::CompositingArray::Mock11
-    end
-    working_instance = CascadingConfiguration::CompositingArray::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::CompositingArray::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