uberhook 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Martin Jagusch
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,50 @@
+# Uberhook
+
+The Uberhook gem allows you to define `before` and `after` hooks for your classes and models.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```
+gem 'uberhook'
+```
+
+And then execute:
+
+```
+$ bundle
+```
+
+Or install it yourself as:
+
+```
+$ gem install uberhook
+```
+
+## Usage
+
+``` ruby
+require 'uberhook'
+
+class Car
+  include Uberhook
+
+  before :drive, :start_engine
+
+  def drive
+    puts 'Now lets drive.'
+  end
+
+  def start_engine
+    puts 'First start the engine.'
+  end
+end
+
+beatle = Car.new
+beatle.drive
+
+# Output:
+#   First start the engine.
+#   And now lets drive.
+```

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.warning = true
+  t.verbose = true
+end

data/lib/uberhook.rb

@@ -0,0 +1,81 @@
+# Include the Uberhook module to define 'before' and 'after' hooks
+# for your classes and models.
+#
+#   class Car
+#     include Uberhook
+#
+#     before :drive, :start_engine
+#
+#     def drive
+#       puts 'Now lets drive.'
+#     end
+#
+#     def start_engine
+#       puts 'First start the engine.'
+#     end
+#   end
+#
+#   beatle = Car.new
+#   beatle.drive
+#
+# Output:
+#   First start the engine.
+#   Now lets drive.
+module Uberhook
+  def self.included(base)
+    base.extend ClassMethods
+    base.instance_variable_set :@hooks, {}
+  end
+
+  module ClassMethods
+    def before(target, callback)
+      register_hook :pre, target, callback
+    end
+
+    def after(target, callback)
+      register_hook :post, target, callback
+    end
+
+    def register_hook(type, target, callback)
+      if method_defined? target
+        define_hook(type, target, callback)
+      else
+        add_hook_to_waitinglist(type, target, callback)
+      end
+    end
+
+    private
+
+    def define_hook(type, target, callback)
+      alias_method "#{target}_without_callbacks", target
+      define_method target do
+        send callback
+        send "#{target}_without_callbacks"
+      end
+    end
+
+    def add_hook_to_waitinglist(type, target, callback)
+      @hooks[type] = {} unless @hooks[type].kind_of? Hash
+      callbacks = @hooks[type][target]
+      @hooks[type][target] = (callbacks || []) << callback
+    end
+
+    def remove_hook_from_waitinglist(type, target, callback)
+      @hooks[type][target].delete callback
+    end
+
+    def perform_method_added(name)
+      @hooks.each do |type, hook|
+        next unless hook[name]
+        hook[name].each do |callback|
+          remove_hook_from_waitinglist(type, name, callback)
+          define_hook(type, name, callback)
+        end
+      end
+    end
+
+    def method_added(name)
+      perform_method_added(name)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'test/unit'
+require 'mocha'
+
+require 'uberhook'
+
+class Uberhook::TestCase < Test::Unit::TestCase
+  def self.test(name, &block)
+    define_method("test #{name.inspect}", &block)
+  end
+end

data/test/uberhook_test.rb

@@ -0,0 +1,93 @@
+require 'test_helper'
+
+class UberhookTest < Uberhook::TestCase
+  def setup
+    @car = Class.new do
+      include Uberhook
+      def drive; end
+      def start; end
+      def stop; end
+    end
+  end
+
+  test 'should register :pre hook' do
+    @car.expects(:register_hook).with(:pre, :drive, :start).once
+    @car.class_eval do
+      before :drive, :start
+    end
+  end
+  
+  test 'should register :post hook' do
+    @car.expects(:register_hook).with(:post, :drive, :stop).once
+    @car.class_eval do
+      after :drive, :stop
+    end
+  end
+
+  test 'should save :pre hook temporally when target is not defined' do
+    @car.expects(:add_hook_to_waitinglist).with(:pre, :two, :one).once
+    @car.class_eval do
+      register_hook :pre, :two, :one
+      def one; end
+      def two; end
+    end
+  end
+  
+  test 'should not define :pre hook when target is not defined' do
+    @car.expects(:define_hook).times(0)
+    @car.class_eval do
+      register_hook :pre, :two, :one
+    end
+  end
+  
+  test 'should not define :post hook when target is not defined' do
+    @car.expects(:define_hook).times(0)
+    @car.class_eval do
+      register_hook :post, :one, :two
+    end
+  end
+  
+  test 'should run callback before the hook method' do
+    @car.class_eval do
+      register_hook :pre, :drive, :start
+    end
+    beatle = @car.new
+    # TODO how to test before call
+    beatle.expects(:start).once
+    beatle.drive
+  end
+  
+  test 'should run callback after the hook method' do
+    @car.class_eval do
+      register_hook :post, :drive, :start
+    end
+    beatle = @car.new
+    # TODO how to test after call
+    beatle.expects(:start).once
+    beatle.drive
+  end
+  
+  test 'should run :pre callback when hook method gets defined' do
+    @car.class_eval do
+      register_hook :pre, :two, :one
+      def one; end
+      def two; end
+    end
+    beatle = @car.new
+    # TODO how to test before call
+    beatle.expects(:one).once
+    beatle.two
+  end
+  
+  test 'should run :post callback when hook method gets defined' do
+    @car.class_eval do
+      register_hook :post, :one, :two
+      def one; end
+      def two; end
+    end
+    beatle = @car.new
+    # TODO how to test after call
+    beatle.expects(:two).once
+    beatle.one
+  end
+end

data/uberhook.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |gem|
+  gem.name          = 'uberhook'
+  gem.version       = '0.0.1'
+  gem.authors       = ['Martin Jagusch']
+  gem.email         = ['_@mj.io']
+  gem.description   = 'Allows you to define :before and :after hooks for your classes and models.'
+  gem.summary       = ':before and :after hooks'
+  gem.homepage      = 'https://github.com/mjio/uberhook'
+
+  gem.add_development_dependency 'rake', '~> 0.9.2.2'
+  gem.add_development_dependency 'mocha', '~> 0.12.1'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^test/})
+  gem.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: uberhook
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Martin Jagusch
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.12.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.12.1
+description: Allows you to define :before and :after hooks for your classes and models.
+email:
+- _@mj.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/uberhook.rb
+- test/test_helper.rb
+- test/uberhook_test.rb
+- uberhook.gemspec
+homepage: https://github.com/mjio/uberhook
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: ':before and :after hooks'
+test_files:
+- test/test_helper.rb
+- test/uberhook_test.rb