hook 0.0.2 → 0.1.0

data/lib/hook.rb

@@ -1,32 +1,56 @@
+require 'method_decorators'
+
 module Hook
   def self.included(base)
     base.extend ::Hook::ClassMethods
+    base.extend ::MethodDecorators
+  end
+
+  class HookDecorator < MethodDecorator
+    def call(wrapped, *args, &block)
+      method_name = wrapped.name.to_s
+      receiver = wrapped.receiver
+      owner = wrapped.owner
+
+      run_hooks owner.around_hooks[method_name], receiver
+      run_hooks owner.before_hooks[method_name], receiver
+      return_value = wrapped.call *args, &block
+      run_hooks owner.after_hooks[method_name], receiver
+      run_hooks owner.around_hooks[method_name], receiver
+
+      return_value
+    end
+
+    private
+    def run_hooks(hooks, object)
+      hooks.each {|hook| hook.call object}
+    end
   end
 
   module ClassMethods
-    def hook(method)
-      self.instance_eval <<-HOOKS
-        def before_#{method}(&block)
-          before_hooks["#{method}"] << block
-        end
+    def hook
+      ::Hook::HookDecorator
+    end
 
-        def after_#{method}(&block)
-          after_hooks["#{method}"] << block
-        end
+    def hook_before method, &block 
+      before_hooks[method.to_s] << block
+    end
 
-        def around_#{method}(&block)
-          around_hooks["#{method}"] << block
-        end
+    def hook_after method, &block 
+      after_hooks[method.to_s] << block
+    end
 
-        def remove_#{method}_callbacks!
-          [before_hooks, after_hooks, around_hooks].each do |hooks|
-            hooks["#{method}"] = []
-          end
-        end
-      HOOKS
+    def hook_around method, &block 
+      around_hooks[method.to_s] << block
     end
 
-    def remove_callbacks!
+    def remove_callbacks! method
+      [before_hooks, after_hooks, around_hooks].each do |hooks|
+        hooks[method.to_s] = []
+      end
+    end
+
+    def remove_all_callbacks!
       @before_hooks = nil
       @after_hooks = nil
       @around_hooks = nil
@@ -49,21 +73,4 @@ module Hook
       Hash.new {|h,k| h[k] = []}
     end
   end
-
-  private
-  def with_hooks(method)
-    method = method.to_s
-
-    run_hooks self.class.around_hooks[method]
-    run_hooks self.class.before_hooks[method]
-    yield
-    run_hooks self.class.after_hooks[method]
-    run_hooks self.class.around_hooks[method]
-
-    nil
-  end
-
-  def run_hooks(hooks)
-    hooks.each {|hook| hook.call self}
-  end
 end

data/readme.markdown

@@ -1,5 +1,7 @@
 # Hook
 
+[![Build Status](https://secure.travis-ci.org/moonmaster9000/hook.png)](http://travis-ci.org/moonmaster9000/hook)
+
 A simple API for adding before, after, and around callbacks to methods.
 
 Think of it as `ActiveSupport::Callbacks`Lite.
@@ -17,40 +19,17 @@ Or add it to your Gemfile:
 ## Usage
 
 Imagine you've created a testing framework, and it includes a `Test`
-class with an `execute` method:
-
-```ruby
-class Test
-  #...
-  def execute
-    #...
-  end
-end
-```
+class with an `execute` method.
 
 You'll likely want to offer hooks into the execution lifecycle of your
-tests. First, include `Hook` into your class, then call `hook :execute`:
+tests. First, include `Hook` into your class, then decorate any methods you wish to hook with `+hook`:
 
 ```ruby
 class Test
-  include ::Hook
-  hook :execute
-end
-```
+  include Hook
 
-Next, you'll need to wrap the body of the `execute` method with a call
-to `with_hooks(:execute)`:
-
-```ruby
-class Test
-  include ::Hook
-  hook :execute
-
-  def execute
-    with_hooks :execute do
-      #...
-    end
-  end
+  +hook
+  def execute; end
 end
 ```
 

metadata

@@ -1,100 +1,68 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: hook
-version: !ruby/object:Gem::Version 
-  hash: 27
+version: !ruby/object:Gem::Version
+  version: 0.1.0
   prerelease: 
-  segments: 
-  - 0
-  - 0
-  - 2
-  version: 0.0.2
 platform: ruby
-authors: 
+authors:
 - Matt Parker
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-01-29 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: specdown
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+date: 2012-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: method_decorators
+  requirement: &70329024742560 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: -2344376328
-        segments: 
-        - 0
-        - 4
-        - 0
-        - beta
-        - 1
-        version: 0.4.0.beta.1
-  type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rspec
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *70329024742560
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70329024742120 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id002
+  prerelease: false
+  version_requirements: *70329024742120
 description: 
 email: moonmaster9000@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - lib/hook.rb
 - readme.markdown
-- specdown/readme.specdown
-- specdown/support/env.rb
 homepage: http://github.com/moonmaster9000/hook
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
 summary: A simple, lightweight system for adding lifecycle callbacks to your objects.
-test_files: 
-- specdown/readme.specdown
-- specdown/support/env.rb
+test_files: []

data/specdown/readme.specdown

@@ -1,78 +0,0 @@
-Hook Details
-============================================
-
-
-anyone can hook into the lifecycle of a test
---------------------------------------------
-
-You can create before hooks that execute before a test is executed:
-    
-    before = false
-
-    Test.before_execute do |test|
-      before = true
-    end
-
-    Test.new.execute
-
-    before.should be(true)
-
-You can create after hooks that execute after a test is execute:
-
-    after = false
-
-    Test.after_execute do |test|
-      after = true
-    end
-
-    Test.new.execute
-
-    after.should be(true)
-
-And lastly, you can create around hooks that execute before _and_ after
-a test executes:
-
-    around = nil
-
-    Test.around_execute do |test|
-      if around.nil?
-        around = "before"
-      else
-        around = "after"
-      end
-    end
-
-    Test.new.execute
-
-    around.should == "after"
-
-
-
-remove all before, after, and around execute callbacks
-------------------------------------------------------
-
-    Test.around_hooks["execute"].should_not be_empty
-    Test.before_hooks["execute"].should_not be_empty
-    Test.after_hooks["execute"].should_not be_empty
-
-    Test.remove_execute_callbacks!
-
-    Test.around_hooks["execute"].should be_empty
-    Test.before_hooks["execute"].should be_empty
-    Test.after_hooks["execute"].should be_empty
-
-
-remove all configured callbacks for all hooked methods
-------------------------------------------------------
-
-    Test.around_hooks["execute"].should_not be_empty
-    Test.before_hooks["execute"].should_not be_empty
-    Test.after_hooks["execute"].should_not be_empty
-
-    Test.remove_callbacks!
-
-    Test.around_hooks["execute"].should be_empty
-    Test.before_hooks["execute"].should be_empty
-    Test.after_hooks["execute"].should be_empty
-
-

data/specdown/support/env.rb

@@ -1,3 +0,0 @@
-$LOAD_PATH.unshift './lib'
-
-require 'hook'