cascading-configuration-setting 1.3.1 → 1.3.2

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

@@ -70,6 +70,39 @@ module CascadingConfiguration::Setting::AccessorDefinitionMethods
   #######################################
   
   def define_local_configuration_setter( configuration_name )
+    configuration_setter_name = ( configuration_name.to_s + '=' ).to_s
+    [ accessor_instance_support, accessor_local_instance_support ].compact.each do |module_support|
+      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 accessor_module_support.set_configuration_variable( self, configuration_name, value )
+  	    end
+  		end
+		end
+  end
+
+  #######################################
+  #  define_local_configuration_getter  #
+  #######################################
+  
+  def define_local_configuration_getter( configuration_name )
+    configuration_getter_name = configuration_name
+    [ accessor_instance_support, accessor_local_instance_support ].compact.each do |module_support|
+      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
+  	      return accessor_module_support.get_configuration_variable( self, configuration_name )
+  	    end
+  		end
+		end
+  end
+	
+	##########################################
+  #  define_existant_configuration_setter  #
+  ##########################################
+  
+  def define_existant_configuration_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_s
     accessor_local_instance_support.module_eval do 
 			define_method( configuration_setter_name ) do |value|
@@ -79,11 +112,11 @@ module CascadingConfiguration::Setting::AccessorDefinitionMethods
 		end
   end
 
-  #######################################
-  #  define_local_configuration_getter  #
-  #######################################
+  ##########################################
+  #  define_existant_configuration_getter  #
+  ##########################################
   
-  def define_local_configuration_getter( configuration_name )
+  def define_existant_configuration_getter( configuration_name )
     configuration_getter_name = configuration_name
     accessor_local_instance_support.module_eval do 
 	    define_method( configuration_getter_name ) do
@@ -93,5 +126,5 @@ module CascadingConfiguration::Setting::AccessorDefinitionMethods
 	    end
 		end
   end
-	
+  
 end

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

@@ -38,8 +38,10 @@ module CascadingConfiguration::Setting::Interface
   #  attr_local_configuration  #
   ##############################
 
-	# defines configuration in present class or module context
-	# configuration does not cascade
+  # local to class or module that declares it
+  # also local to instances of class or module
+  # * any instances of class
+  # * first class to include module (inherited)
   def attr_local_configuration( *property_names )
 		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
     property_names.each do |this_property_name|
@@ -48,6 +50,23 @@ module CascadingConfiguration::Setting::Interface
       # define configuration getter
       define_local_configuration_getter( this_property_name )
     end
+    CascadingConfiguration::Variable.cascade_local_instance( self )
+  end
+
+  #################################
+  #  attr_existant_configuration  #
+  #################################
+
+  # local to class or module or instance that declares it
+  # * only in the instance that declares it
+  def attr_existant_configuration( *property_names )
+		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
+    property_names.each do |this_property_name|
+      # define configuration setter
+      define_existant_configuration_setter( this_property_name )
+      # define configuration getter
+      define_existant_configuration_getter( this_property_name )
+    end
   end
 
 end

data/spec/CascadingConfiguration/Setting_spec.rb

@@ -284,7 +284,7 @@ describe CascadingConfiguration::Setting do
   #  attr_local_configuration  #
   ##############################
   
-  it 'can define a local configuration setting, which will not cascade' do
+  it 'can define a local configuration setting, which cascades to the first class and 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)
@@ -342,13 +342,19 @@ describe CascadingConfiguration::Setting do
       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
+      instance_methods.include?( :some_configuration ).should == true
       instance_variables.empty?.should == true
       # => 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
+        instance_methods.include?( :some_configuration ).should == true
+        respond_to?( :some_configuration ).should == true
+        instance_variables.empty?.should == true
+      end
+      module SubSubmoduleIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubmoduleIncluding
+        instance_methods.include?( :some_configuration ).should == true
+        respond_to?( :some_configuration ).should == true
         instance_variables.empty?.should == true
       end
       # => extending modules and classes get attr_configuration and configurations
@@ -357,6 +363,15 @@ describe CascadingConfiguration::Setting do
         # 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
+        instance_methods.include?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      module SubSubmoduleExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubmoduleExtending
+        # 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
         instance_variables.empty?.should == true
@@ -364,23 +379,51 @@ describe CascadingConfiguration::Setting do
       # => 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
+        instance_methods.include?( :some_configuration ).should == true
+        respond_to?( :some_configuration ).should == true
         instance_variables.empty?.should == true
       end
       setting_class_including_instance = ClassIncluding.new
-      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      setting_class_including_instance.respond_to?( :some_configuration ).should == true
       setting_class_including_instance.instance_variables.empty?.should == true
       # => instances of extending classes get nothing
       class ClassExtending
         extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded
-        respond_to?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == true
         instance_methods.include?( :some_configuration ).should == false
         instance_variables.empty?.should == true
       end
       setting_class_including_instance = ClassExtending.new
       setting_class_including_instance.respond_to?( :some_configuration ).should == false
       setting_class_including_instance.instance_variables.empty?.should == true
+      class ClassSubSubmoduleIncludingIncluding
+        include CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubSubmoduleIncluding
+        respond_to?( :some_configuration ).should == false
+        instance_methods.include?( :some_configuration ).should == true
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassSubSubmoduleIncludingIncluding.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == true
+      setting_class_including_instance.instance_variables.empty?.should == true
+      class ClassSubSubmoduleIncludingExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubSubmoduleIncluding
+        respond_to?( :some_configuration ).should == true
+        instance_methods.include?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassSubSubmoduleIncludingExtending.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+      class ClassSubSubmoduleIncludingIncludingAndExtending
+        include CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubSubmoduleIncluding
+        extend CascadingConfiguration::Setting::LocalConfigurationMockIncluded::SubSubmoduleIncluding
+        respond_to?( :some_configuration ).should == true
+        instance_methods.include?( :some_configuration ).should == true
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassSubSubmoduleIncludingIncludingAndExtending.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == true
+      setting_class_including_instance.instance_variables.empty?.should == true
     end
 
     class CascadingConfiguration::Setting::LocalConfigurationMockClass
@@ -397,5 +440,123 @@ describe CascadingConfiguration::Setting do
       instance_variables.empty?.should == true
     end
   end
+
+  #################################
+  #  attr_existant_configuration  #
+  #################################
   
+  it 'can define a configuration setting for the present instance, 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_existant_configuration ).should == true
+      attr_existant_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
+      instance_variables.empty?.should == true
+      # => 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
+        instance_variables.empty?.should == true
+      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
+        instance_variables.empty?.should == true
+      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
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+    end
+  
+    # * module included with setting
+    module CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+      include CascadingConfiguration::Setting
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_existant_configuration ).should == true
+      attr_existant_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
+      instance_variables.empty?.should == true
+      # => including modules and classes get attr_configuration and configurations
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      # => extending modules and classes get attr_configuration and configurations
+      module SubmoduleExtending
+        extend CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        # 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
+        instance_variables.empty?.should == true
+      end
+      # => instances of including classes get configurations
+      class ClassIncluding
+        include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassIncluding.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+      # => instances of extending classes get nothing
+      class ClassExtending
+        extend CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        respond_to?( :some_configuration ).should == false
+        instance_methods.include?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      setting_class_including_instance = ClassExtending.new
+      setting_class_including_instance.respond_to?( :some_configuration ).should == false
+      setting_class_including_instance.instance_variables.empty?.should == true
+    end
+
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClass
+      include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded::SubmoduleIncluding
+      respond_to?( :some_configuration ).should == false
+      instance_variables.empty?.should == true
+    end
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1 < CascadingConfiguration::Setting::InstanceConfigurationMockClass
+      respond_to?( :some_configuration ).should == false
+      instance_variables.empty?.should == true
+    end
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub2 < CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1
+      respond_to?( :some_configuration ).should == false
+      instance_variables.empty?.should == true
+    end
+  end
+    
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 3
-  - 1
-  version: 1.3.1
+  - 2
+  version: 1.3.2
 platform: ruby
 authors: 
 - Asher
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-01 00:00:00 -04:00
+date: 2011-08-03 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency