implicitly 0.0.1

data/README.rdoc

@@ -0,0 +1,50 @@
+= Synopsis
+
+Implicits in Ruby, based on Scala. Works like:
+
+    implicitly.from(BaseClass).to(WrapperClass).via do |base_object|
+      WrapperClass.new(base_object)
+    end
+
+= Example
+
+For example, to extend Fixnum with #seconds, #minutes, and #hours:
+
+    class FixnumWithTime
+      def initialize(n)
+        @n = n
+      end
+    
+      def minutes
+        seconds * 60
+      end
+    
+      def hours
+        minutes * 60
+      end
+    
+      def seconds
+        @n
+      end
+    end
+
+    class Person
+      implicitly.from(Fixnum).to(FixnumWithTime).via do |fixnum|
+        FixnumWithTime.new(fixnum)
+      end
+
+      def age_in_seconds
+        37.minutes
+      end
+    end
+
+= Why
+
+By using a wrapping class the extension can be tested independently of the base
+class.
+
+= Author
+
+Mike Burns
+mburns@thoughtbot.com
+http://mike-burns.com/

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/test*.rb']
+end
+
+desc "Run tests"
+task :default => :test

data/lib/implicitly.rb

@@ -0,0 +1,54 @@
+class Module
+  # Set up the implicit handling. Use the #from #to and #via methods to specify
+  # the full transformation. For example:
+  #
+  #    implicit.from(Fixnum).to(FixnumWithTime).via {|number| FixnumWithTime.new(number) }
+  #
+  # Nothing takes effect until all three (#from #to and #via) are set.
+  #
+  # The above implicit will transform a Fixnum instance into a FixnumWithTime
+  # wrapper, but only when you call a public instance method which is defined
+  # in FixnumWithTime.
+  def implicitly
+    Implicit.new
+  end
+end
+
+class Implicit
+  # Set the base of the implicit wrapping. This should be an existing class.
+  def from(starting_class)
+    @starting_class = starting_class
+    try_to_do_everything
+    self
+  end
+
+  # Set the wrapper class. This class must have a constructor which takes one
+  # argument, which is an instance of the base class.
+  def to(ending_class)
+    @ending_class = ending_class
+    try_to_do_everything
+    self
+  end
+
+  # Set the transformer. This is a Proc which takes an instance of the base
+  # class and produces an instance of the wrapper class.
+  def via(&transformer)
+    @transformer = transformer
+    try_to_do_everything
+    self
+  end
+
+  def try_to_do_everything
+    if !@starting_class.nil? && !@ending_class.nil? && !@transformer.nil?
+      transformer = @transformer
+      (@ending_class.instance_methods - Object.instance_methods).each do |meth_name|
+        @starting_class.class_eval do
+          define_method(meth_name) do |*args|
+            transformer.call(self).send(meth_name,*args)
+          end
+        end
+      end
+    end
+  end
+  private :try_to_do_everything
+end

data/test/test_implicitly.rb

@@ -0,0 +1,43 @@
+require 'test/unit'
+require 'implicitly'
+
+class FixnumWithTime
+  def initialize(n)
+    @n = n
+  end
+
+  def minutes
+    seconds * 60
+  end
+
+  def hours
+    minutes * 60
+  end
+
+  def seconds
+    @n
+  end
+end
+
+class ImplicitlyTest < Test::Unit::TestCase
+  implicitly.from(Fixnum).to(FixnumWithTime).via {|n| FixnumWithTime.new(n) }
+
+  def test_fixnum_with_time
+    assert_equal 120, 2.minutes
+    assert_equal 7200, 2.hours
+    assert_equal 2, 2.seconds
+  end
+
+  def test_fixnum_with_time_delegation
+    assert !2.minutes.zero?
+  end
+end
+
+# TODO:
+#class UnimplicitlyTest < Test::Unit::TestCase
+#  def test_fixnum_sans_time
+#    assert_raise(NoMethodError) do
+#      2.minutes
+#    end
+#  end
+#end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: implicitly
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mike Burns
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-24 00:00:00 Z
+dependencies: []
+
+description: A port of Scala's implicits, this is an alternative to open classes that allows for easier testing.
+email: mburns@thoughtbot.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- Rakefile
+- lib/implicitly.rb
+- test/test_implicitly.rb
+homepage: http://rubygems.org/gems/implicitly
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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.7.2
+signing_key: 
+specification_version: 3
+summary: Wrap class instances implicitly
+test_files: 
+- test/test_implicitly.rb