module-cluster 1.4.8 → 2.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: module-cluster
 version: !ruby/object:Gem::Version
-  version: 1.4.8
+  version: 2.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,108 +9,36 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-12 00:00:00.000000000 Z
+date: 2012-07-05 00:00:00.000000000 Z
 dependencies: []
-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).'
+description: Provides hooks via :included, :extended, :append_features, :extend_object,
+  :subclass. Define behavior at hooks via simple interface.
 email: asher@ridiculouspower.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/module-cluster/_private_/ModuleCluster/CascadeFeatures/ClusterStack.rb
-- lib/module-cluster/_private_/ModuleCluster/CascadeFeatures/PerformCascades.rb
-- lib/module-cluster/_private_/ModuleCluster/CascadeFeatures/Subclass.rb
-- lib/module-cluster/_private_/ModuleCluster/CascadeFeatures.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Class.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Inherited.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Instance.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Module.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block/Set.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Block.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Extends.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Includes.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/PrependsExtends.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/PrependsIncludes.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Set/MultiSetProxy.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Set.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Status.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack/Suspend.rb
-- lib/module-cluster/_private_/ModuleCluster/ClusterStack.rb
-- lib/module-cluster/_private_/ModuleCluster/ExtendForCascade.rb
-- lib/module-cluster/ModuleCluster/Define/Block/CascadingClass.rb
-- lib/module-cluster/ModuleCluster/Define/Block/CascadingClassOrModule.rb
-- lib/module-cluster/ModuleCluster/Define/Block/CascadingModule.rb
-- lib/module-cluster/ModuleCluster/Define/Block/CascadingModuleOrSubclass.rb
-- lib/module-cluster/ModuleCluster/Define/Block/Class.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ClassOrInstance.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ClassOrModule.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ClassOrModuleOrInstance.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ClassOrModuleOrSubclass.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ClassOrSubclass.rb
-- lib/module-cluster/ModuleCluster/Define/Block/Instance.rb
-- lib/module-cluster/ModuleCluster/Define/Block/Module.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ModuleOrInstance.rb
-- lib/module-cluster/ModuleCluster/Define/Block/ModuleOrSubclass.rb
-- lib/module-cluster/ModuleCluster/Define/Block/Subclass.rb
-- lib/module-cluster/ModuleCluster/Define/Block.rb
-- lib/module-cluster/ModuleCluster/Define/ClassCluster.rb
-- lib/module-cluster/ModuleCluster/Define/ClassOrInstanceCluster.rb
-- lib/module-cluster/ModuleCluster/Define/Cluster.rb
-- lib/module-cluster/ModuleCluster/Define/ClusterCascades.rb
-- lib/module-cluster/ModuleCluster/Define/ClusterCascadesToClass.rb
-- lib/module-cluster/ModuleCluster/Define/ClusterCascadesToModule.rb
-- lib/module-cluster/ModuleCluster/Define/Deprecated.rb
-- lib/module-cluster/ModuleCluster/Define/InstanceCluster.rb
-- lib/module-cluster/ModuleCluster/Define/ModuleCluster.rb
-- lib/module-cluster/ModuleCluster/Define/ModuleOrClassCluster.rb
-- lib/module-cluster/ModuleCluster/Define/ModuleOrInstanceCluster.rb
-- lib/module-cluster/ModuleCluster/Define/Status.rb
-- lib/module-cluster/ModuleCluster/Define.rb
-- lib/module-cluster/ModuleCluster/Suspend/Hooks.rb
-- lib/module-cluster/ModuleCluster/Suspend/WithoutHooks.rb
-- lib/module-cluster/ModuleCluster/Suspend.rb
-- lib/module-cluster/ModuleCluster.rb
+- lib/module/cluster/class_support.rb
+- lib/module/cluster/cluster/cluster_interface.rb
+- lib/module/cluster/cluster.rb
+- lib/module/cluster/exception/module_not_in_stack.rb
+- lib/module/cluster/instance_controller/hook_controller/chain_proxy.rb
+- lib/module/cluster/instance_controller/hook_controller/hook_controller_interface.rb
+- lib/module/cluster/instance_controller/hook_controller.rb
+- lib/module/cluster/instance_controller/instance_controller_interface.rb
+- lib/module/cluster/instance_controller/multiple_hook_controller_proxy/chain_proxy.rb
+- lib/module/cluster/instance_controller/multiple_hook_controller_proxy.rb
+- lib/module/cluster/instance_controller.rb
+- lib/module/cluster/module_support.rb
+- lib/module/cluster.rb
+- lib/module/namespaces.rb
+- lib/module/requires.rb
 - lib/module-cluster.rb
-- spec/_private_/ModuleCluster/CascadeFeatures/PerformCascades_spec.rb
-- spec/_private_/ModuleCluster/ClusterStack/Set/MultiSetProxy_spec.rb
-- spec/_private_/ModuleCluster/ClusterStack/Suspend_spec.rb
-- spec/ModuleCluster/Define/Block/CascadingClass_spec.rb
-- spec/ModuleCluster/Define/Block/CascadingClassOrModule_spec.rb
-- spec/ModuleCluster/Define/Block/CascadingModule_spec.rb
-- spec/ModuleCluster/Define/Block/CascadingModuleOrSubclass_spec.rb
-- spec/ModuleCluster/Define/Block/Class_spec.rb
-- spec/ModuleCluster/Define/Block/ClassOrInstance_spec.rb
-- spec/ModuleCluster/Define/Block/ClassOrModule_spec.rb
-- spec/ModuleCluster/Define/Block/ClassOrModuleOrInstance_spec.rb
-- spec/ModuleCluster/Define/Block/ClassOrModuleOrSubclass_spec.rb
-- spec/ModuleCluster/Define/Block/ClassOrSubclass_spec.rb
-- spec/ModuleCluster/Define/Block/Instance_spec.rb
-- spec/ModuleCluster/Define/Block/Module_spec.rb
-- spec/ModuleCluster/Define/Block/ModuleOrInstance_spec.rb
-- spec/ModuleCluster/Define/Block/ModuleOrSubclass_spec.rb
-- spec/ModuleCluster/Define/Block/Subclass_spec.rb
-- spec/ModuleCluster/Define/Block_spec.rb
-- spec/ModuleCluster/Define/ClassCluster_spec.rb
-- spec/ModuleCluster/Define/ClassOrInstanceCluster_spec.rb
-- spec/ModuleCluster/Define/Cluster_spec.rb
-- spec/ModuleCluster/Define/ClusterCascades_spec.rb
-- spec/ModuleCluster/Define/ClusterCascadesToClass_spec.rb
-- spec/ModuleCluster/Define/ClusterCascadesToModule_spec.rb
-- spec/ModuleCluster/Define/InstanceCluster_spec.rb
-- spec/ModuleCluster/Define/ModuleCluster_spec.rb
-- spec/ModuleCluster/Define/ModuleOrClassCluster_spec.rb
-- spec/ModuleCluster/Define/ModuleOrInstanceCluster_spec.rb
-- spec/ModuleCluster/Suspend/Hooks_spec.rb
-- spec/ModuleCluster/Suspend/WithoutHooks_spec.rb
-- spec/ModuleCluster_spec.rb
+- spec/module/cluster/cluster_spec.rb
+- spec/module/cluster/instance_controller/hook_controller_spec.rb
+- spec/module/cluster/instance_controller/multiple_hook_controller_proxy_spec.rb
+- spec/module/cluster_spec.rb
 - README.md
-- README.rdoc
 homepage: http://rubygems.org/gems/module-cluster
 licenses: []
 post_install_message: 
@@ -131,9 +59,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: module-cluster
-rubygems_version: 1.8.11
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: ! 'Adds methods for defining module clusters using #included, #extended,
-  #append_features, and #extend_object.'
+summary: Provides an interface for event hooks at any point during module include/extend
+  or class subclassing.
 test_files: []
+has_rdoc: 

data/README.rdoc

@@ -1,395 +0,0 @@
-== Module Cluster
-
-http://rubygems.org/gems/module-cluster
-
-== Description
-
-Adds methods for defining module clusters using #included, #extended, #append_features, and #extend_object.
-
-== Summary
-
-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). 
-
-== Install
-
-* sudo gem install module-cluster
-
-== Usage
-
-Simply:
-
-module SomeModule
-  extend ::ModuleCluster
-end
-
-Definition methods accept modules as arguments. 
-
-For example:
-
-module SomeModule
-  extend ::ModuleCluster
-  include_also_includes( SomeOtherModule )
-end
-
-Additionally, all methods accept a block that returns one or more modules; the modules will be added *after* any modules specified in the parameters:
-
-module SomeModule
-  extend ::ModuleCluster
-  include_also_includes( SomeOtherModule ) do
-    AnotherModule
-  end
-end
-
-Blocks can be used to return dynamically-determined modules at runtime.
-
-module SomeModule
-  extend ::ModuleCluster
-  include_or_extend_cascades_prepend_extends do
-    method_that_returns_one_or_more_modules
-  end
-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_prepend_extends do
-    method_that_returns_one_or_more_modules
-  end
-end
-
-Calls to the various functions are cumulative and stack in the order called. This permits multiple calls, whether subsequently or otherwise.
-
-== Methods
-
-Cluster methods:
-
-* include_also_includes
-* include_also_extends
-* include_also_includes_and_extends
-* extend_also_includes
-* extend_also_extends
-* extend_also_includes_and_extends
-* include_prepends_includes
-* include_prepends_extends
-* include_prepends_includes_and_extends
-* extend_prepends_includes
-* extend_prepends_extends
-* extend_prepends_includes_and_extends
-* include_or_extend_also_includes
-* include_or_extend_also_extends
-* include_or_extend_also_includes_and_extends
-* include_or_extend_prepends_includes
-* include_or_extend_prepends_extends
-* include_or_extend_prepends_includes_and_extends
-
-Module cluster methods:
-
-* module_include_also_includes
-* module_include_also_extends
-* module_include_also_includes_and_extends
-* module_extend_also_includes
-* module_extend_also_extends
-* module_extend_also_includes_and_extends
-* module_include_prepends_includes
-* module_include_prepends_extends
-* module_include_prepends_includes_and_extends
-* module_extend_prepends_includes
-* module_extend_prepends_extends
-* module_extend_prepends_includes_and_extends
-* module_include_or_extend_also_includes
-* module_include_or_extend_also_extends
-* module_include_or_extend_also_includes_and_extends
-* module_include_or_extend_prepends_includes
-* module_include_or_extend_prepends_extends
-* module_include_or_extend_prepends_includes_and_extends
-
-Class cluster methods:
-
-* class_include_also_includes
-* class_include_also_extends
-* class_include_also_includes_and_extends
-* class_extend_also_includes
-* class_extend_also_extends
-* class_extend_also_includes_and_extends
-* class_include_prepends_includes
-* class_include_prepends_extends
-* class_include_prepends_includes_and_extends
-* class_extend_prepends_includes
-* class_extend_prepends_extends
-* class_extend_prepends_includes_and_extends
-* class_include_or_extend_also_includes
-* class_include_or_extend_also_extends
-* class_include_or_extend_also_includes_and_extends
-* class_include_or_extend_prepends_includes
-* class_include_or_extend_prepends_extends
-* class_include_or_extend_prepends_includes_and_extends
-
-Instance cluster methods:
-
-* instance_extend_also_extends
-* instance_extend_prepends_extends
-
-Module or instance cluster methods:
-
-* module_include_or_extend_or_instance_extend_also_includes_or_extends
-* module_include_or_extend_or_instance_extend_also_extends
-* module_include_or_instance_extend_also_includes_or_extends
-* module_include_or_instance_extend_also_extends
-* module_or_instance_extend_also_extends
-* module_include_or_extend_or_instance_extend_prepends_includes_or_extends
-* module_include_or_instance_extend_prepends_includes_or_extends
-* module_include_or_extend_or_instance_extend_prepends_extends
-* module_include_or_instance_extend_prepends_extends
-* module_or_instance_extend_prepends_extends
-
-Class or module cluster methods:
-
-* module_or_class_include_also_includes
-* module_or_class_include_also_extends
-* module_or_class_include_also_includes_and_extends
-* module_or_class_extend_also_includes
-* module_or_class_extend_also_extends
-* module_or_class_extend_also_includes_and_extends
-* module_or_class_include_prepends_includes
-* module_or_class_include_prepends_extends
-* module_or_class_include_prepends_includes_and_extends
-* module_or_class_extend_prepends_includes
-* module_or_class_extend_prepends_extends
-* module_or_class_extend_prepends_includes_and_extends
-* module_or_class_include_or_extend_also_includes
-* module_or_class_include_or_extend_also_extends
-* module_or_class_include_or_extend_also_includes_and_extends
-* module_or_class_include_or_extend_prepends_includes
-* module_or_class_include_or_extend_prepends_extends
-* module_or_class_include_or_extend_prepends_includes_and_extends
-
-Class or module or instance cluster methods:
-
-* module_include_or_extend_or_instance_extend_also_includes_or_extends
-* module_include_or_extend_or_instance_extend_also_extends
-* module_include_or_instance_extend_also_includes_or_extends
-* module_include_or_instance_extend_also_extends
-* module_or_instance_extend_also_extends
-* module_include_or_extend_or_instance_extend_prepends_includes_or_extends
-* module_include_or_instance_extend_prepends_includes_or_extends
-* module_include_or_extend_or_instance_extend_prepends_extends
-* module_include_or_instance_extend_prepends_extends
-* module_or_instance_extend_prepends_extends
-
-Class or instance cluster methods:
-
-* class_include_or_extend_or_instance_extend_also_includes_or_extends
-* class_include_or_extend_or_instance_extend_also_extends
-* class_include_or_instance_extend_also_includes_or_extends
-* class_include_or_instance_extend_also_extends
-* class_or_instance_extend_also_extends
-* class_include_or_extend_or_instance_extend_prepends_includes_or_extends
-* class_include_or_instance_extend_prepends_includes_or_extends
-* class_include_or_extend_or_instance_extend_prepends_extends
-* class_include_or_instance_extend_prepends_extends
-* class_or_instance_extend_prepends_extends
-
-Cascade methods (cascades to modules and classes):
-
-* include_cascades_includes
-* include_cascades_extends
-* include_cascades_includes_and_extends
-* extend_cascades_includes
-* extend_cascades_extends
-* extend_cascades_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_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):
-
-* include_cascades_includes_to_class
-* include_cascades_extends_to_class
-* include_cascades_includes_and_extends_to_class
-* extend_cascades_includes_to_class
-* extend_cascades_extends_to_class
-* extend_cascades_includes_and_extends_to_class
-* 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_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):
-
-* include_cascades_includes_to_module
-* include_cascades_extends_to_module
-* include_cascades_includes_and_extends_to_module
-* extend_cascades_includes_to_module
-* extend_cascades_extends_to_module
-* extend_cascades_includes_and_extends_to_module
-* 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_prepend_includes
-* include_or_extend_cascades_to_module_prepend_extends
-* include_or_extend_cascades_to_module_prepend_includes_and_extends
-
-Module block methods:
-
-* module_include
-* module_extend
-* module_include_or_extend
-* prepend_module_include
-* prepend_module_extend
-* prepend_module_include_or_extend
-
-* cascading_module_include
-* cascading_module_extend
-* cascading_module_include_or_extend
-* cascading_prepend_module_include
-* cascading_prepend_module_extend
-* cascading_prepend_module_include_or_extend
-
-Class block methods:
-
-* class_include
-* class_extend
-* class_include_or_extend
-* prepend_class_include
-* prepend_class_extend
-* prepend_class_include_or_extend
-
-* cascading_class_include
-* cascading_class_extend
-* cascading_class_include_or_extend
-* cascading_prepend_class_include
-* cascading_prepend_class_extend
-* cascading_prepend_class_include_or_extend
-
-Instance block methods:
-
-* instance_extend
-* prepend_instance_extend
-
-Class or module block methods:
-
-* class_or_module_include
-* class_or_module_extend
-* class_or_module_include_or_extend
-* prepend_class_or_module_include
-* prepend_class_or_module_extend
-* prepend_class_or_module_include_or_extend
-
-* cascading_class_or_module_include
-* cascading_class_or_module_extend
-* cascading_class_or_module_include_or_extend
-* cascading_prepend_class_or_module_include
-* cascading_prepend_class_or_module_extend
-* cascading_prepend_class_or_module_include_or_extend
-
-Module or instance block methods:
-
-* module_or_instance_extend
-* module_include_or_instance_extend
-* module_include_or_extend_or_instance_extend
-* prepend_module_or_instance_extend
-* prepend_module_include_or_instance_extend
-* prepend_module_include_or_extend_or_instance_extend
-
-Class or instance block methods:
-
-* class_or_instance_extend
-* class_include_or_instance_extend
-* class_include_or_extend_or_instance_extend
-* prepend_class_or_instance_extend
-* prepend_class_include_or_instance_extend
-* prepend_class_include_or_extend_or_instance_extend
-
-Class or module or instance block methods:
-
-* class_or_module_or_instance_extend
-* class_or_module_include_or_instance_extend
-* class_or_module_include_or_extend_or_instance_extend
-* prepend_class_or_module_or_instance_extend
-* 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)
-
-  Copyright (c) 2011 Asher
-
-  Permission is hereby granted, free of charge, to any person obtaining
-  a copy of this software and associated documentation files (the
-  'Software'), to deal in the Software without restriction, including
-  without limitation the rights to use, copy, modify, merge, publish,
-  distribute, sublicense, and/or sell copies of the Software, and to
-  permit persons to whom the Software is furnished to do so, subject to
-  the following conditions:
-
-  The above copyright notice and this permission notice shall be
-  included in all copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.