cascading-configuration-setting 1.4.0 → 1.4.1

data/lib/cascading-configuration-setting.rb

@@ -10,6 +10,8 @@ module CascadingConfiguration
     module AccessorDefinitionMethods
     end
     module Interface
+      module Instance
+      end
     end
     module ObjectInstance
     end
@@ -19,3 +21,4 @@ end
 require_relative 'cascading-configuration-setting/CascadingConfiguration/Setting.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/Interface/Instance.rb'

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

@@ -13,7 +13,9 @@ module CascadingConfiguration::Setting
     class_or_module.extend_also_extends( CascadingConfiguration::Variable::EigenclassConfigurationChain )
   end
   
-  include_cascades_prepending_extends( CascadingConfiguration::Setting )
+  include_cascades_extends( CascadingConfiguration::Setting::Interface::Instance )
+  
+  include_cascades_extends( CascadingConfiguration::Setting )
   
   prepend_module_include do |class_or_module|
     class_or_module.include_or_extend_cascades_prepending_extends do

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

@@ -104,7 +104,7 @@ module CascadingConfiguration::Setting::AccessorDefinitionMethods
   
   def define_instance_configuration_setter( configuration_name )
     configuration_setter_name = ( configuration_name.to_s + '=' ).to_s
-    accessor_local_instance_support.module_eval do 
+    accessor_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 accessor_module_support.set_configuration_variable( self, configuration_name, value )
@@ -117,6 +117,35 @@ module CascadingConfiguration::Setting::AccessorDefinitionMethods
   ##########################################
   
   def define_instance_configuration_getter( configuration_name )
+    configuration_getter_name = configuration_name
+    accessor_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 accessor_module_support.get_configuration_variable( self, configuration_name )
+	    end
+		end
+  end
+  
+  ########################################
+  #  define_object_configuration_setter  #
+  ########################################
+  
+  def define_object_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|
+	      # 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
+
+  ########################################
+  #  define_object_configuration_getter  #
+  ########################################
+  
+  def define_object_configuration_getter( configuration_name )
     configuration_getter_name = configuration_name
     accessor_local_instance_support.module_eval do 
 	    define_method( configuration_getter_name ) do

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

@@ -53,19 +53,19 @@ module CascadingConfiguration::Setting::Interface
     CascadingConfiguration::Variable.cascade_local_instance( self )
   end
 
-  #################################
-  #  attr_instance_configuration  #
-  #################################
+  ###############################
+  #  attr_object_configuration  #
+  ###############################
 
   # local to class or module or instance that declares it
   # * only in the instance that declares it
-  def attr_instance_configuration( *property_names )
+  def attr_object_configuration( *property_names )
 		CascadingConfiguration::Variable.define_accessor_local_instance_support( self )
     property_names.each do |this_property_name|
       # define configuration setter
-      define_instance_configuration_setter( this_property_name )
+      define_object_configuration_setter( this_property_name )
       # define configuration getter
-      define_instance_configuration_getter( this_property_name )
+      define_object_configuration_getter( this_property_name )
     end
   end
 

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

@@ -0,0 +1,23 @@
+
+module CascadingConfiguration::Setting::Interface::Instance
+
+	extend  CascadingConfiguration::InternalModuleStub
+
+  #################################
+  #  attr_instance_configuration  #
+  #################################
+
+  # local to class or module or instance that declares it
+  # * in instances of the class or module that declares it
+  # * in instance if declared on non-class/non-module object instance
+  def attr_instance_configuration( *property_names )
+    property_names.each do |this_property_name|
+      # define configuration setter
+      define_instance_configuration_setter( this_property_name )
+      # define configuration getter
+      define_instance_configuration_getter( this_property_name )
+    end
+    return self
+  end
+  
+end

data/spec/CascadingConfiguration/Setting_spec.rb

@@ -449,19 +449,122 @@ describe CascadingConfiguration::Setting do
   
   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
+    module CascadingConfiguration::Setting::InstanceConfigurationMockExtended
       extend CascadingConfiguration::Setting
       # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_instance_configuration ).should == false
+      instance_methods.include?( :some_configuration ).should == false
+      instance_variables.empty?.should == true
+      # => including modules and classes get nothing
+      module SubmoduleIncluding
+        include CascadingConfiguration::Setting::InstanceConfigurationMockExtended
+        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::InstanceConfigurationMockExtended
+        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::InstanceConfigurationMockExtended
+        instance_methods.include?( :some_configuration ).should == false
+        respond_to?( :some_configuration ).should == false
+        instance_variables.empty?.should == true
+      end
+      class ClassExtending
+        extend CascadingConfiguration::Setting::InstanceConfigurationMockExtended
+        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_instance_configuration ).should == true
       attr_instance_configuration :some_configuration
+      respond_to?( :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::InstanceConfigurationMockIncluded
+        instance_methods.include?( :some_configuration ).should == true
+        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 == true
+        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 == true
+        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 == true
+      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 == 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
+    end
+
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClass
+      include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded::SubmoduleIncluding
+      respond_to?( :some_configuration ).should == false
+      instance_methods.include?( :some_configuration ).should == true
+      instance_variables.empty?.should == true
+    end
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1 < CascadingConfiguration::Setting::InstanceConfigurationMockClass
+      respond_to?( :some_configuration ).should == false
+      instance_methods.include?( :some_configuration ).should == true
+      instance_variables.empty?.should == true
+    end
+    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub2 < CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1
+      respond_to?( :some_configuration ).should == false
+      instance_methods.include?( :some_configuration ).should == true
+      instance_variables.empty?.should == true
+    end
+  end
+  
+  ###############################
+  #  attr_object_configuration  #
+  ###############################
+  
+  it 'can define a configuration setting for the present instance, which will not cascade' do
+
+    # possibilities:
+    # * module extended with setting
+    module CascadingConfiguration::Setting::ObjectConfigurationMockExtended
+      extend CascadingConfiguration::Setting
+      # => singleton gets attr_configuration and configurations
+      respond_to?( :attr_object_configuration ).should == true
+      attr_object_configuration :some_configuration
       respond_to?( :some_configuration ).should == true
       self.some_configuration = :our_setting_value
       some_configuration.should == :our_setting_value
@@ -469,27 +572,27 @@ describe CascadingConfiguration::Setting do
       instance_variables.empty?.should == true
       # => including modules and classes get nothing
       module SubmoduleIncluding
-        include CascadingConfiguration::Setting::LocalConfigurationMockExtended
+        include CascadingConfiguration::Setting::ObjectConfigurationMockExtended
         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
+        extend CascadingConfiguration::Setting::ObjectConfigurationMockExtended
         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
+        include CascadingConfiguration::Setting::ObjectConfigurationMockExtended
         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
+        extend CascadingConfiguration::Setting::ObjectConfigurationMockExtended
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
         instance_variables.empty?.should == true
@@ -497,11 +600,11 @@ describe CascadingConfiguration::Setting do
     end
   
     # * module included with setting
-    module CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+    module CascadingConfiguration::Setting::ObjectConfigurationMockIncluded
       include CascadingConfiguration::Setting
       # => singleton gets attr_configuration and configurations
-      respond_to?( :attr_instance_configuration ).should == true
-      attr_instance_configuration :some_configuration
+      respond_to?( :attr_object_configuration ).should == true
+      attr_object_configuration :some_configuration
       respond_to?( :some_configuration ).should == true
       self.some_configuration = :our_setting_value
       some_configuration.should == :our_setting_value
@@ -509,14 +612,14 @@ describe CascadingConfiguration::Setting do
       instance_variables.empty?.should == true
       # => including modules and classes get attr_configuration and configurations
       module SubmoduleIncluding
-        include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        include CascadingConfiguration::Setting::ObjectConfigurationMockIncluded
         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
+        extend CascadingConfiguration::Setting::ObjectConfigurationMockIncluded
         # 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
@@ -526,7 +629,7 @@ describe CascadingConfiguration::Setting do
       end
       # => instances of including classes get configurations
       class ClassIncluding
-        include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        include CascadingConfiguration::Setting::ObjectConfigurationMockIncluded
         instance_methods.include?( :some_configuration ).should == false
         respond_to?( :some_configuration ).should == false
         instance_variables.empty?.should == true
@@ -536,7 +639,7 @@ describe CascadingConfiguration::Setting do
       setting_class_including_instance.instance_variables.empty?.should == true
       # => instances of extending classes get nothing
       class ClassExtending
-        extend CascadingConfiguration::Setting::InstanceConfigurationMockIncluded
+        extend CascadingConfiguration::Setting::ObjectConfigurationMockIncluded
         respond_to?( :some_configuration ).should == false
         instance_methods.include?( :some_configuration ).should == false
         instance_variables.empty?.should == true
@@ -546,19 +649,19 @@ describe CascadingConfiguration::Setting do
       setting_class_including_instance.instance_variables.empty?.should == true
     end
 
-    class CascadingConfiguration::Setting::InstanceConfigurationMockClass
-      include CascadingConfiguration::Setting::InstanceConfigurationMockIncluded::SubmoduleIncluding
+    class CascadingConfiguration::Setting::ObjectConfigurationMockClass
+      include CascadingConfiguration::Setting::ObjectConfigurationMockIncluded::SubmoduleIncluding
       respond_to?( :some_configuration ).should == false
       instance_variables.empty?.should == true
     end
-    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1 < CascadingConfiguration::Setting::InstanceConfigurationMockClass
+    class CascadingConfiguration::Setting::ObjectConfigurationMockClassSub1 < CascadingConfiguration::Setting::ObjectConfigurationMockClass
       respond_to?( :some_configuration ).should == false
       instance_variables.empty?.should == true
     end
-    class CascadingConfiguration::Setting::InstanceConfigurationMockClassSub2 < CascadingConfiguration::Setting::InstanceConfigurationMockClassSub1
+    class CascadingConfiguration::Setting::ObjectConfigurationMockClassSub2 < CascadingConfiguration::Setting::ObjectConfigurationMockClassSub1
       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
   - 4
-  - 0
-  version: 1.4.0
+  - 1
+  version: 1.4.1
 platform: ruby
 authors: 
 - Asher
@@ -53,6 +53,7 @@ extra_rdoc_files: []
 
 files: 
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting/AccessorDefinitionMethods.rb
+- lib/cascading-configuration-setting/CascadingConfiguration/Setting/Interface/Instance.rb
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting/Interface.rb
 - lib/cascading-configuration-setting/CascadingConfiguration/Setting.rb
 - lib/cascading-configuration-setting.rb