anchor 0.0.1

data/README.rdoc

@@ -0,0 +1,76 @@
+== Purpose
+
+Alternative for AOP libaries providing simple syntax and containing less than 100 rows of code.
+
+Containing only:
+* before
+* after
+* around
+
+
+== Installation
+
+Add to your Gemfile:
+  gem 'anchor'
+
+And run:
+  bundle install
+
+
+
+== Naming recommendations
+
+You can name things as you want, but it is recommended to it so:
+
+=== Example A
+
+Create app/hooks/model_name.rb 
+  hook to: ModelName do
+
+    before :save do |opts|
+      puts opts[:method_name]
+      puts opts[:arguments]
+      puts opts[:proc]
+
+    end
+
+    after :save do |opts|
+      puts opts[:method_name]
+      puts opts[:arguments]
+      puts opts[:proc]
+      puts opts[:return_value]
+
+    end
+
+    around :save do |opts|
+      puts opts[:method_name]
+      puts opts[:arguments]
+      puts opts[:proc]
+
+      # TODO ...
+    end
+
+  end
+
+
+=== Example B
+
+Create app/hooks/model_name/what_for_hook_is_itended.rb
+    ...
+
+
+=== Example C
+
+You can also do in app/models/your_model.rb
+
+  class YourModel
+    extend Anchor::Hooked
+
+    before :save do
+      puts "Saving #{self.inspect}"
+    end
+
+  end
+
+
+

data/lib/anchor.rb

@@ -0,0 +1,2 @@
+require 'hooks/hooked'
+require 'kernel'

data/lib/anchor/hooked.rb

@@ -0,0 +1,74 @@
+
+module Anchor
+  # Something similar to AOP, but much more simplified, providing:
+  # * before
+  # * after
+  # * around
+  module Hooked
+    # Information about hooks is stored in @hooks
+    attr_reader :hooks
+    # Orginal methods are not aliased but stored in @orginal_methods as UnboundMethod
+    attr_reader :orginal_methods
+    
+    def before(*methods, &block)
+      create_hook(:before, *methods, &block)
+    end
+  
+    def after(*methods, &block)
+      create_hook(:after, *methods, &block)    
+    end
+  
+    def around(*methods, &block)
+      create_hook(:around, *methods, &block)
+    end
+    
+    def create_hook(type, *methods, &block)
+      @hooks ||= {}
+      @orginal_methods ||= {}
+      
+      methods.each do |method|
+        method_scope  = :instance
+        method_name   = case method; when Hash; method_scope, name = method.flatten; name; when Symbol; method; end
+        
+        # if hook on static, call new hook on self metaclass
+        return hook({to: class << self; self; end}, &block) if method_scope == :static
+                
+        # register hook
+        @hooks[method_name] ||= {}  
+        @hooks[method_name][type] ||= []
+        @hooks[method_name][type] << block        
+        
+        # store and replace orginal method
+        unless @orginal_methods[method_name]
+          # store orginal
+          @orginal_methods[method_name] = self.instance_method(method_name)
+          
+          # replace orginal to call hooks and orginal          
+          define_method method_name do   
+            hooks             = self.class.methods.include?(:hooks) ? self.class.hooks : class << self; self.hooks; end            
+            orginal_methods   = self.class.methods.include?(:orginal_methods) ? self.class.orginal_methods : class << self; self.orginal_methods; end    
+            # Hooks. Before.
+            before_hooks  = hooks[method_name][:before]
+            before_hooks.each do |proc|
+              proc.call
+            end if before_hooks         
+            # bind method to self and call
+            retval        = orginal_methods[method_name].bind(self).call              
+            # Hooks. After.              
+            after_hooks   = hooks[method_name][:after]
+            after_hooks.each do |proc|
+              proc.call
+            end if after_hooks
+            # return value returned by orginal method
+            retval
+          end
+        end
+
+      
+      end  
+    end 
+    protected :create_hook
+    
+  end
+
+end

data/lib/kernel.rb

@@ -0,0 +1,9 @@
+module Kernel
+  def hook(opts, &block)
+    hook_to = opts[:to]
+    hook_to.module_eval do
+      extend Anchor::Hooked
+      module_eval &block
+    end
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: anchor
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- "Margus P\xC3\xA4rt"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-01 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Inspired from multiple AOP libaries, but its much more simplified.
+email: margus@tione.eu
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- lib/anchor/hooked.rb
+- lib/kernel.rb
+- lib/anchor.rb
+has_rdoc: true
+homepage: https://github.com/tione/anchor
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 9
+      - 2
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Before, after and around method calls.
+test_files: []
+