cascading-configuration-hash 1.1.6 → 1.2.0

data/README.md

@@ -1,4 +1,4 @@
-# Cascading Configuration #
+# Cascading Configuration Hash #
 
 http://rubygems.org/gems/cascading-configuration-hash
 
@@ -8,336 +8,254 @@ Adds methods for cascading configuration hashes. Support package for cascading-c
 
 # Summary #
 
-## :attr_configuration_hash ##
-
-:attr_configuration_hash provides inheritable configuration that cascades downward. 
-
-Configuration inheritance can cascade through modules, classes, and instances.
+Cascading configuration methods for hashes, which returns the appropriate lowest accumulated value. Configuration inheritance can cascade through modules, classes, and to instances.
 
-:attr_configuration_hash 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.
+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-hash
+* 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_hash.
-
-```ruby
-
-  module CascadingConfiguration::MockModule
-	include CascadingConfiguration::Hash
-  end
-
-```
-
-* Declare attr_configuration_hash.
+Including the module will enable support for singleton and for instances.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-    attr_configuration_hash :some_hash_configuration
-  end
-
+module AnyModuleOrClass
+  include CascadingConfiguration
+end
 ```
 
-* Set initial value.
+Extending the module will enable support for singleton only.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-    self.some_hash_configuration = { :some_value => :some_value }
-  end
-
+module AnyModuleOrClass
+  extend CascadingConfiguration
+end
 ```
 
-* Verify initial configuration value
-
-```ruby
+Including or extending CascadingConfiguration includes or extends:
 
-  module CascadingConfiguration::MockModule
-    # => some_hash_configuration.should == { :some_value => :some_value }
-  end
+* CascadingConfiguration::Variable
 
-```
+## :attr_configuration_hash ##
 
-## Including Module 1 ##
+:attr_configuration_array provides inheritable hash configurations that cascade downward. A composite hash will be returned (merging downward from most distant ancestor to self). 
 
-2. Include initial module in another module.
+An internal cache is kept, and any configuration updates that occur to higher-level ancestors cascade immediately downward.
 
-Including the module that has included a CascadingConfiguration module is the same as including a CascadingConfiguration module.
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  module CascadingConfiguration::MockModule2
-    include CascadingConfiguration::MockModule
-  end
+  include CascadingConfiguration::Hash
 
-```
+  attr_configuration_hash :some_hash_setting
 
-* Verify inherited value
+  some_hash_setting # => nil
 
-```ruby
+  some_hash_setting[ :some_setting ] = :some_value
 
-  module CascadingConfiguration::MockModule2
-    # => some_hash_configuration.should == { :some_value => :some_value }
-  end
+  some_hash_setting[ :some_setting ] # => :some_value
 
+end
 ```
 
-* Override inherited value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  module CascadingConfiguration::MockModule2
-    self.some_hash_configuration = { :module_value => :some_value }
-  end
-
-```
+  include SomeModule
 
-* Verify local override value
+  some_hash_setting[ :some_setting ] # => :some_value
 
-```ruby
+  self.some_hash_setting.replace( :some_other_setting => :some_other_value )
 
-  module CascadingConfiguration::MockModule2
-    # => some_hash_configuration.should == { :module_value => :some_value }
-  end
+  some_hash_setting # => { :some_other_setting => :some_other_value }
 
+end
 ```
 
-## Including Module 2 ##
-
-3. Include second module in another module.
+And it cascades to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  module CascadingConfiguration::MockModule3
-    include CascadingConfiguration::MockModule2
-  end
-
-```
-
-* Verify inherited value
-
-```ruby
+instance.some_hash_setting.should == { :some_other_setting => :some_other_value }
 
-  module CascadingConfiguration::MockModule3
-    # => some_array_configuration.should == { :module_value => :some_value }
-  end
+instance.some_hash_setting.delete( :some_other_setting )
 
+instance.some_hash_setting.should == {}
 ```
 
-## Top Class ##
-
-4. Include third module in a class.
+### :attr_module_configuration_hash, :attr_class_configuration_hash ###
 
-```ruby
-
-  class CascadingConfiguration::MockClass
-    include CascadingConfiguration::MockModule3
-  end
+:attr_class_configuration_hash works like :attr_configuration_hash but does not cascade to instances.
 
-```
-
-* Verify inherited value
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  class CascadingConfiguration::MockClass
-    # => some_hash_configuration.should == { :module_value => :some_value }
-  end
+  include CascadingConfiguration::Hash
 
-```
+  attr_class_configuration_hash :some_hash_setting
 
-* Override inherited value
+  some_hash_setting # => nil
 
-```ruby
+  some_hash_setting[ :some_setting ] = :some_value
 
-  class CascadingConfiguration::MockClass
-    self.some_hash_configuration = { :another_value => :some_value }
-  end
+  some_hash_setting[ :some_setting ] # => :some_value
 
+end
 ```
 
-* Verify local override value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  class CascadingConfiguration::MockClass
-    # => some_hash_configuration.should == { :another_value => :some_value }
-  end
-
-```
-
-## Instance of Top Class ##
+  include SomeModule
 
-5. Instantiate class.
+  some_hash_setting[ :some_setting ] # => :some_value
 
-```ruby
+  self.some_hash_setting.replace( :some_other_setting => :some_other_value )
 
-  object_instance_one = CascadingConfiguration::MockClass.new
+  some_hash_setting # => { :some_other_setting => :some_other_value }
 
+end
 ```
 
-* Verify inherited value
+And it does not cascade to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  # => object_instance_one.some_hash_configuration.should == { :another_value => :some_value }
-
+instance.respond_to?( :some_hash_setting ).should == false
 ```
 
-* Override inherited value
-
-```ruby
-
-  object_instance_one.some_hash_configuration = { :yet_another_value => :some_value }
+### :attr_local_configuration_hash ###
 
-```
+:attr_local_configuration_hash works like :attr_configuration_hash 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).
 
-* Verify local override value
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  # => object_instance_one.some_hash_configuration.should == { :yet_another_value => :some_value }
-  # => CascadingConfiguration::MockClass.some_hash_configuration.should == { :another_value => :some_value }
-  # => CascadingConfiguration::MockModule.some_hash_configuration.should == { :some_value => :some_value }
-
-```
-
-# First Inheriting Class #
-
-6. Inheriting class.
+  include CascadingConfiguration::Hash
 
-Inheriting class should not get any settings from instance of superclass.
+  attr_class_configuration_hash :some_hash_setting
 
-* Verify inherited value
+  some_hash_setting # => nil
 
-```ruby
+  some_hash_setting[ :some_setting ] = :some_value
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_hash_configuration.should == { :another_value => :some_value }
-  end
+  some_hash_setting[ :some_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_hash_configuration = { :a_value_not_yet_used => :some_value }
-  end
+  include SomeModule
 
-```
+  respond_to?( :some_hash_setting ).should == false
 
-* Verify local override value
+end
+```
 
-```ruby
+## Additional Functionality ##
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_hash_configuration.should == { :a_value_not_yet_used => :some_value }
-    # => CascadingConfiguration::MockClass.some_hash_configuration.should == { :another_value => :some_value }
-    # => CascadingConfiguration::MockModule.some_hash_configuration.should == { :some_value => :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_hash_configuration.should == { :a_value_not_yet_used => :some_value }
-  # => object_instance_one.some_hash_configuration.should == { :yet_another_value => :some_value }
-  # => CascadingConfiguration::MockClass.some_hash_configuration.should == { :another_value => :some_value }
-  # => CascadingConfiguration::MockModule.some_hash_configuration.should == { :some_value => :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_hash_configuration.should == { :a_value_not_yet_used => :some_value }
-  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_hash_configuration = { :another_value_not_yet_used => :some_value }
-  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_hash_configuration.should == { :another_value_not_yet_used => :some_value }
+  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_hash_configuration.should == { :another_value_not_yet_used => :some_value }
+  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_hash_configuration = { :one_more_unused_value => :some_value }
+  instance_variables.include?( :@some_array_setting ) # => false  
 
+end
 ```
 
-* Verify local override value
-
-```ruby
-
-  # => object_instance_three.some_hash_configuration.should == { :one_more_unused_value => :some_value }
-
-```
+Causes configuration variable to be stored in external context so that it is not included in instance variables.
 
 # License #
 

data/README.rdoc

@@ -1,30 +1,34 @@
 == Cascading Configuration
 
-http://rubygems.org/gems/cascading-configuration
+http://rubygems.org/gems/cascading-configuration-hash
 
 == Description
 
-Adds methods for cascading configurations.
+Adds methods for cascading configuration hashes. Support package for cascading-configuration.
 
 == Summary
 
-Cascading configuration methods for single settings, arrays, hashes.
+Cascading configuration methods for hashes, which returns the appropriate lowest accumulated value. Configuration inheritance can cascade through modules, classes, and to instances.
+
+This means that we can create configuration modules, optionally setting configuration defaults, and include those configuration modules in other modules or classes.
 
 == :attr_configuration_hash
 
-:attr_configuration_hash provides inheritable configuration that cascades downward. 
+:attr_configuration_array provides inheritable hash configurations that cascade downward. A composite hash will be returned (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.
 
-Configuration inheritance can cascade through modules, classes, and instances.
+:attr_class_configuration_hash works like :attr_configuration_hash but does not cascade to instances.
 
-:attr_configuration_hash 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.
+:attr_local_configuration_hash works like :attr_configuration_hash 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
+* sudo gem install cascading-configuration-hash
 
 == Usage
 
-See supporting package README markdown files (README.md) for examples.
+See README.md
 
 == License
 

data/lib/cascading-configuration-hash.rb

@@ -13,7 +13,7 @@ module CascadingConfiguration
   class LocalConfigurationHash < Hash
   end
   module Hash
-    module ConfigurationAccessors
+    module AccessorDefinitionMethods
     end
     module Interface
     end
@@ -30,6 +30,6 @@ require_relative 'cascading-configuration-hash/CascadingConfiguration/Compositin
 require_relative 'cascading-configuration-hash/CascadingConfiguration/LocalConfigurationHash.rb'
 require_relative 'cascading-configuration-hash/CascadingConfiguration/_private_/LocalConfigurationHash.rb'
 require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/ConfigurationAccessors.rb'
+require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/AccessorDefinitionMethods.rb'
 require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/Interface.rb'
 require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/ModuleInclusionExtensionSupport.rb'

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

@@ -34,7 +34,7 @@ module CascadingConfiguration::Hash
     class_or_module.instance_eval do
       extend module_self
       extend module_self::Interface
-      extend module_self::ConfigurationAccessors
+      extend module_self::AccessorDefinitionMethods
       extend CascadingConfiguration::Hash::ModuleInclusionExtensionSupport unless is_a?( Class )
     end
   end
@@ -47,7 +47,7 @@ module CascadingConfiguration::Hash
 		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-hash/CascadingConfiguration/Hash/{ConfigurationAccessors.rb → AccessorDefinitionMethods.rb}

@@ -1,5 +1,5 @@
 
-module CascadingConfiguration::Hash::ConfigurationAccessors
+module CascadingConfiguration::Hash::AccessorDefinitionMethods
 
 	extend  CascadingConfiguration::InternalModuleStub
 
@@ -9,8 +9,8 @@ module CascadingConfiguration::Hash::ConfigurationAccessors
   
   def define_cascading_hash_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    [ 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 |hash|
 		      # we want the hash to supplant existing config
 		      return composite_hash_for_cascading_configuration( configuration_name ).replace( hash )
@@ -25,8 +25,8 @@ module CascadingConfiguration::Hash::ConfigurationAccessors
   
   def define_cascading_hash_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_hash_for_cascading_configuration( configuration_name )
 		    end
@@ -67,7 +67,7 @@ module CascadingConfiguration::Hash::ConfigurationAccessors
   
   def define_local_configuration_hash_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 |hash|
 	      # we want the hash to supplant existing config
 	      return composite_hash_for_cascading_configuration( configuration_name ).replace( hash )
@@ -81,7 +81,7 @@ module CascadingConfiguration::Hash::ConfigurationAccessors
   
   def define_local_configuration_hash_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_hash_for_cascading_configuration( configuration_name )
 	    end

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

@@ -23,13 +23,13 @@ module CascadingConfiguration::Hash::Interface
 
   end
 
-  ###################################
-  #  attr_class_configuration_hash  #
-  ###################################
+  ####################################
+  #  attr_module_configuration_hash  #
+  ####################################
 
 	# defines configuration in class or module
 	# configuration cascades downward to last class or module
-  def attr_class_configuration_hash( *property_names, & compositing_block )
+  def attr_module_configuration_hash( *property_names, & compositing_block )
     
     property_names.each do |this_property_name|
 			accessor_module_support.set_compositing_proc( this_property_name, compositing_block ) if block_given?
@@ -42,6 +42,7 @@ module CascadingConfiguration::Hash::Interface
     return self
 
   end
+	alias_method :attr_class_configuration_hash, :attr_module_configuration_hash
 
   ###################################
   #  attr_local_configuration_hash  #
@@ -50,7 +51,9 @@ module CascadingConfiguration::Hash::Interface
 	# defines configuration in present class or module context
 	# configuration does not cascade
   def attr_local_configuration_hash( *property_names, & compositing_block )
-    
+
+		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
+
     property_names.each do |this_property_name|
 			accessor_module_support.set_compositing_proc( this_property_name, compositing_block ) if block_given?
       # define configuration setter

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

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

data/spec/CascadingConfiguration/Hash_spec.rb

@@ -21,7 +21,7 @@ describe CascadingConfiguration::Hash do
     # => instances of including classes get configurations
     # => extending modules and classes get attr_configuration and configurations
     # => instances of extending classes get nothing
-    module CascadingConfiguration::Hash::MockModuleExtended
+    module CascadingConfiguration::Hash::ConfigurationMockModuleExtended
       extend CascadingConfiguration::Hash
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration_hash ).should == true
@@ -33,31 +33,31 @@ describe CascadingConfiguration::Hash do
       instance_methods.include?( :configuration_setting ).should == false
       # => including modules and classes get nothing
       module SubmoduleIncluding
-        include CascadingConfiguration::Hash::MockModuleExtended
+        include CascadingConfiguration::Hash::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::Hash::MockModuleExtended
+        extend CascadingConfiguration::Hash::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::Hash::MockModuleExtended
+        include CascadingConfiguration::Hash::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
       class ClassExtending
-        extend CascadingConfiguration::Hash::MockModuleExtended
+        extend CascadingConfiguration::Hash::ConfigurationMockModuleExtended
         instance_methods.include?( :configuration_setting ).should == false
         respond_to?( :configuration_setting ).should == false
       end
     end
 
     # * module included with setting
-    module CascadingConfiguration::Hash::MockModuleIncluded
+    module CascadingConfiguration::Hash::ConfigurationMockModuleIncluded
       include CascadingConfiguration::Hash
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration_hash ).should == true
@@ -69,7 +69,7 @@ describe CascadingConfiguration::Hash do
       instance_methods.include?( :configuration_setting ).should == true
       # => including modules and classes get attr_configuration and configurations
       module SubmoduleIncluding
-        include CascadingConfiguration::Hash::MockModuleIncluded
+        include CascadingConfiguration::Hash::ConfigurationMockModuleIncluded
         instance_methods.include?( :configuration_setting ).should == true
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == { :a_configuration => :some_value }
@@ -81,7 +81,7 @@ describe CascadingConfiguration::Hash do
       end
       # => extending modules and classes get attr_configuration and configurations
       module SubmoduleExtending
-        extend CascadingConfiguration::Hash::MockModuleIncluded
+        extend CascadingConfiguration::Hash::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
@@ -96,7 +96,7 @@ describe CascadingConfiguration::Hash do
       end
       # => instances of including classes get configurations
       class ClassIncluding
-        include CascadingConfiguration::Hash::MockModuleIncluded
+        include CascadingConfiguration::Hash::ConfigurationMockModuleIncluded
         instance_methods.include?( :configuration_setting ).should == true
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == { :a_configuration => :some_value }
@@ -111,7 +111,7 @@ describe CascadingConfiguration::Hash do
       setting_class_including_instance.configuration_setting.should == { :a_configuration => :some_value }
       setting_class_including_instance.configuration_setting.delete( :a_configuration )
       class ClassExtending
-        extend CascadingConfiguration::Hash::MockModuleIncluded
+        extend CascadingConfiguration::Hash::ConfigurationMockModuleIncluded
         respond_to?( :configuration_setting ).should == true
         configuration_setting.should == { :a_configuration => :some_value }
         configuration_setting[ :other_setting ] = :some_value
@@ -124,8 +124,8 @@ describe CascadingConfiguration::Hash do
       setting_class_including_instance.respond_to?( :configuration_setting ).should == false
     end
 
-    class CascadingConfiguration::Hash::MockClass
-      include CascadingConfiguration::Hash::MockModuleIncluded::SubmoduleIncluding
+    class CascadingConfiguration::Hash::ConfigurationMockClass
+      include CascadingConfiguration::Hash::ConfigurationMockModuleIncluded::SubmoduleIncluding
       configuration_setting.should == { :a_configuration => :some_value }
       configuration_setting[ :other_setting ] = :some_value
       configuration_setting.should == { :a_configuration => :some_value,
@@ -134,20 +134,20 @@ describe CascadingConfiguration::Hash do
       configuration_setting.should == { :a_configuration => :some_value }
     end
 
-    object_instance_one = CascadingConfiguration::Hash::MockClass.new
+    object_instance_one = CascadingConfiguration::Hash::ConfigurationMockClass.new
     object_instance_one.configuration_setting.should == { :a_configuration => :some_value }
     object_instance_one.configuration_setting[ :some_other_configuration ] = :some_value
     object_instance_one.configuration_setting.should == { :a_configuration          => :some_value,
                                                           :some_other_configuration => :some_value }
     
-    class CascadingConfiguration::Hash::MockClassSub1 < CascadingConfiguration::Hash::MockClass
+    class CascadingConfiguration::Hash::ConfigurationMockClassSub1 < CascadingConfiguration::Hash::ConfigurationMockClass
       configuration_setting.should == { :a_configuration => :some_value }
       self.configuration_setting[ :another_configuration ] = :some_value
       configuration_setting.should == { :a_configuration       => :some_value,
                                         :another_configuration => :some_value }
     end
 
-    object_instance_two = CascadingConfiguration::Hash::MockClassSub1.new
+    object_instance_two = CascadingConfiguration::Hash::ConfigurationMockClassSub1.new
     object_instance_two.configuration_setting.should == { :a_configuration       => :some_value,
                                                           :another_configuration => :some_value }
     object_instance_two.configuration_setting[ :some_other_configuration ] = :some_value
@@ -156,13 +156,13 @@ describe CascadingConfiguration::Hash do
                                                           :some_other_configuration => :some_value }
 
     # change ancestor setting
-    CascadingConfiguration::Hash::MockClass.configuration_setting[ :a_yet_unused_configuration ] = :some_value
-    CascadingConfiguration::Hash::MockClass.configuration_setting.should == { :a_configuration            => :some_value,
+    CascadingConfiguration::Hash::ConfigurationMockClass.configuration_setting[ :a_yet_unused_configuration ] = :some_value
+    CascadingConfiguration::Hash::ConfigurationMockClass.configuration_setting.should == { :a_configuration            => :some_value,
                                                                               :a_yet_unused_configuration => :some_value }
     object_instance_one.configuration_setting.should == { :a_configuration            => :some_value,
                                                           :a_yet_unused_configuration => :some_value,
                                                           :some_other_configuration   => :some_value }
-    CascadingConfiguration::Hash::MockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+    CascadingConfiguration::Hash::ConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
                                                                                   :a_yet_unused_configuration => :some_value,
                                                                                   :another_configuration      => :some_value }
     object_instance_two.configuration_setting.should == { :a_configuration            => :some_value,
@@ -175,18 +175,18 @@ describe CascadingConfiguration::Hash do
     object_instance_one.configuration_setting.should == { :a_configuration            => :some_value,
                                                           :a_yet_unused_configuration => :some_value,
                                                           :some_other_configuration   => :some_value }
-    CascadingConfiguration::Hash::MockClassSub1.configuration_setting.freeze!
-    CascadingConfiguration::Hash::MockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+    CascadingConfiguration::Hash::ConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Hash::ConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
                                                                                   :a_yet_unused_configuration => :some_value,
                                                                                   :another_configuration      => :some_value }
-    CascadingConfiguration::Hash::MockClass.configuration_setting[ :non_cascading_configuration ] = :some_value
-    CascadingConfiguration::Hash::MockClass.configuration_setting.should == { :a_configuration             => :some_value,
+    CascadingConfiguration::Hash::ConfigurationMockClass.configuration_setting[ :non_cascading_configuration ] = :some_value
+    CascadingConfiguration::Hash::ConfigurationMockClass.configuration_setting.should == { :a_configuration             => :some_value,
                                                                               :a_yet_unused_configuration  => :some_value,
                                                                               :non_cascading_configuration => :some_value }
     object_instance_one.configuration_setting.should == { :a_configuration            => :some_value,
                                                           :a_yet_unused_configuration => :some_value,
                                                           :some_other_configuration   => :some_value }
-    CascadingConfiguration::Hash::MockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+    CascadingConfiguration::Hash::ConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
                                                                                   :a_yet_unused_configuration => :some_value,
                                                                                   :another_configuration      => :some_value }
     object_instance_two.configuration_setting.should == { :a_configuration            => :some_value,
@@ -194,7 +194,7 @@ describe CascadingConfiguration::Hash do
                                                           :another_configuration      => :some_value,
                                                           :some_other_configuration   => :some_value }
 
-    module CascadingConfiguration::Hash::MockModule
+    module CascadingConfiguration::Hash::ConfigurationMockModule
       include CascadingConfiguration::Hash
       attr_configuration_hash :some_hash do |parent_hash, composite_hash|
         parent_hash.each do |this_key, this_data|
@@ -210,8 +210,8 @@ describe CascadingConfiguration::Hash do
       self.some_hash.should == { :one => 1, :two => 2 }
     end
 
-    module CascadingConfiguration::Hash::MockModule2
-      include CascadingConfiguration::Hash::MockModule
+    module CascadingConfiguration::Hash::ConfigurationMockModule2
+      include CascadingConfiguration::Hash::ConfigurationMockModule
       self.some_hash.should == { :one => 1, :two => 2 }
       self.some_hash.replace( { :one => 1, :two => 2 } )
       self.some_hash.should == { :one => 0, :two => 0 }
@@ -219,4 +219,314 @@ describe CascadingConfiguration::Hash do
     
   end
   
+  ####################################
+  #  attr_module_configuration_hash  #
+  #  attr_class_configuration_hash   #
+  ####################################
+  
+  it 'can define a class configuration hash, 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::Hash::ClassConfigurationMockModuleExtended
+      extend CascadingConfiguration::Hash
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_module_configuration_hash ).should == true
+      method( :attr_module_configuration_hash ).should == method( :attr_class_configuration_hash )
+      attr_module_configuration_hash :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == {}
+      self.configuration_setting[ :a_configuration ] = :some_value
+      configuration_setting.should == { :a_configuration => :some_value }
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Hash::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::Hash::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::Hash::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Hash::ClassConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+    end
+
+    # * module included with setting
+    module CascadingConfiguration::Hash::ClassConfigurationMockModuleIncluded
+      include CascadingConfiguration::Hash
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_module_configuration_hash ).should == true
+      attr_module_configuration_hash :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == {}
+      self.configuration_setting[ :a_configuration ] = :some_value
+      configuration_setting.should == { :a_configuration => :some_value }
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Hash::ClassConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == { :a_configuration => :some_value }
+        configuration_setting[ :other_setting ] = :some_value
+        configuration_setting.should == { :a_configuration => :some_value,
+                                          :other_setting   => :some_value }
+        configuration_setting.delete( :other_setting ).should == :some_value
+        configuration_setting.should == { :a_configuration => :some_value }
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Hash::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 => :some_value }
+        configuration_setting[ :other_setting ] = :some_value
+        configuration_setting.should == { :a_configuration => :some_value,
+                                          :other_setting   => :some_value }
+        configuration_setting.delete( :other_setting ).should == :some_value
+        configuration_setting.should == { :a_configuration => :some_value }
+        instance_methods.include?( :configuration_setting ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Hash::ClassConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == true
+        configuration_setting.should == { :a_configuration => :some_value }
+        configuration_setting[ :other_setting ] = :some_value
+        configuration_setting.should == { :a_configuration => :some_value,
+                                          :other_setting   => :some_value }
+        configuration_setting.delete( :other_setting ).should == :some_value
+        configuration_setting.should == { :a_configuration => :some_value }
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+      class ClassExtending
+        extend CascadingConfiguration::Hash::ClassConfigurationMockModuleIncluded
+        respond_to?( :configuration_setting ).should == true
+        instance_methods.include?( :configuration_setting ).should == false
+        configuration_setting.should == { :a_configuration => :some_value }
+        configuration_setting[ :other_setting ] = :some_value
+        configuration_setting.should == { :a_configuration => :some_value,
+                                          :other_setting   => :some_value }
+        configuration_setting.delete( :other_setting ).should == :some_value
+        configuration_setting.should == { :a_configuration => :some_value }
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :configuration_setting ).should == false
+    end
+
+    class CascadingConfiguration::Hash::ClassConfigurationMockClass
+      include CascadingConfiguration::Hash::ClassConfigurationMockModuleIncluded::SubmoduleIncluding
+      respond_to?( :configuration_setting ).should == true
+      instance_methods.include?( :configuration_setting ).should == false
+      configuration_setting.should == { :a_configuration => :some_value }
+      configuration_setting[ :other_setting ] = :some_value
+      configuration_setting.should == { :a_configuration => :some_value,
+                                        :other_setting   => :some_value }
+      configuration_setting.delete( :other_setting ).should == :some_value
+      configuration_setting.should == { :a_configuration => :some_value }
+    end
+
+    object_instance_one = CascadingConfiguration::Hash::ClassConfigurationMockClass.new
+    object_instance_one.respond_to?( :a_configuration ).should == false
+    
+    class CascadingConfiguration::Hash::ClassConfigurationMockClassSub1 < CascadingConfiguration::Hash::ClassConfigurationMockClass
+      respond_to?( :configuration_setting ).should == true
+      instance_methods.include?( :configuration_setting ).should == false
+      configuration_setting.should == { :a_configuration => :some_value }
+      self.configuration_setting[ :another_configuration ] = :some_value
+      configuration_setting.should == { :a_configuration       => :some_value,
+                                        :another_configuration => :some_value }
+    end
+
+    object_instance_two = CascadingConfiguration::Hash::ClassConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :a_configuration ).should == false
+
+    # change ancestor setting
+    CascadingConfiguration::Hash::ClassConfigurationMockClass.configuration_setting[ :a_yet_unused_configuration ] = :some_value
+    CascadingConfiguration::Hash::ClassConfigurationMockClass.configuration_setting.should == { :a_configuration            => :some_value,
+                                                                                                :a_yet_unused_configuration => :some_value }
+    CascadingConfiguration::Hash::ClassConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+                                                                                  :a_yet_unused_configuration => :some_value,
+                                                                                  :another_configuration      => :some_value }
+
+    # freeze ancestor setting
+    CascadingConfiguration::Hash::ClassConfigurationMockClassSub1.configuration_setting.freeze!
+    CascadingConfiguration::Hash::ClassConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+                                                                                  :a_yet_unused_configuration => :some_value,
+                                                                                  :another_configuration      => :some_value }
+    CascadingConfiguration::Hash::ClassConfigurationMockClass.configuration_setting[ :non_cascading_configuration ] = :some_value
+    CascadingConfiguration::Hash::ClassConfigurationMockClass.configuration_setting.should == { :a_configuration             => :some_value,
+                                                                              :a_yet_unused_configuration  => :some_value,
+                                                                              :non_cascading_configuration => :some_value }
+    CascadingConfiguration::Hash::ClassConfigurationMockClassSub1.configuration_setting.should == { :a_configuration            => :some_value,
+                                                                                  :a_yet_unused_configuration => :some_value,
+                                                                                  :another_configuration      => :some_value }
+
+    module CascadingConfiguration::Hash::ClassConfigurationMockModule
+      include CascadingConfiguration::Hash
+      attr_module_configuration_hash :some_hash do |parent_hash, composite_hash|
+        parent_hash.each do |this_key, this_data|
+          if existing_value = composite_hash[ this_key ]
+            composite_hash[ this_key ] = this_data - existing_value
+          else
+            composite_hash[ this_key ] = this_data
+          end
+        end
+        composite_hash
+      end
+      self.some_hash = { :one => 1, :two => 2 }
+      self.some_hash.should == { :one => 1, :two => 2 }
+    end
+
+    module CascadingConfiguration::Hash::ClassConfigurationMockModule2
+      include CascadingConfiguration::Hash::ClassConfigurationMockModule
+      self.some_hash.should == { :one => 1, :two => 2 }
+      self.some_hash.replace( { :one => 1, :two => 2 } )
+      self.some_hash.should == { :one => 0, :two => 0 }
+    end
+    
+  end
+  
+  ###################################
+  #  attr_local_configuration_hash  #
+  ###################################
+  
+  it 'can define a local configuration hash, 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::Hash::LocalConfigurationMockModuleExtended
+      extend CascadingConfiguration::Hash
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration_hash ).should == true
+      attr_local_configuration_hash :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == {}
+      self.configuration_setting[ :a_configuration ] = :some_value
+      configuration_setting.should == { :a_configuration => :some_value }
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Hash::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::Hash::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::Hash::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Hash::LocalConfigurationMockModuleExtended
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+    end
+
+    # * module included with setting
+    module CascadingConfiguration::Hash::LocalConfigurationMockModuleIncluded
+      include CascadingConfiguration::Hash
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration_hash ).should == true
+      attr_local_configuration_hash :configuration_setting
+      respond_to?( :configuration_setting ).should == true
+      configuration_setting.should == {}
+      self.configuration_setting[ :a_configuration ] = :some_value
+      configuration_setting.should == { :a_configuration => :some_value }
+      instance_methods.include?( :configuration_setting ).should == false
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Hash::LocalConfigurationMockModuleIncluded
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Hash::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
+        instance_methods.include?( :configuration_setting ).should == false
+        respond_to?( :configuration_setting ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Hash::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
+      class ClassExtending
+        extend CascadingConfiguration::Hash::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::Hash::LocalConfigurationMockClass
+      include CascadingConfiguration::Hash::LocalConfigurationMockModuleIncluded::SubmoduleIncluding
+      instance_methods.include?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+    end
+
+    object_instance_one = CascadingConfiguration::Hash::LocalConfigurationMockClass.new
+    object_instance_one.respond_to?( :a_configuration ).should == false
+    
+    class CascadingConfiguration::Hash::LocalConfigurationMockClassSub1 < CascadingConfiguration::Hash::LocalConfigurationMockClass
+      instance_methods.include?( :configuration_setting ).should == false
+      respond_to?( :configuration_setting ).should == false
+    end
+
+    object_instance_two = CascadingConfiguration::Hash::LocalConfigurationMockClassSub1.new
+    object_instance_two.respond_to?( :a_configuration ).should == false
+
+  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
@@ -43,14 +43,14 @@ files:
 - lib/cascading-configuration-hash/CascadingConfiguration/_private_/LocalConfigurationHash.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/CompositingHash/Instance.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/CompositingHash.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash/ConfigurationAccessors.rb
+- lib/cascading-configuration-hash/CascadingConfiguration/Hash/AccessorDefinitionMethods.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/Hash/Interface.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/Hash/ModuleInclusionExtensionSupport.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/Hash.rb
 - lib/cascading-configuration-hash/CascadingConfiguration/LocalConfigurationHash.rb
 - lib/cascading-configuration-hash.rb
 - spec/CascadingConfiguration/CascadingCompositeHash_spec.rb
-- spec/CascadingConfiguration/Hash/ConfigurationAccessors_spec.rb
+- spec/CascadingConfiguration/Hash/AccessorDefinitionMethods_spec.rb
 - spec/CascadingConfiguration/Hash_spec.rb
 - spec/CascadingConfiguration/LocalConfigurationHash_spec.rb
 - README.md