module-cluster 1.4.0 → 1.4.1

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

@@ -9,7 +9,7 @@ module ModuleCluster::CascadeFeatures
 
   def append_features( hooked_instance )
 
-    ModuleCluster::CascadeFeatures.cascade_features( self, hooked_instance, cluster_stack.prepending_include_hooks )
+    ModuleCluster::CascadeFeatures.perform_cascades( self, :prepend_include, hooked_instance, cluster_stack.prepend_include_hooks )
     
     super
     
@@ -23,7 +23,7 @@ module ModuleCluster::CascadeFeatures
 
     super
 
-    ModuleCluster::CascadeFeatures.cascade_features( self, hooked_instance, cluster_stack.include_hooks )
+    ModuleCluster::CascadeFeatures.perform_cascades( self, :include, hooked_instance, cluster_stack.include_hooks )
     
   end
   
@@ -33,7 +33,7 @@ module ModuleCluster::CascadeFeatures
 
   def extend_object( hooked_instance )
 
-    ModuleCluster::CascadeFeatures.cascade_features( self, hooked_instance, cluster_stack.prepending_extend_hooks )
+    ModuleCluster::CascadeFeatures.perform_cascades( self, :prepend_extend, hooked_instance, cluster_stack.prepend_extend_hooks )
     
     super
     
@@ -47,7 +47,7 @@ module ModuleCluster::CascadeFeatures
 
     super
 
-    ModuleCluster::CascadeFeatures.cascade_features( self, hooked_instance, cluster_stack.extend_hooks )
+    ModuleCluster::CascadeFeatures.perform_cascades( self, :extend, hooked_instance, cluster_stack.extend_hooks )
 
   end
   

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

@@ -1,6 +1,6 @@
 
 module ModuleCluster::CascadeFeatures::ClusterStack
-
+  
   #########################
   #  self.cluster_stacks  #
   #########################

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

@@ -2,66 +2,73 @@
 module ModuleCluster::CascadeFeatures::PerformCascades
 
   ######################
-  #  cascade_features  #
+  #  perform_cascades  #
   ######################
   
-  def cascade_features( module_self, hooked_instance, set_stack )
+  def perform_cascades( module_self, action, hooked_instance, set_stack )
     
     # This method is called when a ModuleCluster module is included or extended.
     # It determines what modules should be included/extended and which should cascade.
-    
-    # for each set:
-    set_stack.each do |this_set|
 
-      # Block sets simply run a block at a hook. They do not include or extend returns from the block.
-      # The hooked module will not be extended by ModuleCluster.
-      if this_set.is_a?( ModuleCluster::ClusterStack::Block::Set )
+    unless module_self.hooks_suspended?( action )
+      
+      # for each set:
+      set_stack.each do |this_set|
+        
+        # if this particular set is suspended, skip to the next
+        next if this_set.suspended
+        
+        # Block sets simply run a block at a hook. They do not include or extend returns from the block.
+        # The hooked module will not be extended by ModuleCluster.
+        if this_set.is_a?( ModuleCluster::ClusterStack::Block::Set )
 
-        if this_set.dependency_module.should_run_block?( hooked_instance )
+          if this_set.dependency_module.should_run_block?( hooked_instance )
 
-          case this_set.runtime_block.arity
-            when 0
-              module_self.instance_eval( & this_set.runtime_block )
-            else
-              module_self.instance_exec( hooked_instance, & this_set.runtime_block )
-          end
+            case this_set.runtime_block.arity
+              when 0
+                module_self.instance_eval( & this_set.runtime_block )
+              else
+                module_self.instance_exec( hooked_instance, & this_set.runtime_block )
+            end
 
-        end
+          end
         
-      # Other sets take parameters and an optional block. The optional block returns are included
-      # or extended like the parameters provided.
-      else
+        # Other sets take parameters and an optional block. The optional block returns are included
+        # or extended like the parameters provided.
+        else
         
-        # dependency modules can cause instances to be included/extended and/or cascade
-        should_include = this_set.dependency_module.should_include_or_extend?( hooked_instance )
-        should_cascade = this_set.dependency_module.should_cascade?( hooked_instance )
+          # dependency modules can cause instances to be included/extended and/or cascade
+          should_include = this_set.dependency_module.should_include_or_extend?( hooked_instance )
+          should_cascade = this_set.dependency_module.should_cascade?( hooked_instance )
 
-        # cascade parameter modules as appropriate
-        cascade_modules_into_hooked_instance( module_self, hooked_instance, this_set, this_set.modules ) if should_cascade
+          # cascade parameter modules as appropriate
+          cascade_modules_into_hooked_instance( module_self, hooked_instance, this_set, this_set.modules ) if should_cascade
 
-        # include/extend parameter modules as appropriate
-        include_extend_modules( module_self, hooked_instance, this_set, this_set.modules ) if should_include        
+          # include/extend parameter modules as appropriate
+          include_extend_modules( module_self, hooked_instance, this_set, this_set.modules ) if should_include        
         
-        # process runtime block if present
-        if this_set.runtime_includes_or_extends_block
+          # process runtime block if present
+          if this_set.runtime_includes_or_extends_block
           
-          # if we have a runtime block, run block and collect returns as appropriate
-          if runtime_modules = collect_block_runtime_result_modules( module_self, hooked_instance, this_set )
+            # if we have a runtime block, run block and collect returns as appropriate
+            if runtime_modules = collect_block_runtime_result_modules( module_self, hooked_instance, this_set )
         
-            # cascade return modules if appropriate
-            cascade_modules_into_hooked_instance( module_self, hooked_instance, this_set, runtime_modules ) if should_cascade
+              # cascade return modules if appropriate
+              cascade_modules_into_hooked_instance( module_self, hooked_instance, this_set, runtime_modules ) if should_cascade
           
-            # include/extend return modules if appropriate
-            include_extend_modules( module_self, hooked_instance, this_set, runtime_modules ) if should_include
+              # include/extend return modules if appropriate
+              include_extend_modules( module_self, hooked_instance, this_set, runtime_modules ) if should_include
           
-          end
+            end
           
-        end
+          end
         
-      end
+        end
       
+      end
+    
     end
-            
+       
   end
 
   ############################
@@ -159,15 +166,26 @@ module ModuleCluster::CascadeFeatures::PerformCascades
   
     should_include_or_extend_instance = false
     
-    if module_class_instance_or_all == :all                                                                               or
-       module_class_instance_or_all == :module   && ( into_instance.is_a?( Module ) && ! into_instance.is_a?( Class ) )   or
-       module_class_instance_or_all == :class    && into_instance.is_a?( Class )                                          or
-       module_class_instance_or_all == :instance && ! into_instance.is_a?( Module )
-       
-      should_include_or_extend_instance = true
-    
+    case module_class_instance_or_all
+      when :all, :module_or_class_or_instance, :module_and_class_and_instance, 
+           :module_class_or_instance, :module_class_and_instance, :module_class_instance
+        should_include_or_extend_instance = true
+      when :module_or_class, :module_and_class, :module_class
+        should_include_or_extend_instance = into_instance.is_a?( Module )
+      when :module_or_instance, :module_and_instance, :module_instance
+        should_include_or_extend_instance = ( ! into_instance.is_a?( Module ) or
+                                              ( into_instance.is_a?( Module ) && ! into_instance.is_a?( Class ) ) )
+      when :class_or_instance, :class_and_instance, :class_instance
+        should_include_or_extend_instance = ( into_instance.is_a?( Class ) or
+                                              ! into_instance.is_a?( Module ) )
+      when :module
+        should_include_or_extend_instance = ( into_instance.is_a?( Module ) && ! into_instance.is_a?( Class ) )
+      when :class
+        should_include_or_extend_instance = into_instance.is_a?( Class )
+      when :instance
+        should_include_or_extend_instance = ! into_instance.is_a?( Module )
     end
-    
+
     return should_include_or_extend_instance
     
   end

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

@@ -1,10 +1,12 @@
 
 class ModuleCluster::ClusterStack
 
-  include ModuleCluster::ClusterStack::Block
-  include ModuleCluster::ClusterStack::Includes
-  include ModuleCluster::ClusterStack::Extends
-  include ModuleCluster::ClusterStack::PrependsIncludes
-  include ModuleCluster::ClusterStack::PrependsExtends
+  include Block
+  include Includes
+  include Extends
+  include PrependsIncludes
+  include PrependsExtends
+  include Status
+  include Suspend
   
 end

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

@@ -1,8 +1,8 @@
 
 module ModuleCluster::ClusterStack::Block
   
-  include ModuleCluster::ClusterStack::Block::Class
-  include ModuleCluster::ClusterStack::Block::Module
-  include ModuleCluster::ClusterStack::Block::Instance
+  include Class
+  include Module
+  include Instance
 
 end

data/lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Class.rb

@@ -22,7 +22,7 @@ module ModuleCluster::ClusterStack::Block::Class
   ###########################
 
   def prepend_class_include( dependency_module, runtime_block )
-    prepending_include_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
+    prepend_include_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
   end
 
   ##########################
@@ -30,7 +30,7 @@ module ModuleCluster::ClusterStack::Block::Class
   ##########################
 
   def prepend_class_extend( dependency_module, runtime_block )
-    prepending_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
+    prepend_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
   end
 
 end

data/lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Instance.rb

@@ -14,7 +14,7 @@ module ModuleCluster::ClusterStack::Block::Instance
   #############################
 
   def prepend_instance_extend( dependency_module, runtime_block )
-    prepending_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
+    prepend_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
   end
 
 end

data/lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Module.rb

@@ -22,7 +22,7 @@ module ModuleCluster::ClusterStack::Block::Module
   ############################
 
   def prepend_module_include( dependency_module, runtime_block )
-    prepending_include_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
+    prepend_include_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
   end
 
   ###########################
@@ -30,7 +30,7 @@ module ModuleCluster::ClusterStack::Block::Module
   ###########################
 
   def prepend_module_extend( dependency_module, runtime_block )
-    prepending_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
+    prepend_extend_hooks.push( ModuleCluster::ClusterStack::Block::Set.new( dependency_module, runtime_block ) )
   end
 
 end

data/lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Set.rb

@@ -1,2 +1,5 @@
 
-ModuleCluster::ClusterStack::Block::Set = Struct.new( :dependency_module, :runtime_block )
+ModuleCluster::ClusterStack::Block::Set = Struct.new( :dependency_module, 
+                                                      :runtime_block,
+                                                      :suspended,
+                                                      :name )

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

@@ -6,7 +6,7 @@ module ModuleCluster::ClusterStack::Extends
   ##################
 
   def extend_hooks
-    return @extend_hooks ||= Array.new
+    return @extend_hooks ||= ::ModuleCluster::ClusterStack::Set::MultiSetProxy.new
   end
 
   #####################
@@ -14,7 +14,9 @@ module ModuleCluster::ClusterStack::Extends
   #####################
   
   def extend_includes( module_instance, method, includes, runtime_includes_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include, includes, runtime_includes_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
   
   ####################
@@ -22,7 +24,9 @@ module ModuleCluster::ClusterStack::Extends
   ####################
 
   def extend_extends( module_instance, method, extends, runtime_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :extend, extends, runtime_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   #################################
@@ -30,7 +34,9 @@ module ModuleCluster::ClusterStack::Extends
   #################################
   
   def extend_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   ############################
@@ -38,7 +44,9 @@ module ModuleCluster::ClusterStack::Extends
   ############################
   
   def module_extend_includes( module_instance, method, includes, runtime_includes_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include, includes, runtime_includes_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
   
   ###########################
@@ -46,7 +54,9 @@ module ModuleCluster::ClusterStack::Extends
   ###########################
 
   def module_extend_extends( module_instance, method, extends, runtime_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :extend, extends, runtime_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   ########################################
@@ -54,7 +64,9 @@ module ModuleCluster::ClusterStack::Extends
   ########################################
   
   def module_extend_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   ###########################
@@ -62,7 +74,9 @@ module ModuleCluster::ClusterStack::Extends
   ###########################
   
   def class_extend_includes( module_instance, method, includes, runtime_includes_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include, includes, runtime_includes_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
   
   ##########################
@@ -70,7 +84,9 @@ module ModuleCluster::ClusterStack::Extends
   ##########################
 
   def class_extend_extends( module_instance, method, extends, runtime_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :extend, extends, runtime_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   #######################################
@@ -78,7 +94,9 @@ module ModuleCluster::ClusterStack::Extends
   #######################################
   
   def class_extend_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   ##############################
@@ -86,7 +104,9 @@ module ModuleCluster::ClusterStack::Extends
   ##############################
   
   def instance_extend_includes( module_instance, method, includes, runtime_includes_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :include, includes, runtime_includes_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
   
   #############################
@@ -94,7 +114,9 @@ module ModuleCluster::ClusterStack::Extends
   #############################
 
   def instance_extend_extends( module_instance, method, extends, runtime_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :extend, extends, runtime_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
   end
 
   ##########################################
@@ -102,7 +124,17 @@ module ModuleCluster::ClusterStack::Extends
   ##########################################
   
   def instance_extend_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    extend_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :instance, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    extend_hooks.push( new_set )
+    return new_set
+  end
+  
+  ######################
+  #  has_extend_hook?  #
+  ######################
+  
+  def has_extend_hook?( description )
+    return extend_hooks.hooks_with( description ) || false
   end
   
 end

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

@@ -6,7 +6,7 @@ module ModuleCluster::ClusterStack::Includes
   ###################
 
   def include_hooks
-    return @include_hooks ||= Array.new
+    return @include_hooks ||= ::ModuleCluster::ClusterStack::Set::MultiSetProxy.new
   end
 
   ######################
@@ -14,7 +14,9 @@ module ModuleCluster::ClusterStack::Includes
   ######################
 
   def include_includes( module_instance, method, includes, runtime_includes_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include, includes, runtime_includes_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   #####################
@@ -22,7 +24,9 @@ module ModuleCluster::ClusterStack::Includes
   #####################
   
   def include_extends( module_instance, method, extends, runtime_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :extend, extends, runtime_extends_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   ##################################
@@ -30,7 +34,9 @@ module ModuleCluster::ClusterStack::Includes
   ##################################
   
   def include_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :all, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   #############################
@@ -38,7 +44,9 @@ module ModuleCluster::ClusterStack::Includes
   #############################
 
   def module_include_includes( module_instance, method, includes, runtime_includes_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include, includes, runtime_includes_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   ############################
@@ -46,7 +54,9 @@ module ModuleCluster::ClusterStack::Includes
   ############################
   
   def module_include_extends( module_instance, method, extends, runtime_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :extend, extends, runtime_extends_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   #########################################
@@ -54,7 +64,9 @@ module ModuleCluster::ClusterStack::Includes
   #########################################
   
   def module_include_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :module, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   ############################
@@ -62,7 +74,9 @@ module ModuleCluster::ClusterStack::Includes
   ############################
 
   def class_include_includes( module_instance, method, includes, runtime_includes_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include, includes, runtime_includes_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include, includes, runtime_includes_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   ###########################
@@ -70,7 +84,9 @@ module ModuleCluster::ClusterStack::Includes
   ###########################
   
   def class_include_extends( module_instance, method, extends, runtime_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :extend, extends, runtime_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :extend, extends, runtime_extends_block )
+    include_hooks.push( new_set )
+    return new_set
   end
 
   ########################################
@@ -78,7 +94,17 @@ module ModuleCluster::ClusterStack::Includes
   ########################################
   
   def class_include_includes_and_extends( module_instance, method, includes_and_extends, runtime_includes_and_extends_block )
-    include_hooks.push( ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block ) )
+    new_set = ModuleCluster::ClusterStack::Set.new( module_instance, method, :class, :include_and_extend, includes_and_extends, runtime_includes_and_extends_block )
+    include_hooks.push( new_set )
+    return new_set
+  end
+
+  #######################
+  #  has_include_hook?  #
+  #######################
+  
+  def has_include_hook?( description )
+    return include_hooks.hooks_with( description ) || false
   end
 
 end