parallax 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 199b9a1f7d00f3ab396af10da44fbec350f059444e133a68128c33f6103efd44
-  data.tar.gz: f23cd123597d3070c5e23ab98a5db1288c5d85bf0f4170618ff304a1f17e05e9
+  metadata.gz: 8550cb7115815b07ee890e22a8d9df2c956b8f7ed4c8d6b3e72cfbcb7045926c
+  data.tar.gz: ab4ce11646317867bc4aca9e6a14b8877255afddc3bb7486831e3522feae7576
 SHA512:
-  metadata.gz: a6a57b1760de4e0e857f46e2da3d0c18040846358c5f398270ec33328e661e63bff3d68d6a6d91baf09b38eb209a73691a14b3294b8aa58870847dac66084018
-  data.tar.gz: 6b8a58e098e65c5070b804cc6081dce58f616aaf06bd6b25adadb2cc2db8e5bf1606fa75732ef4fe0f73c9f98ba0f97c87ee6dc1fd8ec7c4d469bc3549edb7bc
+  metadata.gz: 62c77b06eb45b8ddfa0142c962d808ece8a44f41d39d7ec942ab320c59213b32fa83b814dc69b7095e8654b28d7f724046b53830dabd1fb58d9ce6823d00e6ac
+  data.tar.gz: b9def74a52b5ec5132ec7bd26c28aeacecb33cfee4147c6281b5d59f31795cbb476c2f87fc35b89d16bde9be05ea9565848efef2cff1e568100fd76b2cfb074c

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    parallax (0.3.0)
+    parallax (0.3.1)
       activesupport
 
 GEM

data/README.md

@@ -71,21 +71,21 @@ Other options you can pass to execute are:
 * `processes`: the number of processes in which parallelize the execution. Defaults to `Etc.nprocessors` (which is equal to the number of cores of the current running machine).
 * `collector`: a custom collector object that you can implement yourself.
 
-To use a custom collector, you need to `include Parallax::Collectable` in your custom collector, and initialize your collector by calling the included `initialize_collector` method.
-Example of a custom collector:
+To use a custom collector, you need to `include Parallax::Collectable` in your custom collector. Example of a custom collector:
 
 ```ruby
 # custom_collector.rb
 class CustomCollector
   include Parallax::Collectable
 
-  def initialize(worker_count, *args)
-    # Do your own initialization with *args, and then
-    initialize_collector(workers_count)
+  attr_accessor :name
+
+  def initialize(name)
+    @name = name
   end
 
   def store(worker_index, object)
-    workers_data.push [ "worker #{worker_index} stored: #{object.inspect}" ]
+    workers_data.push "#{self.name}: worker #{worker_index} stored: #{object}"
   end
 end
 ```
@@ -94,7 +94,7 @@ end
 workers_count = 4
 numbers = (0..100).to_a
 
-custom_collector = CustomCollector.new(workers_count)
+custom_collector = CustomCollector.new('custom_collector')
 Parallax.execute numbers, collector: custom_collector, do |worker, numbers_chunk|
   numbers_chunk.each do |number|
     worker.store number * 2
@@ -104,10 +104,10 @@ end
 puts custom_collector.workers_data.inspect
 
 # Example output with 4 cores and custom collector:
-#   [ ["worker 0 stored 0"],
-#     ["worker 3 stored 152"],
-#     ["worker 1 stored 52"],
-#     ["worker 2 stored 102"],
+#   [ "custom_collector: worker 0 stored 0",
+#     "custom_collector: worker 3 stored 152",
+#     "custom_collector: worker 1 stored 52",
+#     "custom_collector: worker 2 stored 102",
 #     ...
 ```
 

data/lib/parallax/collectable.rb

@@ -19,12 +19,13 @@ module Parallax
       #
       # @param [Integer] workers_count the number of workers running in parallel.
       #
-      # @return [nil]
+      # @return [Object] the instance of the including object.
       def initialize_collector(workers_count)
         @workers_count = workers_count
         @closed_workers_count = 0
         @receiving_stream, @sending_stream = IO.pipe
         @workers_data = []
+        self
       end
 
       ##

data/lib/parallax/version.rb

@@ -1,3 +1,3 @@
 module Parallax
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

data/lib/parallax.rb

@@ -9,14 +9,6 @@ module Parallax
 
   class << self
 
-    ##
-    # Get the default number of workers.
-    #
-    # @return [Integer] the workers count.
-    def workers_count
-      Etc.nprocessors
-    end
-  
     ##
     # Divides the given elements in groups of N and executes
     # each chunk in parallel with the given block.
@@ -26,10 +18,10 @@ module Parallax
     #
     # @return [Collector] all processes output collector.
     def execute(elements, options = {}, &block)
-      processes = options[:processes] || Parallax.workers_count
+      processes = options[:processes] || Etc.nprocessors
 
       if options[:collector].present?
-        collector = options[:collector]
+        collector = options[:collector].initialize_collector(processes)
       else
         collector = Parallax::Collector.new(processes)
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parallax
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Francesco Ballardin