funkify 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b1509b7e4e421ff184a3ddebf8bae52b54063883
-  data.tar.gz: 30e1768e67a4a65de187b0035050c795fa572e61
+  metadata.gz: 45022580a84d3526daa607b98036af6b25a5866c
+  data.tar.gz: b16a211aebf621fa75120b2936fb286c7b5a231e
 SHA512:
-  metadata.gz: d0ba7e0c32a65562b351b001264506ed55c13980382c25169dd76839cc23feb8138df7715aaf0cc9b8e000fe3cb56277bbc6684a3f2674f9e0263bf121594d58
-  data.tar.gz: e22735ce17f3f5e11ef60952c176d9d07ce1cb71f99370043035c0314e9998af8ba6b31ebf0e7f55760651713cba23dac33986947addedd82e1c05e77cd518c1
+  metadata.gz: 7e8d44488265a956d845f8ce1a701ab1f09f0922494feb4f8cbc5945aa76c5b258b14e551be2ee28cf380c65166958221cf7ec6b03961d88cbad0ba6f8d1d194
+  data.tar.gz: 98937ae54c307757bd8d9720183bccb4f62795d751f0d10d80e52ca527c564d610d45757343211e741cce3d3699ca88713df29b7f338126a15865ec15454980f

data/README.md

@@ -2,17 +2,22 @@
 
 _Haskell-style partial application and composition for Ruby methods_
 
-"In computer science, partial application refers to the process of
-fixing a number of arguments to a function, producing another function of smaller arity."
---[Wikipedia](http://en.wikipedia.org/wiki/Partial_application)
+Function composition when used in conjunction with partial application can yield exceptionally concise code, often more concise than the idiomatic Ruby counterpart. Check out the links
+below for further explanations of these features and examples of their use in Haskell:
 
-[Curring in Haskell](http://www.haskell.org/haskellwiki/Currying)<br>
 [Partial application in Haskell](http://www.haskell.org/haskellwiki/Partial_application)<br>
-[Function composition in Haskell](http://www.haskell.org/haskellwiki/Function_composition)
+[Function composition in Haskell](http://www.haskell.org/haskellwiki/Function_composition)<br>
+[Curring in Haskell](http://www.haskell.org/haskellwiki/Currying)
 
+Also, watch [this video](http://www.youtube.com/watch?v=m3svKOdZijA) to learn about some of the cool things you can do with
+function composition and partial application (the video is in Javascript but the ideas still apply to Ruby with Funkify)
 
 ## Usage
 
+### Autocurrying
+
+In order for a Ruby method to be amenable to partial application and composition it must first be autocurried:
+
 ```ruby
 class MyFunkyClass
   include Funkify
@@ -48,12 +53,12 @@ funky = MyFunkyClass.new
 
 funky.add(1, 2) #=> This works normally and returns 3
 add_1 = funky.add(1) #=> The `1` is partially applied and a `Proc` is returned
-add_1.(2) #=> We invoke that `Proc` with the remaining argument and the final result (`3`) is returned.
+add_1.(2) #=> 3 (We invoke that `Proc` with the remaining argument)
 ```
 
 ### Function composition
 
-We compose methods using the `*` and `|` operators. 
+We compose methods using the `*` and `|` operators.
 
 `*` composes right to left, this is the standard way to compose functions found in languages like Haskell:
 ```ruby
@@ -68,9 +73,9 @@ We compose methods using the `*` and `|` operators.
 (mult(5) | add(1) | negate).(3) #=> -16
 ```
 
-As a cute bonus, we can inject values from the left into a pipeline with the `pass` method ([see more](http://showterm.io/47f46234281cf2c25f44a#fast)):
+As a cute bonus, we can inject values from the left into a pipeline with the `pass` method together with the `>=` (pipeline operator) (([see more](http://showterm.io/47f46234281cf2c25f44a#fast)):
 ```ruby
-pass(3) | (mult(5) | add(1) | negate) #=> -16
+pass(3) >= mult(5) | add(1) | negate #=> -16
 ```
 
 #### Other examples:
@@ -84,7 +89,7 @@ Add 10 to every item in an Enumerable:
 Multiply by 10 and negate every item in an Enumerable:
 
 ```ruby
-(1..5).map &(funky.negate * funky.mult(10)) => [-10, -20, -30, -40, -50]
+(1..5).map &(funky.negate * funky.mult(10)) #=> [-10, -20, -30, -40, -50]
 ```
 
 ## Installation
@@ -100,7 +105,7 @@ And then execute:
 Or install it yourself as:
 
     $ gem install funkify
-    
+
 ## Dedication
 
 This library was inspired in part by stimulating conversations with [epitron](https://github.com/epitron) on Freenode.

data/lib/funkify.rb

@@ -11,11 +11,11 @@ module Funkify
     end
 
     def |(other)
-      if arity.zero?
-        other.(*self.())
-      else
-        Funkify.compose(other, self)
-      end
+      Funkify.compose(other, self)
+    end
+
+    def >=(other)
+      other.(*self.())
     end
   end
 

data/lib/funkify/version.rb

@@ -1,3 +1,3 @@
 module Funkify
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/spec/funkify_spec.rb

@@ -143,11 +143,11 @@ describe Funkify do
 
     describe "pass method" do
       it 'passes values into a reverse-composition stream' do
-        (@c.pass(5) | ( @c.add(5) | @c.mult(5))).should == 50
+        (@c.pass(5) >= @c.add(5) | @c.mult(5)).should == 50
       end
 
       it 'passes values into a normal-composition stream' do
-        (@c.pass(5) | ( @c.add(5) * @c.mult(5))).should == 30
+        (@c.pass(5) >= @c.add(5) * @c.mult(5)).should == 30
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: funkify
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - John Mair