module-cluster 1.4.0 → 1.4.1

data/README.md

@@ -51,7 +51,7 @@ Blocks can be used to return dynamically-determined modules at runtime.
 ```ruby
 module SomeModule
   extend ModuleCluster
-  include_or_extend_cascades_prepending_extends do
+  include_or_extend_cascades_prepend_extends do
     method_that_returns_one_or_more_modules
   end
 end
@@ -61,7 +61,7 @@ Block methods can be used for nesting declarations, for instance to apply cascad
 
 ```ruby
 prepend_module_include do |class_or_module|
-  class_or_module.include_or_extend_cascades_prepending_extends do
+  class_or_module.include_or_extend_cascades_prepend_extends do
     method_that_returns_one_or_more_modules
   end
 end
@@ -207,18 +207,18 @@ Cascade methods (cascades to modules and classes):
 * extend_cascades_includes
 * extend_cascades_extends
 * extend_cascades_includes_and_extends
-* include_cascades_prepending_includes
-* include_cascades_prepending_extends
-* include_cascades_prepending_includes_and_extends
-* extend_cascades_prepending_includes
-* extend_cascades_prepending_extends
-* extend_cascades_prepending_includes_and_extends
+* include_cascades_prepend_includes
+* include_cascades_prepend_extends
+* include_cascades_prepend_includes_and_extends
+* extend_cascades_prepend_includes
+* extend_cascades_prepend_extends
+* extend_cascades_prepend_includes_and_extends
 * include_or_extend_cascades_includes
 * include_or_extend_cascades_extends
 * include_or_extend_cascades_includes_and_extends
-* include_or_extend_cascades_prepending_includes
-* include_or_extend_cascades_prepending_extends
-* include_or_extend_cascades_prepending_includes_and_extends
+* include_or_extend_cascades_prepend_includes
+* include_or_extend_cascades_prepend_extends
+* include_or_extend_cascades_prepend_includes_and_extends
 
 Cascade to class methods (does not cascade to modules):
 
@@ -228,18 +228,18 @@ Cascade to class methods (does not cascade to modules):
 * extend_cascades_includes_to_class
 * extend_cascades_extends_to_class
 * extend_cascades_includes_and_extends_to_class
-* include_cascades_to_class_prepending_includes
-* include_cascades_to_class_prepending_extends
-* include_cascades_to_class_prepending_includes_and_extends
-* extend_cascades_to_class_prepending_includes
-* extend_cascades_to_class_prepending_extends
-* extend_cascades_to_class_prepending_includes_and_extends
+* include_cascades_to_class_prepend_includes
+* include_cascades_to_class_prepend_extends
+* include_cascades_to_class_prepend_includes_and_extends
+* extend_cascades_to_class_prepend_includes
+* extend_cascades_to_class_prepend_extends
+* extend_cascades_to_class_prepend_includes_and_extends
 * include_or_extend_cascades_includes_to_class
 * include_or_extend_cascades_extends_to_class
 * include_or_extend_cascades_includes_and_extends_to_class
-* include_or_extend_cascades_to_class_prepending_includes
-* include_or_extend_cascades_to_class_prepending_extends
-* include_or_extend_cascades_to_class_prepending_includes_and_extends
+* include_or_extend_cascades_to_class_prepend_includes
+* include_or_extend_cascades_to_class_prepend_extends
+* include_or_extend_cascades_to_class_prepend_includes_and_extends
 
 Cascade to module methods (does not cascade to classes):
 
@@ -249,18 +249,18 @@ Cascade to module methods (does not cascade to classes):
 * extend_cascades_includes_to_module
 * extend_cascades_extends_to_module
 * extend_cascades_includes_and_extends_to_module
-* include_cascades_to_module_prepending_includes
-* include_cascades_to_module_prepending_extends
-* include_cascades_to_module_prepending_includes_and_extends
-* extend_cascades_to_module_prepending_includes
-* extend_cascades_to_module_prepending_extends
-* extend_cascades_to_module_prepending_includes_and_extends
+* include_cascades_to_module_prepend_includes
+* include_cascades_to_module_prepend_extends
+* include_cascades_to_module_prepend_includes_and_extends
+* extend_cascades_to_module_prepend_includes
+* extend_cascades_to_module_prepend_extends
+* extend_cascades_to_module_prepend_includes_and_extends
 * include_or_extend_cascades_includes_to_module
 * include_or_extend_cascades_extends_to_module
 * include_or_extend_cascades_includes_and_extends_to_module
-* include_or_extend_cascades_to_module_prepending_includes
-* include_or_extend_cascades_to_module_prepending_extends
-* include_or_extend_cascades_to_module_prepending_includes_and_extends
+* include_or_extend_cascades_to_module_prepend_includes
+* include_or_extend_cascades_to_module_prepend_extends
+* include_or_extend_cascades_to_module_prepend_includes_and_extends
 
 Module block methods:
 
@@ -321,6 +321,43 @@ Class or module or instance block methods:
 * prepend_class_or_module_include_or_instance_extend
 * prepend_class_or_module_include_or_extend_or_instance_extend
 
+Suspend methods:
+
+*  suspend_any_hooks
+*  suspend_any_include_hooks
+*  suspend_any_extend_hooks
+*  suspend_include_hooks
+*  suspend_extend_hooks
+*  suspend_prepend_include_hooks
+*  suspend_prepend_extend_hooks
+
+*  hooks_suspended?
+*  all_hooks_suspended?
+*  all_include_hooks_suspended?
+*  all_extend_hooks_suspended?
+*  include_hooks_suspended?
+*  extend_hooks_suspended?
+*  prepend_include_hooks_suspended?
+*  prepend_extend_hooks_suspended?
+
+*  resume_any_hooks
+*  resume_any_include_hooks
+*  resume_any_extend_hooks
+*  resume_include_hooks
+*  resume_extend_hooks
+*  resume_prepend_include_hooks
+*  resume_prepend_extend_hooks
+
+Suspend for block methods:
+
+*  without_any_hooks
+*  without_any_include_hooks
+*  without_any_extend_hooks
+*  without_include_hooks
+*  without_extend_hooks
+*  without_prepend_include_hooks
+*  without_prepend_extend_hooks
+
 # License #
 
   (The MIT License)

data/README.rdoc

@@ -44,7 +44,7 @@ Blocks can be used to return dynamically-determined modules at runtime.
 
 module SomeModule
   extend ModuleCluster
-  include_or_extend_cascades_prepending_extends do
+  include_or_extend_cascades_prepend_extends do
     method_that_returns_one_or_more_modules
   end
 end
@@ -52,7 +52,7 @@ end
 Block methods can be used for nesting declarations, for instance to apply cascades only after first module/class:
 
 prepend_module_include do |class_or_module|
-  class_or_module.include_or_extend_cascades_prepending_extends do
+  class_or_module.include_or_extend_cascades_prepend_extends do
     method_that_returns_one_or_more_modules
   end
 end
@@ -197,18 +197,18 @@ Cascade methods (cascades to modules and classes):
 * extend_cascades_includes
 * extend_cascades_extends
 * extend_cascades_includes_and_extends
-* include_cascades_prepending_includes
-* include_cascades_prepending_extends
-* include_cascades_prepending_includes_and_extends
-* extend_cascades_prepending_includes
-* extend_cascades_prepending_extends
-* extend_cascades_prepending_includes_and_extends
+* include_cascades_prepend_includes
+* include_cascades_prepend_extends
+* include_cascades_prepend_includes_and_extends
+* extend_cascades_prepend_includes
+* extend_cascades_prepend_extends
+* extend_cascades_prepend_includes_and_extends
 * include_or_extend_cascades_includes
 * include_or_extend_cascades_extends
 * include_or_extend_cascades_includes_and_extends
-* include_or_extend_cascades_prepending_includes
-* include_or_extend_cascades_prepending_extends
-* include_or_extend_cascades_prepending_includes_and_extends
+* include_or_extend_cascades_prepend_includes
+* include_or_extend_cascades_prepend_extends
+* include_or_extend_cascades_prepend_includes_and_extends
 
 Cascade to class methods (does not cascade to modules):
 
@@ -218,18 +218,18 @@ Cascade to class methods (does not cascade to modules):
 * extend_cascades_includes_to_class
 * extend_cascades_extends_to_class
 * extend_cascades_includes_and_extends_to_class
-* include_cascades_to_class_prepending_includes
-* include_cascades_to_class_prepending_extends
-* include_cascades_to_class_prepending_includes_and_extends
-* extend_cascades_to_class_prepending_includes
-* extend_cascades_to_class_prepending_extends
-* extend_cascades_to_class_prepending_includes_and_extends
+* include_cascades_to_class_prepend_includes
+* include_cascades_to_class_prepend_extends
+* include_cascades_to_class_prepend_includes_and_extends
+* extend_cascades_to_class_prepend_includes
+* extend_cascades_to_class_prepend_extends
+* extend_cascades_to_class_prepend_includes_and_extends
 * include_or_extend_cascades_includes_to_class
 * include_or_extend_cascades_extends_to_class
 * include_or_extend_cascades_includes_and_extends_to_class
-* include_or_extend_cascades_to_class_prepending_includes
-* include_or_extend_cascades_to_class_prepending_extends
-* include_or_extend_cascades_to_class_prepending_includes_and_extends
+* include_or_extend_cascades_to_class_prepend_includes
+* include_or_extend_cascades_to_class_prepend_extends
+* include_or_extend_cascades_to_class_prepend_includes_and_extends
 
 Cascade to module methods (does not cascade to classes):
 
@@ -239,18 +239,18 @@ Cascade to module methods (does not cascade to classes):
 * extend_cascades_includes_to_module
 * extend_cascades_extends_to_module
 * extend_cascades_includes_and_extends_to_module
-* include_cascades_to_module_prepending_includes
-* include_cascades_to_module_prepending_extends
-* include_cascades_to_module_prepending_includes_and_extends
-* extend_cascades_to_module_prepending_includes
-* extend_cascades_to_module_prepending_extends
-* extend_cascades_to_module_prepending_includes_and_extends
+* include_cascades_to_module_prepend_includes
+* include_cascades_to_module_prepend_extends
+* include_cascades_to_module_prepend_includes_and_extends
+* extend_cascades_to_module_prepend_includes
+* extend_cascades_to_module_prepend_extends
+* extend_cascades_to_module_prepend_includes_and_extends
 * include_or_extend_cascades_includes_to_module
 * include_or_extend_cascades_extends_to_module
 * include_or_extend_cascades_includes_and_extends_to_module
-* include_or_extend_cascades_to_module_prepending_includes
-* include_or_extend_cascades_to_module_prepending_extends
-* include_or_extend_cascades_to_module_prepending_includes_and_extends
+* include_or_extend_cascades_to_module_prepend_includes
+* include_or_extend_cascades_to_module_prepend_extends
+* include_or_extend_cascades_to_module_prepend_includes_and_extends
 
 Module block methods:
 
@@ -311,6 +311,43 @@ Class or module or instance block methods:
 * prepend_class_or_module_include_or_instance_extend
 * prepend_class_or_module_include_or_extend_or_instance_extend
 
+Suspend methods:
+
+*  suspend_any_hooks
+*  suspend_any_include_hooks
+*  suspend_any_extend_hooks
+*  suspend_include_hooks
+*  suspend_extend_hooks
+*  suspend_prepend_include_hooks
+*  suspend_prepend_extend_hooks
+
+*  hooks_suspended?
+*  all_hooks_suspended?
+*  all_include_hooks_suspended?
+*  all_extend_hooks_suspended?
+*  include_hooks_suspended?
+*  extend_hooks_suspended?
+*  prepend_include_hooks_suspended?
+*  prepend_extend_hooks_suspended?
+
+*  resume_any_hooks
+*  resume_any_include_hooks
+*  resume_any_extend_hooks
+*  resume_include_hooks
+*  resume_extend_hooks
+*  resume_prepend_include_hooks
+*  resume_prepend_extend_hooks
+
+Suspend for block methods:
+
+*  without_any_hooks
+*  without_any_include_hooks
+*  without_any_extend_hooks
+*  without_include_hooks
+*  without_extend_hooks
+*  without_prepend_include_hooks
+*  without_prepend_extend_hooks
+
 == License
 
   (The MIT License)

data/lib/module-cluster.rb

@@ -9,6 +9,10 @@ module ModuleCluster
       module Module
       end
     end
+    module Status
+    end
+    module Suspend
+    end
   end
   module CascadeFeatures
   end
@@ -52,6 +56,12 @@ module ModuleCluster
     module ModuleOrInstanceCluster
     end
   end
+  module Suspend
+    module Hooks
+    end
+    module WithoutHooks
+    end
+  end
 end
 
 
@@ -62,6 +72,9 @@ require_relative 'module-cluster/_private_/ModuleCluster/CascadeFeatures.rb'
 require_relative 'module-cluster/_private_/ModuleCluster/ExtendForCascade.rb'
 
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Set.rb'
+require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Set/MultiSetProxy.rb'
+require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Suspend.rb'
+require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Status.rb'
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Includes.rb'
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Extends.rb'
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/PrependsIncludes.rb'
@@ -73,6 +86,10 @@ require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Block/Modu
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack/Block.rb'
 require_relative 'module-cluster/_private_/ModuleCluster/ClusterStack.rb'
 
+require_relative 'module-cluster/ModuleCluster/Suspend/Hooks.rb'
+require_relative 'module-cluster/ModuleCluster/Suspend/WithoutHooks.rb'
+require_relative 'module-cluster/ModuleCluster/Suspend.rb'
+
 require_relative 'module-cluster/ModuleCluster/Define/Block/Class.rb'
 require_relative 'module-cluster/ModuleCluster/Define/Block/Instance.rb'
 require_relative 'module-cluster/ModuleCluster/Define/Block/Module.rb'
@@ -95,6 +112,7 @@ require_relative 'module-cluster/ModuleCluster/Define/ClusterCascadesToModule.rb
 
 require_relative 'module-cluster/ModuleCluster/Define/Deprecated.rb'
 
+require_relative 'module-cluster/ModuleCluster/Define.rb'
 
 require_relative 'module-cluster/ModuleCluster.rb'
 

data/lib/module-cluster/ModuleCluster.rb

@@ -3,12 +3,7 @@ module ModuleCluster
 	
 	extend ModuleCluster::ExtendForCascade
     
-  include ModuleCluster::Define::Block
-  include ModuleCluster::Define::Cluster
-  include ModuleCluster::Define::ClusterCascades
-  include ModuleCluster::Define::ClusterCascadesToClass
-  include ModuleCluster::Define::ClusterCascadesToModule
-
-  include ModuleCluster::Define::Deprecated
+  include Define
+  include Suspend
 
 end

data/lib/module-cluster/ModuleCluster/Define/Block.rb

@@ -1,9 +1,9 @@
 
 module ModuleCluster::Define::Block
   
-  include ModuleCluster::Define::Block::ClassOrModule
-  include ModuleCluster::Define::Block::ClassOrInstance
-  include ModuleCluster::Define::Block::ClassOrModuleOrInstance
-  include ModuleCluster::Define::Block::ModuleOrInstance
+  include ClassOrModule
+  include ClassOrInstance
+  include ClassOrModuleOrInstance
+  include ModuleOrInstance
   
 end

data/lib/module-cluster/ModuleCluster/Define/Block/Class.rb

@@ -2,6 +2,7 @@
 module ModuleCluster::Define::Block::Class
 
   include ModuleCluster::CascadeFeatures::ClusterStack
+  include ModuleCluster::Suspend::WithoutHooks
   
   extend ModuleCluster::ExtendForCascade
   
@@ -18,7 +19,7 @@ module ModuleCluster::Define::Block::Class
   ###################
 
   def class_include( & runtime_block )
-    cluster_stack.class_include( ModuleCluster::Define::Block::Class, runtime_block )
+    return cluster_stack.class_include( ModuleCluster::Define::Block::Class, runtime_block )
   end
 
   ##################
@@ -26,7 +27,7 @@ module ModuleCluster::Define::Block::Class
   ##################
 
   def class_extend( & runtime_block )
-    cluster_stack.class_extend( ModuleCluster::Define::Block::Class, runtime_block )
+    return cluster_stack.class_extend( ModuleCluster::Define::Block::Class, runtime_block )
   end
 
   #############################
@@ -34,8 +35,9 @@ module ModuleCluster::Define::Block::Class
   #############################
 
   def class_include_or_extend( & runtime_block )
-    class_include( & runtime_block )
-    class_extend( & runtime_block )
+    include_set = class_include( & runtime_block )
+    extend_set = class_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( include_set, extend_set )
   end
 
   ###########################
@@ -43,7 +45,7 @@ module ModuleCluster::Define::Block::Class
   ###########################
 
   def prepend_class_include( & runtime_block )
-    cluster_stack.prepend_class_include( ModuleCluster::Define::Block::Class, runtime_block )
+    return cluster_stack.prepend_class_include( ModuleCluster::Define::Block::Class, runtime_block )
   end
 
   ##########################
@@ -51,7 +53,7 @@ module ModuleCluster::Define::Block::Class
   ##########################
 
   def prepend_class_extend( & runtime_block )
-    cluster_stack.prepend_class_extend( ModuleCluster::Define::Block::Class, runtime_block )
+    return cluster_stack.prepend_class_extend( ModuleCluster::Define::Block::Class, runtime_block )
   end
 
   #####################################
@@ -59,8 +61,9 @@ module ModuleCluster::Define::Block::Class
   #####################################
 
   def prepend_class_include_or_extend( & runtime_block )
-    prepend_class_include( & runtime_block )
-    prepend_class_extend( & runtime_block )
+    include_set = prepend_class_include( & runtime_block )
+    extend_set = prepend_class_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( include_set, extend_set )
   end
 	
 end

data/lib/module-cluster/ModuleCluster/Define/Block/ClassOrInstance.rb

@@ -3,6 +3,7 @@ module ModuleCluster::Define::Block::ClassOrInstance
   
   include ModuleCluster::Define::Block::Class
   include ModuleCluster::Define::Block::Instance
+  include ModuleCluster::Suspend::WithoutHooks
   
   extend ModuleCluster::ExtendForCascade
   
@@ -11,8 +12,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ##############################
 
   def class_or_instance_extend( & runtime_block )
-    class_extend( & runtime_block )
-    instance_extend( & runtime_block )
+    class_set = class_extend( & runtime_block )
+    instance_set = instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
   ######################################
@@ -20,8 +22,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ######################################
 
   def class_include_or_instance_extend( & runtime_block )
-    class_include( & runtime_block )
-    instance_extend( & runtime_block )
+    class_set = class_include( & runtime_block )
+    instance_set = instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
   ################################################
@@ -29,8 +32,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ################################################
 
   def class_include_or_extend_or_instance_extend( & runtime_block )
-    class_include_or_extend( & runtime_block )
-    instance_extend( & runtime_block )
+    class_set = class_include_or_extend( & runtime_block )
+    instance_set = instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
   ######################################
@@ -38,8 +42,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ######################################
 
   def prepend_class_or_instance_extend( & runtime_block )
-    prepend_class_extend( & runtime_block )
-    prepend_instance_extend( & runtime_block )
+    class_set = prepend_class_extend( & runtime_block )
+    instance_set = prepend_instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
   ##############################################
@@ -47,8 +52,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ##############################################
 
   def prepend_class_include_or_instance_extend( & runtime_block )
-    prepend_class_include( & runtime_block )
-    prepend_instance_extend( & runtime_block )
+    class_set = prepend_class_include( & runtime_block )
+    instance_set = prepend_instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
   ########################################################
@@ -56,8 +62,9 @@ module ModuleCluster::Define::Block::ClassOrInstance
   ########################################################
 
   def prepend_class_include_or_extend_or_instance_extend( & runtime_block )
-    prepend_class_include_or_extend( & runtime_block )
-    prepend_instance_extend( & runtime_block )
+    class_set = prepend_class_include_or_extend( & runtime_block )
+    instance_set = prepend_instance_extend( & runtime_block )
+    return ModuleCluster::ClusterStack::Set::MultiSetProxy.new( class_set, instance_set )
   end
 
 end