peplum 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39d9ce50f924ae2ba75b9722feab0a00b40d7c18bca14fdfcfe823de5672ef4b
-  data.tar.gz: 995a13165a99b8dde616ce02fc878876e9ede71b70016f3f08928312cd969566
+  metadata.gz: a833d561020be57a98a105e264e6acd79ebe1a93b17de86e7bd3bb7f34bb88a4
+  data.tar.gz: f25b64342453bc340139bceea007d2baf8d95115afd5dc890be29413c3210405
 SHA512:
-  metadata.gz: 6f5eb468b00c381da6731f52295cce1636875ad4ba19df0494f2c8957e420cd4161599f65faccec22dd3e1238e1dacc2e18242ba4ecf216e5e3cb5686fe98c8a
-  data.tar.gz: bf11c45c00a5a2d1f028ac028060588448a2dbc342c133bf0ab7526c8fe09585f17eb2624897231b4bc06b40199b6b6fa24c937ec43cf30e2b12a9eee933da1f
+  metadata.gz: 0311c9ba56ad671e05146bdbc5449ce5d8c2c533a07e48a8de55e062813b7865624fc400e4fb9b955a156eabc0b16077bcf7ddca45cbf04e7fd3f002aed4bbdb
+  data.tar.gz: 3d9b8e8cc3a45a5f73a4466ecef138dfdd459b8655aeb679b54724881c64ab7873ffff9843226e5a0e61c6bcf1a4d06b3a95da56c022702795d988487a1fd08b

data/lib/peplum/application/payload.rb

@@ -0,0 +1,67 @@
+require 'peplum/core_ext/array'
+
+module Peplum
+class Application
+module Payload
+
+  class Error < Error
+    class ImplementationMissing < Error
+    end
+  end
+
+  # Run payload against `objects` based on given `options`
+  #
+  # @param  [Array] objects Objects that this worker should process.
+  # @param  [Hash, NilClass]  options Worker options.
+  # @abstract
+  def run( objects, options )
+    fail Error::ImplementationMissing, 'Missing implementation.'
+  end
+
+  # Distribute `objects` into `groups_of` amount of groups, one for each worker.
+  #
+  # @param  [Array] objects All objects that need to be processed.
+  # @param  [Integer] groups_of  Amount of object groups that should be generated.
+  #
+  # @return [Array<Array<Object>>]  `objects` split in `chunks` amount of groups.
+  def split( objects, groups_of )
+    objects.chunk groups_of
+  end
+
+  # Merge result `data` for reporting.
+  #
+  # By default provides a generic implementation that merges the values of `Hash`es and `Array`s.
+  # If `String`s or `Numeric`s are contained, the Array is returned as is.
+  #
+  # @param  [Array] data  Report data from workers.
+  # @return [Object]  Merged results.
+  #
+  # @raise  [Error::ImplementationMissing]  When the data cannot be handled.
+  def merge( data )
+    case data.first
+    when Hash
+        f = data.pop
+        data.each do |d|
+
+          if !f.is_a? Hash
+            fail Error::ImplementationMissing, 'Missing implementation: Item not a Hash!'
+          end
+
+          f.merge! d
+        end
+        f
+
+    when Array
+      data.flatten
+
+    when String, Numeric
+      data
+
+    else
+      fail Error::ImplementationMissing, 'Missing implementation.'
+    end
+  end
+
+end
+end
+end

data/lib/peplum/application.rb

@@ -1,10 +1,11 @@
 require 'cuboid'
 require 'json'
 require 'peplum'
-require 'peplum/core_ext/array'
 
 module Peplum
   class Application < Cuboid::Application
+    require 'peplum/application/payload'
+
     require 'peplum/application/services/shared_hash'
     require 'peplum/application/services/scheduler'
 
@@ -24,7 +25,10 @@ module Peplum
       end
     end
 
+    # @return   [Cuboid::RPC::Server::Instance::Peers]
     attr_reader :peers
+
+    # @return   [Cuboid::RPC::Client::Instance]
     attr_reader :master
 
     def initialize(*)
@@ -34,10 +38,6 @@ module Peplum
     end
 
     def run
-      Raktr.global.on_error do |_, e|
-        $stderr.puts e
-      end
-
       options = @options.dup
       peplum_options = options.delete( 'peplum' )
       payload_options = options.delete( 'payload' )
@@ -52,20 +52,22 @@ module Peplum
       end
     end
 
+    # @return [TrueClass, FalseClass] Are we a worker Instance?
     def worker?
       # Has a master?
       !!@master
     end
 
-    # Implements:
-    #   * `.run` -- Worker; executes its payload against `objects`.
-    #   * `.split` -- Splits given `objects` into groups for each worker.
-    #   * `.merge` -- Merges results from multiple workers.
+    # @return [#run, #split, #merge]
+    #
+    #   * `#run` -- Worker; executes its payload against `objects`.
+    #   * `#split` -- Scheduler; splits given `objects` into groups for each worker.
+    #   * `#merge` -- Scheduler; merges results from multiple workers.
     #
-    # That's all we need to turn any application into a super version of itself.
+    #   That's all we need to turn any application into a super version of itself.
     #
     # @abstract
-    def payload
+   def payload
       fail Error, 'Missing #payload!'
     end
 

data/lib/peplum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Peplum
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: peplum
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Tasos Laskos
@@ -34,6 +34,7 @@ files:
 - bin/.gitkeep
 - lib/peplum.rb
 - lib/peplum/application.rb
+- lib/peplum/application/payload.rb
 - lib/peplum/application/services/scheduler.rb
 - lib/peplum/application/services/shared_hash.rb
 - lib/peplum/core_ext/array.rb