cascading-configuration-array 1.4.1 → 1.5.0

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

@@ -1,175 +0,0 @@
-
-module CascadingConfiguration::Array::AccessorDefinitionMethods
-
-	extend  CascadingConfiguration::InternalModuleStub
-
-  ###################################
-  #  define_cascading_array_setter  #
-  ###################################
-  
-  def define_cascading_array_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-		self_instance = self
-    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_module_support|
-			accessor_module_support.module_eval do
-		    define_method( configuration_setter_name ) do |array|
-		      composite_array = composite_array_for_cascading_configuration( configuration_name )
-		      # we want the array to supplant existing config
-		      # clear the array (excludes everything explicitly)
-		      composite_array.clear
-		      # push array elements (removes anything excluded from exclude)
-		      composite_array.push( *array )
-		      return composite_array
-		    end
-			end
-    end
-  end
-
-  ###################################
-  #  define_cascading_array_getter  #
-  ###################################
-  
-  def define_cascading_array_getter( configuration_name )
-    configuration_getter_name = configuration_name
-    [ accessor_instance_support, accessor_module_support ].compact.each do |accessor_module_support|
-			accessor_module_support.module_eval do
-		    define_method( configuration_getter_name ) do
-		      return composite_array_for_cascading_configuration( configuration_name )
-		    end
-			end
-    end
-  end
-
-  #############################################
-  #  define_class_configuration_array_setter  #
-  #############################################
-  
-  def define_class_configuration_array_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    accessor_module_support.module_eval do 
-	    define_method( configuration_setter_name ) do |array|
-	      composite_array = composite_array_for_cascading_configuration( configuration_name )
-	      # we want the array to supplant existing config
-	      # clear the array (excludes everything explicitly)
-	      composite_array.clear
-	      # push array elements (removes anything excluded from exclude)
-	      composite_array.push( *array )
-	      return composite_array
-	    end
-    end
-  end
-
-  #############################################
-  #  define_class_configuration_array_getter  #
-  #############################################
-  
-  def define_class_configuration_array_getter( configuration_name )
-    configuration_getter_name = configuration_name
-    accessor_module_support.module_eval do 
-	    define_method( configuration_getter_name ) do
-	      return composite_array_for_cascading_configuration( configuration_name )
-	    end
-    end
-  end
-
-  #############################################
-  #  define_local_configuration_array_setter  #
-  #############################################
-  
-  def define_local_configuration_array_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    [ accessor_instance_support, accessor_local_instance_support ].compact.each do |module_support|
-      module_support.module_eval do 
-  	    define_method( configuration_setter_name ) do |array|
-  	      composite_array = composite_array_for_cascading_configuration( configuration_name )
-  	      # we want the array to supplant existing config
-  	      # clear the array (excludes everything explicitly)
-  	      composite_array.clear
-  	      # push array elements (removes anything excluded from exclude)
-  	      composite_array.push( *array )
-  	      return composite_array
-  	    end
-      end
-    end
-  end
-
-  #############################################
-  #  define_local_configuration_array_getter  #
-  #############################################
-  
-  def define_local_configuration_array_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
-  	      return composite_array_for_cascading_configuration( configuration_name )
-  	    end
-      end
-    end
-  end
-
-  ################################################
-  #  define_instance_configuration_array_setter  #
-  ################################################
-  
-  def define_instance_configuration_array_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    accessor_instance_support.module_eval do 
-	    define_method( configuration_setter_name ) do |array|
-	      composite_array = composite_array_for_cascading_configuration( configuration_name )
-	      # we want the array to supplant existing config
-	      # clear the array (excludes everything explicitly)
-	      composite_array.clear
-	      # push array elements (removes anything excluded from exclude)
-	      composite_array.push( *array )
-	      return composite_array
-	    end
-    end
-  end
-
-  ################################################
-  #  define_instance_configuration_array_getter  #
-  ################################################
-  
-  def define_instance_configuration_array_getter( configuration_name )
-    configuration_getter_name = configuration_name
-    accessor_instance_support.module_eval do 
-	    define_method( configuration_getter_name ) do
-	      return composite_array_for_cascading_configuration( configuration_name )
-	    end
-    end
-  end
-  
-  ##############################################
-  #  define_object_configuration_array_setter  #
-  ##############################################
-  
-  def define_object_configuration_array_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    accessor_local_instance_support.module_eval do 
-	    define_method( configuration_setter_name ) do |array|
-	      composite_array = composite_array_for_cascading_configuration( configuration_name )
-	      # we want the array to supplant existing config
-	      # clear the array (excludes everything explicitly)
-	      composite_array.clear
-	      # push array elements (removes anything excluded from exclude)
-	      composite_array.push( *array )
-	      return composite_array
-	    end
-    end
-  end
-
-  ##############################################
-  #  define_object_configuration_array_getter  #
-  ##############################################
-  
-  def define_object_configuration_array_getter( configuration_name )
-    configuration_getter_name = configuration_name
-    accessor_local_instance_support.module_eval do 
-	    define_method( configuration_getter_name ) do
-	      return composite_array_for_cascading_configuration( configuration_name )
-	    end
-    end
-  end
-  
-end

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

@@ -1,22 +0,0 @@
-
-module CascadingConfiguration::Array::Interface::Instance
-
-	extend  CascadingConfiguration::InternalModuleStub
-
-  #######################################
-  #  attr_instance_configuration_array  #
-  #######################################
-
-	# defines configuration in present class or module context
-	# configuration does not cascade
-  def attr_instance_configuration_array( *property_names )
-    property_names.each do |this_property_name|
-      # define configuration setter
-      define_instance_configuration_array_setter( this_property_name )
-      # define configuration getter
-      define_instance_configuration_array_getter( this_property_name )
-    end
-    return self
-  end
-
-end

data/lib/cascading-configuration-array/CascadingConfiguration/CompositingArray/Instance.rb

@@ -1,31 +0,0 @@
-
-module CascadingConfiguration::CompositingArray::Instance
-
-  extend ModuleCluster
-
-	extend CascadingConfiguration::InternalModuleStub
-
-  include_also_extends( self )
-
-  #################################################
-  #  composite_array_for_cascading_configuration  #
-  #################################################
-
-  def composite_array_for_cascading_configuration( cascading_name )
-
-    composite_array = nil
-
-		klass = ( is_a?( Module ) ? self : self.class )
-		self_instance = self
-		accessor_module_support.module_eval do
-			unless composite_array = ( ( @composite_arrays ||= Hash.new )[ cascading_name ] ||= Hash.new )[ self_instance ]
-	      composite_array = ::CascadingConfiguration::CompositingArray.new( cascading_name, self_instance )
-				@composite_arrays[ cascading_name ][ self_instance ] = composite_array
-			end
-		end
-
-    return composite_array
-    
-  end
-
-end

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

@@ -1,215 +0,0 @@
-
-class CascadingConfiguration::CompositingArray < Array
-
-  attr_accessor  :working_instance, :local_cascading_array
-
-  ################
-  #  initialize  #
-  ################
-  
-  def initialize( cascading_name, working_instance )
-    @cascading_name     = cascading_name
-		@working_class = ( working_instance.is_a?( Module ) ? working_instance : working_instance.class )
-    @working_instance   = working_instance
-    # if first ancestor can have a composite array, register self with it in case it gets updated in the future
-    if ( first_ancestor = @working_instance.first_ancestor ).respond_to?( :composite_array_for_cascading_configuration )
-      @parent_composite_array = first_ancestor.composite_array_for_cascading_configuration( @cascading_name )
-      @parent_composite_array.register_child_composite_array( self )
-    end
-    # get local cascading array (not included in parent composite)
-    @local_cascading_array = ::CascadingConfiguration::LocalConfigurationArray.new
-    # we may later have our own child composites
-    @child_composite_arrays = ::Array.new
-    # initialize self status for parent and local
-    update_self_as_cascading_composite
-  end
-
-  ####################################
-  #  register_child_composite_array  #
-  ####################################
-
-  def register_child_composite_array( child_composite_array )
-    @child_composite_arrays.push( child_composite_array )
-    return self
-  end
-
-  ######################################
-  #  unregister_child_composite_array  #
-  ######################################
-
-  def unregister_child_composite_array( child_composite_array )
-    @child_composite_arrays.delete( child_composite_array )
-    return self
-  end
-
-  #########
-  #  []=  #
-  #########
-
-  def []=( index, element )
-    # we sort internally, so index is irrelevant
-    # no reason to differentiate from push
-    push( element )
-  end
-
-  ########
-  #  <<  #
-  ########
-  
-  def <<( *elements )
-    # no reason to differentiate from push
-    push( *elements )
-  end
-  
-  #######
-  #  +  #
-  #######
-
-  def +( *arrays )
-    # no reason to differentiate from push
-    arrays.each do |this_array|
-      push( *this_array )
-    end
-    return self
-  end
-
-  ############
-  #  concat  #
-  ############
-  
-  def concat( *arrays )
-    arrays.each do |this_array|
-      push( *this_array )
-    end
-  end
-  
-  ##########
-  #  push  #
-  ##########
-  
-  alias_method :super_push, :push
-  def push( *elements )
-
-    # we are a composite array
-    # that means we have to set the value for our class
-    @local_cascading_array.push( *elements )
-        
-    update_adding_composite_elements( *elements )
-    
-    return self
-
-  end
-  
-  #######
-  #  -  #
-  #######
-  
-  def -( *arrays )
-    
-    arrays.each do |this_array|
-      delete( *this_array )
-    end
-    
-    return self
-    
-  end
-
-  ############
-  #  delete  #
-  ############
-  
-  alias_method :super_delete, :delete
-  def delete( *elements )
-  
-    @local_cascading_array.delete( *elements )
-
-    update_removing_composite_elements( *elements )
-    
-    return self
-    
-  end
-
-  #########
-  #  pop  #
-  #########
-  
-  def pop
-
-    element = super
-
-    @local_cascading_array.delete( element )
-
-    update_removing_composite_elements( element )
-    
-    return element
-
-  end
-
-  ###########
-  #  shift  #
-  ###########
-  
-  def shift
-
-    element = super
-
-    @local_cascading_array.delete( element )
-
-    update_removing_composite_elements( element )
-
-    return element
-    
-  end
-
-  ############
-  #  slice!  #
-  ############
-  
-  def slice!( *args )
-
-    elements = super
-
-    @local_cascading_array.delete( *elements )
-
-    update_removing_composite_elements( *elements )
-    
-    return elements
-    
-  end
-  
-  ###########
-  #  clear  #
-  ###########
-  
-  alias_method :super_clear, :clear
-  def clear
-
-    # add all existing values to exclude array
-    @local_cascading_array.delete( *self )
-
-    update_removing_composite_elements( *self )
-
-    return self
-    
-  end
-
-  #############
-  #  freeze!  #
-  #############
-
-  # freezes configuration and prevents ancestors from changing this configuration in the future
-  def freeze!
-    
-    # move current configuration into local configuration
-    @local_cascading_array.clear
-    @local_cascading_array.exclude_array.clear
-    @local_cascading_array.push( *self )
-    
-    # unregister with parent composite so we don't get future updates from it
-    @parent_composite_array.unregister_child_composite_array( self ) if @parent_composite_array
-    
-    return self
-    
-  end
-    
-end

data/lib/cascading-configuration-array/CascadingConfiguration/_private_/CompositingArray.rb

@@ -1,57 +0,0 @@
-
-class CascadingConfiguration::CompositingArray < Array
-  
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-  
-  ########################################
-  #  update_self_as_cascading_composite  #
-  ########################################
-
-  def update_self_as_cascading_composite
-    # start fresh
-    super_clear
-    # add parent config
-    super_push( *@parent_composite_array ) if @parent_composite_array
-    # add additional local config
-    super_push( *@local_cascading_array )
-    # remove local exclude
-    super_delete( *@local_cascading_array.exclude_array ) unless @local_cascading_array.exclude_array.empty?
-    # notify children to update their composite status
-    update_child_composite_arrays
-    return self
-  end
-
-  ######################################
-  #  update_adding_composite_elements  #
-  ######################################
-
-  def update_adding_composite_elements( *elements_to_cascade )
-    super_push( *elements_to_cascade )
-    sort!.uniq!
-    update_child_composite_arrays
-  end
-
-  ########################################
-  #  update_removing_composite_elements  #
-  ########################################
-
-  def update_removing_composite_elements( *elements_to_exclude )
-    elements_to_exclude.each do |this_excluded_element|
-      super_delete( this_excluded_element )
-    end
-    update_child_composite_arrays
-  end
-
-  ###################################
-  #  update_child_composite_arrays  #
-  ###################################
-  
-  def update_child_composite_arrays
-    @child_composite_arrays.each do |this_composite_array|
-      this_composite_array.instance_eval { update_self_as_cascading_composite }
-    end
-  end
-  
-end

data/lib/cascading-configuration-array/CascadingConfiguration/_private_/LocalConfigurationArray.rb

@@ -1,26 +0,0 @@
-
-class CascadingConfiguration::LocalConfigurationArray < Array
-
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-
-  ##########################
-  #  add_to_exclude_array  #
-  ##########################
-
-  def add_to_exclude_array( *elements )
-    @exclude_array += elements
-    @exclude_array.sort!.uniq!
-  end
-
-  ###############################
-  #  remove_from_exclude_array  #
-  ###############################
-
-  def remove_from_exclude_array( *elements )
-    @exclude_array -= elements
-    @exclude_array.sort!.uniq!
-  end
-  
-end

data/spec/CascadingConfiguration/Array/AccessorDefinitionMethods_spec.rb

@@ -1,30 +0,0 @@
-
-require_relative '../../../lib/cascading-configuration-array.rb'
-
-describe CascadingConfiguration::Array::AccessorDefinitionMethods do
-
-  ###################################
-  #  define_cascading_array_setter  #
-  #  define_cascading_array_getter  #
-  ###################################
-
-  it 'can define a method to get and modify the configuration array' do
-    class CascadingConfiguration::Array::Mock
-      include CascadingConfiguration::Variable
-      CascadingConfiguration::Variable.define_accessor_module_support( self )
-      CascadingConfiguration::Variable.define_accessor_instance_support( self )
-      extend  CascadingConfiguration::Array::AccessorDefinitionMethods
-      include CascadingConfiguration::Array::ObjectInstance
-      extend  CascadingConfiguration::Array::Interface
-    end
-    # setter
-    CascadingConfiguration::Array::Mock.define_cascading_array_setter( :some_configuration )
-    CascadingConfiguration::Array::Mock.respond_to?( :some_configuration= ).should == true
-    CascadingConfiguration::Array::Mock.instance_methods.include?( :some_configuration= ).should == true
-    # getter
-    CascadingConfiguration::Array::Mock.define_cascading_array_getter( :some_configuration )
-    CascadingConfiguration::Array::Mock.respond_to?( :some_configuration ).should == true
-    CascadingConfiguration::Array::Mock.instance_methods.include?( :some_configuration ).should == true
-  end
-
-end