divvy 1.0 → 1.1

data/README.md

@@ -18,7 +18,7 @@ and their associated storage components.
 
 This is a simple and contrived example of a divvy job script. You must define a
 class that includes the `Divvy::Parallelizable` module and implement the
-`#dispatch` and `#perform` methods. There are also hooks available for tapping
+`#dispatch` and `#process` methods. There are also hooks available for tapping
 into the worker process lifecycle.
 
 ``` ruby
@@ -38,7 +38,7 @@ class DanceParty
   # This is the main loop responsible for generating work items for worker
   # processes. It runs in the master process only. Each item yielded from this
   # method is marshalled over a pipe and distributed to the next available
-  # worker process where it arrives at the #perform method (see below).
+  # worker process where it arrives at the #process method (see below).
   #
   # In this example we're just going to generate a series of numbers to pass
   # to the workers. The workers just write the number out with their pid and the
@@ -59,7 +59,7 @@ class DanceParty
   # In this example we're given a Fixnum ticket number and asked to produce a
   # code. Pretend this is a network intense operation where you're mostly
   # sleeping waiting for a reply.
-  def perform(ticket_number)
+  def process(ticket_number)
     ticket_sha1 = Digest::SHA1.hexdigest(ticket_number.to_s)
     printf "%5d %6d %s\n" % [$$, ticket_number, ticket_sha1]
     sleep 0.150 # fake some latency

data/divvy.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = "divvy"
-  s.version     = "1.0"
+  s.version     = "1.1"
   s.platform    = Gem::Platform::RUBY
   s.authors     = %w[@rtomayko]
   s.email       = ["rtomayko@gmail.com"]

data/example.rb

@@ -14,7 +14,7 @@ class DanceParty
   # This is the main loop responsible for generating work items for worker
   # processes. It runs in the master process only. Each item yielded from this
   # method is marshalled over a pipe and distributed to the next available
-  # worker process where it arrives at the #perform method (see below).
+  # worker process where it arrives at the #process method (see below).
   #
   # In this example we're just going to generate a series of numbers to pass
   # to the workers. The workers just write the number out with their pid and the
@@ -35,7 +35,7 @@ class DanceParty
   # In this example we're given a Fixnum ticket number and asked to produce a
   # code. Pretend this is a network intense operation where you're mostly
   # sleeping waiting for a reply.
-  def perform(ticket_number)
+  def process(ticket_number)
     ticket_sha1 = Digest::SHA1.hexdigest(ticket_number.to_s)
     printf "%5d %6d %s\n" % [$$, ticket_number, ticket_sha1]
     sleep 0.150 # fake some latency

data/lib/divvy/parallelizable.rb

@@ -1,15 +1,15 @@
 module Divvy
   # Module defining the main task interface. Parallelizable classes must respond
-  # to #dispatch and #perform and may override hook methods to tap into the
+  # to #dispatch and #process and may override hook methods to tap into the
   # worker process lifecycle.
   module Parallelizable
     # The main loop responsible for generating task items to process in workers.
     # Runs in the master process only. Each item this method yields is distributed
-    # to one of a pool of worker processes where #perform (see below) is invoked
+    # to one of a pool of worker processes where #process (see below) is invoked
     # to process the task item.
     #
     # The arguments yielded to the block are passed with same arity to
-    # the #perform method. Only marshallable types may be included.
+    # the #process method. Only marshallable types may be included.
     #
     # The dispatch method takes no arguments. It's expected that the receiving
     # object is setup with all necessary state to generate task items or can
@@ -24,8 +24,8 @@ module Divvy
     # Process an individual task item. Each item produced by #dispatch is sent here
     # in one of a pool of the worker processes. The arguments to this method must
     # match the arity of the task item yielded from #dispatch.
-    def perform(*args)
-      raise NotImplementedError, "#{self.class} must implement perform method"
+    def process(*args)
+      raise NotImplementedError, "#{self.class} must implement process method"
     end
 
     # Hook called after a worker process is forked off from the master process.

data/lib/divvy/worker.rb

@@ -105,7 +105,7 @@ module Divvy
       @task.after_fork(self)
 
       while arguments = dequeue
-        @task.perform(*arguments)
+        @task.process(*arguments)
         break if @shutdown
       end
 

data/test/master_test.rb

@@ -10,7 +10,7 @@ class MasterTest < MiniTest::Unit::TestCase
       10.times(&block)
     end
 
-    def perform(num)
+    def process(num)
     end
   end
 
@@ -82,7 +82,7 @@ class MasterTest < MiniTest::Unit::TestCase
       yield 'just one thing'
     end
 
-    def perform(arg)
+    def process(arg)
       if arg != 'just one thing'
         fail "expected arg to be 'just one thing'"
       end
@@ -102,7 +102,7 @@ class MasterTest < MiniTest::Unit::TestCase
       10.times(&block)
     end
 
-    def perform(num)
+    def process(num)
       if num % 2 == 0
         fail "simulated failure"
       else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: divvy
 version: !ruby/object:Gem::Version
-  version: '1.0'
+  version: '1.1'
   prerelease: 
 platform: ruby
 authors: