parallel 0.3.1 → 0.3.2

data/README.markdown

@@ -1,10 +1,11 @@
 Run any kind of code in parallel Processes or Threads, to speedup computation by factor #{your_cpus} X.
 
  - Child processes are killed when your main process is killed through Ctrl+c or kill -2
+ - Processes/threads are workers, they grab the next piece of work when they finish
 
 Install
 =======
-    sudo gem install grosser-parallel -s http://gems.github.com/
+    sudo gem install parallel
 
 Usage
 =====
@@ -19,7 +20,6 @@ Usage
  - Global data can be modified
  - No extra memory used
 
-Map-Reduce-Style
     # 2 CPUs -> finished after 2 runs (a,b + c)
     results = Parallel.map(['a','b','c']) do |one_letter|
       expensive_calculation(letter)
@@ -31,22 +31,8 @@ Map-Reduce-Style
     # 3 Threads -> finished after 1 run
     results = Parallel.map(['a','b','c'], :in_threads=>3){|one_letter| ... }
 
-
-Normal
-    #i -> 0...number_of_your_cpus
-    results = Parallel.in_processes do |i|
-      expensive_computation(data[i])
-    end
-
-    #i -> 0...4
-    results = Parallel.in_processes(4) do |i|
-      expensive_computation(data[i])
-    end
-
-    # Threads
-    results = Parallel.in_threads(4) do |i|
-      blocking_computation(data[i])
-    end
+Same can be done with `each`
+    Parallel.each(['a','b','c']){|one_letter| ... }
 
 TODO
 ====

data/Rakefile

@@ -5,7 +5,6 @@ task :default do
   system("spec #{options} #{files}")
 end
 
-# fake task so that rubyforge:release works
 task :rdoc do
 end
 
@@ -20,6 +19,13 @@ begin
     gem.authors = ["Michael Grosser"]
     gem.rubyforge_project = 'parallel'
   end
+
+  # fake task so that rubyforge:release works
+  task :rdoc do
+    `mkdir rdoc`
+    `echo documentation is at http://github.com/grosser/#{project_name} > rdoc/README.rdoc`
+  end
+
   Jeweler::RubyforgeTasks.new
 rescue LoadError
   puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"

data/VERSION

@@ -1 +1 @@
-0.3.1
+0.3.2

data/lib/parallel.rb

@@ -1,3 +1,5 @@
+require 'thread' # to get Thread.exclusive
+
 class Parallel
   VERSION = File.read( File.join(File.dirname(__FILE__),'..','VERSION') ).strip
 
@@ -51,9 +53,12 @@ class Parallel
     out.map{|x| Marshal.load(x) } # Deserialize results
   end
 
-  def self.map(array, options = {})
-    require 'thread' # to get Thread.exclusive
+  def self.each(array, options={}, &block)
+    map(array, options, &block)
+    array
+  end
 
+  def self.map(array, options = {})
     if options[:in_threads]
       method = :in_threads
       size = options[method]
@@ -89,6 +94,7 @@ class Parallel
 
   private
 
+  # split an array into groups of size items
   def self.in_groups_of(array, size)
     results = []
     loop do
@@ -102,7 +108,7 @@ class Parallel
     results
   end
 
-  #handle user interrup (Ctrl+c)
+  #handle user interrupt (Ctrl+c)
   def self.kill_on_ctrl_c(pids)
     Signal.trap :SIGINT do
       $stderr.puts 'Parallel execution interrupted, exiting ...'

data/parallel.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{parallel}
-  s.version = "0.3.1"
+  s.version = "0.3.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Michael Grosser"]
-  s.date = %q{2009-10-04}
+  s.date = %q{2009-10-11}
   s.email = %q{grosser.michael@gmail.com}
   s.extra_rdoc_files = [
     "README.markdown"
@@ -20,6 +20,8 @@ Gem::Specification.new do |s|
      "VERSION",
      "lib/parallel.rb",
      "parallel.gemspec",
+     "rdoc/README.rdoc",
+     "spec/cases/parallel_each.rb",
      "spec/cases/parallel_influence_outside_data.rb",
      "spec/cases/parallel_map.rb",
      "spec/cases/parallel_map_sleeping.rb",
@@ -49,7 +51,8 @@ Gem::Specification.new do |s|
      "spec/cases/parallel_map_sleeping.rb",
      "spec/cases/parallel_map_uneven.rb",
      "spec/cases/parallel_with_detected_cpus.rb",
-     "spec/cases/parallel_map.rb"
+     "spec/cases/parallel_map.rb",
+     "spec/cases/parallel_each.rb"
   ]
 
   if s.respond_to? :specification_version then

data/rdoc/README.rdoc

@@ -0,0 +1 @@
+documentation is at http://github.com/grosser/parallel

data/spec/cases/parallel_each.rb

@@ -0,0 +1,9 @@
+require 'spec/spec_helper.rb'
+STDOUT.sync = true # otherwise results can go weird...
+
+x = ['a','b','c','d']
+result = Parallel.each(x) do |x|
+  sleep 0.1 if x == 'a'
+  print "-#{x}-"
+end
+print result * ' '

data/spec/parallel_spec.rb

@@ -90,6 +90,12 @@ describe Parallel do
     end
   end
 
+  describe :each do
+    it "returns original array, works like map" do
+      `ruby spec/cases/parallel_each.rb`.should == '-b--c--d--a-a b c d'
+    end
+  end
+
   describe :in_groups_of do
     it "works for empty" do
       Parallel.send(:in_groups_of, [], 3).should == []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: parallel
 version: !ruby/object:Gem::Version 
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors: 
 - Michael Grosser
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-04 00:00:00 +02:00
+date: 2009-10-11 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -27,6 +27,8 @@ files:
 - VERSION
 - lib/parallel.rb
 - parallel.gemspec
+- rdoc/README.rdoc
+- spec/cases/parallel_each.rb
 - spec/cases/parallel_influence_outside_data.rb
 - spec/cases/parallel_map.rb
 - spec/cases/parallel_map_sleeping.rb
@@ -78,3 +80,4 @@ test_files:
 - spec/cases/parallel_map_uneven.rb
 - spec/cases/parallel_with_detected_cpus.rb
 - spec/cases/parallel_map.rb
+- spec/cases/parallel_each.rb