stages 0.4.1 → 1.0.0

data/README.md

@@ -35,6 +35,31 @@ pipeline = evens | map{|x| x*3} | select{|x| x % 7 == 0}
 ```
 Just include Stages::Sugar to get all the helpers.
 
+Weird Stages
+------------
+
+The feeder stage lets you have a pipeline which can add new values to the left hand side:
+```ruby
+pipeline = feeder
+feeder.done? # true
+feeder << 1
+feeder.done? # false
+feeder.run # 1
+feeder.done? # true
+``` 
+
+The wrap stage has different behavior depending on the arguments you specify.  In general, it runs the given pipeline in the context of the passed value.  Wrap has various output modes you can use depending on what you are expecting.
+```ruby
+emit('foo') | wrap(each{|x| x.chars}, :hash) # {'foo' => ['f', 'o', 'o']} this is the default
+emit('foo') | wrap(each{|x| x.chars} | group, :aggregated) # {'foo' => {'f' => 1, 'o' => 2}} assumes a single value output
+emit('foo') | wrap(each{|x| x.chars}, :array) # ['f', 'o', 'o'] discards the original value
+emit('foo') | wrap(each{|x| x.chars}, :each) | run_until_exhausted # ['f', 'o', 'o'] equivalent to array + each
+emit('foo') | wrap(each{|x| x.chars}){ |k, v| {k => v}} # {'foo' => ['f', 'o', 'o']
+emit('foo') | wrap(each{|x| x.chars}, :each){|k, v| {k => v}} # {'foo' => 'f'} ... {'foo' => 'o'} 
+```
+
+Each does not build an internal list of results from the sub-array, and so may be useful in cases of high memory pressure when you are expecting many results for each input. 
+
 Writing New Stages
 ------------------
 

data/Rakefile

@@ -25,7 +25,7 @@ Jeweler::Tasks.new do |gem|
   gem.summary = "pipeline builder"
   gem.description = "pipeline builder"
   gem.email = "support@igodigital.com"
-  gem.authors = ["The Justice Eight"]
+  gem.authors = ["Nathan D Acuff"]
   # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -1 +1 @@
-0.4.1
+1.0.0

data/lib/stages/wrap.rb

@@ -1,9 +1,13 @@
 module Stages
   class Wrap < Stage
-    def initialize(pipeline, *args)
+
+    #pass a block that takes two arguments that joins the original thing passed to the results, for each result
+
+    def initialize(pipeline, *args, &block)
       @feeder = Feeder.new
       @pipeline = @feeder | pipeline
       @output_style = :hash
+      @block = block
       unless args.empty?
         if args.include? :array
           @output_style = :array
@@ -28,11 +32,27 @@ module Stages
         results = []
         while !@pipeline.done?
           v = @pipeline.run
-          @output_style == :each ? output(v) : results << v
+          #yield each subpipeline result, as they are generated
+          if @output_style == :each
+            if @block
+              output @block.call(value, v)
+            else
+              output v
+            end
+          else
+            results << v
+          end
+        end
+        if @output_style != :each
+          results = results.first if @aggregated
+          #note that block supercedes array or hash
+          if @block
+            output @block.call(value, results)
+          else
+            output results if @output_style == :array
+            output({ value => results}) if @output_style == :hash
+          end
         end
-        results = results.first if @aggregated
-        output results if @output_style == :array
-        output({ value => results}) if @output_style == :hash
         @pipeline.reset
       end
       @pipeline.reset

data/stages.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "stages"
-  s.version = "0.4.1"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["The Justice Eight"]
-  s.date = "2012-04-16"
+  s.authors = ["Nathan D Acuff"]
+  s.date = "2012-07-13"
   s.description = "pipeline builder"
   s.email = "support@igodigital.com"
   s.extra_rdoc_files = [
@@ -46,7 +46,7 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "https://github.com/iGoDigital-LLC/stages"
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.17"
+  s.rubygems_version = "1.8.19"
   s.summary = "pipeline builder"
 
   if s.respond_to? :specification_version then

data/test/test_stages.rb

@@ -48,6 +48,27 @@ class TestStages < MiniTest::Unit::TestCase
     assert_equal(3, result['bar'].keys.length)
   end
 
+  test 'wrap/join array' do
+    pipeline = Each.new(%w(foo bar)) | Wrap.new(Each.new{ |x| x.chars}) { |context, values| { context => values}}
+    result = pipeline.run
+    assert_equal({ 'foo' => %w(f o o)}, result)
+  end
+
+  test 'wrap/join each' do
+    pipeline = Each.new(%w(foo bar)) | Wrap.new(Each.new{ |x| x.chars}, :each) { |context, values| { context => values}}
+    result = pipeline.run
+    assert_equal({ 'foo' => 'f'}, result)
+    result = pipeline.run
+    assert_equal({ 'foo' => 'o'}, result)
+    result = pipeline.run
+    assert_equal({ 'foo' => 'o'}, result)
+    result = pipeline.run
+    assert_equal({ 'bar' => 'b'}, result)
+    result = pipeline.run
+    assert_equal({ 'bar' => 'a'}, result)
+    result = pipeline.run
+    assert_equal({ 'bar' => 'r'}, result)
+  end
 
   test 'array mode wrap' do
     pipeline = Each.new(%w(foo bar)) | Wrap.new(Each.new{ |x| x.chars}, :array)

metadata

@@ -1,37 +1,39 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: stages
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 1.0.0
   prerelease: 
-  version: 0.4.1
 platform: ruby
-authors: 
-- The Justice Eight
+authors:
+- Nathan D Acuff
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-04-16 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-07-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rake
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - "="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
         version: 0.9.2
   type: :runtime
   prerelease: false
-  version_requirements: *id001
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.2
 description: pipeline builder
 email: support@igodigital.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.md
-files: 
+files:
 - .autotest
 - Gemfile
 - Gemfile.lock
@@ -61,33 +63,29 @@ files:
 - test/test_syntax.rb
 homepage: https://github.com/iGoDigital-LLC/stages
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3910381420948442962
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 667046773893445689
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.17
+rubygems_version: 1.8.19
 signing_key: 
 specification_version: 3
 summary: pipeline builder
 test_files: []
-