cloudq_client 0.0.3 → 0.0.4

data/lib/cloudq/connection.rb

@@ -2,7 +2,15 @@ module Cloudq
   module Connection
     extend self
 
-    attr_accessor :url
+    def url
+      @url
+    end
+
+    def url=(uri)
+      raise "Bad URL" unless uri =~ /^http/
+      @url = uri
+    end
+
   end
 end
 

data/lib/cloudq/consume.rb

@@ -10,7 +10,7 @@ module Cloudq
   private
     def perform(a_job)
       klass = Object.const_get(a_job["klass"])
-      klass.perform(a_job["args"])
+      klass.perform(*a_job["args"])
     end
     
     def get(&block)

data/lib/cloudq/publish.rb

@@ -4,17 +4,21 @@ require 'json'
 module Cloudq
   class Publish < Base
     def job(klass, *args)
-      post(:job => { :klass => klass, :args => args} )
+      jsonized_job = jsonize(:job => { :klass => klass, :args => args})
+      post(jsonized_job)
     end
 
   private
-    def post(job)
+    def post(data)
       headers = {:content_type => :json, :accept => :json}
-      RestClient.post [Cloudq::Connection.url, @queue].join('/'), job, headers do |response|
+      RestClient.post [Cloudq::Connection.url, @queue].join('/'), data, headers do |response|
         JSON.parse(response)['status'] == 'success'
       end
     end
 
+    def jsonize(data)
+      data.to_json
+    end
 
   end
 end

data/lib/cloudq/version.rb

@@ -1,4 +1,4 @@
 module Cloudq
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end
 

data/lib/cloudq/worker.rb

@@ -0,0 +1,29 @@
+# Cloudq Client Worker
+
+# A Worker is a process that subscribes to a queue and
+# Processes Jobs from that queue
+#
+# This worker makes it super simple to subscribe to a queue
+
+# Cloudq::Worker.new(:queue1, :queue2, :queue3).run do
+#   print '.'
+#   sleep 2
+# end
+
+
+module Cloudq
+  class Worker
+    attr_accessor :queues
+
+    def initialize(*args)
+      @queues = args
+    end
+
+    def run(&block)
+      loop do
+        @queues.each { |q| Consume.new(q).job }
+        yield
+      end
+    end
+  end
+end

data/lib/cloudq.rb

@@ -5,4 +5,4 @@ require 'cloudq/connection'
 require 'cloudq/base'
 require 'cloudq/publish'
 require 'cloudq/consume'
-
+require 'cloudq/worker'

data/readme.md

@@ -1,56 +1,54 @@
 # Cloudq Client
 
-This is the Cloudq Client Gem, it has both the consumer and publisher
-modules.
+(In Development Mode)
 
-## The Job
+## What is it?
 
-The Job is the JSON message that is published to the queue server to be
-consumed by a worker.  The queue server can have one to many queues and
-you can create one to many workers.  With Cloudq you can have these
-workers all over the internet.  The Cloudq server is a rack application
-so you can do awesome things with rack middleware to add authentication,
-encryption, logging, etc.  All using Rack Middleware.
+Cloudq is a job queue system that allows you to publish or subscribe to queues
+anywhere in the cloud.  
 
-The job message is simple: (It is a json object )
+Cloudq_Client is a ruby implementation of the cloudq protocol that makes publishing jobs
+and consuming jobs in ruby, very easy.
 
-    { 'job': { 'klass': 'Archive', 'args': [1] }}
+For more information on the cloudq protocol see [http://cloudq.heroku.com](http://cloudq.heroku.com)
 
-Args can be a hash or array.
+## Requirements
 
-## The Consumer
+You need a cloudq job server, if you do not have a cloudq job server to connect to, then you 
+need to set one up.  If you do have a cloudq server, then for this client to work you need the
+following:
 
-The consumer will reserve a job from the queue then perform the job and
-delete it from the queue.
+* Ruby 1.9
+* RubyGems
 
-### Sample Consumer Worker
+And the Cloudq Gem depends on the rest-client gem, but it should install when you install the gem.
 
-    require 'cloudq/consume'
-    # You must require the files that have the Job you need to perform
+## Install
 
-    require 'donut/job'
+    gem install cloudq_client
 
-    Cloudq::Connection.url = 'http://donuts.com'
+## How do I publish a job?
 
-    loop do
-      Cloudq::Consume.new(:make_the_donuts).job
-      sleep 5
-    end 
-
-## The Publisher
-
-The publisher will create a job on the queue, the great thing about the
-publisher, is that it does not have to know the klass or the job that
-you want your worker to perform.  It just published the job on the
-queue.
+    require 'cloudq'
+    
+    Cloudq::Connection.url = 'http://your.cloudq.server'
+    
+    # Publish Job to a queue called - awesome
+    
+    Cloudq::Publish(:awesome).job 'Awesome', :type => 'Sauce'
+    
 
-### Sample Publisher
 
-    require 'cloudq/publish'
+## How do I create a worker?
 
-    Cloudq::Connection.url = 'http://donuts.com'
-
-    Cloudq::Publish.new(:make_donuts).job(:make_donuts, 'Bake', :type =>
-'glazed')
+    require 'cloudq'
+    
+    Cloudq::Connection.url = 'http://your.cloudq.server'
 
+    # Check Q every 5 seconds
+    Cloudq::Worker.new(:awesome).run do
+      print '.'
+      sleep 5
+    end
+      
 

metadata

@@ -2,7 +2,7 @@
 name: cloudq_client
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Tom Wilson
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-18 00:00:00 -04:00
+date: 2011-04-21 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -35,7 +35,7 @@ dependencies:
         version: 1.6.1
   type: :runtime
   version_requirements: *id002
-description: "The Cloudq will "
+description: "The Cloudq Client gem is an awesome client interface to the cloudq a remote job queue engine that allows you to publish jobs and subscribe from jobs anywhere in the cloud.... "
 email: 
 - tom@jackhq.com
 executables: []
@@ -50,6 +50,7 @@ files:
 - lib/cloudq/consume.rb
 - lib/cloudq/publish.rb
 - lib/cloudq/version.rb
+- lib/cloudq/worker.rb
 - lib/cloudq.rb
 - LICENSE
 - readme.md