resque-remote 0.0.1 → 0.1.0

data/Gemfile.lock

@@ -1,44 +1,45 @@
 PATH
   remote: .
   specs:
-    resque-remote (0.0.1)
+    resque-remote (0.1.0)
+      resque (< 1.18.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    diff-lcs (1.1.2)
-    json (1.4.6)
-    rack (1.2.1)
-    redis (2.0.5)
-    redis-namespace (0.8.0)
+    diff-lcs (1.1.3)
+    json (1.5.4)
+    rack (1.4.1)
+    rack-protection (1.2.0)
+      rack
+    redis (2.2.2)
+    redis-namespace (1.0.3)
       redis (< 3.0.0)
-    resque (1.10.0)
-      json (~> 1.4.6)
-      redis-namespace (~> 0.8.0)
+    resque (1.17.1)
+      json (>= 1.4.6, < 1.6)
+      redis-namespace (~> 1.0.2)
       sinatra (>= 0.9.2)
       vegas (~> 0.1.2)
-    rspec (2.0.0.beta.20)
-      rspec-core (= 2.0.0.beta.20)
-      rspec-expectations (= 2.0.0.beta.20)
-      rspec-mocks (= 2.0.0.beta.20)
-    rspec-core (2.0.0.beta.20)
-    rspec-expectations (2.0.0.beta.20)
-      diff-lcs (>= 1.1.2)
-    rspec-mocks (2.0.0.beta.20)
-    sinatra (1.0)
-      rack (>= 1.0)
-    vegas (0.1.7)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    tilt (1.3.3)
+    vegas (0.1.11)
       rack (>= 1.0.0)
-    yajl-ruby (0.7.7)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (= 1.0.0.rc.6)
-  redis
-  redis-namespace
-  resque (= 1.10.0)
+  bundler (~> 1.0)
   resque-remote!
-  rspec (= 2.0.0.beta.20)
-  yajl-ruby
+  rspec (~> 2.8)

data/README.md

@@ -0,0 +1,61 @@
+> **Please note that Resque Remote depends on Resque versions < 1.18.0. resque-remote is not necessary in Resque >= 1.18 as `Resque.enqueue_at` became a standard
+API method which does exactly what resque-remote aims to provide.**
+
+Resque Remote is a plugin to allow remote job droppability. Try saying that 10 times fast.
+
+Resque is great and so is queue-based job processing with redis. Resque Remote aims to provide you the ability to queue a job without having the processing class (e.g. the Job handler itself) loaded into memory. 
+
+Resque Remote's simple goal is to allow you to add a job to a queue with a string identifier for the class rather than the class constant. It is assumed that the worker-side of the equation _will_ have the class in memory and hence will be able to run it no problem. If this isn't the case, the worker will explode in a fiery ball. Probably getting some on you as a result.
+
+# Installation
+
+**Note: You must have a version of Resque installed or added to your Gemfile for Resque Remote to work. Resque Version 0.10.0 has been tested to work with the current release of Resque Remote.**
+
+Install the gem ad-hoc:
+
+	$ gem install resque -v 0.10.0
+	$ gem install resque-remote
+	
+Or, add it to your Bundler `Gemfile`:
+
+	# Gemfile
+	gem 'resque', '0.10.0'
+	gem 'resque-remote'
+	
+And then run a `bundle install`.
+	
+Without Bundler, in your appropriate config location for your app:
+
+	require 'resque'
+	require 'resque-remote'
+	
+If you're using bundler, just setup your gemset normally.
+
+# Usage
+
+## (De)Queueing
+To queue a job, tell resque to `remote_enqueue` your job by passing the string representation of your job's class name, the name of the queue to use, and whatever parameters are appropriate for the job.
+
+	Resque.remote_enqueue('MyJobClass', :low_priority, param1, param2, ...)
+	
+To dequeue, call `remote_dequeue` instead:
+
+	Resque.remote_dequeue('MyJobClass', :low_priority, param1, param2, ...)
+	
+## Worker processing
+
+Resque Remotes purpose is to make remote job processing doable. Hence, your workers won't be running the same application code that actually queued the job for you in the first place. So, assuming I queued the jobs from above, your separate application should have an implementing class that your workers have access to.
+
+Note that the queue this job belongs to isn't defined in our job class because it's metadata that Resque uses when it first queues the job, which we've already done. So, no `@queue = :low_priority` needed here.
+
+	class MyJobClass
+		# no queue needed
+		
+		def self.perform(param1, param2)
+			# ... process the job herre
+		end
+	end
+
+# Errata
+
+Feedback, comments and questions are welcome at bj [dot] neilsen [at] gmail [dot] com.

data/lib/resque-remote/version.rb

@@ -1,7 +1,7 @@
 module Resque
 	module Plugins
 	  module Remote
-	    VERSION = "0.0.1"
+	    VERSION = "0.1.0"
 	  end
 	end
 end

data/resque-remote.gemspec

@@ -10,6 +10,9 @@ Gem::Specification.new do |s|
   s.homepage    = 'http://github.com/localshred/resque-remote'
   s.summary     = 'Resque plugin to allow remote job droppability'
   s.description = %Q{
+Note: Resque-remote is not needed in resque >= 0.18 as `enqueue_at` became a standard
+API method which does exactly what resque-remote aims to provide.
+
 Resque is great. So is job processing with redis. Our biggest drawback has been that
 resque requires the class that will be processing a job to be loaded when the job 
 is enqueued. But what happens when the implementing job is defined in a separate application
@@ -27,12 +30,13 @@ Feedback, comments and questions are welcome at bj [dot] neilsen [at] gmail [dot
   s.required_rubygems_version = '>= 1.3.6'
   s.rubyforge_project         = 'resque-remote'
 
-  s.add_development_dependency 'bundler', '1.0.0.rc.6'
-  s.add_development_dependency 'rspec', '2.0.0.beta.20'
-  s.add_development_dependency 'resque', '1.10.0'
-  s.add_development_dependency 'redis'
-  s.add_development_dependency 'redis-namespace'
-  s.add_development_dependency 'yajl-ruby'
+  s.add_dependency 'resque', '< 1.18.0'
+  
+  s.add_development_dependency 'bundler', '~> 1.0'
+  s.add_development_dependency 'rspec', '~> 2.8'
+  # s.add_development_dependency 'redis'
+  # s.add_development_dependency 'redis-namespace'
+  # s.add_development_dependency 'yajl-ruby'
 
   s.files        = `git ls-files`.split("\n")
   s.require_path = 'lib'

metadata

@@ -1,132 +1,69 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: resque-remote
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 0
-  - 1
-  version: 0.0.1
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - BJ Neilsen
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-08-25 00:00:00 -06:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: bundler
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - "="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 0
-        - 0
-        - rc
-        - 6
-        version: 1.0.0.rc.6
-  type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rspec
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - "="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 0
-        - 0
-        - beta
-        - 20
-        version: 2.0.0.beta.20
-  type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
+date: 2012-02-06 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: resque
-  prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: &2153289880 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - "="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 10
-        - 0
-        version: 1.10.0
-  type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: redis
+    requirements:
+    - - <
+      - !ruby/object:Gem::Version
+        version: 1.18.0
+  type: :runtime
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *2153289880
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2153288740 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :development
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: redis-namespace
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: *2153288740
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153287300 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.8'
   type: :development
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  name: yajl-ruby
   prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
-  type: :development
-  version_requirements: *id006
-description: "\n\
-  Resque is great. So is job processing with redis. Our biggest drawback has been that\n\
-  resque requires the class that will be processing a job to be loaded when the job \n\
-  is enqueued. But what happens when the implementing job is defined in a separate application\n\
-  and isn't currently loaded into memory?\n\n\
-  Enter Resque Remote.\n\n\
-  Resque Remote's simple goal is to allow you to add a job to a queue with a string\n\
-  identifier for the class rather than the class constant. It is assumed that the worker-side of\n\
-  the equation _will_ have the class in memory and hence will be able to run it no problem.\n\n\
-  Feedback, comments and questions are welcome at bj [dot] neilsen [at] gmail [dot] com.\n"
-email: 
+  version_requirements: *2153287300
+description: ! "\nNote: Resque-remote is not needed in resque >= 0.18 as `enqueue_at`
+  became a standard\nAPI method which does exactly what resque-remote aims to provide.\n\nResque
+  is great. So is job processing with redis. Our biggest drawback has been that\nresque
+  requires the class that will be processing a job to be loaded when the job \nis
+  enqueued. But what happens when the implementing job is defined in a separate application\nand
+  isn't currently loaded into memory?\n\nEnter Resque Remote.\n\nResque Remote's simple
+  goal is to allow you to add a job to a queue with a string\nidentifier for the class
+  rather than the class constant. It is assumed that the worker-side of\nthe equation
+  _will_ have the class in memory and hence will be able to run it no problem.\n\nFeedback,
+  comments and questions are welcome at bj [dot] neilsen [at] gmail [dot] com.\n"
+email:
 - bj.neilsen@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - Gemfile
 - Gemfile.lock
+- README.md
 - Rakefile
 - lib/resque-remote.rb
 - lib/resque-remote/remote.rb
@@ -134,39 +71,29 @@ files:
 - resque-remote.gemspec
 - spec/remote_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
 homepage: http://github.com/localshred/resque-remote
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 1
-      - 3
-      - 6
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-
 rubyforge_project: resque-remote
-rubygems_version: 1.3.7
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Resque plugin to allow remote job droppability
 test_files: []
-
+has_rdoc: