cloudq_client 0.0.3

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2011 Tom Wilson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/lib/cloudq.rb

@@ -0,0 +1,8 @@
+require 'rest-client'
+require 'json'
+
+require 'cloudq/connection'
+require 'cloudq/base'
+require 'cloudq/publish'
+require 'cloudq/consume'
+

data/lib/cloudq/base.rb

@@ -0,0 +1,9 @@
+module Cloudq
+  class Base
+    attr_accessor :queue
+
+    def initialize(queue = nil)
+      @queue = queue
+    end
+  end
+end

data/lib/cloudq/connection.rb

@@ -0,0 +1,8 @@
+module Cloudq
+  module Connection
+    extend self
+
+    attr_accessor :url
+  end
+end
+

data/lib/cloudq/consume.rb

@@ -0,0 +1,40 @@
+module Cloudq
+  class Consume < Base
+    def job
+      get do |a_job|
+        perform a_job
+        delete a_job["id"]
+      end
+    end
+
+  private
+    def perform(a_job)
+      klass = Object.const_get(a_job["klass"])
+      klass.perform(a_job["args"])
+    end
+    
+    def get(&block)
+      RestClient.get url do |response|
+        if response.code == 200
+          result = JSON.parse(response)
+          return nil if result['status'] == 'empty'
+          yield result
+          result
+        end
+      end
+    end
+
+    def delete(job_id)
+      RestClient.delete [url, job_id].join('/')
+    end
+
+    def url
+      [Cloudq::Connection.url, @queue].join('/')
+    end
+
+ 
+
+  end
+end
+
+    

data/lib/cloudq/publish.rb

@@ -0,0 +1,20 @@
+require 'rest-client'
+require 'json'
+
+module Cloudq
+  class Publish < Base
+    def job(klass, *args)
+      post(:job => { :klass => klass, :args => args} )
+    end
+
+  private
+    def post(job)
+      headers = {:content_type => :json, :accept => :json}
+      RestClient.post [Cloudq::Connection.url, @queue].join('/'), job, headers do |response|
+        JSON.parse(response)['status'] == 'success'
+      end
+    end
+
+
+  end
+end

data/lib/cloudq/version.rb

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

data/readme.md

@@ -0,0 +1,56 @@
+# Cloudq Client
+
+This is the Cloudq Client Gem, it has both the consumer and publisher
+modules.
+
+## The Job
+
+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.
+
+The job message is simple: (It is a json object )
+
+    { 'job': { 'klass': 'Archive', 'args': [1] }}
+
+Args can be a hash or array.
+
+## The Consumer
+
+The consumer will reserve a job from the queue then perform the job and
+delete it from the queue.
+
+### Sample Consumer Worker
+
+    require 'cloudq/consume'
+    # You must require the files that have the Job you need to perform
+
+    require 'donut/job'
+
+    Cloudq::Connection.url = 'http://donuts.com'
+
+    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.
+
+### Sample Publisher
+
+    require 'cloudq/publish'
+
+    Cloudq::Connection.url = 'http://donuts.com'
+
+    Cloudq::Publish.new(:make_donuts).job(:make_donuts, 'Bake', :type =>
+'glazed')
+
+

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: cloudq_client
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.3
+platform: ruby
+authors: 
+- Tom Wilson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-18 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.6.1
+  type: :runtime
+  version_requirements: *id002
+description: "The Cloudq will "
+email: 
+- tom@jackhq.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/cloudq/base.rb
+- lib/cloudq/connection.rb
+- lib/cloudq/consume.rb
+- lib/cloudq/publish.rb
+- lib/cloudq/version.rb
+- lib/cloudq.rb
+- LICENSE
+- readme.md
+has_rdoc: true
+homepage: http://github.com/twilson63/cloudq_client
+licenses: []
+
+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: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A Ruby Interface to the Cloudq
+test_files: []
+