piperator 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5ce14dd4a45b8ce9bc5453cb30df67c1357c8903
-  data.tar.gz: b3df089403c086b52d8f0a48d2292d9f06495c51
+SHA256:
+  metadata.gz: af5e198f4b96db3cee04f76d28630879c8a6d7f69a83b7aef26d895ccff7051a
+  data.tar.gz: 236c0753cdde6275d2e9bf350b2afa839312bbe72a636eff5a190a1a6bcd8b3b
 SHA512:
-  metadata.gz: e93f487947ca4c0bacc904b3b04d1e90a245a3bc2efa68bb2b461f3df0427b6e34182cfc01c8cb50be9ae79906de91848ee70102687b55b31d769ed4938f40d9
-  data.tar.gz: 0a2e61d19a4533ac76bb302f6fbc505f7a8e4cf5e97f0652ab9bd6b8f34aff1e79e22d271c12656a7e7a0b0cb460be2f6f3e681bbdf6e31d4c55c06f2296499c
+  metadata.gz: 17220ec804befc2717354c004a9c0b038d00618a3296ac773e77a99d14333d3dafc87d73b112dc1921eeaf6c67e4b7e8e8070ba42cd983b692d9a7c73999e44c
+  data.tar.gz: b74fe2c27cc940c5be501ecfb429dad7a89fde7283f30f67c64840013361a32101e7d9b5fa72b590d13750b8f75bc94683139cc38bdc8d0309516d04ffc931f5

data/.travis.yml

@@ -1,5 +1,10 @@
 sudo: false
+cache: bundler
 language: ruby
 rvm:
-  - 2.4.0
-before_install: gem install bundler -v 1.14.6
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
+  - jruby
+  - truffleruby

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.0.0. (13 October 2019)
+
+- add `Piperator.build` to build pipelines with DSL
+
 ## 0.3.0 (13 July 2017)
 
 - remove implicit wrapping to callable from `Pipeline.pipe`

data/README.md

@@ -6,6 +6,20 @@ The library is heavily inspired by [Elixir pipe operator](https://elixirschool.c
 
 [![Build Status](https://travis-ci.org/lautis/piperator.svg?branch=master)](https://travis-ci.org/lautis/piperator)
 
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**
+
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Pipelines](#pipelines)
+  - [Enumerators as IO objects](#enumerators-as-io-objects)
+- [Development](#development)
+- [Related Projects](#related-projects)
+- [Contributing](#contributing)
+- [License](#license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
 ## Installation
 
@@ -35,7 +49,16 @@ Piperator.
 # => 18
 ```
 
-If desired, the input enumerable can also be given as the first elmenent of the pipeline using `Piperator.wrap`.
+The same could also be achieved using DSL instead of method chaining:
+
+```ruby
+Piperator.build do
+  pipe(->(values) { values.lazy.map { |i| i * 3 } })
+  pipe(->(values) { values.sum })
+end.call([1, 2, 3])
+```
+
+If desired, the input enumerable can also be given as the first element of the pipeline using `Piperator.wrap`.
 
 ```ruby
 Piperator.
@@ -156,6 +179,12 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Related Projects
+
+* [D★Stream](https://github.com/ddfreyne/d-stream) - Set of extensions for writing stream-processing code.
+* [ddbuffer](https://github.com/ddfreyne/ddbuffer) - Buffer enumerables/enumerators.
+* [Down::ChunkedIO](https://github.com/janko-m/down/blob/master/lib/down/chunked_io.rb) - A similar IO class as Piperator::IO.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/lautis/piperator.

data/lib/piperator.rb

@@ -1,13 +1,43 @@
 require 'piperator/version'
 require 'piperator/pipeline'
 require 'piperator/io'
+require 'piperator/builder'
 
 # Top-level shortcuts
 module Piperator
+  # Build a new pipeline using DSL. This enables easy control of the pipeline
+  # stucture.
+  #
+  #   Piperator.build do
+  #     wrap [1, 2, 3]
+  #     pipe(-> (enumerable) { enumerable.map { |i| i + 1 } })
+  #   end
+  #   # => Pipeline that returns [2, 3, 4] called
+  #
+  #   # Alternatively, the Builder is also given as argument to the block
+  #   Piperator.build do |p|
+  #     p.wrap [1, 2, 3]
+  #     p.pipe(-> (enumerable) { enumerable.map { |i| i + 1 } })
+  #   end
+  #   # This is similar, but allows access to instance variables.
+  #
+  # @return [Pipeline] Pipeline containing defined steps
+  def self.build(&block)
+    return Pipeline.new unless block_given?
+
+    Builder.new(block&.binding).tap do |builder|
+      if block.arity.positive?
+        yield builder
+      else
+        builder.instance_eval(&block)
+      end
+    end.to_pipeline
+  end
+
   # Build a new pipeline from a callable or an enumerable object
   #
   # @see Piperator::Pipeline.pipe
-  # @param callable An object responding to call(enumerable)
+  # @param enumerable An object responding to call(enumerable)
   # @return [Pipeline] A pipeline containing only the callable
   def self.pipe(enumerable)
     Pipeline.pipe(enumerable)

data/lib/piperator/builder.rb

@@ -0,0 +1,53 @@
+module Piperator
+  # Builder is used to provide DSL-based Pipeline building. Using Builder,
+  # Pipelines can be built without pipe chaining, which might be easier if
+  # some steps need to be included only on specific conditions.
+  #
+  # @see Piperator.build
+  class Builder
+    # Expose a chained method in Pipeline in DSL
+    #
+    # @param method_name Name of method in Pipeline
+    # @see Pipeline
+    #
+    # @!macro [attach] dsl_method
+    #   @method $1
+    #   Call Pipeline#$1 given arguments and use the return value as builder state.
+    #
+    #   @see Pipeline.$1
+    def self.dsl_method(method_name)
+      define_method(method_name) do |*arguments|
+        @pipeline = @pipeline.send(method_name, *arguments)
+      end
+    end
+
+    dsl_method :pipe
+    dsl_method :wrap
+
+    def initialize(saved_binding, pipeline = Pipeline.new)
+      @pipeline = pipeline
+      @saved_binding = saved_binding
+    end
+
+    # Return build pipeline
+    #
+    # @return [Pipeline]
+    def to_pipeline
+      @pipeline
+    end
+
+    private
+
+    def method_missing(method_name, *arguments, &block)
+      if @saved_binding.receiver.respond_to?(method_name, true)
+        @saved_binding.receiver.send(method_name, *arguments, &block)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @saved_binding.receiver.respond_to?(method_name, include_private) || super
+    end
+  end
+end

data/lib/piperator/version.rb

@@ -1,3 +1,4 @@
 module Piperator
-  VERSION = '0.3.0'.freeze
+  # Piperator version
+  VERSION = '1.0.0'.freeze
 end

data/piperator.gemspec

@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.14'
+  spec.add_development_dependency 'bundler', '>= 1.14'
   spec.add_development_dependency 'rake', '~> 12.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
 end

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: piperator
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Ville Lautanala
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-07-13 00:00:00.000000000 Z
+date: 2019-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.14'
 - !ruby/object:Gem::Dependency
@@ -71,6 +71,7 @@ files:
 - bin/console
 - bin/setup
 - lib/piperator.rb
+- lib/piperator/builder.rb
 - lib/piperator/io.rb
 - lib/piperator/pipeline.rb
 - lib/piperator/version.rb
@@ -94,8 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Composable pipelines for streaming large collections