message 0.0.8 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ee19d8a22b05ea1f808a9fa3bbdf502d11c48d1b
+  data.tar.gz: f2c79a4328536efc675c732beb8ad0d97a69450b
+SHA512:
+  metadata.gz: 45e79a88708e35ad52016f2af849c36365a9e2763617752bb6c696934f496abda8b16f4ce23d3653b60fa824c6eb11177c3f8d0444c220458831fd1a710ed904
+  data.tar.gz: 1a5263521182fd8d51f0d65b3dc6c828b2d3a7b9df48ad0568b7b08a1d929d81dcf4f8c3e21913e7bb21e3ecad8a8fd98cdb5542f6a7299e61957502af946b86

data/README.md

@@ -50,6 +50,14 @@ Add a rake task for start worker process
       end
     end
 
+To monitor worker thread events:
+
+   Message.worker.callbacks[:start] << lambda {|job_name, options| "start event with options" }
+   Message.worker.callbacks[:crash] << lambda {|job_name, e| "crash event with error" }
+   Message.worker.callbacks[:stop] << lambda {|job_name| "stop event" }
+
+By default, there are event log callbacks installed.
+
 ### Queuing jobs
 
 
@@ -96,4 +104,3 @@ For some environment or queue system (e.g. AWS SQS), you will need set an applic
 By change queue adapter:
 
     Message.queue.adapter = :sqs
-

data/lib/message/worker.rb

@@ -52,6 +52,10 @@ module Message
         @jobs ||= RUBY_PLATFORM =~ /java/ ? java.util.concurrent.ConcurrentHashMap.new : {}
       end
 
+      def callbacks
+        @callbacks ||= {:start => [], :crash => [], :stop => []}
+      end
+
       def reset
         @default_job = nil
         @sync = nil
@@ -59,6 +63,10 @@ module Message
       end
     end
 
+    callbacks[:start] << lambda {|job_name, options| Message.log(:info) { "[Worker] start in #{delay}" } }
+    callbacks[:crash] << lambda {|job_name, e| Message.log(:error) { "[Worker] crashed: #{e.message}\n#{e.backtrace.join("\n")}"} }
+    callbacks[:stop] << lambda {|job_name| Message.log(:info) { "[Worker] stopped" } }
+
     attr_reader :job_name
 
     def initialize(job_name)
@@ -66,22 +74,28 @@ module Message
     end
 
     def start(options={})
+      Thread.start do
+        self.work_in_thread(options) do |size|
+          process(size)
+        end
+      end
+    end
+
+    def work_in_thread(options, &block)
       size = options[:size] || DEFAULT_PROCESS_SIZE
       interval = options[:interval] || DEFAULT_PROCESS_INTERVAL
       delay = options[:delay] || 10 + rand(20)
-      Thread.start do
-        begin
-          Message.log(:info) { "[Worker] start in #{delay}" }
-          sleep delay
-          loop do
-            process(size)
-            sleep interval
-          end
-        rescue => e
-          Message.log(:error) { "[Worker] crashed: #{e.message}\n#{e.backtrace.join("\n")}"}
-        ensure
-          Message.log(:info) { "[Worker] stopped" }
+      begin
+        callback(:start, options)
+        sleep delay if delay > 0
+        loop do
+          yield(size)
+          sleep interval
         end
+      rescue => e
+        callback(:crash, e)
+      ensure
+        callback(:stop)
       end
     end
 
@@ -99,6 +113,12 @@ module Message
     alias :<< :enq
 
     private
+    def callback(name, *args)
+      self.class.callbacks[name].each do |c|
+        c.call(job_name, *args)
+      end
+    end
+
     def job
       self.class.jobs[@job_name] ||= Message.job(@job_name, &job_processor)
     end
@@ -114,4 +134,4 @@ module Message
       obj.send(m, *args)
     end
   end
-end
+end

metadata

@@ -1,29 +1,22 @@
 --- !ruby/object:Gem::Specification
 name: message
 version: !ruby/object:Gem::Version
-  version: 0.0.8
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - Xiao Li
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-27 00:00:00.000000000 Z
+date: 2015-05-28 00:00:00.000000000 Z
 dependencies: []
-description: ! 'Message provides flexible & reliable background/asynchronous job processing
-  mechanism on top of simple queue interface.
-
-
-  Any developer can create queue adapter for Message to hook up different messaging/queue
-  system.
+description: |
+  Message provides flexible & reliable background/asynchronous job processing mechanism on top of simple queue interface.
 
+  Any developer can create queue adapter for Message to hook up different messaging/queue system.
 
   One in-memory queue is included with Message for you to start development and test,
-
   and you can easily swap in other queues later.
-
-'
 email:
 - swing1979@gmail.com
 executables: []
@@ -31,38 +24,37 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- lib/message.rb
+- lib/message/filters.rb
 - lib/message/filters/benchmarking.rb
 - lib/message/filters/error_handling.rb
 - lib/message/filters/retry_on_error.rb
-- lib/message/filters.rb
 - lib/message/in_memory_queue.rb
 - lib/message/job.rb
 - lib/message/q.rb
 - lib/message/worker.rb
-- lib/message.rb
 homepage: https://github.com/xli/message
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Simplify Ruby messaging/queue/async/job processing.
 test_files: []