cascading-configuration-setting 1.1.6 → 1.2.0

data/README.md

@@ -1,4 +1,4 @@
-# Cascading Configuration #
+# Cascading Configuration Setting #
 
 http://rubygems.org/gems/cascading-configuration-setting
 
@@ -7,341 +7,258 @@ http://rubygems.org/gems/cascading-configuration-setting
 Adds methods for cascading configuration settings. Support package for cascading-configuration.
 
 # Summary #
-  
-## :attr_configuration ##
-
-:attr_configuration provides inheritable configuration that cascades downward. 
 
-Configuration inheritance can cascade through modules, classes, and instances.
+Cascading configuration methods for settings, which returns the appropriate lowest accumulated value. Configuration inheritance can cascade through modules, classes, and to instances.
 
-:attr_configuration defines a single attribute accessor that searches upward for the first ancestor defining the configuration. 
+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-setting
+* sudo gem install cascading-configuration
 
 # Usage #
 
-Attributes are defined with :attr_configuration.
-
-Settings are set and acquired by the attribute name declared in :attr_configuration.
-
-## 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_setting.
+Including the module will enable support for singleton and for instances.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-    include CascadingConfiguration::Setting
-  end
-
+module AnyModuleOrClass
+  include CascadingConfiguration::Setting
+end
 ```
 
-* Declare attr_configuration_setting.
+Extending the module will enable support for singleton only.
 
 ```ruby
-
-  module CascadingConfiguration::MockModule
-    attr_configuration :some_configuration
-  end
-
+module AnyModuleOrClass
+  extend CascadingConfiguration::Setting
+end
 ```
 
-* Set initial value.
+Including or extending CascadingConfiguration includes or extends:
 
-```ruby
+* CascadingConfiguration::Variable
 
-  module CascadingConfiguration::MockModule
-    self.some_configuration = :some_value
-  end
+## :attr_configuration ##
 
-```
+:attr_configuration provides inheritable single-object configurations that cascades downward. The value lowest in the ancestor hierarchy will be returned.
 
-* Verify initial configuration value
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  module CascadingConfiguration::MockModule
-    # => some_configuration.should == :some_value
-  end
-
-```
-
-## Including Module 1 ##
+  include CascadingConfiguration::Setting
 
-2. Include initial module in another module.
+  attr_configuration :some_setting
 
-Including the module that has included a CascadingConfiguration module is the same as including a CascadingConfiguration module.
+  some_setting # => nil
 
-```ruby
+  # note: if we don't specify the receiver here (self) assignment creates local variable instead
+  self.some_setting = :some_value
 
-  module CascadingConfiguration::MockModule2
-    include CascadingConfiguration::MockModule
-  end
+  some_setting # => :some_value
 
+end
 ```
 
-* Verify inherited value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  module CascadingConfiguration::MockModule2
-    # => some_configuration.should == :some_value
-  end
+  include SomeModule
 
-```
+  some_setting # => :some_value
 
-* Override inherited value
+  self.some_setting = :some_other_value
 
-```ruby
+  some_setting # => :some_other_value
 
-  module CascadingConfiguration::MockModule2
-    self.some_configuration = :module_value
-  end
+  SomeModule.some_setting # => :some_value
 
+end
 ```
 
-* Verify local override value
+And it cascades to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  module CascadingConfiguration::MockModule2
-    # => some_configuration.should == :module_value
-  end
-
-```
-
-## Including Module 2 ##
-
-3. Include second module in another module.
-
-```ruby
+instance.some_setting.should == :some_value
 
-  module CascadingConfiguration::MockModule3
-    include CascadingConfiguration::MockModule2
-  end
+instance.some_setting = :another_value
 
+instance.some_setting.should == :another_value
 ```
 
-* Verify inherited value
+### :attr_module_configuration, :attr_class_configuration ###
 
-```ruby
+:attr_class_configuration works like :attr_configuration but does not cascade to instances.
 
-  module CascadingConfiguration::MockModule3
-    # => some_configuration.should == :module_value
-  end
-
-```
-
-## Top Class ##
-
-4. Include third module in a class.
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  class CascadingConfiguration::MockClass
-    include CascadingConfiguration::MockModule3
-  end
+  include CascadingConfiguration::Setting
 
-```
+  attr_class_configuration :some_setting
 
-* Verify inherited value
+  some_setting # => nil
 
-```ruby
+  self.some_setting = :some_value
 
-  class CascadingConfiguration::MockClass
-    # => some_configuration.should == :module_value
-  end
+  some_setting # => :some_value
 
+end
 ```
 
-* Override inherited value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  class CascadingConfiguration::MockClass
-    self.some_configuration = :another_value
-  end
+  include SomeModule
 
-```
+  some_setting # => :some_value
 
-* Verify local override value
+  self.some_setting = :some_other_value
 
-```ruby
+  some_setting # => :some_other_value
 
-  class CascadingConfiguration::MockClass
-    # => some_configuration.should == :another_value
-  end
+  SomeModule.some_setting # => :some_value
 
+end
 ```
 
-## Instance of Top Class ##
-
-5. Instantiate class.
+And it does not cascade to instances:
 
 ```ruby
+instance = SomeClass.new
 
-  object_instance_one = CascadingConfiguration::MockClass.new
-
+instance.respond_to?( :some_setting ).should == false
 ```
 
-* Verify inherited value
-
-```ruby
-
-  # => object_instance_one.some_configuration.should == :another_value
+### :attr_local_configuration ###
 
-```
+:attr_local_configuration works like :attr_configuration 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).
 
-* Override inherited value
+Define initial configuration in a module or class:
 
 ```ruby
+module SomeModule
 
-  object_instance_one.some_configuration = :yet_another_value
+  include CascadingConfiguration::Setting
 
-```
+  attr_local_configuration :some_setting
 
-* Verify local override value
+  some_setting # => nil
 
-```ruby
+  self.some_setting = :some_value
 
-  # => object_instance_one.some_configuration.should == :yet_another_value
-  # => CascadingConfiguration::MockClass.some_configuration.should == :another_value
-  # => CascadingConfiguration::MockModule.some_configuration.should == :some_value
+  some_setting # => :some_value
 
+end
 ```
 
-# First Inheriting Class #
-
-6. Inheriting class.
-
-Inheriting class should not get any settings from instance of superclass.
-
-* Verify inherited value
+Include initial module in a module or class:
 
 ```ruby
+class SomeClass
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_configuration.should == :another_value
-  end
-
-```
-
-* Override inherited value
-
-```ruby
+  include SomeModule
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    self.some_configuration = :a_value_not_yet_used
-  end
+  respond_to?( :some_setting ).should == false
 
+end
 ```
 
-* Verify local override value
-
-```ruby
+## Additional Functionality ##
 
-  class CascadingConfiguration::MockClassSub1 < CascadingConfiguration::MockClass
-    # => some_configuration.should == :a_value_not_yet_used
-    # => CascadingConfiguration::MockClass.some_configuration.should == :another_value
-    # => CascadingConfiguration::MockModule.some_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_configuration.should == :a_value_not_yet_used
-  # => object_instance_one.some_configuration.should == :yet_another_value
-  # => CascadingConfiguration::MockClass.some_configuration.should == :another_value
-  # => CascadingConfiguration::MockModule.some_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_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
-
-```ruby
+### Method Redefinition ###
 
-  class CascadingConfiguration::MockClassSub2 < CascadingConfiguration::MockClassSub1
-    self.some_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_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_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_configuration = :one_more_unused_value
+  instance_variables.include?( :@some_array_setting ) # => false  
 
+end
 ```
 
-* Verify local override value
-
-```ruby
-
-  # => object_instance_three.some_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 #
 
@@ -366,4 +283,4 @@ Inheriting class should not get any settings from instance of superclass.
   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
   CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
   TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -1,22 +1,24 @@
 == Cascading Configuration
 
-http://rubygems.org/gems/cascading-configuration
+http://rubygems.org/gems/cascading-configuration-setting
 
 == Description
 
-Adds methods for cascading configurations.
+Adds methods for cascading configuration settings. Support package for cascading-configuration.
 
 == Summary
 
-Cascading configuration methods for single settings, arrays, hashes.
+Cascading configuration methods for settings, 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
 
-:attr_configuration provides inheritable configuration that cascades downward. 
+:attr_configuration provides inheritable single-object configurations that cascades downward. The value lowest in the ancestor hierarchy will be returned.
 
-Configuration inheritance can cascade through modules, classes, and instances.
+:attr_class_configuration works like :attr_configuration but does not cascade to instances.
 
-:attr_configuration defines a single attribute accessor that searches upward for the first ancestor defining the configuration. 
+:attr_local_configuration works like :attr_configuration 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
 
@@ -24,7 +26,7 @@ Configuration inheritance can cascade through modules, classes, and instances.
 
 == Usage
 
-See supporting package README markdown files (README.md) for examples.
+See README.md
 
 == License
 

data/lib/cascading-configuration-setting.rb

@@ -7,7 +7,7 @@ end
 
 module CascadingConfiguration
   module Setting
-    module ConfigurationAccessors
+    module AccessorDefinitionMethods
     end
     module Interface
     end
@@ -19,6 +19,6 @@ module CascadingConfiguration
 end
 
 require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting.rb'
-require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting/ConfigurationAccessors.rb'
+require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting/AccessorDefinitionMethods.rb'
 require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting/Interface.rb'
 require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting/ModuleInclusionExtensionSupport.rb'

data/lib/cascading-configuration-setting/CascadingConfiguration/Setting.rb

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

@@ -1,5 +1,5 @@
 
-module CascadingConfiguration::Setting::ConfigurationAccessors
+module CascadingConfiguration::Setting::AccessorDefinitionMethods
 	
 	extend  CascadingConfiguration::InternalModuleStub
 	
@@ -9,11 +9,11 @@ module CascadingConfiguration::Setting::ConfigurationAccessors
   
   def define_cascading_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_s
-    [ 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 |value|
 		      # configuration setter returns setting variable (variable from self), which is now the ID of value
-		      return instance_variable_set( accessor_support_module.cascading_variable_name( configuration_name ), value )
+		      return instance_variable_set( accessor_module_support.cascading_variable_name( configuration_name ), value )
 		    end
 			end
 		end
@@ -26,8 +26,8 @@ module CascadingConfiguration::Setting::ConfigurationAccessors
   def define_cascading_getter( configuration_name )
     configuration_getter_name = configuration_name
 		module_self = 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_getter_name ) do
 		      # configuration getter returns current setting value (taken from first superclass with setting)
 		      # that means first variable that has been set
@@ -46,7 +46,7 @@ module CascadingConfiguration::Setting::ConfigurationAccessors
     accessor_module_support.module_eval do 
 			define_method( configuration_setter_name ) do |value|
 	      # configuration setter returns setting variable (variable from self), which is now the ID of value
-	      return instance_variable_set( accessor_support_module.cascading_variable_name( configuration_name ), value )
+	      return instance_variable_set( accessor_module_support.cascading_variable_name( configuration_name ), value )
 	    end
 		end
   end
@@ -72,10 +72,10 @@ module CascadingConfiguration::Setting::ConfigurationAccessors
   
   def define_local_configuration_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_s
-    accessor_instance_support.module_eval do 
+    accessor_local_instance_support.module_eval do 
 			define_method( configuration_setter_name ) do |value|
 	      # configuration setter returns setting variable (variable from self), which is now the ID of value
-	      return instance_variable_set( accessor_support_module.cascading_variable_name( configuration_name ), value )
+	      return instance_variable_set( accessor_module_support.cascading_variable_name( configuration_name ), value )
 	    end
 		end
   end
@@ -86,11 +86,11 @@ module CascadingConfiguration::Setting::ConfigurationAccessors
   
   def define_local_configuration_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
 	      # configuration getter returns current setting value (taken from first superclass with setting)
 	      # that means first variable that has been set
-	      return get_configuration_searching_upward( configuration_name )
+	      return instance_variable_get( accessor_module_support.cascading_variable_name( configuration_name ) )
 	    end
 		end
   end

data/lib/cascading-configuration-setting/CascadingConfiguration/Setting/Interface.rb

@@ -18,13 +18,13 @@ module CascadingConfiguration::Setting::Interface
     end
   end
 
-  ##############################
-  #  attr_class_configuration  #
-  ##############################
+  ###############################
+  #  attr_module_configuration  #
+  ###############################
 
 	# defines configuration in class or module
 	# configuration cascades downward to last class or module
-  def attr_class_configuration( *property_names )
+  def attr_module_configuration( *property_names )
     property_names.each do |this_property_name|
       # define configuration setter
       define_class_configuration_setter( this_property_name )
@@ -32,6 +32,7 @@ module CascadingConfiguration::Setting::Interface
       define_class_configuration_getter( this_property_name )
     end
   end
+	alias_method :attr_class_configuration, :attr_module_configuration
 
   ##############################
   #  attr_local_configuration  #
@@ -40,6 +41,7 @@ module CascadingConfiguration::Setting::Interface
 	# defines configuration in present class or module context
 	# configuration does not cascade
   def attr_local_configuration( *property_names )
+		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
     property_names.each do |this_property_name|
       # define configuration setter
       define_local_configuration_setter( this_property_name )

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

@@ -1,7 +1,7 @@
 
 require_relative '../../../lib/cascading-configuration-setting.rb'
 
-describe CascadingConfiguration::Setting::ConfigurationAccessors do
+describe CascadingConfiguration::Setting::AccessorDefinitionMethods do
 
   #############################
   #  define_cascading_setter  #

data/spec/CascadingConfiguration/Setting_spec.rb

@@ -17,7 +17,7 @@ describe CascadingConfiguration::Setting do
 
     # possibilities:
     # * module extended with setting
-    module CascadingConfiguration::Setting::MockModuleExtended
+    module CascadingConfiguration::Setting::ConfigurationMockExtended
       extend CascadingConfiguration::Setting
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration ).should == true
@@ -28,31 +28,31 @@ describe CascadingConfiguration::Setting do
       instance_methods.include?( :some_configuration ).should == false
       # => including modules and classes get nothing
       module SubmoduleIncluding
-        include CascadingConfiguration::Setting::MockModuleExtended
+        include CascadingConfiguration::Setting::ConfigurationMockExtended
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
       end
       # => extending modules and classes get nothing
       module SubmoduleExtending
-        extend CascadingConfiguration::Setting::MockModuleExtended
+        extend CascadingConfiguration::Setting::ConfigurationMockExtended
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
       end
       # => instances of including and extending classes get nothing
       class ClassIncluding
-        include CascadingConfiguration::Setting::MockModuleExtended
+        include CascadingConfiguration::Setting::ConfigurationMockExtended
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
       end
       class ClassExtending
-        extend CascadingConfiguration::Setting::MockModuleExtended
+        extend CascadingConfiguration::Setting::ConfigurationMockExtended
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
       end
     end
 
     # * module included with setting
-    module CascadingConfiguration::Setting::MockModuleIncluded
+    module CascadingConfiguration::Setting::ConfigurationMockIncluded
       include CascadingConfiguration::Setting
       # => singleton gets attr_configuration and configurations
       respond_to?( :attr_configuration ).should == true
@@ -63,7 +63,7 @@ describe CascadingConfiguration::Setting do
       instance_methods.include?( :some_configuration ).should == true
       # => including modules and classes get attr_configuration and configurations
       module SubmoduleIncluding
-        include CascadingConfiguration::Setting::MockModuleIncluded
+        include CascadingConfiguration::Setting::ConfigurationMockIncluded
         instance_methods.include?( :some_configuration ).should == true
         respond_to?( :some_configuration ).should == true
         some_configuration.should == :our_setting_value
@@ -72,7 +72,7 @@ describe CascadingConfiguration::Setting do
       end
       # => extending modules and classes get attr_configuration and configurations
       module SubmoduleExtending
-        extend CascadingConfiguration::Setting::MockModuleIncluded
+        extend CascadingConfiguration::Setting::ConfigurationMockIncluded
         # 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
@@ -84,7 +84,7 @@ describe CascadingConfiguration::Setting do
       end
       # => instances of including classes get configurations
       class ClassIncluding
-        include CascadingConfiguration::Setting::MockModuleIncluded
+        include CascadingConfiguration::Setting::ConfigurationMockIncluded
         instance_methods.include?( :some_configuration ).should == true
         respond_to?( :some_configuration ).should == true
         some_configuration.should == :our_setting_value
@@ -98,7 +98,7 @@ describe CascadingConfiguration::Setting do
       some_configuration.should == :our_setting_value
       # => instances of extending classes get nothing
       class ClassExtending
-        extend CascadingConfiguration::Setting::MockModuleIncluded
+        extend CascadingConfiguration::Setting::ConfigurationMockIncluded
         respond_to?( :some_configuration ).should == true
         some_configuration.should == :our_setting_value
         self.some_configuration = :some_other_configuration
@@ -109,22 +109,248 @@ describe CascadingConfiguration::Setting do
       setting_class_including_instance.respond_to?( :some_configuration ).should == false
     end
 
-    class CascadingConfiguration::Setting::MockClass
-      include CascadingConfiguration::Setting::MockModuleIncluded::SubmoduleIncluding
+    class CascadingConfiguration::Setting::ConfigurationMockClass
+      include CascadingConfiguration::Setting::ConfigurationMockIncluded::SubmoduleIncluding
       some_configuration.should == :another_configuration
       self.some_configuration = :our_setting_value
       some_configuration.should == :our_setting_value
     end
-    class CascadingConfiguration::Setting::MockClassSub1 < CascadingConfiguration::Setting::MockClass
+    class CascadingConfiguration::Setting::ConfigurationMockClassSub1 < CascadingConfiguration::Setting::ConfigurationMockClass
       some_configuration.should == :our_setting_value
       self.some_configuration = :our_other_setting_value
       some_configuration.should == :our_other_setting_value
     end
-    class CascadingConfiguration::Setting::MockClassSub2 < CascadingConfiguration::Setting::MockClassSub1
+    class CascadingConfiguration::Setting::ConfigurationMockClassSub2 < CascadingConfiguration::Setting::ConfigurationMockClassSub1
       some_configuration.should == :our_other_setting_value
       self.some_configuration = :a_third_setting_value
       some_configuration.should == :a_third_setting_value
     end
   end
   
+  ###############################
+  #  attr_module_configuration  #
+  #  attr_class_configuration   #
+  ###############################
+  
+  it 'can define a class configuration setting, which will not cascade to instances' do
+
+    # extending a module or class works like a finalizer for the cascading configuration
+    # if the configuration is re-opened at a later point (including or extending a lower ancestor)
+    # then the configuration will still cascade upward
+    # this permits ancestors in the heirarchy to skip out on configurations
+    # upward cascade can be frozen at any point using :freeze!, which will prevent further upward lookup
+
+    # possibilities:
+    # * module extended with setting
+    module CascadingConfiguration::Setting::ClassConfigurationMockExtended
+      extend CascadingConfiguration::Setting
+      # => singleton gets attr_module_configuration and configurations
+      respond_to?( :attr_module_configuration ).should == true
+      method( :attr_module_configuration ).should == method( :attr_class_configuration )
+      attr_module_configuration :some_configuration
+      respond_to?( :attr_module_configuration ).should == true
+      self.some_configuration = :our_setting_value
+      some_configuration.should == :our_setting_value
+      instance_methods.include?( :some_configuration ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::ClassConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Setting::ClassConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Setting::ClassConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Setting::ClassConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+    end
+
+    # * module included with setting
+    module CascadingConfiguration::Setting::ClassConfigurationMockIncluded
+      include CascadingConfiguration::Setting
+      # => singleton gets attr_module_configuration and configurations
+      respond_to?( :attr_module_configuration ).should == true
+      attr_module_configuration :some_configuration
+      respond_to?( :some_configuration ).should == true
+      self.some_configuration = :our_setting_value
+      some_configuration.should == :our_setting_value
+      instance_methods.include?( :some_configuration ).should == false
+      # => including modules and classes get attr_module_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::ClassConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == true
+        some_configuration.should == :our_setting_value
+        self.some_configuration = :another_configuration
+        some_configuration.should == :another_configuration
+      end
+      # => extending modules and classes get attr_module_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Setting::ClassConfigurationMockIncluded
+        # 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?( :some_configuration ).should == true
+        some_configuration.should == :our_setting_value
+        self.some_configuration = :some_other_configuration
+        some_configuration.should == :some_other_configuration
+        instance_methods.include?( :some_configuration ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Setting::ClassConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == true
+        some_configuration.should == :our_setting_value
+        self.some_configuration = :another_configuration
+        some_configuration.should == :another_configuration
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Setting::ClassConfigurationMockIncluded
+        respond_to?( :some_configuration ).should == true
+        some_configuration.should == :our_setting_value
+        self.some_configuration = :some_other_configuration
+        some_configuration.should == :some_other_configuration
+        instance_methods.include?( :some_configuration ).should == false
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+    end
+
+    class CascadingConfiguration::Setting::ClassConfigurationMockClass
+      include CascadingConfiguration::Setting::ClassConfigurationMockIncluded::SubmoduleIncluding
+      some_configuration.should == :another_configuration
+      self.some_configuration = :our_setting_value
+      some_configuration.should == :our_setting_value
+    end
+    class CascadingConfiguration::Setting::ClassConfigurationMockClassSub1 < CascadingConfiguration::Setting::ClassConfigurationMockClass
+      some_configuration.should == :our_setting_value
+      self.some_configuration = :our_other_setting_value
+      some_configuration.should == :our_other_setting_value
+    end
+    class CascadingConfiguration::Setting::ClassConfigurationMockClassSub2 < CascadingConfiguration::Setting::ClassConfigurationMockClassSub1
+      some_configuration.should == :our_other_setting_value
+      self.some_configuration = :a_third_setting_value
+      some_configuration.should == :a_third_setting_value
+    end
+  end
+  
+  ##############################
+  #  attr_local_configuration  #
+  ##############################
+  
+  it 'can define a local configuration setting, which will not cascade' do
+
+    # extending a module or class works like a finalizer for the cascading configuration
+    # if the configuration is re-opened at a later point (including or extending a lower ancestor)
+    # then the configuration will still cascade upward
+    # this permits ancestors in the heirarchy to skip out on configurations
+    # upward cascade can be frozen at any point using :freeze!, which will prevent further upward lookup
+
+    # possibilities:
+    # * module extended with setting
+    module CascadingConfiguration::Setting::LocalConfigurationMockExtended
+      extend CascadingConfiguration::Setting
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration ).should == true
+      attr_local_configuration :some_configuration
+      respond_to?( :some_configuration ).should == true
+      self.some_configuration = :our_setting_value
+      some_configuration.should == :our_setting_value
+      instance_methods.include?( :some_configuration ).should == false
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      # => extending modules and classes get nothing
+      module SubmoduleExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      # => instances of including and extending classes get nothing
+      class ClassIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+    end
+  
+    # * module included with setting
+    module CascadingConfiguration::Setting::LocalConfigurationMockIncluded
+      include CascadingConfiguration::Setting
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_local_configuration ).should == true
+      attr_local_configuration :some_configuration
+      respond_to?( :some_configuration ).should == true
+      self.some_configuration = :our_setting_value
+      some_configuration.should == :our_setting_value
+      instance_methods.include?( :some_configuration ).should == false
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded
+        # 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?( :some_configuration ).should == false
+        instance_methods.include?( :some_configuration ).should == false
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded
+        respond_to?( :some_configuration ).should == false
+        instance_methods.include?( :some_configuration ).should == false
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+    end
+
+    class CascadingConfiguration::Setting::LocalConfigurationMockClass
+      include CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubmoduleIncluding
+      respond_to?( :some_configuration ).should == false
+    end
+    class CascadingConfiguration::Setting::LocalConfigurationMockClassSub1 < CascadingConfiguration::Setting::LocalConfigurationMockClass
+      respond_to?( :some_configuration ).should == false
+    end
+    class CascadingConfiguration::Setting::LocalConfigurationMockClassSub2 < CascadingConfiguration::Setting::LocalConfigurationMockClassSub1
+      respond_to?( :some_configuration ).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
@@ -39,12 +39,12 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/cascading-configuration-setting/CascadingConfiguration/Setting/ConfigurationAccessors.rb
+- lib/cascading-configuration-setting/CascadingConfiguration/Setting/AccessorDefinitionMethods.rb
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting/Interface.rb
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting/ModuleInclusionExtensionSupport.rb
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting.rb
 - lib/cascading-configuration-setting.rb
-- spec/CascadingConfiguration/Setting/ConfigurationAccessors_spec.rb
+- spec/CascadingConfiguration/Setting/AccessorDefinitionMethods_spec.rb
 - spec/CascadingConfiguration/Setting_spec.rb
 - README.md
 - README.rdoc