cascading-configuration-hash 1.1.3 → 1.1.4

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 1
-  - 3
-  version: 1.1.3
+  - 4
+  version: 1.1.4
 platform: ruby
 authors: 
 - Asher
@@ -39,20 +39,9 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/cascading-configuration-hash/CascadingConfiguration/_private_/CompositingHash.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/_private_/LocalConfigurationHash.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/CompositingHash/Instance.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/CompositingHash.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash/Accessors.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash/ClassInstance.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash/ModuleInstance.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/Hash.rb
-- lib/cascading-configuration-hash/CascadingConfiguration/LocalConfigurationHash.rb
-- lib/cascading-configuration-hash.rb
-- spec/CascadingConfiguration/CascadingCompositeHash_spec.rb
-- spec/CascadingConfiguration/ConfigurationHash_spec.rb
-- spec/CascadingConfiguration/Hash/Accessors_spec.rb
-- spec/CascadingConfiguration/Hash_spec.rb
+- lib/cascading-configuration/CascadingConfiguration.rb
+- lib/cascading-configuration.rb
+- spec/CascadingConfiguration_spec.rb
 - README.md
 - README.rdoc
 has_rdoc: true

data/lib/cascading-configuration-hash/CascadingConfiguration/CompositingHash/Instance.rb

@@ -1,39 +0,0 @@
-
-module CascadingConfiguration::CompositingHash::Instance
-
-	extend  CascadingConfiguration::InternalModuleStub
-
-  ###################
-  #  self.included  #
-  ###################
-
-  def self.included( class_or_module )
-    module_self = self
-    class_or_module.instance_eval do
-      extend module_self
-    end
-  end
-
-  ################################################
-  #  composite_hash_for_cascading_configuration  #
-  ################################################
-
-  def composite_hash_for_cascading_configuration( cascading_name )
-    
-    composite_hash = nil
-
-		klass = ( is_a?( Module ) ? self : self.class )
-		accessor_support_module = klass::AccessorSupportModule
-		self_instance = self
-		accessor_support_module.instance_eval do
-			unless composite_hash = ( ( @composite_hashes ||= Hash.new )[ cascading_name ] ||= Hash.new )[ self_instance ]
-	      composite_hash = ::CascadingConfiguration::CompositingHash.new( cascading_name, self_instance )
-				@composite_hashes[ cascading_name ][ self_instance ] = composite_hash
-			end
-		end
-
-    return composite_hash
-    
-  end
-
-end

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

@@ -1,136 +0,0 @@
-
-class CascadingConfiguration::CompositingHash < Hash
-
-  attr_accessor  :working_instance, :local_cascading_hash
-
-  ################
-  #  initialize  #
-  ################
-  
-  def initialize( cascading_name, working_instance )
-    @cascading_name     = cascading_name
-		@working_class = ( working_instance.is_a?( Module ) ? working_instance : working_instance.class )
-    @cascading_variable = @working_class::AccessorSupportModule.cascading_variable_name( @cascading_name )
-    @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_hash_for_cascading_configuration )
-      @parent_composite_hash = first_ancestor.composite_hash_for_cascading_configuration( @cascading_name )
-      @parent_composite_hash.register_child_composite_hash( self )
-    end
-    # get local cascading array (not included in parent composite)
-    @local_cascading_hash = ::CascadingConfiguration::LocalConfigurationHash.new
-    # we may later have our own child composites
-    @child_composite_hashes = ::Array.new
-    # initialize self status for parent and local
-    update_self_as_cascading_composite
-  end
-
-  ###################################
-  #  register_child_composite_hash  #
-  ###################################
-
-  def register_child_composite_hash( child_composite_hash )
-    @child_composite_hashes.push( child_composite_hash )
-    return self
-  end
-
-  #####################################
-  #  unregister_child_composite_hash  #
-  #####################################
-
-  def unregister_child_composite_hash( child_composite_hash )
-    @child_composite_hashes.delete( child_composite_hash )
-    return self
-  end
-
-  #########
-  #  []=  #
-  #########
-
-  def []=( key, value )
-    @local_cascading_hash[ key ] = value
-    update_adding_composite_elements( key => value )
-  end
-  alias_method :store, :[]=
-
-  ############
-  #  delete  #
-  ############
-
-  alias_method :super_delete, :delete
-  def delete( key )
-    value = self[ key ]
-    @local_cascading_hash.delete( key )
-    update_removing_composite_elements( key )
-    return value
-  end
-
-  ############
-  #  merge!  #
-  ############
-  
-  alias_method :super_merge!, :merge!
-  def merge!( other_hash )
-    @local_cascading_hash.merge!( other_hash )
-    update_adding_composite_elements( other_hash )
-    return self
-  end
-  
-  #############
-  #  replace  #
-  #############
-  
-  alias_method :super_replace, :replace
-  def replace( other_hash )
-    # clear current values
-    clear
-    # merge replacement settings
-    merge!( other_hash )
-		update_self_as_cascading_composite
-    return self
-  end
-
-  ###########
-  #  shift  #
-  ###########
-  
-  def shift
-    element = super
-    key = element[ 0 ]
-    @local_cascading_hash.delete( key )
-    update_removing_composite_elements( key )
-    return element
-  end
-
-  ###########
-  #  clear  #
-  ###########
-  
-  alias_method :super_clear, :clear
-  def clear
-    # add all existing values to exclude array
-    keys.each do |this_key|
-      delete( this_key )
-    end
-    update_removing_composite_elements( *self.keys )
-    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_hash.replace( self )
-    
-    # unregister with parent composite so we don't get future updates from it
-    @parent_composite_hash.unregister_child_composite_hash( self ) if @parent_composite_hash
-    
-    return self
-    
-  end
-  
-end

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

@@ -1,33 +0,0 @@
-
-module CascadingConfiguration::Hash::Accessors
-
-	extend  CascadingConfiguration::InternalModuleStub
-
-  ######################################
-  #  define_configuration_hash_setter  #
-  ######################################
-  
-  def define_configuration_hash_setter( configuration_name )
-    configuration_setter_name = ( configuration_name.to_s + '=' ).to_sym
-    self::AccessorSupportModule.module_eval do 
-	    define_method( configuration_setter_name ) do |hash|
-	      # we want the hash to supplant existing config
-	      return composite_hash_for_cascading_configuration( configuration_name ).replace( hash )
-	    end
-    end
-  end
-
-  ######################################
-  #  define_configuration_hash_getter  #
-  ######################################
-  
-  def define_configuration_hash_getter( configuration_name )
-    configuration_getter_name = configuration_name
-    self::AccessorSupportModule.module_eval do 
-	    define_method( configuration_getter_name ) do
-	      return composite_hash_for_cascading_configuration( configuration_name )
-	    end
-    end
-  end
-
-end

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

@@ -1,24 +0,0 @@
-
-module CascadingConfiguration::Hash::ClassInstance
-
-	extend  CascadingConfiguration::InternalModuleStub
-
-  #############################
-  #  attr_configuration_hash  #
-  #############################
-
-  def attr_configuration_hash( *property_names, & compositing_block )
-    
-    property_names.each do |this_property_name|
-			self::AccessorSupportModule.set_compositing_proc( this_property_name, compositing_block ) if block_given?
-      # define configuration setter
-      define_configuration_hash_setter( this_property_name )
-      # define configuration getter
-      define_configuration_hash_getter( this_property_name )
-    end
-    
-    return self
-
-  end
-
-end

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

@@ -1,36 +0,0 @@
-
-module CascadingConfiguration::Hash::ModuleInstance
-  
-	extend  CascadingConfiguration::InternalModuleStub
-	
-  ##############
-  #  included  #
-  ##############
-  
-  def included( class_or_module )
-		super if method_defined?( :super )
-		# CascadingConfiguration::Hash
-    module_self = self
-    class_or_module.instance_eval do
-			# whichever module included CascadingConfiguration::Hash
-      extend  module_self
-      # cascade CascadingConfiguration::Hash
-      include CascadingConfiguration::Hash
-    end
-  end
-
-  ##############
-  #  extended  #
-  ##############
-  
-  def extended( class_or_module )
-		super if method_defined?( :super )
-		# CascadingConfiguration::Hash
-    module_self = self
-    class_or_module.instance_eval do
-      # cascade CascadingConfiguration::Hash
-      include CascadingConfiguration::Hash
-    end
-  end
-  
-end

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

@@ -1,24 +0,0 @@
-
-module CascadingConfiguration::Hash
-  
-	extend  CascadingConfiguration::InternalModuleStub
-
-  include CascadingConfiguration::Variable
-  include CascadingConfiguration::CompositingHash::Instance
-
-  ###################
-  #  self.included  #
-  ###################
-
-  def self.included( class_or_module )
-		module_self = self
-    class_or_module.instance_eval do
-      extend  module_self
-      extend  module_self::Accessors
-      extend  module_self::ClassInstance
-			# module support
-      extend CascadingConfiguration::Hash::ModuleInstance unless is_a?( Class )
-    end
-  end
-
-end

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

@@ -1,83 +0,0 @@
-
-class CascadingConfiguration::LocalConfigurationHash < Hash
-  
-  attr_accessor  :exclude_array
-  
-  ################
-  #  initialize  #
-  ################
-
-  def initialize()
-    @exclude_array = ::Array.new
-  end
-  
-  #########
-  #  []=  #
-  #########
-
-  def []=( key, value )
-    super
-    remove_from_exclude_array( key )
-  end
-
-  ###########
-  #  store  #
-  ###########
-
-  def store( key, value )
-    self[ key ] = value
-  end
-
-  ############
-  #  delete  #
-  ############
-
-  def delete( key )
-    value = super
-    add_to_exclude_array( key )
-    return value
-  end
-
-  ############
-  #  merge!  #
-  ############
-  
-  def merge!( other_hash )
-    super
-    remove_from_exclude_array( *other_hash.keys )
-    return self
-  end
-  
-  #############
-  #  replace  #
-  #############
-  
-  def replace( other_hash )
-    add_to_exclude_array( *self.keys )
-    super
-  end
-
-  ###########
-  #  shift  #
-  ###########
-  
-  def shift
-    element = super
-    add_to_exclude_array( element )
-    return element
-  end
-
-  ###########
-  #  clear  #
-  ###########
-  
-  def clear
-    # add all existing values to exclude array
-    self.each do |this_key, this_value|
-      delete( this_key )
-    end
-    # clear existing values
-    super
-  end
-
-end

data/lib/cascading-configuration-hash/CascadingConfiguration/_private_/CompositingHash.rb

@@ -1,79 +0,0 @@
-
-class CascadingConfiguration::CompositingHash < Hash
-  
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-
-  ########################################
-  #  update_self_as_cascading_composite  #
-  ########################################
-
-  def update_self_as_cascading_composite
-    # start fresh
-    super_clear
-		update_composite_self_for_parent_hash( @parent_composite_hash, @local_cascading_hash )
-    # remove local exclude
-    unless @local_cascading_hash.exclude_array.empty?
-      @local_cascading_hash.exclude_array.each do |this_excluded_element|
-        super_delete( this_excluded_element )
-      end
-    end
-    # 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 )
-		update_composite_self_for_parent_hash( self, elements_to_cascade )
-    update_child_composite_arrays
-		return self
-  end
-
-  ###########################################
-  #  update_composite_self_for_parent_hash  #
-  ###########################################
-
-	def update_composite_self_for_parent_hash( parent_hash, second_hash )
-		if compositing_proc = @working_class::AccessorSupportModule.get_compositing_proc( @cascading_name )
-			# if we have a compositing proc defined, use its result to replace
-			parent_hash_copy = Hash.new
-			parent_hash_copy.merge!( parent_hash ) if parent_hash
-			second_hash_copy = Hash.new
-			second_hash_copy.merge!( second_hash ) if second_hash
-			composite_result = compositing_proc.call( parent_hash_copy, second_hash_copy )
-			super_replace( composite_result )
-		else
-			# otherwise we simply merge
-	    super_merge!( parent_hash ) if parent_hash
-	    super_merge!( second_hash ) if second_hash
-		end
-		return self
-	end
-
-  ########################################
-  #  update_removing_composite_elements  #
-  ########################################
-
-  def update_removing_composite_elements( *elements_to_exclude )
-    elements_to_exclude.each do |this_key|
-      super_delete( this_key )
-    end
-    update_child_composite_arrays
-  end
-
-  ###################################
-  #  update_child_composite_arrays  #
-  ###################################
-  
-  def update_child_composite_arrays
-    @child_composite_hashes.each do |this_composite_hash|
-      this_composite_hash.instance_eval { update_self_as_cascading_composite }
-    end
-  end
-    
-end

data/lib/cascading-configuration-hash/CascadingConfiguration/_private_/LocalConfigurationHash.rb

@@ -1,31 +0,0 @@
-
-class CascadingConfiguration::LocalConfigurationHash < Hash
-
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-
-  ##########################
-  #  add_to_exclude_array  #
-  ##########################
-
-  def add_to_exclude_array( *elements )
-    @exclude_array ||= ::Array.new
-    @exclude_array += elements
-    @exclude_array.sort!.uniq!
-  end
-
-  ###############################
-  #  remove_from_exclude_array  #
-  ###############################
-
-  def remove_from_exclude_array( *elements )
-    if @exclude_array
-      @exclude_array -= elements
-      @exclude_array.sort!.uniq!
-    else
-      @exclude_array ||= ::Array.new
-    end
-  end
-  
-end

data/lib/cascading-configuration-hash.rb

@@ -1,35 +0,0 @@
-
-if $cascading_configuration_development
-	require_relative '../../variable/lib/cascading-configuration-variable.rb'
-else
-	require 'cascading-configuration-variable'
-end
-
-module CascadingConfiguration
-  class CompositingHash < Hash
-    module Instance
-    end
-  end
-  class LocalConfigurationHash < Hash
-  end
-  module Hash
-    module Accessors
-    end
-    module ClassInstance
-    end
-    module ObjectInstance
-    end
-    module ModuleInstance
-    end
-  end
-end
-
-require_relative 'cascading-configuration-hash/CascadingConfiguration/CompositingHash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/_private_/CompositingHash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/CompositingHash/Instance.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/LocalConfigurationHash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/_private_/LocalConfigurationHash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/Accessors.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/ClassInstance.rb'
-require_relative 'cascading-configuration-hash/CascadingConfiguration/Hash/ModuleInstance.rb'