module-cluster 1.1.1 → 1.2.0

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 1
-  - 1
-  version: 1.1.1
+  - 2
+  - 0
+  version: 1.2.0
 platform: ruby
 authors: 
 - Asher
@@ -14,11 +14,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-25 00:00:00 -04:00
+date: 2011-07-31 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
-description: Provides :define_module_included, :define_module_extended, :define_module_cluster, :define_module_included_cascades, :define_module_extended_cascades, :define_module_cluster_cascades, :define_module_included_cascades_to_class, :define_module_extended_cascades_to_class, :define_module_cluster_cascades_to_class.
+description: "Provides methods for clustering modules so that when the main module is included other modules are also included or extended, either before or after the main module. There are currently three variants: cluster, cascade, cascade to class. Cluster causes the next module to be affected. Cascade causes all subsequent modules to be affected. Cascade to class causes the first including/extending class to be affected, but not any modules prior to it (although the effects will cascade through those unaffected modules)."
 email: asher@ridiculouspower.com
 executables: []
 
@@ -27,14 +27,23 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/module-cluster/_private_/ModuleCluster.rb
-- lib/module-cluster/ModuleCluster/_private_/IncludeExtendSupport.rb
-- lib/module-cluster/ModuleCluster/ExtendSupport.rb
-- lib/module-cluster/ModuleCluster/IncludeExtendSupport.rb
-- lib/module-cluster/ModuleCluster/IncludeSupport.rb
+- lib/module-cluster/ModuleCluster/Define/_private_/ClusterStack.rb
+- lib/module-cluster/ModuleCluster/Define/_private_/ModuleCluster.rb
+- lib/module-cluster/ModuleCluster/Define/_private_/ModuleClusterCascades.rb
+- lib/module-cluster/ModuleCluster/Define/_private_/ModuleClusterCascadesToClass.rb
+- lib/module-cluster/ModuleCluster/Define/Deprecated.rb
+- lib/module-cluster/ModuleCluster/Define/ModuleCluster.rb
+- lib/module-cluster/ModuleCluster/Define/ModuleClusterCascades.rb
+- lib/module-cluster/ModuleCluster/Define/ModuleClusterCascadesToClass.rb
 - lib/module-cluster/ModuleCluster.rb
 - lib/module-cluster.rb
-- spec/ModuleCluster/IncludeExtendSupport_spec.rb
+- spec/ModuleCluster/Define/_private_/ClusterStack_spec.rb
+- spec/ModuleCluster/Define/_private_/ModuleCluster_spec.rb
+- spec/ModuleCluster/Define/_private_/ModuleClusterCascades_spec.rb
+- spec/ModuleCluster/Define/_private_/ModuleClusterCascadesToClass_spec.rb
+- spec/ModuleCluster/Define/ModuleCluster_spec.rb
+- spec/ModuleCluster/Define/ModuleClusterCascades_spec.rb
+- spec/ModuleCluster/Define/ModuleClusterCascadesToClass_spec.rb
 - spec/ModuleCluster_spec.rb
 - README.md
 - README.rdoc
@@ -69,6 +78,6 @@ rubyforge_project: module-cluster
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: "Adds methods for defining module clusters using #included and #extended."
+summary: "Adds methods for defining module clusters using #included, #extended, #append_features, and #extend_object."
 test_files: []
 

data/lib/module-cluster/ModuleCluster/ExtendSupport.rb

@@ -1,95 +0,0 @@
-
-module ModuleCluster::ExtendSupport
-
-	extend ModuleCluster::IncludeExtendSupport
-
-  ##############
-  #  extended  #
-  ##############
-
-	def extended( class_or_module )
-		super if defined?( super )
-		module_self = self
-		class_or_module.instance_eval do
-			# cascade ModuleCluster support
-			extend ModuleCluster
-			# take care of anything we're supposed to include when we are extended
-			ModuleCluster::ExtendSupport.included_sets( module_self ).each do |this_set|
-				# if we have a set intended to cascade only to classes
-				if this_set.is_a?( Array::CascadeToClass ) or this_set.is_a?( Array::CascadeToClassOrModule )
-					# and we have a class
-					if is_a?( Class ) or this_set.is_a?( Array::CascadeToClassOrModule )
-						# include the set
-						include( *this_set )
-					end
-					unless is_a?( Class )
-						if this_set.is_a?( Array::CascadeToClass )
-							# cascade our includes to the next module
-							define_module_extended_cascades_to_class do |included, extended|
-								included.concat( this_set )
-							end
-							if ModuleCluster::ExtendSupport.include_cluster?( module_self, *this_set )
-								define_module_included_cascades_to_class do |included, extended|
-									included.concat( this_set )
-								end
-							end
-						else
-							# cascade our includes to the next module
-							define_module_extended_cascades do |included, extended|
-								included.concat( this_set )
-							end
-							if ModuleCluster::ExtendSupport.include_cluster?( module_self, *this_set )
-								define_module_included_cascades do |included, extended|
-									included.concat( this_set )
-								end
-							end
-						end
-					end
-				# otherwise
-				else
-					# include the set
-					include( *this_set )
-				end
-			end
-			# take care of anything we're supposed to extend when we are extended
-			ModuleCluster::ExtendSupport.extended_sets( module_self ).each do |this_set|
-				# if we have a set intended to cascade only to classes
-				if this_set.is_a?( Array::CascadeToClass ) or this_set.is_a?( Array::CascadeToClassOrModule )
-					# and we have a class
-					if is_a?( Class ) or this_set.is_a?( Array::CascadeToClassOrModule )
-						# extend the set
-						extend( *this_set )
-					end
-					unless is_a?( Class )
-						if this_set.is_a?( Array::CascadeToClass )
-							# cascade our extends to the next module
-							define_module_extended_cascades_to_class do |included, extended|
-								extended.concat( this_set )
-							end
-							if ModuleCluster::ExtendSupport.extend_cluster?( module_self, *this_set )
-								define_module_included_cascades_to_class do |included, extended|
-									extended.concat( this_set )
-								end
-							end
-						else
-							# cascade our extends to the next module
-							define_module_extended_cascades do |included, extended|
-								extended.concat( this_set )
-							end
-							if ModuleCluster::ExtendSupport.extend_cluster?( module_self, *this_set )
-								define_module_included_cascades do |included, extended|
-									extended.concat( this_set )
-								end
-							end
-						end
-					end
-				# otherwise
-				else
-					# extend the set
-					extend( *this_set )
-				end
-			end
-		end
-	end
-
-end

data/lib/module-cluster/ModuleCluster/IncludeExtendSupport.rb

@@ -1,104 +0,0 @@
-
-module ModuleCluster::IncludeExtendSupport
-
-	######################################
-	#  add_includes_for_class_or_module  #
-	######################################
-
-	def add_includes_for_class_or_module( class_or_module, includes )
-		included_sets( class_or_module ).push( includes ) unless includes.empty?
-	end
-
-	#####################################
-	#  add_extends_for_class_or_module  #
-	#####################################
-	
-	def add_extends_for_class_or_module( class_or_module, extends )
-		extended_sets( class_or_module ).push( extends ) unless extends.empty?
-	end
-
-	################################################
-	#  add_cascading_includes_for_class_or_module  #
-	################################################
-
-	def add_cascading_includes_for_class_or_module( class_or_module, includes )
-		included_sets( class_or_module ).push( includes ) unless includes.empty?
-	end
-
-	###############################################
-	#  add_cascading_extends_for_class_or_module  #
-	###############################################
-	
-	def add_cascading_extends_for_class_or_module( class_or_module, extends )
-		extended_sets( class_or_module ).push( extends ) unless extends.empty?
-	end
-
-	######################################
-	#  add_cascading_includes_for_class  #
-	######################################
-
-	def add_cascading_includes_for_class( klass, includes )
-		included_sets( klass ).push( includes ) unless includes.empty?
-	end
-
-	#####################################
-	#  add_cascading_extends_for_class  #
-	#####################################
-	
-	def add_cascading_extends_for_class( klass, extends )
-		extended_sets( klass ).push( extends ) unless extends.empty?
-	end
-
-	###################
-	#  included_sets  #
-	###################
-
-	def included_sets( class_or_module )
-		return included_sets_hash[ class_or_module ] ||= Array.new
-	end
-
-	###################
-	#  extended_sets  #
-	###################
-
-	def extended_sets( class_or_module )
-		return extended_sets_hash[ class_or_module ] ||= Array.new
-	end
-
-	####################
-	#  set_as_cluster  #
-	####################
-
-	def set_as_cluster( class_or_module, includes, extends )
-		includes_cluster_hash_for_class_or_module( class_or_module ).concat( includes )
-		extends_cluster_hash_for_class_or_module( class_or_module ).concat( extends )
-		return self
-	end
-
-	######################
-	#  include_cluster?  #
-	######################
-
-	def include_cluster?( class_or_module, *modules )
-		include_set_as_cluster = true
-		modules.each do |this_module|
-			include_set_as_cluster = false unless includes_cluster_hash_for_class_or_module( class_or_module ).include?( this_module )
-			break unless include_set_as_cluster
-		end
-		return include_set_as_cluster
-	end
-
-	#####################
-	#  extend_cluster?  #
-	#####################
-
-	def extend_cluster?( class_or_module, *modules )
-		extend_set_as_cluster = true
-		modules.each do |this_module|
-			extend_set_as_cluster = false unless extends_cluster_hash_for_class_or_module( class_or_module ).include?( this_module )
-			break unless extend_set_as_cluster
-		end
-		return extend_set_as_cluster
-	end
-
-end

data/lib/module-cluster/ModuleCluster/IncludeSupport.rb

@@ -1,94 +0,0 @@
-
-module ModuleCluster::IncludeSupport
-
-	extend ModuleCluster::IncludeExtendSupport
-
-  ##############
-  #  included  #
-  ##############
-
-	def included( class_or_module )
-		super if defined?( super )
-		module_self = self
-		class_or_module.instance_eval do
-			# cascade ModuleCluster support
-			extend ModuleCluster
-			ModuleCluster::IncludeSupport.included_sets( module_self ).each do |this_set|
-				# if we have a set intended to cascade only to classes
-				if this_set.is_a?( Array::CascadeToClass ) or this_set.is_a?( Array::CascadeToClassOrModule )
-					# and we have a class
-					if is_a?( Class ) or this_set.is_a?( Array::CascadeToClassOrModule )
-						# include the set
-						include( *this_set )
-					end
-					unless is_a?( Class )
-						if this_set.is_a?( Array::CascadeToClass )
-							# cascade our includes to the next module
-							define_module_included_cascades_to_class do |included, extended|
-								included.concat( this_set )
-							end
-							if ModuleCluster::IncludeSupport.include_cluster?( module_self, *this_set )
-								define_module_extended_cascades_to_class do |included, extended|
-									included.concat( this_set )
-								end
-							end
-						else
-							# cascade our includes to the next module
-							define_module_included_cascades do |included, extended|
-								included.concat( this_set )
-							end
-							if ModuleCluster::IncludeSupport.include_cluster?( module_self, *this_set )
-								define_module_extended_cascades do |included, extended|
-									included.concat( this_set )
-								end
-							end
-						end
-					end
-				# otherwise
-				else
-					# include the set
-					include( *this_set )
-				end
-			end
-			# take care of anything we're supposed to extend when we are included
-			ModuleCluster::IncludeSupport.extended_sets( module_self ).each do |this_set|
-				# if we have a set intended to cascade only to classes
-				if this_set.is_a?( Array::CascadeToClass ) or this_set.is_a?( Array::CascadeToClassOrModule )
-					# and we have a class
-					if is_a?( Class ) or this_set.is_a?( Array::CascadeToClassOrModule )
-						# extend the set
-						extend( *this_set )
-					end
-					unless is_a?( Class )
-						if this_set.is_a?( Array::CascadeToClass )
-							# cascade our extends to the next module
-							define_module_included_cascades_to_class do |included, extended|
-								extended.concat( this_set )
-							end
-							if ModuleCluster::IncludeSupport.extend_cluster?( module_self, *this_set )
-								define_module_extended_cascades_to_class do |included, extended|
-									extended.concat( this_set )
-								end
-							end
-						else
-							# cascade our extends to the next module
-							define_module_included_cascades do |included, extended|
-								extended.concat( this_set )
-							end
-							if ModuleCluster::IncludeSupport.extend_cluster?( module_self, *this_set )
-								define_module_extended_cascades do |included, extended|
-									extended.concat( this_set )
-								end
-							end
-						end
-					end
-				# otherwise
-				else
-					# extend the set
-					extend( *this_set )
-				end
-			end
-		end
-	end
-
-end

data/lib/module-cluster/ModuleCluster/_private_/IncludeExtendSupport.rb

@@ -1,56 +0,0 @@
-
-module ModuleCluster::IncludeExtendSupport
-
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-
-	########################
-	#  included_sets_hash  #
-	########################
-
-	def included_sets_hash
-		return @included_sets_hash ||= Hash.new
-	end
-
-	########################
-	#  extended_sets_hash  #
-	########################
-
-	def extended_sets_hash
-		return @extended_sets_hash ||= Hash.new
-	end
-	
-	##################
-	#  cluster_hash  #
-	##################
-	
-	def cluster_hash
-		return @cluster_hash ||= Hash.new
-	end
-
-	######################################
-	#  cluster_hash_for_class_or_module  #
-	######################################
-	
-	def cluster_hash_for_class_or_module( class_or_module )
-		return cluster_hash[ class_or_module ] ||= Hash.new
-	end
-
-	###############################################
-	#  includes_cluster_hash_for_class_or_module  #
-	###############################################
-	
-	def includes_cluster_hash_for_class_or_module( class_or_module )
-		return cluster_hash_for_class_or_module( class_or_module )[ :includes ] ||= Array.new
-	end
-		
-	##############################################
-	#  extends_cluster_hash_for_class_or_module  #
-	##############################################
-	
-	def extends_cluster_hash_for_class_or_module( class_or_module )
-		return cluster_hash_for_class_or_module( class_or_module )[ :extends ] ||= Array.new
-	end
-	
-end

data/lib/module-cluster/_private_/ModuleCluster.rb

@@ -1,23 +0,0 @@
-
-module ModuleCluster
-
-  ###########################################################################################################
-      private ###############################################################################################
-  ###########################################################################################################
-
-	def yield_for_includes_extends( inclusion_array, extension_array, block )
-		returned_includes, returned_extends = block.call( inclusion_array, extension_array )
-		if returned_includes and returned_extends and 
-			 returned_includes.is_a?( Array ) and returned_extends.is_a?( Array )
-			inclusion_array = returned_includes
-			extension_array = returned_extends
-		end
-		unless inclusion_array.is_a?( Array ) and extension_array.is_a?( Array )
-			raise 'Expected module inclusion/extension variables to remain Array. Received ' +
-			      inclusion_array.inspect + ' for inclusion array, and ' + extension_array.inspect +
-			      ' for extension array.'
-		end
-		return inclusion_array, extension_array
-	end
-	
-end

data/spec/ModuleCluster/IncludeExtendSupport_spec.rb

@@ -1,46 +0,0 @@
-
-require_relative '../../lib/module-cluster.rb'
-
-describe ModuleCluster::IncludeExtendSupport do
-  
-  ############################################
-	#  set_includes_for_class_or_module        #
-	#  includes_for_class_or_module_inclusion  #
-	############################################
-
-	it 'can set and return includes for a class or module' do
-	  module ModuleCluster::IncludeExtendSupport::Mock01
-	    extend ModuleCluster::IncludeExtendSupport
-      module MockModule1
-      end
-      module MockModule2
-      end
-    end
-	  class ModuleCluster::IncludeExtendSupport::MockClass
-	    includes = [ ModuleCluster::IncludeExtendSupport::Mock01::MockModule1,
-	                 ModuleCluster::IncludeExtendSupport::Mock01::MockModule2 ]
-	    ModuleCluster::IncludeExtendSupport::Mock01.add_includes_for_class_or_module( self, includes )
-    end
-  end
-
-	###########################################
-	#  set_extends_for_class_or_module        #
-	#  extends_for_class_or_module_extension  #
-	###########################################
-	
-	it 'can set and return extends for a class or module' do
-	  module ModuleCluster::IncludeExtendSupport::Mock02
-	    extend ModuleCluster::IncludeExtendSupport
-      module MockModule1
-      end
-      module MockModule2
-      end
-    end
-	  class ModuleCluster::IncludeExtendSupport::MockClass
-	    includes = [ ModuleCluster::IncludeExtendSupport::Mock02::MockModule1,
-	                 ModuleCluster::IncludeExtendSupport::Mock02::MockModule2 ]
-	    ModuleCluster::IncludeExtendSupport::Mock02.add_includes_for_class_or_module( self, includes )
-    end	  
-  end
-  
-end