cascading-configuration-array 1.1.6 → 1.2.0

data/README.md

@@ -1,4 +1,4 @@
-# Cascading Configuration #
+# Cascading Configuration Array #
 
 http://rubygems.org/gems/cascading-configuration-array
 
@@ -8,340 +8,260 @@ Adds methods for cascading configuration arrays. Support package for cascading-c
 
 # Summary #
 
-## :attr_configuration_array ##
-
-:attr_configuration_array provides inheritable configuration that cascades downward. 
+Cascading configuration methods for arrays, which returns the appropriate lowest accumulated value. Configuration inheritance can cascade through modules, classes, and to instances.
 
-Configuration inheritance can cascade through modules, classes, and instances.
-
-:attr_configuration_array defines a single attribute accessor that composes the set of configuration values appropriate to the ancestor level being queried (merging downward from most distant ancestor to self). An internal cache is kept, and any configuration updates that occur to higher-level ancestors cascade immediately downward.
-
-The array maintained by :attr_configuration_array is kept ordered and unique.
+This means that we can create configuration modules, optionally setting configuration defaults, and include those configuration modules in other modules or classes.
 
 # Install #
 
-* sudo gem install cascading-configuration-array
+* sudo gem install cascading-configuration
 
 # Usage #
 
-## First Module ##
-
-1. Define initial configuration in a module.
-
-A class works just as well, but we can't use a module in the same chain if we start with a class.
-
-* Include module to enable attr_configuration_array.
+Including the module will enable support for singleton and for instances.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-	include CascadingConfiguration::Array
-  end
-
-```
-
-* Declare attr_configuration_array.
-
-```ruby
-
-  module CascadingConfiguration::MockModule
-    attr_configuration_array :some_array_configuration
-  end
-
-```
-
-* Set initial value.
-
-```ruby
-
-  module CascadingConfiguration::MockModule
-    self.some_array_configuration = [ :some_value ]
-  end
-
+module AnyModuleOrClass
+  include CascadingConfiguration
+end
 ```
 
-* Verify initial configuration value
+Extending the module will enable support for singleton only.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-
-    # => some_array_configuration.should == [ :some_value ]
-
-  end
-
+module AnyModuleOrClass
+  extend CascadingConfiguration
+end
 ```
 
-## Including Module 1 ##
+Including or extending CascadingConfiguration includes or extends:
 
-2. Include initial module in another module.
+* CascadingConfiguration::Variable
 
-Including the module that has included a CascadingConfiguration module is the same as including a CascadingConfiguration module.
+## :attr_configuration_array ##
 
-```ruby
+:attr_configuration_array provides inheritable array configurations that cascade downward. A composite sorted and unique array will be returned (merging downward from most distant ancestor to self). 
 
-  module CascadingConfiguration::MockModule2
-    include CascadingConfiguration::MockModule
-  end
+An internal cache is kept, and any configuration updates that occur to higher-level ancestors cascade immediately downward. 
 
-```
+The array maintained by :attr_configuration_array is kept ordered and unique.
 
-* Verify inherited value
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  module CascadingConfiguration::MockModule2
-    # => some_array_configuration.should == [ :some_value ]
-  end
+  include CascadingConfiguration::Array
 
-```
+  attr_array_configuration :some_array_setting
 
-* Override inherited value
+  some_array_setting # => nil
 
-```ruby
+  some_array_setting.push( :some_value )
 
-  module CascadingConfiguration::MockModule2
-    self.some_array_configuration = [ :module_value ]
-  end
+  some_array_setting # => [ :some_value ]
 
+end
 ```
 
-* Verify local override value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  module CascadingConfiguration::MockModule2
-    # => some_array_configuration.should == [ :module_value ]
-  end
+  include SomeModule
 
-```
+  some_array_setting # => [ :some_value ]
 
-## Including Module 2 ##
+  self.some_array_setting = [ :some_other_value ]
 
-3. Include second module in another module.
+  some_array_setting # => [ :some_other_value ]
 
-```ruby
+  some_array_setting.push( :another_value ) # => [ :another_value, :some_other_value ]
 
-  module CascadingConfiguration::MockModule3
-    include CascadingConfiguration::MockModule2
-  end
+  SomeModule.some_array_setting # => [ :some_value ]
 
+end
 ```
 
-* Verify inherited value
+And it cascades to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  module CascadingConfiguration::MockModule3
-    # => some_array_configuration.should == [ :module_value ]
-  end
-
-```
-
-## Top Class ##
-
-4. Include third module in a class.
-
-```ruby
+instance.some_array_setting.should == [ :another_value, :some_other_value ]
 
-  class CascadingConfiguration::MockClass
-    include CascadingConfiguration::MockModule3
-  end
+instance.some_array_setting.delete( :some_other_value )
 
+instance.some_array_setting.should == [ :another_value ]
 ```
 
-* Verify inherited value
+### :attr_module_configuration_array, :attr_class_configuration_array ###
+
+:attr_class_configuration_array works like :attr_configuration_array but does not cascade to instances.
 
 ```ruby
+module SomeModule
 
-  class CascadingConfiguration::MockClass
-    # => some_array_configuration.should == [ :module_value ]
-  end
+  include CascadingConfiguration::Array
 
-```
+  attr_array_configuration :some_array_setting
 
-* Override inherited value
+  some_array_setting # => nil
 
-```ruby
+  some_array_setting.push( :some_value )
 
-  class CascadingConfiguration::MockClass
-    self.some_array_configuration = [ :another_value ]
-  end
+  some_array_setting # => [ :some_value ]
 
+end
 ```
 
-* Verify local override value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  class CascadingConfiguration::MockClass
-    # => some_array_configuration.should == [ :another_value ]
-  end
+  include SomeModule
 
-```
+  some_array_setting # => [ :some_value ]
 
-## Instance of Top Class ##
+  self.some_array_setting = [ :some_other_value ]
 
-5. Instantiate class.
+  some_array_setting # => [ :some_other_value ]
 
-```ruby
+  some_array_setting.push( :another_value ) # => [ :another_value, :some_other_value ]
 
-  object_instance_one = CascadingConfiguration::MockClass.new
+  SomeModule.some_array_setting # => [ :some_value ]
 
+end
 ```
 
-* Verify inherited value
+And it does not cascade to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  # => object_instance_one.some_array_configuration.should == [ :another_value ]
-
+instance.respond_to?( :some_array_setting ).should == false
 ```
 
-* Override inherited value
+### :attr_local_configuration_array ###
 
-```ruby
-
-  object_instance_one.some_array_configuration = [ :yet_another_value ]
-
-```
-
-* Verify local override value
+:attr_local_configuration_array works like :attr_configuration_array but does not cascade. This is primarily useful for creating local configurations maintained in parallel with cascading configurations (for instance, with the same variable prefixes), for overriding the local configuration method, and for hiding the configuration variable (coming soon).
 
 ```ruby
+module SomeModule
 
-  # => object_instance_one.some_array_configuration.should == [ :yet_another_value ]
-  # => CascadingConfiguration::MockClass.some_array_configuration.should == [ :another_value ]
-  # => CascadingConfiguration::MockModule.some_array_configuration.should == [ :some_value ]
-
-```
-
-# First Inheriting Class #
-
-6. Inheriting class.
+  include CascadingConfiguration::Array
 
-Inheriting class should not get any settings from instance of superclass.
+  attr_array_configuration :some_array_setting
 
-* Verify inherited value
+  some_array_setting # => nil
 
-```ruby
+  some_array_setting.push( :some_value )
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_array_configuration.should == [ :another_value ]
-  end
+  some_array_setting # => [ :some_value ]
 
+end
 ```
 
-* Override inherited value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    self.some_array_configuration = [ :a_value_not_yet_used ]
-  end
+  include SomeModule
 
-```
+  respond_to?( :some_array_setting ).should == false
 
-* Verify local override value
+end
+```
 
-```ruby
+## Additional Functionality ##
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_array_configuration.should == [ :a_value_not_yet_used ]
-    # => CascadingConfiguration::MockClass.some_array_configuration.should == [ :another_value ]
-    # => CascadingConfiguration::MockModule.some_array_configuration.should == [ :some_value ]
-  end
+Cascading-configuration also provides several other convenience functions. 
 
-```
+### Variable Name Prefixing ###
 
-## Instance of First Inheriting Class ##
+Configuration prefix can be set so that variables use property name with the configuration prefix prepended.
 
-7. Instantiate first inheriting class.
+This can be done in order defined (current configuration prefix is stored for configuration), or it can be specified on a per-property basis.
 
 ```ruby
+module SomeModule
 
-  object_instance_two = CascadingConfiguration::MockClassSub1.new
+  include CascadingConfiguration
 
-```
+  attr_configuration :some_setting
 
-* Verify inherited value
+  self.some_setting = :a_value
 
-```ruby
+  instance_variables.include?( :@some_setting ) # => true
 
-  # => object_instance_two.some_array_configuration.should == [ :a_value_not_yet_used ]
-  # => object_instance_one.some_array_configuration.should == [ :yet_another_value ]
-  # => CascadingConfiguration::MockClass.some_array_configuration.should == [ :another_value ]
-  # => CascadingConfiguration::MockModule.some_array_configuration.should == [ :some_value ]
+  # we can declare a prefix for specific properties
+  attr_configuration_prefix '__configuration_prefix__', :some_other_setting
 
-```
+  attr_configuration :some_other_setting, :yet_another_setting
 
-## Second Inheriting Class ##
+  self.some_setting = :some_value
+  self.yet_another_setting = :another_value
 
-8. Second inheriting class.
+  instance_variables.include?( :@some_other_setting ) # => false
+  instance_variables.include?( :@__configuration_prefix__some_other_setting ) # => true
+  instance_variables.include?( :@yet_another_setting ) # => true
 
-* Verify inherited value
+  # or we can declare a prefix for all properties defined after prefix is declared
+  attr_configuration_prefix '__another_configuration_prefix__'
 
-```ruby
+  attr_configuration :still_another_prefix
 
-  class CascadingConfiguration::MockClassSub2 < CascadingConfiguration::MockClassSub1
-    # => some_array_configuration.should == [ :a_value_not_yet_used ]
-  end
+  instance_variables.include?( :@still_another_prefix ) # => false
+  instance_variables.include?( :@__another_configuration_prefix__still_another_prefix ) # => true
 
+end
 ```
 
-* Override inherited value
+### Method Redefinition ###
 
-```ruby
-
-  class CascadingConfiguration::MockClassSub2 < CascadingConfiguration::MockClassSub1
-    self.some_array_configuration = [ :another_value_not_yet_used ]
-  end
+Any declared configuration is defined in order to support locally redefining the method and accessing the original by calling super.
 
-```
+```ruby
+module SomeModule
 
-* Verify local override value
+  include CascadingConfiguration
 
-```ruby
+  attr_configuration :some_array_setting
 
-  class CascadingConfiguration::MockClassSub2 < CascadingConfiguration::MockClassSub1
-    # => some_array_configuration.should == [ :another_value_not_yet_used ]
+  def some_array_setting=( value )
+    puts 'Replacing configuration array!'
+    super
   end
 
+end
 ```
 
-## Instance of Second Inheriting Class ##
+### Hidden Configuration ###
 
-9. Instantiate Second Inheriting Class.
+#### :attr_hide ####
 
-```ruby
-
-  object_instance_three = CascadingConfiguration::MockClassSub2.new
-
-```
-
-* Verify inherited value
+Coming soon.
 
 ```ruby
+module SomeModule
 
-  # => object_instance_three.some_array_configuration.should == [ :another_value_not_yet_used ]
+  include CascadingConfiguration
 
-```
+  attr_configuration :some_array_setting
 
-* Override inherited value
+  instance_variables.include?( :@some_array_setting ) # => true
 
-```ruby
+  attr_hide :some_array_setting
 
-  object_instance_three.some_array_configuration = [ :one_more_unused_value ]
+  instance_variables.include?( :@some_array_setting ) # => false  
 
+end
 ```
 
-* Verify local override value
-
-```ruby
-
-  # => object_instance_three.some_array_configuration.should == [ :one_more_unused_value ]
-
-```
+Causes configuration variable to be stored in external context so that it is not included in instance variables.
 
 # License #
 

data/README.rdoc

@@ -1,32 +1,36 @@
 == Cascading Configuration
 
-http://rubygems.org/gems/cascading-configuration
+http://rubygems.org/gems/cascading-configuration-array
 
 == Description
 
-Adds methods for cascading configurations.
+Adds methods for cascading configuration arrays. Support package for cascading-configuration.
 
 == Summary
 
-Cascading configuration methods for single settings, arrays, hashes.
+Cascading configuration methods for arrays, which returns the appropriate lowest accumulated value. Configuration inheritance can cascade through modules, classes, and to instances.
 
-== :attr_configuration_array
+This means that we can create configuration modules, optionally setting configuration defaults, and include those configuration modules in other modules or classes.
 
-:attr_configuration_array provides inheritable configuration that cascades downward. 
+== :attr_configuration_array
 
-Configuration inheritance can cascade through modules, classes, and instances.
+:attr_configuration_array provides inheritable array configurations that cascade downward. A composite sorted and unique array will be returned (merging downward from most distant ancestor to self). 
 
-:attr_configuration_array defines a single attribute accessor that composes the set of configuration values appropriate to the ancestor level being queried (merging downward from most distant ancestor to self). An internal cache is kept, and any configuration updates that occur to higher-level ancestors cascade immediately downward.
+An internal cache is kept, and any configuration updates that occur to higher-level ancestors cascade immediately downward. 
 
 The array maintained by :attr_configuration_array is kept ordered and unique.
 
+:attr_class_configuration_array works like :attr_configuration_array but does not cascade to instances.
+
+:attr_local_configuration_array works like :attr_configuration_array but does not cascade. This is primarily useful for creating local configurations maintained in parallel with cascading configurations (for instance, with the same variable prefixes), for overriding the local configuration method, and for hiding the configuration variable (coming soon).
+
 == Install
 
 * sudo gem install cascading-configuration
 
 == Usage
 
-See supporting package README markdown files (README.md) for examples.
+See README.md
 
 == License
 

data/lib/cascading-configuration-array.rb

@@ -13,7 +13,7 @@ module CascadingConfiguration
   class LocalConfigurationArray < Array
   end
   module Array
-    module ConfigurationAccessors
+    module AccessorDefinitionMethods
     end
     module Interface
     end
@@ -30,6 +30,6 @@ require_relative 'cascading-configuration-array/CascadingConfiguration/Compositi
 require_relative 'cascading-configuration-array/CascadingConfiguration/LocalConfigurationArray.rb'
 require_relative 'cascading-configuration-array/CascadingConfiguration/_private_/LocalConfigurationArray.rb'
 require_relative 'cascading-configuration-array/CascadingConfiguration/Array.rb'
-require_relative 'cascading-configuration-array/CascadingConfiguration/Array/ConfigurationAccessors.rb'
+require_relative 'cascading-configuration-array/CascadingConfiguration/Array/AccessorDefinitionMethods.rb'
 require_relative 'cascading-configuration-array/CascadingConfiguration/Array/Interface.rb'
 require_relative 'cascading-configuration-array/CascadingConfiguration/Array/ModuleInclusionExtensionSupport.rb'

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

@@ -34,7 +34,7 @@ module CascadingConfiguration::Array
     class_or_module.instance_eval do
       extend module_self
       extend module_self::Interface
-      extend module_self::ConfigurationAccessors
+      extend module_self::AccessorDefinitionMethods
       extend CascadingConfiguration::Array::ModuleInclusionExtensionSupport unless is_a?( Class )
     end
   end
@@ -47,7 +47,7 @@ module CascadingConfiguration::Array
 		module_self = self
     class_or_module.instance_eval do
       extend  module_self::Interface
-      extend  module_self::ConfigurationAccessors
+      extend  module_self::AccessorDefinitionMethods
     end
   end
 

data/lib/cascading-configuration-array/CascadingConfiguration/Array/{ConfigurationAccessors.rb → AccessorDefinitionMethods.rb}

@@ -1,5 +1,5 @@
 
-module CascadingConfiguration::Array::ConfigurationAccessors
+module CascadingConfiguration::Array::AccessorDefinitionMethods
 
 	extend  CascadingConfiguration::InternalModuleStub
 
@@ -10,8 +10,8 @@ module CascadingConfiguration::Array::ConfigurationAccessors
   def define_cascading_array_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
 		self_instance = self
-    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_support_module|
-			accessor_support_module.module_eval do
+    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_module_support|
+			accessor_module_support.module_eval do
 		    define_method( configuration_setter_name ) do |array|
 		      composite_array = composite_array_for_cascading_configuration( configuration_name )
 		      # we want the array to supplant existing config
@@ -31,8 +31,8 @@ module CascadingConfiguration::Array::ConfigurationAccessors
   
   def define_cascading_array_getter( configuration_name )
     configuration_getter_name = configuration_name
-    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_support_module|
-			accessor_support_module.module_eval do
+    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_module_support|
+			accessor_module_support.module_eval do
 		    define_method( configuration_getter_name ) do
 		      return composite_array_for_cascading_configuration( configuration_name )
 		    end
@@ -78,7 +78,7 @@ module CascadingConfiguration::Array::ConfigurationAccessors
   
   def define_local_configuration_array_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    accessor_instance_support.module_eval do 
+    accessor_local_instance_support.module_eval do 
 	    define_method( configuration_setter_name ) do |array|
 	      composite_array = composite_array_for_cascading_configuration( configuration_name )
 	      # we want the array to supplant existing config
@@ -97,7 +97,7 @@ module CascadingConfiguration::Array::ConfigurationAccessors
   
   def define_local_configuration_array_getter( configuration_name )
     configuration_getter_name = configuration_name
-    accessor_instance_support.module_eval do 
+    accessor_local_instance_support.module_eval do 
 	    define_method( configuration_getter_name ) do
 	      return composite_array_for_cascading_configuration( configuration_name )
 	    end

data/lib/cascading-configuration-array/CascadingConfiguration/Array/Interface.rb

@@ -18,13 +18,13 @@ module CascadingConfiguration::Array::Interface
     end
   end
 
-  ####################################
-  #  attr_class_configuration_array  #
-  ####################################
+  #####################################
+  #  attr_module_configuration_array  #
+  #####################################
 
 	# defines configuration in class or module
 	# configuration cascades downward to last class or module
-  def attr_class_configuration_array( *property_names )
+  def attr_module_configuration_array( *property_names )
     property_names.each do |this_property_name|
       # define configuration setter
       define_class_configuration_array_setter( this_property_name )
@@ -32,6 +32,7 @@ module CascadingConfiguration::Array::Interface
       define_class_configuration_array_getter( this_property_name )
     end
   end
+	alias_method :attr_class_configuration_array, :attr_module_configuration_array
 
   ####################################
   #  attr_local_configuration_array  #
@@ -40,6 +41,7 @@ module CascadingConfiguration::Array::Interface
 	# defines configuration in present class or module context
 	# configuration does not cascade
   def attr_local_configuration_array( *property_names )
+		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
     property_names.each do |this_property_name|
       # define configuration setter
       define_local_configuration_array_setter( this_property_name )

data/spec/CascadingConfiguration/Array/{ConfigurationAccessors_spec.rb → AccessorDefinitionMethods_spec.rb}

@@ -1,7 +1,7 @@
 
 require_relative '../../../lib/cascading-configuration-array.rb'
 
-describe CascadingConfiguration::Array::ConfigurationAccessors do
+describe CascadingConfiguration::Array::AccessorDefinitionMethods do
 
   ###################################
   #  define_cascading_array_setter  #
@@ -11,7 +11,7 @@ describe CascadingConfiguration::Array::ConfigurationAccessors do
   it 'can define a method to get and modify the configuration array' do
     class CascadingConfiguration::Array::Mock
       include CascadingConfiguration::Variable
-      extend  CascadingConfiguration::Array::ConfigurationAccessors
+      extend  CascadingConfiguration::Array::AccessorDefinitionMethods
       include CascadingConfiguration::Array::ObjectInstance
       extend  CascadingConfiguration::Array::Interface
     end

data/spec/CascadingConfiguration/Array_spec.rb

@@ -21,7 +21,7 @@ describe CascadingConfiguration::Array do
     # => instances of including classes get configurations
     # => extending modules and classes get attr_configuration and configurations
     # => instances of extending classes get nothing
-    module CascadingConfiguration::Array::MockModuleExtended
+    module CascadingConfiguration::Array::ConfigurationMockModuleExtended
       extend CascadingConfiguration::Array
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration_array ).should == true
@@ -33,31 +33,31 @@ describe CascadingConfiguration::Array do
       instance_methods.include?( :configuration_setting ).should == false
       # => including modules and classes get nothing
       module SubmoduleIncluding
-        include CascadingConfiguration::Array::MockModuleExtended
+        include CascadingConfiguration::Array::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
       # => extending modules and classes get nothing
       module SubmoduleExtending
-        extend CascadingConfiguration::Array::MockModuleExtended
+        extend CascadingConfiguration::Array::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
       # => instances of including and extending classes get nothing
       class ClassIncluding
-        include CascadingConfiguration::Array::MockModuleExtended
+        include CascadingConfiguration::Array::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
       class ClassExtending
-        extend CascadingConfiguration::Array::MockModuleExtended
+        extend CascadingConfiguration::Array::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
     end
 
     # * module included with setting
-    module CascadingConfiguration::Array::MockModuleIncluded
+    module CascadingConfiguration::Array::ConfigurationMockModuleIncluded
       include CascadingConfiguration::Array
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration_array ).should == true
@@ -69,7 +69,7 @@ describe CascadingConfiguration::Array do
       instance_methods.include?( :configuration_setting ).should == true
       # => including modules and classes get attr_configuration and configurations
       module SubmoduleIncluding
-        include CascadingConfiguration::Array::MockModuleIncluded
+        include CascadingConfiguration::Array::ConfigurationMockModuleIncluded
         instance_methods.include?( :configuration_setting ).should == true
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == [ :a_configuration ]
@@ -78,7 +78,7 @@ describe CascadingConfiguration::Array do
       end
       # => extending modules and classes get attr_configuration and configurations
       module SubmoduleExtending
-        extend CascadingConfiguration::Array::MockModuleIncluded
+        extend CascadingConfiguration::Array::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
@@ -90,7 +90,7 @@ describe CascadingConfiguration::Array do
       end
       # => instances of including classes get configurations
       class ClassIncluding
-        include CascadingConfiguration::Array::MockModuleIncluded
+        include CascadingConfiguration::Array::ConfigurationMockModuleIncluded
         instance_methods.include?( :configuration_setting ).should == true
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == [ :a_configuration ]
@@ -105,7 +105,7 @@ describe CascadingConfiguration::Array do
       setting_class_including_instance.configuration_setting.should == [ :our_setting_value ]
       # => instances of extending classes get nothing
       class ClassExtending
-        extend CascadingConfiguration::Array::MockModuleIncluded
+        extend CascadingConfiguration::Array::ConfigurationMockModuleIncluded
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == [ :a_configuration ]
         configuration_setting.push( :some_other_configuration )
@@ -115,50 +115,319 @@ describe CascadingConfiguration::Array do
       setting_class_including_instance.respond_to?( :configuration_setting ).should == false
     end
 
-    class CascadingConfiguration::Array::MockClass
-      include CascadingConfiguration::Array::MockModuleIncluded::SubmoduleIncluding
+    class CascadingConfiguration::Array::ConfigurationMockClass
+      include CascadingConfiguration::Array::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 ]
     end
-    object_instance_one = CascadingConfiguration::Array::MockClass.new
+    object_instance_one = CascadingConfiguration::Array::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 ]
-    class CascadingConfiguration::Array::MockClassSub1 < CascadingConfiguration::Array::MockClass
+    class CascadingConfiguration::Array::ConfigurationMockClassSub1 < CascadingConfiguration::Array::ConfigurationMockClass
       configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
       configuration_setting.delete( :a_configuration )
       configuration_setting.should == [ :another_configuration, :some_other_configuration ]
     end
-    object_instance_two = CascadingConfiguration::Array::MockClassSub1.new
+    object_instance_two = CascadingConfiguration::Array::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 ]
-    class CascadingConfiguration::Array::MockClassSub2 < CascadingConfiguration::Array::MockClassSub1
+    class CascadingConfiguration::Array::ConfigurationMockClassSub2 < CascadingConfiguration::Array::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 ]
     end
 
     # change ancestor setting
-    CascadingConfiguration::Array::MockClass.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
-    CascadingConfiguration::Array::MockClass.configuration_setting.push( :a_yet_unused_configuration )
-    CascadingConfiguration::Array::MockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ConfigurationMockClass.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ConfigurationMockClass.configuration_setting.push( :a_yet_unused_configuration )
+    CascadingConfiguration::Array::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::MockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::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::MockClassSub1.configuration_setting.freeze!
-    CascadingConfiguration::Array::MockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
-    CascadingConfiguration::Array::MockClass.configuration_setting.push( :non_cascading_configuration )
-    CascadingConfiguration::Array::MockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :non_cascading_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Array::ConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ConfigurationMockClass.configuration_setting.push( :non_cascading_configuration )
+    CascadingConfiguration::Array::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::MockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::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_configuration_array  #
+  #  attr_class_configuration_array   #
+  #####################################
+  
+  it 'can define a class configuration array, which will not cascade to instances' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_configuration 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_configuration and configurations
+    # => including modules and classes get attr_configuration and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_configuration and configurations
+    # => instances of extending classes get nothing
+    module CascadingConfiguration::Array::ClassConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_module_configuration_array ).should == true
+      method( :attr_module_configuration_array ).should == method( :attr_class_configuration_array )
+      attr_module_configuration_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+    end
+
+    # * module included with setting
+    module CascadingConfiguration::Array::ClassConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_module_configuration_array ).should == true
+      attr_module_configuration_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::ClassConfigurationMockModuleIncluded
+        instance_methods.include?( :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 ]
+        instance_methods.include?( :configuration_setting ).should == false
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::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 == true
+        configuration_setting.should == [ :a_configuration ]
+        configuration_setting.push( :some_other_configuration )
+        configuration_setting.should == [ :a_configuration, :some_other_configuration ]
+        instance_methods.include?( :configuration_setting ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::ClassConfigurationMockModuleIncluded
+        instance_methods.include?( :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 ]
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::ClassConfigurationMockModuleIncluded
+        instance_methods.include?( :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 ]
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+    end
+
+    class CascadingConfiguration::Array::ClassConfigurationMockClass
+      include CascadingConfiguration::Array::ClassConfigurationMockModuleIncluded::SubmoduleIncluding
+      instance_methods.include?( :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 ]
+    end
+    object_instance_one = CascadingConfiguration::Array::ClassConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == false
+    class CascadingConfiguration::Array::ClassConfigurationMockClassSub1 < CascadingConfiguration::Array::ClassConfigurationMockClass
+      instance_methods.include?( :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 ]
+    end
+    object_instance_two = CascadingConfiguration::Array::ClassConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == false
+    class CascadingConfiguration::Array::ClassConfigurationMockClassSub2 < CascadingConfiguration::Array::ClassConfigurationMockClassSub1
+      instance_methods.include?( :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 ]
+    end
+
+    # change ancestor setting
+    CascadingConfiguration::Array::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ClassConfigurationMockClass.configuration_setting.push( :a_yet_unused_configuration )
+    CascadingConfiguration::Array::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    
+    # freeze ancestor setting
+    CascadingConfiguration::Array::ClassConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Array::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ClassConfigurationMockClass.configuration_setting.push( :non_cascading_configuration )
+    CascadingConfiguration::Array::ClassConfigurationMockClass.configuration_setting.should == [ :a_configuration, :a_yet_unused_configuration, :another_configuration, :non_cascading_configuration, :some_other_configuration ]
+    CascadingConfiguration::Array::ClassConfigurationMockClassSub1.configuration_setting.should == [ :a_yet_unused_configuration, :another_configuration, :some_other_configuration ]
+        
+  end
+  
+  ####################################
+  #  attr_local_configuration_array  #
+  ####################################
+  
+  it 'can define a local configuration array, which will not cascade' do
+
+    # possibilities:
+    # * module extended with setting
+    # => singleton gets attr_configuration 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_configuration and configurations
+    # => including modules and classes get attr_configuration and configurations
+    # => instances of including classes get configurations
+    # => extending modules and classes get attr_configuration and configurations
+    # => instances of extending classes get nothing
+    module CascadingConfiguration::Array::LocalConfigurationMockModuleExtended
+      extend CascadingConfiguration::Array
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration_array ).should == true
+      attr_local_configuration_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Array::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Array::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+    end
+
+    # * module included with setting
+    module CascadingConfiguration::Array::LocalConfigurationMockModuleIncluded
+      include CascadingConfiguration::Array
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration_array ).should == true
+      attr_local_configuration_array :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == []
+      configuration_setting.push( :a_configuration )
+      configuration_setting.should == [ :a_configuration ]
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Array::LocalConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+        instance_methods.include?( :configuration_setting ).should == false
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Array::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 == false
+        instance_methods.include?( :configuration_setting ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Array::LocalConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Array::LocalConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+    end
+
+    class CascadingConfiguration::Array::LocalConfigurationMockClass
+      include CascadingConfiguration::Array::LocalConfigurationMockModuleIncluded::SubmoduleIncluding
+      instance_methods.include?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+    end
+    object_instance_one = CascadingConfiguration::Array::LocalConfigurationMockClass.new
+    object_instance_one.respond_to?( :configuration_setting ).should == false
+    class CascadingConfiguration::Array::LocalConfigurationMockClassSub1 < CascadingConfiguration::Array::LocalConfigurationMockClass
+      instance_methods.include?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+    end
+    object_instance_two = CascadingConfiguration::Array::LocalConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :configuration_setting ).should == false
+    class CascadingConfiguration::Array::LocalConfigurationMockClassSub2 < CascadingConfiguration::Array::LocalConfigurationMockClassSub1
+      instance_methods.include?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+    end
+        
+  end
   
 end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 1
-  - 6
-  version: 1.1.6
+  - 2
+  - 0
+  version: 1.2.0
 platform: ruby
 authors: 
 - Asher
@@ -41,7 +41,7 @@ extra_rdoc_files: []
 files: 
 - lib/cascading-configuration-array/CascadingConfiguration/_private_/CompositingArray.rb
 - lib/cascading-configuration-array/CascadingConfiguration/_private_/LocalConfigurationArray.rb
-- lib/cascading-configuration-array/CascadingConfiguration/Array/ConfigurationAccessors.rb
+- lib/cascading-configuration-array/CascadingConfiguration/Array/AccessorDefinitionMethods.rb
 - lib/cascading-configuration-array/CascadingConfiguration/Array/Interface.rb
 - lib/cascading-configuration-array/CascadingConfiguration/Array/ModuleInclusionExtensionSupport.rb
 - lib/cascading-configuration-array/CascadingConfiguration/Array.rb
@@ -49,7 +49,7 @@ files:
 - lib/cascading-configuration-array/CascadingConfiguration/CompositingArray.rb
 - lib/cascading-configuration-array/CascadingConfiguration/LocalConfigurationArray.rb
 - lib/cascading-configuration-array.rb
-- spec/CascadingConfiguration/Array/ConfigurationAccessors_spec.rb
+- spec/CascadingConfiguration/Array/AccessorDefinitionMethods_spec.rb
 - spec/CascadingConfiguration/Array_spec.rb
 - spec/CascadingConfiguration/CompositingArray_spec.rb
 - spec/CascadingConfiguration/LocalConfigurationArray_spec.rb