funkify 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d5d368db1d50577c1cf79227015a65bfa6c89d02
-  data.tar.gz: 819c4d262056e8c8c2fbd4e37eeb3d822681e4f1
+  metadata.gz: b1509b7e4e421ff184a3ddebf8bae52b54063883
+  data.tar.gz: 30e1768e67a4a65de187b0035050c795fa572e61
 SHA512:
-  metadata.gz: e1c249b9939eabca11d0221377aff41e2c59951c4980ab6e54e30f5ca1561bc0117c949429c43ade6a5de0a32a64651759eda7915c7857f9ab26466f5003a5f8
-  data.tar.gz: 5948d58b24e0c4deaf5a397f4daf672531263b952aef994400f12ac775a5f41a2284996c39b8795321203f3e9a1bb5d02a9bf35656f22d77785d8c44d148c6dc
+  metadata.gz: d0ba7e0c32a65562b351b001264506ed55c13980382c25169dd76839cc23feb8138df7715aaf0cc9b8e000fe3cb56277bbc6684a3f2674f9e0263bf121594d58
+  data.tar.gz: e22735ce17f3f5e11ef60952c176d9d07ce1cb71f99370043035c0314e9998af8ba6b31ebf0e7f55760651713cba23dac33986947addedd82e1c05e77cd518c1

data/README.md

@@ -2,13 +2,13 @@
 
 _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)
 
-[Partial application in haskell](http://www.haskell.org/haskellwiki/Partial_application)<br>
-[Function composition in haskell](http://www.haskell.org/haskellwiki/Function_composition)
+[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)
 
 
 ## Usage
@@ -38,6 +38,8 @@ class MyFunkyClass
 end
 ```
 
+### Partial application and currying
+
 When a method supports autocurrying it can still be invoked normally (if all parameters are provided) however if less than the required number are given a `Proc` is returned
 with the given parameters partially applied:
 
@@ -49,18 +51,29 @@ 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.
 ```
 
-We can also compose methods using `*`:
+### Function composition
+
+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
-add_1_and_multiply_by_5 = funky.mult(5) * funky.add(1)
-add_1_and_multiply_by_5.(10) #=> 55
+(mult(5) * add(1)).(10) #=> 55
 
-# We can even further compose the above with another method:
+# We can further compose the above with another method:
+(negate * mult(5) * add(1)).(10) #=> -55
+```
 
-(funky.negate * add_1_and_multiply_by_5).(10) #=> -55
+`|` composes left to right, like a shell pipeline:
+```ruby
+(mult(5) | add(1) | negate).(3) #=> -16
 ```
 
-Other examples:
+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)):
+```ruby
+pass(3) | (mult(5) | add(1) | negate) #=> -16
+```
+
+#### Other examples:
 
 Add 10 to every item in an Enumerable:
 
@@ -87,6 +100,10 @@ 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.
 
 ## Contributing
 

data/Rakefile

@@ -8,6 +8,34 @@ def run_specs paths
   exec "bacon -Ispec -rubygems #{quiet} #{paths.join ' '}"
 end
 
+desc "run tests"
 task :test do
   run_specs Dir['spec/**/*_spec.rb'].shuffle!
 end
+
+desc "run pry with the development version of funkify loaded"
+task :pry do
+  sh "pry -I./lib -r funkify"
+end
+
+desc "remove all gems"
+task :rm_gems do
+  sh "rm *.gem" rescue nil
+end
+
+desc "build the gem"
+task :gem => :rm_gems do
+  sh "gem build funkify.gemspec"
+end
+
+desc "display the current version"
+task :version do
+  puts Funkify::VERSION
+end
+
+desc "build and push latest gems"
+task :pushgem => :gem do
+  Dir["*.gem"].each do |gemfile|
+    sh "gem push funkify-#{Funkify::VERSION}.gem"
+  end
+end

data/lib/funkify.rb

@@ -9,6 +9,14 @@ module Funkify
     def *(other)
       Funkify.compose(self, other)
     end
+
+    def |(other)
+      if arity.zero?
+        other.(*self.())
+      else
+        Funkify.compose(other, self)
+      end
+    end
   end
 
   module_function
@@ -22,6 +30,11 @@ module Funkify
     end
   end
 
+  def pass(*xs)
+    -> { xs }
+  end
+  public :pass
+
   def compose(*args)
     head, *tail = args
     head = _procify(head)
@@ -41,22 +54,22 @@ module Funkify
     end
   end
 
-  module ClassMethods
-    def auto_curry(*names)
-      if names.empty?
-        in_use = nil
-        define_singleton_method(:method_added) do |name|
-          return if in_use
-          in_use = true
-          auto_curry name
-          in_use = false
-        end
-        return
-      end
+  def self.auto_curry_all_methods(receiver)
+    in_use = nil
+    receiver.define_singleton_method(:method_added) do |name|
+      return if in_use
+      in_use = true
+      receiver.auto_curry name
+      in_use = false
+    end
+  end
 
-      names.each do |name|
-        m = instance_method(name)
-        curried_method = nil
+  def self.auto_curry_some_methods(names, receiver)
+    names.each do |name|
+      m = receiver.instance_method(name)
+      curried_method = nil
+
+      receiver.class_eval do
         define_method(name) do |*args|
           curried_method ||= m.bind(self).to_proc.curry
           curried_method[*args]
@@ -64,4 +77,21 @@ module Funkify
       end
     end
   end
+
+  module ClassMethods
+    def auto_curry(*names)
+      if names.empty?
+        Funkify.auto_curry_all_methods(self)
+      else
+        Funkify.auto_curry_some_methods(names, self)
+      end
+    end
+
+    def point_free(&block)
+      -> (*args) do
+        b = instance_exec(&block).curry
+        args.empty? ? b : b[*args]
+      end
+    end
+  end
 end

data/lib/funkify/version.rb

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

data/spec/funkify_spec.rb

@@ -105,20 +105,50 @@ describe Funkify do
       end.new
     end
 
-    it 'returns a new Proc when composing methods' do
-      (@c.negate * @c.plus_1).is_a?(Proc).should == true
-    end
+    describe "normal composition" do
+      it 'returns a new Proc when composing methods' do
+        (@c.negate * @c.plus_1).is_a?(Proc).should == true
+      end
+
+      it 'invokes composed methods in the correct order (right-to-left)' do
+        (@c.negate * @c.plus_1).(5).should == -6
+      end
 
-    it 'invokes composed methods in the correct order (right-to-left)' do
-      (@c.negate * @c.plus_1).(5).should == -6
+      it 'can compose partially applied methods' do
+        (@c.add(5) * @c.mult(2)).(5).should == 15
+      end
+
+      it 'can compose multiple methods' do
+        (@c.negate * @c.add(5) * @c.mult(5)).(5).should == -30
+      end
     end
 
-    it 'can compose partially applied methods' do
-      (@c.add(5) * @c.mult(2)).(5).should == 15
+    describe "reverse composition" do
+      it 'returns a new Proc when composing methods' do
+        (@c.negate | @c.plus_1).is_a?(Proc).should == true
+      end
+
+      it 'invokes reverse-composed methods in the correct order (left-to-right)' do
+        (@c.negate | @c.plus_1).(5).should == -4
+      end
+
+      it 'can reverse-compose partially applied methods' do
+        (@c.add(5) | @c.mult(2)).(5).should == 20
+      end
+
+      it 'can reverse-compose multiple methods' do
+        (@c.negate | @c.add(5) | @c.mult(5)).(5).should == 0
+      end
     end
 
-    it 'can compose multiple methods' do
-      (@c.negate * @c.add(5) * @c.mult(5)).(5).should == -30
+    describe "pass method" do
+      it 'passes values into a reverse-composition stream' do
+        (@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
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: funkify
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - John Mair
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-11 00:00:00.000000000 Z
+date: 2013-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler