anchor 0.0.3 → 0.0.4

data/README.rdoc

@@ -1,17 +1,17 @@
 == Purpose
 
-Alternative for AOP libaries providing simple syntax and containing less than 100 rows of code.
+I love the concepts of AOP, but I did not like different too bloated libraries, 
+so I made my own.
 
-Containing only:
-* before
-* after
-* around (Not implemented yet)
+Anchor contains 91 lines of code and supports *before*, *after* and *around*.
+ 
+See example: https://github.com/tione/anchor/tree/master/lib/anchor/support/rails.rb
 
 
 == Installation
 
 Add to your Gemfile:
-  gem 'anchor'
+  gem 'anchor'              # add this row after "gem 'rails'" if rails is used
 
 And run:
   bundle install
@@ -24,25 +24,18 @@ Or run:
 
 You can name things as you want, but it is recommended to it so:
 
-=== Example: Using *hooks* for *models* in Rails app (Not implemented yet)
+=== Example: Using *anchor* for *models* in Rails app 
 
-Create app/hooks/model_name.rb 
-  anchor ModelName do
 
+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 *hooks* for *conserns* in Rails app (Not implemented yet)
-
-Create app/hooks/model_name/what_for_hook_is_itended.rb
-    ...
-
-
-=== Example: Using *hooks* in *models*
+=== Example: Using *anchor* in *models*
 
 You can also do in app/models/your_model.rb
 
@@ -59,9 +52,35 @@ You can also do in app/models/your_model.rb
 
 == Usage examples
 
-=== You can find some examples from:
+=== Instance, singleton, class, object
 
-* https://github.com/tione/anchor/blob/master/test/test.rb
+  class Example
+    def self.class_method
+      "CLASS_METHOD"
+    end
+    def instance_method
+      "INSTANCE_METHOD"
+    end
+  end
+  
+  anchor Example do
+    before singleton :class_method do
+      puts "before class_method"
+    end
+    after :instance_method do
+      puts "after instance_method"
+    end
+  end
+  
+  @example = Example.new
+  @other   = Example.new
+  
+  anchor @example do
+    before :instance_method do
+      puts "before @example
+    end
+  end
+  
 
 
 === Method regexp
@@ -71,3 +90,9 @@ You can also do in app/models/your_model.rb
       puts 
     end
   end
+
+=== You can find some examples from:
+
+* https://github.com/tione/anchor/blob/master/test/test.rb
+
+TODO: add some examples more

data/lib/anchor.rb

@@ -1,3 +1,3 @@
-require 'kernel'
+require 'anchor/support/kernel'
 require 'anchor/hooks'
-
+require 'anchor/support/rails'

data/lib/anchor/hooks.rb

@@ -1,6 +1,6 @@
 # = Anchor
 module Anchor
-  def self.hook(*objs, &block)
+  def self.hook(*objs, &block) # :nodoc:
     objs.each do |obj|
       #puts "Trying to hook: #{obj} #{block.inspect}"
       Hooks.included(obj)
@@ -45,11 +45,16 @@ module Anchor
           orginal_methods = @orginal_methods ||= {}
           
           unless @orginal_methods[name]
-            @orginal_methods[name] = self.instance_method(name)
-            define_method name do 
-              hooks[name][:before].each {|proc| proc.call} if hooks[name][:before]
-              retval = orginal_methods[name].bind(self).call
-              hooks[name][:after].each {|proc| proc.call} if hooks[name][:after]
+            orginal_methods[name] = self.instance_method(name)
+            define_method name do
+              ihooks  = hooks[name] # instance hooks
+              orginal_method = orginal_methods[name].bind(self)
+              # before
+              ihooks[:before].each {|proc| proc.call} if ihooks[:before]
+              # TODO: around
+              retval=orginal_method.call
+              # after
+              ihooks[:after].each {|proc| proc.call} if ihooks[:after]
               retval
             end
           end
@@ -68,5 +73,4 @@ module Anchor
       include Anchor::Hooks::Hooked
     end
   end
-
 end

data/lib/{kernel.rb → anchor/support/kernel.rb}

@@ -2,4 +2,4 @@ module Kernel
   def anchor(*objs, &block)
     Anchor.hook(*objs, &block)
   end
-end
+end

data/lib/anchor/support/rails.rb

@@ -0,0 +1,7 @@
+if defined?(Rails)
+  anchor Rails::Application do
+    after :initialize! do
+      Dir['app/**/*_anchor.rb'].each {|file| require File.expand_path(file) }
+    end
+  end
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 3
-  version: 0.0.3
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - "Margus P\xC3\xA4rt"
@@ -14,11 +14,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-01-03 00:00:00 +02:00
+date: 2012-01-04 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
-description: Inspired from multiple AOP libaries, but its much more simplified.
+description: Before, after and around method calls.
 email: margus@tione.eu
 executables: []
 
@@ -29,7 +29,8 @@ extra_rdoc_files: []
 files: 
 - README.rdoc
 - lib/anchor/hooks.rb
-- lib/kernel.rb
+- lib/anchor/support/rails.rb
+- lib/anchor/support/kernel.rb
 - lib/anchor.rb
 has_rdoc: true
 homepage: https://github.com/tione/anchor
@@ -64,6 +65,6 @@ rubyforge_project:
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Before, after and around method calls.
+summary: Inspired by AOP.
 test_files: []