parallax 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cae7c981eb874ee20e40f328564c54396b01ba96f4c6690ed413c90ad944a308
-  data.tar.gz: a39524c02835452a762cc05a6dd72d334f45a77ed6d4da13f91f83f49c9f4a31
+  metadata.gz: 1b5ac6d394abaaa2b0f2b6634f0cb46a1e77584ae41d0a603dd46c96bd35b3c3
+  data.tar.gz: cc568d1e88bed4cb5f7d2f7708fe6cdf1203e4623c0541c4a0326c6d8c5771c5
 SHA512:
-  metadata.gz: 683dafee698a6ff5777161e942d8c0ebe692e185de551f15d98142bc59808c95981bf90d9fcaf4e61576232936da8158596a56e25eff79940172c9cca93bbc74
-  data.tar.gz: d309857b1a699cedc9f680f5d13220c8b0ab6b9079de499b9038f9b38fe92e4f627eb78bee3d3fab7c2c89aefdb0f149adb676974a40cb1eb61772083692a46f
+  metadata.gz: a72b7b5fb0d24365f359ce534b0c5feba903a8e534a994c509a0f2ff13fac449023990903e6f5dcd8ac85dc6bb2d358bddfd7f40c5f3f0058b2b16d79288bdf1
+  data.tar.gz: 126f94e0441ce1bbc4acbbc86488b4f0df19bfa537c2afaca0ec0b6dd1d51ae7eb3b06d3cfd8586a3b40364ff7c54370abba4a89cdf6c9220d39575c7ddc7cfd

data/Gemfile.lock

@@ -1,9 +1,8 @@
 PATH
   remote: .
   specs:
-    parallax (0.1.0)
+    parallax (0.1.1)
       activesupport
-      msgpack
 
 GEM
   remote: https://rubygems.org/
@@ -18,7 +17,6 @@ GEM
     i18n (1.1.1)
       concurrent-ruby (~> 1.0)
     minitest (5.11.3)
-    msgpack (1.2.4)
     rainbow (3.0.0)
     rake (10.5.0)
     rspec (3.8.0)

data/README.md

@@ -29,7 +29,7 @@ array = [ 'running', 'code', 'in', 'parallel' ]
 
 Parallax.execute array do |worker, array_chunk|
   array_chunk.each do |element|
-    worker.send :log, "[#{worker.index}] #{element}"
+    worker.log "[#{worker.index}] #{element}"
   end
 end
 
@@ -40,34 +40,31 @@ end
 #   [2] in
 ```
 
-If you need inter-process communication, this can be done by calling `worker.send` and passing a list of arguments. The args are serialized and passed via IO pipe to a `collector` object, which is by default an instance of `Parallax::Collector` class. The collector then parses the args and treats them like a method call where the first arg is the name of the method. In the example above, the collectors calls the `log` method which prints the second arg. Of course you can specify your own collector, as long as it responds to a `collect(*args)` method.
+If you need inter-process communication, this can be done by calling `worker.send` and passing a list of arguments. The args are serialized and passed via IO pipe to a `collector` object, which is by default an instance of `Parallax::Collector` class. The collector then parses the args and treats them like a method call where the first arg is the name of the method. In the example above, the collectors calls the `log` method which prints the second arg.
 
-```ruby
-class MyCollector
-  def receive(*args)
-    puts "Custom collector is receiving: #{args.inspect}"
-  end
-end
+The collector object is returned by the `Parallax.execute` method, so if you need to store each worker processed data you can use the `worker.store` method or implement it in your own custom collector. For example:
 
-array = [ 'running', 'code', 'in', 'parallel' ]
+```ruby
+numbers = (0..100).to_a
 
-Parallax.execute array, collector: MyCollector do |worker, array_chunk|
-  array_chunk.each do |element|
-    worker.send "[#{worker.index}] #{element}"
+collector = Parallax.execute numbers, do |worker, numbers_chunk|
+  numbers_chunk.each do |number|
+    worker.store number * 2
   end
 end
 
+puts collector.workers_data.inspect
+
 # Example output with 4 cores:
-#   Custom collector is receiving: ["[1] code"]
-#   Custom collector is receiving: ["[3] parallel"]
-#   Custom collector is receiving: ["[0] running"]
-#   Custom collector is receiving: ["[2] in"]
+#   [ [2018-12-04 08:22:06 +0100, 0, 0],
+#     [2018-12-04 08:22:06 +0100, 3, 152],
+#     [2018-12-04 08:22:06 +0100, 1, 52],
+#     [2018-12-04 08:22:06 +0100, 2, 102],
+#     ...
 ```
 
-The collector object is returned by the `Parallax.execute` method, so if you need to store each worker processed data you can use the `worker.store` method or implement it in your own custom collector.
-
 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).
+* `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).
 
 Methods available for a `worker` object, which are collected in the `collector` object:
 * `log(message)`: prints a message in stdout.

data/lib/parallax/collector.rb

@@ -14,8 +14,12 @@ module Parallax
       @workers_data = []
     end
 
-    def collect
-      worker_index, method, *arguments = eval(@receiving_stream.gets.chomp)
+    def receive
+      self.collect @receiving_stream.gets.chomp
+    end
+
+    def collect(message)
+      worker_index, method, *arguments = eval(message)
       self.send method, worker_index, *arguments
     end
 

data/lib/parallax/version.rb

@@ -1,3 +1,3 @@
 module Parallax
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/parallax.rb

@@ -35,7 +35,7 @@ module Parallax
       end
       
       until collector.all_workers_terminated?
-        collector.collect
+        collector.receive
       end
       collector.close
       collector

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parallax
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Francesco Ballardin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-12-03 00:00:00.000000000 Z
+date: 2018-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport