functor 0.5.1 → 0.6.0

data/test/reopening.rb

@@ -1,18 +1,18 @@
 require "#{File.dirname(__FILE__)}/helpers"
 
-class A
+class Reopening
   include Functor::Method
   functor( :foo, Integer ) { |x| 1 }
 end
 
-class A
+class Reopening
   functor( :foo, Integer ) { |x| 2 }
 end
 
 describe "Functor methods should support reopening" do
 
   specify "by allowing reopening of a class to override an implementation" do
-    A.new.foo( 5 ).should == 2
+    Reopening.new.foo( 5 ).should == 2
   end
 
 end

data/test/supplement.rb

@@ -0,0 +1,20 @@
+require "#{File.dirname(__FILE__)}/helpers"
+
+class Additive
+  include Functor::Method
+  
+  def foo(*args)
+    args.reverse
+  end
+  
+  functor( :foo, Integer ) { |x| 1 }
+end
+
+describe "A Functor method" do
+
+  specify "supplements, rather than obliterating, an existing method" do
+    Additive.new.foo( 5 ).should == 1
+    Additive.new.foo( :a, :b).should == [ :b, :a ]
+  end
+
+end

data/test/wildcard.rb

@@ -0,0 +1,15 @@
+require "#{File.dirname(__FILE__)}/helpers"
+
+class Wildcard
+  include Functor::Method
+  functor( :foo, Integer, _whatever ) { |int, whatever| "#{int}: #{whatever}" }
+end
+
+describe "A functor" do
+  
+  it "can use a method beginning with '_' to match anything" do
+    c = Wildcard.new
+    c.foo( 7, "Smurf").should == "7: Smurf"
+  end
+  
+end

data/test/with_self.rb

@@ -1,21 +1,26 @@
 require "#{File.dirname(__FILE__)}/helpers"
 
-class A
+class WithSelf
   attr_accessor :bar
   include Functor::Method
   def initialize( x ) ; @bar = x ; end
   functor_with_self( :foo, self, Integer ) { |x| x }
   functor_with_self( :foo, lambda{ |x| x.bar == true }, Integer ) { |s| 'bar' }
+  functor_with_self( :foo, lambda{ |x| x.bar.is_a? String }, Integer ) { |s| 'I be string' }
 end
 
 describe "Functor methods should support allow matching on self" do
   
   specify "by allowing functor_with_self to provide a guard on self" do
-    A.new( true ).foo( 5 ).should == 'bar'
+    WithSelf.new( true ).foo( 5 ).should == 'bar'
   end
   
   specify "or by simply providing self as an argument" do
-    A.new( false ).foo( 5 ).should == 5
+    WithSelf.new( false ).foo( 5 ).should == 5
+  end
+  
+  specify "another guard example, for those who need it" do
+    WithSelf.new( "me" ).foo( 87 ).should == "I be string"
   end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: functor
 version: !ruby/object:Gem::Version 
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors: 
 - Dan Yoder
@@ -11,7 +11,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-08 00:00:00 -07:00
+date: 2009-11-21 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -25,38 +25,11 @@ extra_rdoc_files: []
 
 files: 
 - doc/HISTORY
-- doc/rdoc
-- doc/rdoc/classes
-- doc/rdoc/classes/Functor
-- doc/rdoc/classes/Functor/Method.html
-- doc/rdoc/classes/Functor/Method.src
-- doc/rdoc/classes/Functor/Method.src/M000006.html
-- doc/rdoc/classes/Functor.html
-- doc/rdoc/classes/Functor.src
-- doc/rdoc/classes/Functor.src/M000001.html
-- doc/rdoc/classes/Functor.src/M000002.html
-- doc/rdoc/classes/Functor.src/M000003.html
-- doc/rdoc/classes/Functor.src/M000004.html
-- doc/rdoc/classes/Functor.src/M000005.html
-- doc/rdoc/classes/Object.html
-- doc/rdoc/classes/Object.src
-- doc/rdoc/classes/Object.src/M000007.html
-- doc/rdoc/created.rid
-- doc/rdoc/files
-- doc/rdoc/files/doc
-- doc/rdoc/files/doc/HISTORY.html
-- doc/rdoc/files/doc/README.html
-- doc/rdoc/files/lib
-- doc/rdoc/files/lib/functor_rb.html
-- doc/rdoc/files/lib/object_rb.html
-- doc/rdoc/fr_class_index.html
-- doc/rdoc/fr_file_index.html
-- doc/rdoc/fr_method_index.html
-- doc/rdoc/index.html
-- doc/rdoc/rdoc-style.css
-- doc/README
 - lib/functor.rb
-- lib/object.rb
+- metrics/benchmark.rb
+- metrics/helpers.rb
+- metrics/many_args.rb
+- metrics/one_arg.rb
 - test/fib.rb
 - test/functor.rb
 - test/guards.rb
@@ -64,9 +37,13 @@ files:
 - test/inheritance.rb
 - test/matchers.rb
 - test/reopening.rb
+- test/supplement.rb
+- test/wildcard.rb
 - test/with_self.rb
 has_rdoc: true
 homepage: http://dev.zeraweb.com/
+licenses: []
+
 post_install_message: 
 rdoc_options: []
 
@@ -87,9 +64,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: functor
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: Pattern-based dispatch for Ruby, inspired by Topher Cyll's multi.
 test_files: []
 

data/doc/README

@@ -1,71 +0,0 @@
-Functor provides pattern-based function and method dispatch for Ruby, originally inspired by Topher Cyll's multi gem. 
-
-= Method Functors
-
-To use it in a class:
-
-  class Repeater
-    attr_accessor :times
-    include Functor::Method
-    functor( :repeat, Integer ) { |x| x * @times }
-    functor( :repeat, String ) { |s| [].fill( s, 0..@times ).join(' ') }
-  end
-
-  r = Repeater.new
-  r.times = 5
-  r.repeat( 5 )   # => 25
-  r.repeat( "-" ) # => "- - - - -"
-  r.repeat( 7.3 ) # => ArgumentError!
-
-Warning: This defines a class instance variable <tt>@__functors</tt> behind the scenes as a side-effect. Also, although inheritance works within a functor method, super does not. To call the parent method, you need to call it explicitly using the <tt>#functors</tt> class method, like this:
-
-  A.functors[ :foo ].apply( self, 'bar' )
-
-= Stand-Alone Functors
-
-You can also define Functor objects directly:
-
-  fib = Functor.new do
-    given( 0 ) { 0 }
-    given( 1 ) { 1 }
-    given( Integer ) { |n| self.call( n - 1 ) + self.call( n - 2 ) }
-  end
-  
-You can use functors directly with functions taking a block like this:
-
-  [ *0..10 ].map( &fib )  # => [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55]
-  
-You can call a functor as a method using #apply:
-
-  fun.apply( obj, 7 )
-  
-which is actually how the method functors are implemented.
-
-= Pattern Matching
-
-Arguments are matched first using === and then ==, so anything that supports these methods can be matched against. In addition, you may pass "guards," any object that responds to #call and which take and object (the argument) and return true or false. This allows you to do things like this:
-
-  stripe ||= Functor.new do
-    given( lambda { |x| x % 2 == 0 } ) { 'white' }
-    given( lambda { |x| x % 2 == 1 } ) { 'silver' }
-  end
-
-which will return "white" and "silver" alternately for a sequence of numbers.
-
-= Precedence
-
-Precedence is defined in order of declaration: first-come, first-serve, aka FIFO. Thus, you need to be careful in how you define your functor. The Fibonacci example above would not work properly if the Integer pattern was given first. That said, it is possible to redefine earlier cases, which, in effect, "demotes" it, as if it had not been declared before. So the following will work properly:
-
-  fib = Functor.new do
-    given( Integer ) { |n| raise "this would start an infinite loop ..." }
-    given( 0 ) { 0 }
-    given( 1 ) { 1 }
-    # but this will "demote" the Integer pattern and now it will work ...
-    given( Integer ) { |n| self.call( n - 1 ) + self.call( n - 2 ) }
-  end
-
-This isn't perfect, but it is very easy to predict, simple to implement, and reasonably fast, which other approaches (such as implementing a precedence scheme) are not.
-
-= Credits And Support
-
-Functor was written by Dan Yoder, Matthew King, and Lawrence Pit. Send email to dan at zeraweb.com for support or questions.

data/doc/rdoc/classes/Functor.html

@@ -1,207 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html 
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: Functor</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-
-    elemStyle = elem.style;
-    
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-
-    return true;
-  }
-  
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  
-  // ]]>
-  </script>
-
-</head>
-<body>
-
-
-
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">Functor</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../files/lib/functor_rb.html">
-                lib/functor.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                <a href="Object.html">
-                Object
-               </a>
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-
-  <div id="bodyContent">
-
-
-
-  <div id="contextContent">
-
-
-
-   </div>
-
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-
-      <div class="name-list">
-      <a href="#M000003">apply</a>&nbsp;&nbsp;
-      <a href="#M000004">call</a>&nbsp;&nbsp;
-      <a href="#M000002">given</a>&nbsp;&nbsp;
-      <a href="#M000001">new</a>&nbsp;&nbsp;
-      <a href="#M000005">to_proc</a>&nbsp;&nbsp;
-      </div>
-    </div>
-
-  </div>
-
-
-    <!-- if includes -->
-
-    <div id="section">
-
-    <div id="class-list">
-      <h3 class="section-bar">Classes and Modules</h3>
-
-      Module <a href="Functor/Method.html" class="link">Functor::Method</a><br />
-
-    </div>
-
-
-
-
-      
-
-
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-
-        <div class="method-heading">
-          <a href="Functor.src/M000001.html" target="Code" class="method-signature"
-            onclick="popupCode('Functor.src/M000001.html');return false;">
-          <span class="method-name">new</span><span class="method-args">( &amp;block )</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <h3 class="section-bar">Public Instance methods</h3>
-
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
-
-        <div class="method-heading">
-          <a href="Functor.src/M000003.html" target="Code" class="method-signature"
-            onclick="popupCode('Functor.src/M000003.html');return false;">
-          <span class="method-name">apply</span><span class="method-args">( object, *args, &amp;block )</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
-
-        <div class="method-heading">
-          <a href="Functor.src/M000004.html" target="Code" class="method-signature"
-            onclick="popupCode('Functor.src/M000004.html');return false;">
-          <span class="method-name">call</span><span class="method-args">( *args, &amp;block )</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-
-        <div class="method-heading">
-          <a href="Functor.src/M000002.html" target="Code" class="method-signature"
-            onclick="popupCode('Functor.src/M000002.html');return false;">
-          <span class="method-name">given</span><span class="method-args">( *pattern, &amp;action )</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
-
-        <div class="method-heading">
-          <a href="Functor.src/M000005.html" target="Code" class="method-signature"
-            onclick="popupCode('Functor.src/M000005.html');return false;">
-          <span class="method-name">to_proc</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-
-    </div>
-
-
-  </div>
-
-
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-
-</body>
-</html>