activejob 0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ed055b7c1ce137d0b117867a22ba1ba004b74cbf
+  data.tar.gz: ea42dac65bcb13b4cc7b1897604c1f3b105c41ac
+SHA512:
+  metadata.gz: 14b4bf2e84d31918d860f075dcd556f494de8ef35e52ba4b864c3f7e5fbe9cd30470f89851b2d36a1a993a929de0c56b0693cac5833660b0d0393bfdcdc5eb97
+  data.tar.gz: cbf00f328f8149a6e52dc757c362cd46399b5931ef389e959a58b6e79c5e5581f75d2b4937cf3547cb8e4994e38674e9bf7dd65649f7ac25069da25eeb3e6851

data/CHANGELOG.md

@@ -0,0 +1 @@
+*  Started project.

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2014 David Heinemeier Hansson
+
+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/active_job.rb

@@ -0,0 +1,33 @@
+#--
+# Copyright (c) 2014 David Heinemeier Hansson
+#
+# 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.
+#++
+
+require 'active_support'
+require 'active_support/rails'
+
+require 'active_job/version'
+
+module ActiveJob
+  extend ActiveSupport::Autoload
+
+  autoload :Base
+end

data/lib/active_job/base.rb

@@ -0,0 +1,13 @@
+require 'active_job/queue_adapter'
+require 'active_job/queue_name'
+require 'active_job/enqueuing'
+require 'active_job/logging'
+
+module ActiveJob
+  class Base
+    extend QueueAdapter
+    extend QueueName
+    extend Enqueuing
+    extend Logging
+  end
+end

data/lib/active_job/enqueuing.rb

@@ -0,0 +1,18 @@
+require 'active_job/parameters'
+
+module ActiveJob
+  module Enqueuing
+    # Push a job onto the queue.  The arguments must be legal JSON types
+    # (string, int, float, nil, true, false, hash or array) or
+    # ActiveModel::GlobalIdentication instances.  Arbitrary Ruby objects
+    # are not supported.
+    #
+    # The return value is adapter-specific and may change in a future
+    # ActiveJob release.
+    def enqueue(*args)
+      serialized_args = Parameters.serialize(args)
+      ActiveSupport::Notifications.instrument "enqueue.active_job", adapter: queue_adapter, job: self, args: serialized_args
+      queue_adapter.queue self, *serialized_args
+    end
+  end
+end

data/lib/active_job/gem_version.rb

@@ -0,0 +1,15 @@
+module ActiveJob
+  # Returns the version of the currently loaded ActiveJob as a <tt>Gem::Version</tt>
+  def self.gem_version
+    Gem::Version.new VERSION::STRING
+  end
+
+  module VERSION
+    MAJOR = 4
+    MINOR = 2
+    TINY  = 0
+    PRE   = "alpha"
+
+    STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")
+  end
+end

data/lib/active_job/log_subscriber.rb

@@ -0,0 +1,19 @@
+require 'active_support/core_ext/string/filters'
+
+module ActiveJob
+  class LogSubscriber < ActiveSupport::LogSubscriber
+    def enqueue(event)
+      queue_name = event.payload[:adapter].name.demodulize.remove('Adapter')
+      job_name   = event.payload[:job].name      
+      args       = event.payload[:args].any? ? ": #{event.payload[:args].inspect}" : ""
+
+      info "Enqueued #{job_name} to #{queue_name}" + args
+    end
+
+    def logger
+      ActiveJob::Base.logger
+    end
+  end
+end
+
+ActiveJob::LogSubscriber.attach_to :active_job

data/lib/active_job/logging.rb

@@ -0,0 +1,7 @@
+require 'active_job/log_subscriber'
+
+module ActiveJob
+  module Logging
+    mattr_accessor(:logger) { ActiveSupport::Logger.new(STDOUT) }
+  end
+end

data/lib/active_job/parameters.rb

@@ -0,0 +1,19 @@
+require 'active_model/global_locator'
+require 'active_support/core_ext/object/try'
+
+module ActiveJob
+  class Parameters
+    TYPE_WHITELIST = [NilClass, Fixnum, Float, String, TrueClass, FalseClass, Hash, Array, Bignum]
+
+    def self.serialize(params)
+      params.collect do |param|
+        raise "Unsupported parameter type: #{param.class.name}" unless param.respond_to?(:global_id) || TYPE_WHITELIST.include?(param.class)
+        param.try(:global_id) || param
+      end
+    end
+
+    def self.deserialize(params)
+      params.collect { |param| ActiveModel::GlobalLocator.locate(param) || param }
+    end
+  end
+end

data/lib/active_job/queue_adapter.rb

@@ -0,0 +1,24 @@
+require 'active_job/queue_adapters/inline_adapter'
+require 'active_support/core_ext/string/inflections'
+
+module ActiveJob
+  module QueueAdapter
+    mattr_reader(:queue_adapter) { ActiveJob::QueueAdapters::InlineAdapter }
+
+    def queue_adapter=(name_or_adapter)
+      @@queue_adapter = \
+        case name_or_adapter
+        when Symbol, String
+          load_adapter(name_or_adapter)
+        when Class
+          name_or_adapter
+        end
+    end
+
+    private
+      def load_adapter(name)
+        require "active_job/queue_adapters/#{name}_adapter"
+        "ActiveJob::QueueAdapters::#{name.to_s.camelize}Adapter".constantize
+      end
+  end
+end

data/lib/active_job/queue_adapters/backburner_adapter.rb

@@ -0,0 +1,21 @@
+require 'backburner'
+
+module ActiveJob
+  module QueueAdapters
+    class BackburnerAdapter
+      class << self
+        def queue(job, *args)
+          Backburner::Worker.enqueue JobWrapper, [ job.name, *args ], queue: job.queue_name
+        end
+      end
+
+      class JobWrapper
+        class << self
+          def perform(job_name, *args)
+            job_name.constantize.new.perform *Parameters.deserialize(args)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/delayed_job_adapter.rb

@@ -0,0 +1,19 @@
+require 'delayed_job'
+
+module ActiveJob
+  module QueueAdapters
+    class DelayedJobAdapter
+      class << self
+        def queue(job, *args)
+          JobWrapper.new.delay(queue: job.queue_name).perform(job, *args)
+        end
+      end
+      
+      class JobWrapper
+        def perform(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/inline_adapter.rb

@@ -0,0 +1,11 @@
+module ActiveJob
+  module QueueAdapters
+    class InlineAdapter
+      class << self
+        def queue(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/que_adapter.rb

@@ -0,0 +1,19 @@
+require 'que'
+
+module ActiveJob
+  module QueueAdapters
+    class QueAdapter
+      class << self
+        def queue(job, *args)
+          JobWrapper.enqueue job, *args, queue: job.queue_name
+        end
+      end
+
+      class JobWrapper < Que::Job
+        def run(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/queue_classic_adapter.rb

@@ -0,0 +1,19 @@
+require 'queue_classic'
+
+module ActiveJob
+  module QueueAdapters
+    class QueueClassicAdapter
+      class << self
+        def queue(job, *args)
+          QC::Queue.new(job.queue_name).enqueue("#{JobWrapper.name}.perform", job, *args)
+        end
+      end
+
+      class JobWrapper
+        def self.perform(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/resque_adapter.rb

@@ -0,0 +1,31 @@
+require 'resque'
+require 'active_support/core_ext/enumerable'
+require 'active_support/core_ext/array/access'
+
+module ActiveJob
+  module QueueAdapters
+    class ResqueAdapter
+      class << self
+        def queue(job, *args)
+          Resque.enqueue JobWrapper.new(job), job, *args
+        end
+      end
+
+      class JobWrapper
+        class << self
+          def perform(job_name, *args)
+            job_name.constantize.new.perform *Parameters.deserialize(args)
+          end
+        end
+
+        def initialize(job)
+          @queue = job.queue_name
+        end
+
+        def to_s
+          self.class.name
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/sidekiq_adapter.rb

@@ -0,0 +1,25 @@
+require 'sidekiq'
+
+module ActiveJob
+  module QueueAdapters
+    class SidekiqAdapter
+      class << self
+        def queue(job, *args)
+          Sidekiq::Client.push \
+            'class' => JobWrapper,
+            'queue' => job.queue_name,
+            'args'  => [ job, *args ],
+            'retry' => true
+        end
+      end
+
+      class JobWrapper
+        include Sidekiq::Worker
+
+        def perform(job_name, *args)
+          job_name.constantize.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/sneakers_adapter.rb

@@ -0,0 +1,27 @@
+require 'sneakers'
+require 'thread'
+
+module ActiveJob
+  module QueueAdapters
+    class SneakersAdapter
+      @mutex = Mutex.new
+        
+      class << self
+        def queue(job, *args)
+          @mutex.synchronize do
+            JobWrapper.from_queue job.queue_name
+            JobWrapper.enqueue [ job, *args ]
+          end
+        end
+      end
+
+      class JobWrapper
+        include Sneakers::Worker
+
+        def work(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_adapters/sucker_punch_adapter.rb

@@ -0,0 +1,21 @@
+require 'sucker_punch'
+
+module ActiveJob
+  module QueueAdapters
+    class SuckerPunchAdapter
+      class << self
+        def queue(job, *args)
+          JobWrapper.new.async.perform(job, *args)
+        end
+      end
+
+      class JobWrapper
+        include SuckerPunch::Job
+
+        def perform(job, *args)
+          job.new.perform *Parameters.deserialize(args)
+        end
+      end
+    end
+  end
+end

data/lib/active_job/queue_name.rb

@@ -0,0 +1,10 @@
+module ActiveJob
+  module QueueName
+    mattr_accessor(:queue_base_name) { "active_jobs" }
+    mattr_accessor(:queue_name)      { queue_base_name }
+
+    def queue_as(part_name)
+      self.queue_name = "#{queue_base_name}_#{part_name}"
+    end
+  end
+end

data/lib/active_job/railitie.rb

@@ -0,0 +1,8 @@
+module ActiveJob
+  # = Active Job Railtie
+  class Railtie < Rails::Railtie # :nodoc:
+    initializer 'active_job.logger' do
+      ActiveSupport.on_load(:active_job) { self.logger ||= ::Rails.logger }
+    end
+  end
+end

data/lib/active_job/version.rb

@@ -0,0 +1,8 @@
+require_relative 'gem_version'
+
+module ActiveJob
+  # Returns the version of the currently loaded ActiveJob as a <tt>Gem::Version</tt>
+  def self.version
+    gem_version
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: activejob
+version: !ruby/object:Gem::Version
+  version: '0'
+platform: ruby
+authors:
+- David Heinemeier Hansson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+- !ruby/object:Gem::Dependency
+  name: activemodel-globalid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Declare job classes that can be run by a variety of queueing backends.
+email: david@loudthinking.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- lib/active_job.rb
+- lib/active_job/base.rb
+- lib/active_job/enqueuing.rb
+- lib/active_job/gem_version.rb
+- lib/active_job/log_subscriber.rb
+- lib/active_job/logging.rb
+- lib/active_job/parameters.rb
+- lib/active_job/queue_adapter.rb
+- lib/active_job/queue_adapters/backburner_adapter.rb
+- lib/active_job/queue_adapters/delayed_job_adapter.rb
+- lib/active_job/queue_adapters/inline_adapter.rb
+- lib/active_job/queue_adapters/que_adapter.rb
+- lib/active_job/queue_adapters/queue_classic_adapter.rb
+- lib/active_job/queue_adapters/resque_adapter.rb
+- lib/active_job/queue_adapters/sidekiq_adapter.rb
+- lib/active_job/queue_adapters/sneakers_adapter.rb
+- lib/active_job/queue_adapters/sucker_punch_adapter.rb
+- lib/active_job/queue_name.rb
+- lib/active_job/railitie.rb
+- lib/active_job/version.rb
+homepage: http://www.rubyonrails.org
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Job framework with pluggable queues (will be part of Rails).
+test_files: []
+has_rdoc: