rebound 0.0.2

data/History.txt

@@ -0,0 +1,14 @@
+=== 0.0.2 / 2008-07-21
+
+* Added JavaScript-esque ability to show method definition
+  for unbound methods like so:
+  
+    m = Person.instance_method(:hello)
+    puts m.to_s(:ruby)
+
+* Using new to_s abilities to enable the binding of unbound
+  methods that take block arguments.
+
+=== 0.0.1 / 2008-07-20
+
+* Had an idea. Made it a gem.

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.textile
+Rakefile
+rebound.gemspec
+lib/rebound.rb
+spec/rebound_spec.rb
+spec/spec_helper.rb

data/README.textile

@@ -0,0 +1,74 @@
+h1. rebound
+
+By default, instances of UnboundMethod can only be bound to objects that
+are a kind_of? the method's original class. Pretty lame.
+
+rebound allows unbound methods (instances of UnboundMethod class) to be
+bound to objects of any class. It uses the alias_method_chain pattern to
+accomplish this, meaning you also get a bind_without_indifference method
+that retains the original behavior.
+
+"http://github.com/nakajima/rebound":http://github.com/nakajima/rebound
+
+h3. USAGE
+
+<pre>
+class Guy
+  def greet
+    puts "Hello!"
+  end
+end
+
+class Girl
+  # No #greet method here
+end
+
+girl = Girl.new
+
+m = Guy.instance_method(:greet)
+
+m.bind(girl)
+
+girl.greet # => Hello!
+</pre>
+
+h3. TODO:
+
+* Could probably use some more specs, since I'm pretty sure I didn't think
+  of everything.
+
+h3. REQUIREMENTS:
+
+* ParseTree
+* Ruby2Ruby
+
+h3. Credit
+
+I'm just standing on "Ryan Davis'":http://www.zenspider.com shoulders with
+this project. He did all the hard work. I just did something cool with it.
+(Which isn't to say that what he did wasn't cool, since what he did is *way*
+cooler than what you see here.)
+
+Also, "Magnus Holm":http://judofyr.net contributed a patch that made things
+cleaner behind the scenes.
+
+Copyright (c) 2008 Pat Nakajima
+
+  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/Rakefile

@@ -0,0 +1,4 @@
+desc "Run specs"
+task :default do
+  puts `spec spec/ --colour`
+end

data/lib/rebound.rb

@@ -0,0 +1,44 @@
+module Nakajima
+  module Rebound
+    VERSION = '0.0.2'
+  end
+end  
+
+%w(rubygems ruby2ruby).each { |lib| require lib } unless defined?(Ruby2Ruby)
+
+class UnboundMethod
+  # eval's and memoizes the output of Ruby2Ruby's #to_ruby method
+  def to_proc
+    @to_proc ||= eval(to_ruby)
+  end
+  
+  alias_method :to_s_without_ruby, :to_s
+  # This is sort of ugly, but it does allow us to bind methods that
+  # take block arguments (you can't use block arguments with blocks).
+  def to_s_with_ruby(opt=nil)
+    (opt != :ruby) ? to_s_without_ruby : begin
+      @to_s ||= begin
+        res = to_ruby
+        res.gsub!(/\Aproc \{ /, "def #{name}")      # Replace proc definition
+        res.gsub!(/\|([^\|]*)\|\n/, "(#{'\1'})\n")  # Use method param declaration
+        res.gsub!(/\}\z/, 'end')                    # Replace proc end brace
+        res
+      end
+    end
+  end
+  alias_method :to_s, :to_s_with_ruby
+  
+  # Simple string name. Taken from Pat Maddox's with_context
+  def name
+    @name ||= to_s.split("#").last.delete(">")
+  end
+  
+  alias_method :bind_without_indifference, :bind
+  # Allows an unbound method to be bound to any object, instead
+  # of only those of the same class. Goes with original #bind method
+  # first, and if that fails, meta_def's using #to_proc
+  def bind_with_indifference(obj)
+    bind_without_indifference(obj) rescue class << obj; self end.class_eval(to_s(:ruby))
+  end
+  alias_method :bind, :bind_with_indifference
+end

data/rebound.gemspec

@@ -0,0 +1,20 @@
+Gem::Specification.new do |s|
+  s.name = %q{rebound}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Pat Nakajima"]
+  s.date = %q{2008-07-20}
+  s.description = %q{By default, instances of UnboundMethod can only be bound to objects that are a kind_of? the method's original class. Pretty lame.  rebound allows unbound methods (instances of UnboundMethod class) to be bound to objects of any class. It uses the alias_method_chain pattern to accomplish this, meaning you also get a bind_without_indifference method that retains the original behavior.}
+  s.email = ["patnakajima@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.textile"]
+  s.files = ["History.txt", "Manifest.txt", "README.textile", "Rakefile", "lib/rebound.rb", "spec/rebound_spec.rb", "spec/spec_helper.rb", "rebound.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/nakajima/rebound}
+  s.rdoc_options = ["--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{By default, instances of UnboundMethod can only be bound to objects that are a kind_of? the method's original class. This fixes that.}
+  s.test_files = ["spec/rebound_spec.rb"]
+  s.add_dependency('ruby2ruby', [">= 1.1.9"])
+end

data/spec/rebound_spec.rb

@@ -0,0 +1,100 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe UnboundMethod do
+  before(:each) do
+    @a = Class.new { def foo; :bar end }
+    @b = Class.new { def called?; @called end }
+    @mod = Module.new { def call; @called = true; end }
+    @object_a = @a.new
+    @object_b = @b.new
+  end
+  
+  describe "#name" do
+    it "should return name" do
+      m = @a.instance_method(:foo)
+      m.name.should == 'foo'
+    end
+  end
+  
+  describe "#to_s" do
+    it "should provide source" do
+      m = @a.instance_method(:foo)
+      m.to_s(:ruby).should == "def foo()\n  :bar\nend"
+    end
+    
+    it "should be memoized" do
+      m = @a.instance_method(:foo)
+      m.should_receive(:to_ruby).once.and_return(proc { :bar }.to_ruby)
+      2.times { m.to_s(:ruby) }
+    end
+  end
+  
+  describe "#bind" do
+    it "should bind method from Class.instance_method to object of different class" do
+      m = @a.instance_method(:foo)
+      m.bind(@object_b)
+      @object_b.foo.should == :bar
+    end
+
+    it "should bind singleton method to object of different class" do
+      class << @object_a; def greet; :hello end end
+      m = @object_a.method(:greet).unbind
+      m.bind(@object_b)
+      @object_b.greet.should == :hello
+    end
+    
+    it "should bind methods that take an argument" do
+      class << @object_a; def greet(name); "hello #{name}" end end
+      m = @object_a.method(:greet).unbind
+      m.bind(@object_b)
+      @object_b.greet('pat').should == "hello pat"
+    end
+    
+    it "should bind methods that take splat of arguments" do
+      class << @object_a
+        def add_these(container, *args)
+          args.each { |a| container << a }
+        end
+      end
+      m = @object_a.method(:add_these).unbind
+      m.bind(@object_b)
+      collector = []
+      @object_b.add_these(collector, 'pat', 'tim', 'drew')
+      collector.should == ['pat', 'tim', 'drew']
+    end
+    
+    it "should bind methods that take block" do
+      class << @object_a
+        def append(&block)
+          res = [:original]
+          res << yield
+          res
+        end
+      end
+    
+      m = @object_a.method(:append).unbind
+      m.bind(@object_b)
+      @object_b.append { :addition }.should == [:original, :addition]
+    end
+    
+    it "should bind module instance method" do
+      m = @mod.instance_method(:call)
+      m.bind(@object_b)
+      @object_b.call
+      @object_b.should be_called
+    end
+  end
+  
+  describe "#to_proc" do
+    it "should return proc version" do
+      m = @a.instance_method(:foo)
+      m.to_proc.call.should == :bar
+    end
+    
+    it "should be memoized" do
+      m = @a.instance_method(:foo)
+      m.should_receive(:to_ruby).once.and_return(proc { :bar }.to_ruby)
+      2.times { m.to_proc }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require File.join(File.dirname(__FILE__), '..', 'lib', 'rebound')
+require 'rubygems'
+require 'spec'

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: rebound
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Pat Nakajima
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-20 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby2ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.9
+    version: 
+description: By default, instances of UnboundMethod can only be bound to objects that are a kind_of? the method's original class. Pretty lame.  rebound allows unbound methods (instances of UnboundMethod class) to be bound to objects of any class. It uses the alias_method_chain pattern to accomplish this, meaning you also get a bind_without_indifference method that retains the original behavior.
+email: 
+- patnakajima@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.textile
+files: 
+- History.txt
+- Manifest.txt
+- README.textile
+- Rakefile
+- lib/rebound.rb
+- spec/rebound_spec.rb
+- spec/spec_helper.rb
+- rebound.gemspec
+has_rdoc: true
+homepage: http://github.com/nakajima/rebound
+post_install_message: 
+rdoc_options: 
+- --main
+- README.textile
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.0
+signing_key: 
+specification_version: 2
+summary: By default, instances of UnboundMethod can only be bound to objects that are a kind_of? the method's original class. This fixes that.
+test_files: 
+- spec/rebound_spec.rb