proxy_machine 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Túlio Ornelas
+
+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.rdoc

@@ -0,0 +1,47 @@
+== Example usage
+
+=== The awesome way:
+
+  p = proxy_for [1, 2, 3]
+  p.reverse => [3, 2, 1]
+  
+  p = proxy_for [1, 2, 3], :before => {
+    :reverse => lambda {|obj| puts 'before reverse'}
+  }   
+  
+  p.reverse => before reverse
+               [3, 2, 1]
+  
+=== Other ways:
+
+1º - Creates a proxy for the informed object
+
+  p = Proxy.new [1,2,3]
+  p.size => 3
+
+2º - A proxy with a before callback.
+
+  p = Proxy.new [1,2,3], :before => {
+    :size => lambda {|obj| puts "before: #{obj.inspect}"}
+  }
+  
+  p.size => before: [1, 2, 3]
+            3
+                  
+3º - A proxy with a after callback
+
+  p = Proxy.new [1,2,3], :after => {
+    :size => lambda {|obj, result| puts "after: #{obj.inspect}: result => #{result}"}
+  }
+
+  p.size => after: [1, 2, 3]: result => 3
+            3
+                 
+4º - Both
+
+  p = Proxy.new [1,2,3], 
+                :before => {
+                  :size => lambda {|obj| puts "before: #{obj.inspect}"}
+                }, :after => {
+                  :size => lambda {|obj, result| puts "after: #{obj.inspect}: result => #{result}"}
+                }

data/Rakefile

@@ -0,0 +1,15 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "proxy_machine"
+    gemspec.summary = "A cool proxy implementation pattern in ruby"
+    gemspec.description = "A cool proxy implementation pattern in ruby"
+    gemspec.email = "ornelas.tulio@gmail.com"
+    gemspec.homepage = "http://github.com/tulios/proxy_machine"
+    gemspec.authors = ["Túlio Ornelas"]
+    gemspec.test_files = Dir.glob('spec/*_spec.rb')
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/init.rb

@@ -0,0 +1,4 @@
+require 'proxy_machine'
+include ProxyMachine
+
+require 'kernel'

data/lib/kernel.rb

@@ -0,0 +1,8 @@
+require 'proxy_machine'
+module Kernel
+  
+  def proxy_for object, callbacks = nil
+    Proxy.new object, callbacks
+  end
+  
+end

data/lib/proxy_machine/proxy.rb

@@ -0,0 +1,127 @@
+module ProxyMachine
+  
+  class Proxy < BasicObject
+    
+    # Examples:
+    # 1º - Creates a proxy for the informed object
+    #
+    # p = Proxy.new [1,2,3]
+    # p.size => 3
+    #
+    # 2º - A proxy with a before callback.
+    #
+    # p = Proxy.new [1,2,3], :before => {
+    #   :size => lambda {|obj| puts "before: #{obj.inspect}"}
+    # }
+    # p.size => before: [1, 2, 3]
+    #           3
+    #                   
+    # 3º - A proxy with a after callback
+    #
+    # p = Proxy.new [1,2,3], :after => {
+    #   :size => lambda {|obj, result| puts "after: #{obj.inspect}: result => #{result}"}
+    # }
+    # p.size => after: [1, 2, 3]: result => 3
+    #           3
+    #                  
+    # 4º - Both
+    #
+    # p = Proxy.new [1,2,3], 
+    #               :before => {
+    #                 :size => lambda {|obj| puts "before: #{obj.inspect}"}
+    #               }, :after => {
+    #                 :size => lambda {|obj, result| puts "after: #{obj.inspect}: result => #{result}"}
+    #               }
+    #
+    def initialize object, calls = nil
+      @object = object                    
+      @before = @before_all = @after = @after_all = nil
+      
+      if calls                  
+        @before = calls[:before]
+        @before_all = calls[:before_all]
+        @after = calls[:after]
+        @after_all = calls[:after_all]
+      end
+    end
+                            
+    def method_missing(symbol, *args)        
+      method = symbol.to_s
+      raise NoMethodError.new(method) unless @object.methods.member?(method)
+                                       
+      execute_call(@before_all, symbol)
+      execute_call(@before, symbol)
+
+      result = @object.send(method, *args)
+
+      result_after = execute_call_with_result(@after, symbol, result)
+      result_after_all = execute_call_with_result(@after_all, symbol, result)
+         
+      return result_after_all if result_after_all
+      return result_after if result_after
+      result
+    end
+    
+    def proxied_class?; true end
+    
+    private               
+    def execute_call container, method_symbol
+      if block = get_block(container, method_symbol) and proc?(block)
+        block.call(@object)
+      end
+    end
+                      
+    def execute_call_with_result container, method_symbol, result
+      if block = get_block(container, method_symbol) and proc?(block)
+        block.call(@object, result)
+      end
+    end
+    
+    def get_block container, method_symbol
+      if container
+        return container if container.class == Proc
+        return container[method_symbol]
+      end
+    end
+                
+    def proc? block
+      block and block.class == Proc
+    end
+    
+  end
+  
+end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

data/lib/proxy_machine.rb

@@ -0,0 +1,12 @@
+module ProxyMachine
+  
+  class BasicObject #:nodoc:
+    instance_methods.each { |m| undef_method m unless m =~ /^__|instance_eval/ }
+  end unless defined?(BasicObject)
+  
+end
+                            
+require 'proxy_machine/proxy'
+include ProxyMachine
+
+require 'kernel'

data/proxy_machine.gemspec

@@ -0,0 +1,50 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{proxy_machine}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["T\303\272lio Ornelas"]
+  s.date = %q{2010-10-03}
+  s.description = %q{A cool proxy implementation pattern in ruby}
+  s.email = %q{ornelas.tulio@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/kernel.rb",
+     "lib/proxy_machine.rb",
+     "lib/proxy_machine/proxy.rb",
+     "proxy_machine.gemspec",
+     "spec/proxy_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/tulios/proxy_machine}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A cool proxy implementation pattern in ruby}
+  s.test_files = [
+    "spec/proxy_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/spec/proxy_spec.rb

@@ -0,0 +1,144 @@
+require 'proxy_machine'
+
+describe Proxy do
+                             
+  it 'should create a proxy object from the given one' do
+    array = [1, 2, 3]
+    proxy = Proxy.new array
+    proxy.should_not be_nil
+    proxy.class.should == array.class
+    
+    proxy.reverse.should == array.reverse
+    proxy.proxied_class?.should be_true
+  end
+  
+  context 'for a certain method' do
+  
+    it 'should add a callbefore' do
+      array = [1, 2, 3]
+      proxy = Proxy.new array, :before => {
+        :reverse => lambda {|obj| obj << 50 }
+      }
+      proxy.should_not be_nil                  
+      proxy.reverse.should == [50, 3, 2, 1]
+    end
+  
+    it 'should add a callafter' do
+      array = [1, 2, 3]
+      proxy = Proxy.new array, :after => {
+        :reverse => lambda {|obj, result| result.collect {|e| e*4} }
+      }
+      proxy.should_not be_nil                  
+      proxy.reverse.should == [12, 8, 4]
+    end                                             
+  
+    it 'should add both, callbefore and callafter' do
+      array = [1, 2, 3]
+      proxy = Proxy.new array, 
+      :before => {
+        :reverse => lambda {|obj| obj.map! {|e| e*2} }
+      },
+      :after => {
+        :reverse => lambda {|obj, result| result.collect {|e| e/2} }
+      }
+      proxy.should_not be_nil                  
+      proxy.reverse.should == [3, 2, 1]
+    end
+    
+  end
+  
+  context 'for all methods' do
+    
+    it 'should add a callbefore' do
+      array = [3, 2, 1]
+      proxy = Proxy.new array, :before_all => lambda {|obj| obj.sort!}
+      proxy.should_not be_nil
+      proxy.reverse.should == [3, 2, 1]
+      proxy.max.should == 3
+      proxy.first.should == 1
+      proxy.to_s.should == "123"
+    end
+
+    it 'should add a callafter' do
+      array = [1, 2, 3]
+      
+      proxy = Proxy.new array, :after_all => lambda {|obj, result|
+        return result * 10 if result.class == Fixnum
+        result
+      }
+      
+      proxy.should_not be_nil
+      proxy.reverse.should == [3, 2, 1]
+      proxy.max.should == 30 # 3 * 10
+      proxy.first.should == 10 # 1 * 10
+      proxy.to_s.should == "123"
+    end
+    
+    it 'should add both, callbefore and callafter' do
+      array = [3, 2, 1]
+      proxy = Proxy.new array, 
+      :before_all => lambda {|obj| obj.sort!},
+      :after_all => lambda {|obj, result|
+        return result * 10 if result.class == Fixnum
+        result
+      }
+      proxy.should_not be_nil
+      proxy.reverse.should == [3, 2, 1]
+      proxy.max.should == 30 # 3 * 10
+      proxy.first.should == 10 # 1 * 10
+      proxy.to_s.should == "123"
+    end
+    
+  end
+  
+  context 'for kernel method' do
+    
+    it 'should call proxy' do
+      array = [1, 2, 3]
+      proxy = proxy_for array
+      proxy.should_not be_nil
+      proxy.class.should == array.class
+
+      proxy.reverse.should == array.reverse
+      proxy.proxied_class?.should be_true
+    end
+    
+    it 'should call proxy passing arguments' do
+      array = [1, 2, 3]
+      proxy = proxy_for array, :before => {
+        :reverse => lambda {|obj| obj << 50 }
+      }
+      proxy.should_not be_nil                  
+      proxy.reverse.should == [50, 3, 2, 1]
+    end
+    
+  end
+  
+end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: proxy_machine
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- "T\xC3\xBAlio Ornelas"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-03 00:00:00 -03:00
+default_executable: 
+dependencies: []
+
+description: A cool proxy implementation pattern in ruby
+email: ornelas.tulio@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- lib/kernel.rb
+- lib/proxy_machine.rb
+- lib/proxy_machine/proxy.rb
+- proxy_machine.gemspec
+- spec/proxy_spec.rb
+has_rdoc: true
+homepage: http://github.com/tulios/proxy_machine
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+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 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A cool proxy implementation pattern in ruby
+test_files: 
+- spec/proxy_spec.rb