cascading_configuration 1.0.0

data/spec/cascading_configuration/array/sorted_spec.rb

@@ -0,0 +1,741 @@
+
+require_relative '../../../lib/cascading_configuration.rb'
+
+describe CascadingConfiguration::Array::Sorted do
+    
+  #######################
+  #  attr_sorted_array  #
+  #######################
+  
+  it 'can define a configuration array, which is the primary interface' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get nothing
+    # => extending modules and classes get nothing
+    # => instances of including and extending classes get nothing
+    # * module included with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get attr_setting and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_setting and configurations
+    # => instances of extending classes get nothing
+    module ::CascadingConfiguration::Array::Sorted::ConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_sorted_array ).should == true
+      respond_to?( :attr_configuration_sorted_array ).should == true
+      attr_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+
+    # * module included with setting
+    module ::CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_sorted_array ).should == true
+      attr_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == true
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_setting and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :another_configuration )
+        configuration_setting.should == [ :a_configuration, :another_configuration ]
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_setting and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded
+        # if we're extended then we want to use the eigenclass ancestor chain
+        # - the first ancestor will be the extending module
+        # - the rest of the ancestors will be the extending module's include chain
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :some_other_configuration )
+        configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :some_other_configuration )
+        configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == true
+      setting_class_including_instance.configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+      setting_class_including_instance.configuration_setting.delete( :some_other_configuration )
+      setting_class_including_instance.configuration_setting = [ :our_setting_value ]
+      setting_class_including_instance.configuration_setting.should == [ :our_setting_value ]
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :some_other_configuration )
+        configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Array::Sorted::ConfigurationMockClass
+      include CascadingConfiguration::Array::Sorted::ConfigurationMockModuleIncluded::SubmoduleIncluding
+      configuration_setting.should == [ :a_configuration, :another_configuration ]
+      configuration_setting.push( :some_other_configuration )
+      configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+      instance_variables.empty?.should == true
+    end
+    object_instance_one = CascadingConfiguration::Array::Sorted::ConfigurationMockClass.new
+    object_instance_one.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+    object_instance_one.configuration_setting.delete( :a_configuration )
+    object_instance_one.configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+    object_instance_one.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1 < CascadingConfiguration::Array::Sorted::ConfigurationMockClass
+      configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+      configuration_setting.delete( :a_configuration )
+      configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+      instance_variables.empty?.should == true
+    end
+    object_instance_two = CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1.new
+    object_instance_two.configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+    object_instance_two.configuration_setting.delete( :another_configuration )
+    object_instance_two.configuration_setting.should == [ :some_other_configuration ]
+    object_instance_two.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub2 < CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1
+      configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+      configuration_setting.push( :yet_another_configuration )
+      configuration_setting.should == [ :another_configuration, :some_other_configuration, :yet_another_configuration ]
+      instance_variables.empty?.should == true
+    end
+
+    # change ancestor setting
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClass.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClass.configuration_setting.push( :a_yet_unused_configuration )
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    object_instance_one.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    object_instance_two.configuration_setting.should == [ :a_yet_unused_configuration, :some_other_configuration ]
+    
+    # freeze ancestor setting
+    object_instance_one.configuration_setting.freeze!
+    object_instance_one.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClass.configuration_setting.push( :non_cascading_configuration )
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :non_cascading_configuration, :some_other_configuration ]
+    object_instance_one.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    object_instance_two.configuration_setting.should == [ :a_yet_unused_configuration, :some_other_configuration ]
+        
+  end
+
+  ##############################
+  #  attr_module_sorted_array  #
+  #  attr_class_sorted_array   #
+  ##############################
+  
+  it 'can define a class configuration array, which will not cascade to instances' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get nothing
+    # => extending modules and classes get nothing
+    # => instances of including and extending classes get nothing
+    # * module included with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get attr_setting and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_setting and configurations
+    # => instances of extending classes get nothing
+    module ::CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_module_sorted_array ).should == true
+      respond_to?( :attr_module_configuration_sorted_array ).should == true
+      method( :attr_module_sorted_array ).should == method( :attr_class_sorted_array )
+      attr_module_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+
+    # * module included with setting
+    module ::CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_module_sorted_array ).should == true
+      attr_module_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_setting and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :another_configuration )
+        configuration_setting.should == [ :a_configuration, :another_configuration ]
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_setting and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded
+        # if we're extended then we want to use the eigenclass ancestor chain
+        # - the first ancestor will be the extending module
+        # - the rest of the ancestors will be the extending module's include chain
+        respond_to?( :configuration_setting ).should == false
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :some_other_configuration )
+        configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass
+      include CascadingConfiguration::Array::Sorted::ClassConfigurationMockModuleIncluded::SubmoduleIncluding
+      method_defined?( :configuration_setting ).should == false
+      configuration_setting.should == [ :a_configuration, :another_configuration ]
+      configuration_setting.push( :some_other_configuration )
+      configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+      instance_variables.empty?.should == true
+    end
+    object_instance_one = CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == false
+    object_instance_one.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1 < CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass
+      method_defined?( :configuration_setting ).should == false
+      configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+      configuration_setting.delete( :a_configuration )
+      configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+      instance_variables.empty?.should == true
+    end
+    object_instance_two = CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == false
+    object_instance_two.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub2 < CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1
+      method_defined?( :configuration_setting ).should == false
+      configuration_setting.should == [ :another_configuration, :some_other_configuration ]
+      configuration_setting.push( :yet_another_configuration )
+      configuration_setting.should == [ :another_configuration, :some_other_configuration, :yet_another_configuration ]
+      instance_variables.empty?.should == true
+    end
+
+    # change ancestor setting
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.configuration_setting.push( :a_yet_unused_configuration )
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    
+    # freeze ancestor setting
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.configuration_setting.push( :non_cascading_configuration )
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :non_cascading_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::Sorted::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+        
+  end
+  
+  #############################
+  #  attr_local_sorted_array  #
+  #############################
+  
+  it 'can define a local configuration array, which will not cascade' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get nothing
+    # => extending modules and classes get nothing
+    # => instances of including and extending classes get nothing
+    # * module included with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get attr_setting and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_setting and configurations
+    # => instances of extending classes get nothing
+    module ::CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_local_sorted_array ).should == true
+      respond_to?( :attr_local_configuration_sorted_array ).should == true
+      attr_local_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+
+    # * module included with setting
+    module ::CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_local_sorted_array ).should == true
+      attr_local_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == true
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_setting and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_setting and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded
+        # if we're extended then we want to use the eigenclass ancestor chain
+        # - the first ancestor will be the extending module
+        # - the rest of the ancestors will be the extending module's include chain
+        respond_to?( :configuration_setting ).should == true
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == true
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Array::Sorted::LocalConfigurationMockClass
+      include CascadingConfiguration::Array::Sorted::LocalConfigurationMockModuleIncluded::SubmoduleIncluding
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_one = CascadingConfiguration::Array::Sorted::LocalConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == true
+    object_instance_one.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::LocalConfigurationMockClassSub1 < CascadingConfiguration::Array::Sorted::LocalConfigurationMockClass
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_two = CascadingConfiguration::Array::Sorted::LocalConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == true
+    object_instance_two.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::LocalConfigurationMockClassSub2 < CascadingConfiguration::Array::Sorted::LocalConfigurationMockClassSub1
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+        
+  end
+  
+  ################################
+  #  attr_instance_sorted_array  #
+  ################################
+  
+  it 'can define an instance configuration array, which will not cascade' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get nothing
+    # => extending modules and classes get nothing
+    # => instances of including and extending classes get nothing
+    # * module included with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get attr_setting and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_setting and configurations
+    # => instances of extending classes get nothing
+    module ::CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+
+    # * module included with setting
+    module ::CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_instance_sorted_array ).should == true
+      attr_instance_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == false
+      method_defined?( :configuration_setting ).should == true
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_setting and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == false
+        method_defined?( :configuration_setting ).should == true
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_setting and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded
+        # if we're extended then we want to use the eigenclass ancestor chain
+        # - the first ancestor will be the extending module
+        # - the rest of the ancestors will be the extending module's include chain
+        respond_to?( :configuration_setting ).should == true
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == true
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == true
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClass
+      include CascadingConfiguration::Array::Sorted::InstanceConfigurationMockModuleIncluded::SubmoduleIncluding
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_one = CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == true
+    object_instance_one.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClassSub1 < CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClass
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_two = CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == true
+    object_instance_two.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClassSub2 < CascadingConfiguration::Array::Sorted::InstanceConfigurationMockClassSub1
+      method_defined?( :configuration_setting ).should == true
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+        
+  end
+  
+  ##############################
+  #  attr_object_sorted_array  #
+  ##############################
+  
+  it 'can define an object configuration array, which will not cascade' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get nothing
+    # => extending modules and classes get nothing
+    # => instances of including and extending classes get nothing
+    # * module included with setting
+    # => singleton gets attr_setting and configurations
+    # => including modules and classes get attr_setting and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_setting and configurations
+    # => instances of extending classes get nothing
+    module ::CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_object_configuration_sorted_array ).should == true
+      respond_to?( :attr_object_sorted_array ).should == true
+      attr_object_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleExtended
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+
+    # * module included with setting
+    module ::CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array::Sorted
+      # => singleton gets attr_setting and configurations
+      respond_to?( :attr_object_sorted_array ).should == true
+      attr_object_sorted_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      method_defined?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_setting and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_setting and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded
+        # if we're extended then we want to use the eigenclass ancestor chain
+        # - the first ancestor will be the extending module
+        # - the rest of the ancestors will be the extending module's include chain
+        respond_to?( :configuration_setting ).should == false
+        method_defined?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded
+        method_defined?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClass
+      include CascadingConfiguration::Array::Sorted::ObjectConfigurationMockModuleIncluded::SubmoduleIncluding
+      method_defined?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_one = CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == false
+    object_instance_one.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClassSub1 < CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClass
+      method_defined?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+    object_instance_two = CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == false
+    object_instance_two.instance_variables.empty?.should == true
+    class CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClassSub2 < CascadingConfiguration::Array::Sorted::ObjectConfigurationMockClassSub1
+      method_defined?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+      instance_variables.empty?.should == true
+    end
+        
+  end
+  
+end