komodo 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in komodo.gemspec
+gemspec

data/README.markdown

@@ -0,0 +1,48 @@
+# Komodo
+
+Komodo is a simple wrapper for Delayed::Job that helps you autoscale workers when deployed on [Heroku](http://www.heroku.com). It came about for an upcoming project of [ours](http://www.involved.com.au), which only required the occasional background worker.
+
+__Please note:__ This is still very early days for Komodo, there's very little (read: zero) test coverage - and we've yet to even put it into production.
+
+# Configuration
+
+Setup delayed_job as per [the instructions](http://docs.heroku.com/delayed-job) on Heroku.
+
+Add Komodo to your Gemfile:
+
+	gem "komodo"
+
+Add a `/config/komodo.yml` file to your Rails 3 project directory and add the following:
+
+	defaults: &defaults
+	  max_workers: 1
+	  application_name: my_heroku_application
+	  username: email@myherokuapplication.com
+	  password: sekrit
+  
+	development:
+	  <<: *defaults
+
+	test:
+	  <<: *defaults
+
+	production:
+	  <<: *defaults
+	
+# Usage
+
+Komodo is set up to (try and) be as abstract as possible. Queuing a function works similar to delayed_job, just call:
+
+	Komodo.queue object, :function, [arg1, arg2]
+
+For example:
+	
+	Komodo.queue @image, :resize, {:width => 900, :height => 450}
+	# -- or --
+	Komodo.queue UserMailer.send_registration_notification(@user), :deliver
+
+Komodo will automatically add and remove workers as the queue fills up and empties, respectively.
+
+# Notes
+
+As stated above, this is really a pre-alpha of Komodo, as such the scaling is very basic; Komodo just ramps straight up to the user-configured maximum.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/komodo.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "komodo/version"
+
+Gem::Specification.new do |s|
+  s.name        = "komodo"
+  s.version     = Komodo::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Nicholas Bruning"]
+  s.email       = ["nicholas@bruning.com.au"]
+  s.homepage    = "http://github.com/thetron/komodo"
+  s.summary     = %q{Komodo helps you autoscale delayed_job workers on Heroku}
+  s.description = %q{Komodo is a simple wrapper that allows you to scale on-demand the number of delayed_job workers on Heroku, based on the length of your queue.}
+
+  s.rubyforge_project = "komodo"
+  
+  s.add_dependency 'heroku',        '~> 1.14.6'
+  s.add_dependency 'delayed_job',   '~> 2.1.2'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/komodo.rb

@@ -0,0 +1,34 @@
+class Komodo < Struct.new(:obj, :func, :args)  
+  # delayed_job wrapper, creates a new monitored job and queues it
+  def self.queue(obj, func, args = [])
+    Komodo.configure unless defined?(@@config)
+    Delayed::Job.enqueue MonitoredJob.new(obj, func, args)
+  end
+    
+  protected
+  # nothing of note here
+  def perform
+    obj.send(func, args)
+  end
+  
+  # adds a heroku worker, if required
+  def enqueue(job)
+    if Rails.env == "production" && Delayed::Job.count == 0
+      heroku = Heroku::Client.new(@@config['username'], @@config['password'])
+      heroku.set_workers(@@config['application_name'], @@config['max_workers'])
+    end
+  end
+  
+  # removes heroku workers if queue is empty, or falling below max_workers
+  def after(job)
+    if Rails.env == "production" && Delayed::Job.count == 0
+      heroku = Heroku::Client.new(@@config['username'], @@config['password'])
+      heroku.set_workers(@@config['application_name'], 0)
+    end
+  end
+  
+  private
+  def self.configure
+    @@config = YAML.load_file("#{Rails.root.to_s}/config/komodo.yml")[Rails.env]
+  end
+end

data/lib/komodo/version.rb

@@ -0,0 +1,3 @@
+module Komodo
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: komodo
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Nicholas Bruning
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-07 00:00:00 +11:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: heroku
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 35
+        segments: 
+        - 1
+        - 14
+        - 6
+        version: 1.14.6
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: delayed_job
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 1
+        - 2
+        version: 2.1.2
+  type: :runtime
+  version_requirements: *id002
+description: Komodo is a simple wrapper that allows you to scale on-demand the number of delayed_job workers on Heroku, based on the length of your queue.
+email: 
+- nicholas@bruning.com.au
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- komodo.gemspec
+- lib/komodo.rb
+- lib/komodo/version.rb
+has_rdoc: true
+homepage: http://github.com/thetron/komodo
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: komodo
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Komodo helps you autoscale delayed_job workers on Heroku
+test_files: []
+