message 0.0.1 → 0.0.2

data/README.md

@@ -1,5 +1,7 @@
 # Message
 
+https://travis-ci.org/xli/message.svg?branch=master
+
 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.
@@ -11,24 +13,41 @@ and you can easily swap in other queues later.
 ## Installation
 
 
+### Use AWS SQS as back-end queue system
+
+    gem 'message-sqs'
 
 ## How to use
 
 ### Queuing jobs
 
 
-Inspired by delayed_job API, call .enq.method(params) on any object and it will be processed in the background.
+Inspired by delayed_job API, call .async.method(params) on any object and it will be processed in the background.
 
     # without message
     @img.resize(36)
 
     # with message
-    @img.enq.resize(36)
+    @img.async.resize(36)
 
 ### Start worker to process jobs
 
     Message.worker.start
 
+### Change to synchronize mode
+
+    Message.worker.synch = true
+
+This is designed for test environment or Rails development environment.
+After set the synch option to true, the async jobs will be processed immediately when .async.method(params) is called.
+The default value is false.
+
+### Change default worker job name
+
+For some environment or queue system (e.g. AWS SQS), you will need set an application specific job name, so that you can share same account for multiple applications using Message.
+
+    Message.worker.default_job = "app-name-#{Rails.env}-message-default"
+
 ## Job interface specification
 
 Job = a queue + message processor

data/lib/message/worker.rb

@@ -18,38 +18,49 @@ module Message
           unless @obj.respond_to?(m)
             raise NoMethodError, "undefined method `#{m}' for #{@obj.inspect}"
           end
-          Worker.enq(@job, [@obj, m, args])
+          Message.worker(@job) << [@obj, m, args]
         end
       end
 
-      def enq(job=DEFAULT_JOB_NAME)
-        Enq.new(self, job)
+      def async(job=nil)
+        Enq.new(self, job || Message.worker.default_job)
       end
     end
 
     class << self
-      def jobs
-        @jobs ||= RUBY_PLATFORM =~ /java/ ? java.util.concurrent.ConcurrentHashMap.new : {}
+      attr_accessor :default_job, :synch
+
+      def default_job
+        @default_job ||= DEFAULT_JOB_NAME
       end
 
-      def job(name)
-        jobs[name] ||= Message.job(name, &job_processor)
+      def default
+        new(default_job)
       end
 
-      def enq(name, work)
-        job(name).enq(YAML.dump(work))
+      def process(*args)
+        default.process(*args)
       end
 
-      def job_processor
-        lambda do |msg|
-          obj, m, args = YAML.load(msg)
-          obj.send(m, *args)
-        end
+      def start(*args)
+        default.start(*args)
+      end
+
+      def jobs
+        @jobs ||= RUBY_PLATFORM =~ /java/ ? java.util.concurrent.ConcurrentHashMap.new : {}
+      end
+
+      def reset
+        @default_job = nil
+        @synch = nil
+        @jobs = nil
       end
     end
 
+    attr_reader :job_name
+
     def initialize(job_name)
-      @job_name = job_name || DEFAULT_JOB_NAME
+      @job_name = job_name
     end
 
     def start(size=10, interval=1)
@@ -68,10 +79,28 @@ module Message
     end
 
     def process(size=1)
-      Worker.job(@job_name).process(size)
+      job.process(size)
     end
 
+    def enq(work)
+      job.enq(YAML.dump(work)).tap do
+        process if self.class.synch
+      end
+    end
+    alias :<< :enq
+
     private
+    def job
+      self.class.jobs[@job_name] ||= Message.job(@job_name, &job_processor)
+    end
+
+    def job_processor
+      lambda do |msg|
+        obj, m, args = YAML.load(msg)
+        obj.send(m, *args)
+      end
+    end
+
     def log(level, &block)
       Message.logger.send(level) { "[Worker(#{Thread.current.object_id})] #{block.call}" }
     end

data/lib/message.rb

@@ -22,7 +22,11 @@ module Message
   end
 
   def worker(job=nil)
-    Worker.new(job)
+    if job
+      Worker.new(job)
+    else
+      Worker
+    end
   end
 
   def logger
@@ -36,6 +40,7 @@ module Message
   def reset
     Message.queue.reset
     Message.job.reset
+    Message.worker.reset
   end
 
   reset

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: message
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors: