anchor 0.0.4 → 0.1.1

data/README.rdoc

@@ -3,9 +3,11 @@
 I love the concepts of AOP, but I did not like different too bloated libraries, 
 so I made my own.
 
-Anchor contains 91 lines of code and supports *before*, *after* and *around*.
+Anchor contains 91 lines of code and supports *before*, *after* and *around* with its own DSL or adding methods to object.
  
-See example: https://github.com/tione/anchor/tree/master/lib/anchor/support/rails.rb
+See examples:
+* https://github.com/tione/anchor/tree/master/lib/anchor/support/rails.rb
+
 
 
 == Installation
@@ -20,67 +22,43 @@ Or run:
   gem install anchor
 
 
-== Naming recommendations
-
-You can name things as you want, but it is recommended to it so:
-
-=== Example: Using *anchor* for *models* in Rails app 
-
-
-Create app/anchors/your_model_anchor.rb (For autoload file's postfix has to be "_anchor.rb")
-  anchor YourModel do
-    before :save do
-      puts "Before save #{self.inspect}"
-    end
-  end
-
-
-=== Example: Using *anchor* in *models*
-
-You can also do in app/models/your_model.rb
-
-  class YourModel
-    include Anchor::Hooks
-
-    before :save do
-      puts "Before save #{self.inspect}"
-    end
-
-  end
-
 
 
 == Usage examples
 
 === Instance, singleton, class, object
-
-  class Example
-    def self.class_method
-      "CLASS_METHOD"
+ 
+  anchor Array do
+    before singleton :[] do |*args|
+      puts "About to create an Array containing #{args}"
     end
-    def instance_method
-      "INSTANCE_METHOD"
+    after :push do |*args|
+      puts "Just pushed #{args} into Array #{self}"
     end
   end
   
-  anchor Example do
-    before singleton :class_method do
-      puts "before class_method"
-    end
-    after :instance_method do
-      puts "after instance_method"
+  @b = Array.new
+  
+  anchor @b do
+    after :push do
+      puts "This is only after @b called"
     end
   end
   
-  @example = Example.new
-  @other   = Example.new
-  
-  anchor @example do
-    before :instance_method do
-      puts "before @example
+  @a = Array[1, 2, 3]           # outputs "About to create an Array containing [1, 2, 3]"
+  @a.push(4, 5, 6)              # outputs "Just pushed [4, 5, 6] into Array Array"
+  @b.push(1, 2, 3)              # outputs "Just pushed [4, 5, 6] into Array Array" and "This is only after @b called"
+
+
+
+=== Getting called method's arguments and block
+
+  anchor Anchor::Hooks do
+    before singleton :included do |*args, &block|
+      puts "Just anchored on #{args[0]} with #{block}"
     end
   end
-  
+  # To understand fully, see also: https://github.com/tione/anchor/blob/master/lib/anchor/hooks.rb#L67
 
 
 === Method regexp
@@ -95,4 +73,41 @@ You can also do in app/models/your_model.rb
 
 * https://github.com/tione/anchor/blob/master/test/test.rb
 
-TODO: add some examples more
+TODO: add some examples more
+
+
+
+
+
+
+
+== How to use recommendations
+
+You can name things as you want, but it is recommended to it so:
+
+=== Example: Using *anchor* for *models* in Rails app 
+
+
+Create app/anchors/your_model_anchor.rb (For autoload in Rails file's postfix has to be "_anchor.rb")
+  anchor YourModel do
+    before :save do
+      puts "Before save #{self.inspect}"
+    end
+  end
+
+
+
+=== Example: Using *anchor* in *models*
+
+You can also do in app/models/your_model.rb
+
+  class YourModel
+    include Anchor::Hooks
+
+    before :save do
+      puts "Before save #{self.inspect}"
+    end
+
+  end
+
+

data/lib/anchor/hooks.rb

@@ -30,11 +30,12 @@ module Anchor
       alias :add_hook :add_hook_for_methods
       
       def add_hook_for_method(type, method, &block)
+        puts "#{self} #{type} #{method} #{block} ----------"
         level, name = case method; when Hash; method.shift; when Symbol; [:instance, method]; end        
         # set hooks on metaclass instance, not self, if method has to be class method or self is a Object
         in_scope = :metaclass if level == :singleton or not self.is_a?(Class) 
         return Anchor.hook(class << self; self; end) do
-          self.send(type, name, &block)
+          self.method(type).call(name, &block)
         end if in_scope == :metaclass        
         # replace orginal method with hooked method          
         instance_exec do
@@ -46,15 +47,15 @@ module Anchor
           
           unless @orginal_methods[name]
             orginal_methods[name] = self.instance_method(name)
-            define_method name do
+            define_method name do |*args, &block|
               ihooks  = hooks[name] # instance hooks
               orginal_method = orginal_methods[name].bind(self)
               # before
-              ihooks[:before].each {|proc| proc.call} if ihooks[:before]
+              ihooks[:before].each {|proc| proc.call(*args, &block) } if ihooks[:before]
               # TODO: around
-              retval=orginal_method.call
+              retval=orginal_method.call(*args, &block)
               # after
-              ihooks[:after].each {|proc| proc.call} if ihooks[:after]
+              ihooks[:after].each {|proc| proc.call(*args, &block) } if ihooks[:after]
               retval
             end
           end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 0
-  - 4
-  version: 0.0.4
+  - 1
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - "Margus P\xC3\xA4rt"