fast_forward 1.0.0

data/History.txt

@@ -0,0 +1,3 @@
+== 1.0.0 / 2007-05-12
+
+* Initial release

data/README.txt

@@ -0,0 +1,90 @@
+fast_forward
+    http://codefluency.rubyforge.org/fast_forward
+    Bruce Williams
+
+== DESCRIPTION:
+
+fast_forward is a small library designed to do two things:
+* Allow easy delegation of all missing methods to an accessor/instance variable
+* Generate methods on-the-fly after first invocation of a delegated method to 
+  eliminate the need to search the object's ancestors and use method_missing
+  on subsequent invocations
+
+== FEATURES/PROBLEMS:
+  
+== SYNOPSIS:
+
+To forward all missing methods to an object, use the <tt>fast_forward_to</tt> class method, as in this example:
+
+  class Foo
+    def some_foo_method
+      "Hello"
+    end
+  end
+  
+  class Bar
+    fast_forward_to :my_foo
+    attr_reader :my_foo
+    def initialize
+      @my_foo = Foo.new
+    end
+  end
+  
+Now, if I create a <tt>Bar</tt> instance, I can call <tt>Foo#some_foo_method</tt> transparently using <tt>Bar#some_foo_method</tt>:
+
+  bar = Bar.new
+  bar.some_foo_method
+  => "Hello"
+      
+Note I could have also set the forwarding in this example using an instance variable instead of the accessor:
+
+  class Bar
+    fast_forward_to :@my_foo
+    # the initialize, etc
+  end
+  
+... and it would have worked the same.
+
+The cool feature with this setup is the fact that, one you call a method that gets delegated once on an object, a method to do the delegation is added to the object so performance is better in subsequent invocations:
+
+  bar = Bar.new
+  bar.respond_to?(:some_foo_method)
+  => false
+  bar.some_foo_method
+  => "Hello"
+  bar.respond_to?(:some_foo_method)
+  => true
+
+== REQUIREMENTS:
+
+* activesupport (1.4.2 minimum, though previous versions will likely work), installed if you have Rails
+* hoe
+
+== INSTALL:
+
+* sudo gem install
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 Bruce Williams
+
+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/lib/fast_forward.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'active_support'
+
+module FastForwarding
+      
+  def fast_forward_to(object)
+    class_eval <<-METHOD_MISSING_GENERATION
+      def method_missing_with_fast_forwarding(meth, *args, &block)
+        returning #{object}.__send__(meth, *args, &block) do
+          instance_eval <<-DELEGATION_GENERATION
+            class << self
+              delegate :\#{meth}, :to => :#{object}
+            end
+          DELEGATION_GENERATION
+        end
+      end
+    METHOD_MISSING_GENERATION
+    alias_method_chain :method_missing, :fast_forwarding
+  end
+      
+end
+
+class Class
+  include FastForwarding
+end

data/test/test_fast_forward.rb

@@ -0,0 +1,61 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/fast_forward'
+
+class Target
+  def a_method_that_exists
+    :expected_return_value
+  end
+end
+
+class FastForwarded
+  fast_forward_to :target
+  attr_reader :target
+  def initialize
+    @target = Target.new
+  end
+end
+
+class FastForwardUsingInstanceVar
+  fast_forward_to :@target
+  def initialize
+    @target = Target.new
+  end
+end
+  
+
+class NotFastForwarded
+end
+
+class FastForwardTest < Test::Unit::TestCase
+  
+  attr_reader :fast_forwarded
+  def setup
+    @fast_forwarded = FastForwarded.new
+  end
+  
+  def test_calling_a_method_on_a_fast_forwarded_instance_may_be_forwarded_to_target_object
+    assert !fast_forwarded.respond_to?(:a_method_that_exists)
+    assert_equal :expected_return_value, fast_forwarded.a_method_that_exists
+  end
+  
+  def test_calling_a_method_on_a_fast_forwarded_instance_may_be_forwarded_to_target_object_using_instance_var
+    fast_forward_with_instance_var = FastForwardUsingInstanceVar.new
+    assert !fast_forward_with_instance_var.respond_to?(:a_method_that_exists)
+    assert_equal :expected_return_value, fast_forward_with_instance_var.a_method_that_exists
+  end
+  
+  def test_second_call_to_fast_forwarded_method_does_not_use_method_missing
+    assert !fast_forwarded.respond_to?(:a_method_that_exists)
+    fast_forwarded.a_method_that_exists
+    assert fast_forwarded.respond_to?(:a_method_that_exists)
+  end
+  
+  def test_call_to_fast_forwarded_method_does_not_affect_other_instances_of_same_class
+    assert !fast_forwarded.respond_to?(:a_method_that_exists)
+    fast_forwarded.a_method_that_exists
+    assert fast_forwarded.respond_to?(:a_method_that_exists)
+    another_fast_forward = FastForwarded.new
+    assert !another_fast_forward.respond_to?(:a_method_that_exists)
+  end
+  
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: fast_forward
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2007-05-13 00:00:00 -06:00
+summary: Advanced delegation of method missing with dynamic generation of methods to reduce overhead
+require_paths: 
+- lib
+email: bruce@codefluency.com
+homepage: "    http://codefluency.rubyforge.org/fast_forward"
+rubyforge_project: codefluency
+description: "fast_forward is a small library designed to do two things: * Allow easy delegation of all missing methods to an accessor/instance variable * Generate methods on-the-fly after first invocation of a delegated method to  eliminate the need to search the object's ancestors and use method_missing on subsequent invocations"
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Bruce Williams
+files: 
+- History.txt
+- README.txt
+- lib/fast_forward.rb
+- test/test_fast_forward.rb
+test_files: 
+- test/test_fast_forward.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.0
+    version: