piperator 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eec6368ee594785c21b367e0575ff8e56b1333c9
-  data.tar.gz: 7f4dc49b0dbab3b79bbd171b0099b7c0d623c157
+  metadata.gz: 5ce14dd4a45b8ce9bc5453cb30df67c1357c8903
+  data.tar.gz: b3df089403c086b52d8f0a48d2292d9f06495c51
 SHA512:
-  metadata.gz: a784c23791a28b994d4db90626589478b58dfff806a35f3fc812792ed8c247fef556d5e72b1a2aa7195b97fbc0f73e0deab4d80cf9a03e91e393e1af809bc7e6
-  data.tar.gz: f0e310f29dc9965e0f8a94826e0a66830761d4333aae8884cfb05e64cba35ea359657aa25e8046d37e98e30a1c18029dc670303765cd2f139a75ce9f87faf1fc
+  metadata.gz: e93f487947ca4c0bacc904b3b04d1e90a245a3bc2efa68bb2b461f3df0427b6e34182cfc01c8cb50be9ae79906de91848ee70102687b55b31d769ed4938f40d9
+  data.tar.gz: 0a2e61d19a4533ac76bb302f6fbc505f7a8e4cf5e97f0652ab9bd6b8f34aff1e79e22d271c12656a7e7a0b0cb460be2f6f3e681bbdf6e31d4c55c06f2296499c

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+## 0.3.0 (13 July 2017)
+
+- remove implicit wrapping to callable from `Pipeline.pipe`
+- add `Pipeline.wrap` to wrap a value as callable

data/README.md

@@ -35,11 +35,11 @@ Piperator.
 # => 18
 ```
 
-If desired, the input enumerable can also be given as the first pipe.
+If desired, the input enumerable can also be given as the first elmenent of the pipeline using `Piperator.wrap`.
 
 ```ruby
 Piperator.
-  pipe([1, 2, 3]).
+  wrap([1, 2, 3]).
   pipe(->(values) { values.lazy.map { |i| i * 3 } }).
   pipe(->(values) { values.sum }).
   call

data/lib/piperator.rb

@@ -12,4 +12,13 @@ module Piperator
   def self.pipe(enumerable)
     Pipeline.pipe(enumerable)
   end
+
+  # Build a new pipeline from a from a non-callable, i.e. string, array, etc.
+  #
+  # @see Piperator::Pipeline.wrap
+  # @param value A raw value which will be passed through the pipeline
+  # @return [Pipeline] A pipeline containing only the callable
+  def self.wrap(value)
+    Pipeline.wrap(value)
+  end
 end

data/lib/piperator/pipeline.rb

@@ -11,11 +11,23 @@ module Piperator
     # @param callable An object responding to call(enumerable)
     # @return [Pipeline] A pipeline containing only the callable
     def self.pipe(callable)
-      if callable.respond_to?(:call)
-        Pipeline.new([callable])
-      else
-        Pipeline.new([->(_) { callable }])
-      end
+      Pipeline.new([callable])
+    end
+
+    # Build a new pipeline from a from a non-callable, i.e. string, array, etc.
+    # This method will wrap the value in a proc, thus making it callable.
+    #
+    #   Piperator::Pipeline.wrap([1, 2, 3]).pipe(add_one)
+    #   # => [2, 3, 4]
+    #
+    #   # Wrap is syntactic sugar for wrapping a value in a proc
+    #   Piperator::Pipeline.pipe(->(_) { [1, 2, 3] }).pipe(add_one)
+    #   # => [2, 3, 4]
+    #
+    # @param value A raw value which will be passed through the pipeline
+    # @return [Pipeline] A pipeline containing only the callable
+    def self.wrap(value)
+      Pipeline.new([->(_) { value }])
     end
 
     # Returns enumerable given as an argument without modifications. Usable when
@@ -29,6 +41,7 @@ module Piperator
 
     def initialize(pipes = [])
       @pipes = pipes
+      freeze
     end
 
     # Compute the pipeline and return a lazy enumerable with all the pipes.
@@ -53,5 +66,14 @@ module Piperator
     def pipe(other)
       Pipeline.new(@pipes + [other])
     end
+
+    # Add a new value to the pipeline
+    #
+    # @param other A value which is wrapped into a pipe, then appended to the
+    # pipeline.
+    # @return [Pipeline] A new pipeline instance
+    def wrap(other)
+      Pipeline.new(@pipes + [->(_) { other }])
+    end
   end
 end

data/lib/piperator/version.rb

@@ -1,3 +1,3 @@
 module Piperator
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: piperator
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ville Lautanala
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-06-06 00:00:00.000000000 Z
+date: 2017-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -63,6 +63,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md