activequeue 0.0.1

data/README.markdown

@@ -0,0 +1,28 @@
+ActiveQueue 
+======
+
+ActiveQueue is a Rails abstraction of queue configuration and background job creation/specification. 
+
+Queues and Background Job Runners are becoming as ubiquitous to Rails applications as Databases. Why not treat each of them as the same generic component, conforming to an interface and convention that is well understood. 
+
+Overview
+--------
+ActiveQueue allows you to create jobs and place them on whatever queue you have set as a requirement in
+environment.rb. The first cut of this gem only supports DelayedJob and Resque. Background jobs can be any Ruby class or module that responds to perform. Your existing classes can easily be converted to background jobs or you can create new classes specifically to do work. Or, you can do both.
+
+I place job classes withina Jobs module in models/jobs.rb and like so:
+
+module Jobs
+  class ExampleJob < Struct.new(:foo)
+    def perform
+      # perform magically delicious task
+    end
+  end
+end
+
+With ActiveQueue you can send any job to the configured queue like so
+
+ActiveQueue::Queue.enqueue(Jobs::ExampleJob,'bar')
+
+
+ 

data/lib/active_queue/adapters/delayed_job_adapter.rb

@@ -0,0 +1,15 @@
+
+module ActiveQueue::Adapters::DelayedJobAdapter
+    #Background jobs can be any Ruby class or module that responds to perform. 
+    #Your existing classes can easily be converted to background jobs or 
+    #you can create new classes specifically to do work. 
+    #Or, you can do both.
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    module ClassMethods
+      def enqueue(job_runner_klass, options = { })
+        Delayed::Job.enqueue(job_runner_klass.new(options))
+      end
+    end
+end

data/lib/active_queue/adapters/dummy_adapter.rb

@@ -0,0 +1,16 @@
+module ActiveQueue::Adapters::DummyAdapter
+  
+    #Background jobs can be any Ruby class or module that responds to perform. 
+    #Your existing classes can easily be converted to background jobs or 
+    #you can create new classes specifically to do work. 
+    #Or, you can do both.
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    module ClassMethods
+      def enqueue(job_runner_klass, options = { })
+        true
+      end
+    end
+
+end

data/lib/active_queue/adapters/resque_adapter.rb

@@ -0,0 +1,17 @@
+
+module ActiveQueue::Adapters::ResqueAdapter
+  
+    #Background jobs can be any Ruby class or module that responds to perform. 
+    #Your existing classes can easily be converted to background jobs or 
+    #you can create new classes specifically to do work. 
+    #Or, you can do both.
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    module ClassMethods
+      def enqueue(job_runner_klass, options = { })
+        Resque.enqueue(job_runner_klass, options)
+      end
+    end
+
+end

data/lib/active_queue/jobs.rb

@@ -0,0 +1,10 @@
+
+module Jobs
+  class ExampleJob < Struct.new(:foo)
+    def perform
+      true
+    end
+  end
+  
+  
+end

data/lib/activequeue.rb

@@ -0,0 +1,23 @@
+
+Dir[File.join(File.dirname(__FILE__), 'active_queue','*.rb')].each{|f| require f }
+
+module ActiveQueue
+  def self.adapters
+    ActiveQueue::Adapters
+  end
+  module Adapters
+    
+  end
+  Dir[File.join(File.dirname(__FILE__), 'active_queue', '*','*.rb')].each{|f| require f }
+  class Queue
+    
+    if defined? Resque
+      include ActiveQueue::Adapters::ResqueAdapter
+    elsif defined? Delayed
+      include ActiveQueue::Adapters::DelayedJobAdapter
+    else
+      include ActiveQueue::Adapters::DummyAdapter
+    end
+  end
+  
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'activequeue'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: activequeue
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matthew Jording
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-31 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Queues and Background Job Runners are becoming as ubiquitous to Rails applications as Databases. Why not treat each of them as the same generic component, conforming to an interface and convention that is well understood.
+email: mjording@opengotham.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- lib/active_queue/adapters/delayed_job_adapter.rb
+- lib/active_queue/adapters/dummy_adapter.rb
+- lib/active_queue/adapters/resque_adapter.rb
+- lib/active_queue/jobs.rb
+- lib/activequeue.rb
+- README.markdown
+has_rdoc: true
+homepage: http://github.com/opengotham/active_queue
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: ActiveQueue is a Rails abstraction of queue configuration and background job creation/specification.
+test_files: 
+- test/helper.rb