resque-queue-priority 0.5.0

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+*.DS_Store
+.bundle
+Gemfile.lock
+pkg/*
+.idea
+spec/dump.rdb
+spec/redis-server.log
+spec/redis.pid

data/CHANGELOG

@@ -0,0 +1,4 @@
+0.5.0
+-----
+
+Initial version

data/Gemfile

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

data/README.md

@@ -0,0 +1,41 @@
+A resque plugin for specifying the order a worker will prioritize queues in.
+
+Authored against Resque 1.17.1, so it at least works with that - try running the tests if you use a different version of resque
+
+Usage:
+
+Start your workers with a QUEUE that contains many queue names - this plugin is most useful when using '\*' or a plugin like resque-dynamic-queues.
+
+The queue priority web ui is shown as a tab in the resque-web UI, and allows you to define the queue priorities.  To activate it, you need to require 'resque-queue-priority-server' in whatever initializer you use to bring up resque-web.
+
+Then you should set use the web ui to determine the order a worker will pick a queue for processing.  The "Fairly" checkbox makes all queues that match that pattern get ordered in a random fashion (i.e. provides the same functionality as resque-fairly).
+
+For example, say my resque system has the queues:
+
+low_foo, low_bar, low_baz, high_foo, high_bar, high_baz, otherqueue, somequeue, myqueue
+
+And I run my worker with QUEUE=\* (Note Resque wildcarding sorts queues)
+
+If I set my patterns like:
+
+high\_\* (fairly unchecked)  
+default (fairly unchecked)  
+low\_\* (fairly unchecked)  
+
+Then, the worker will scan the queues for work in this order:
+high_bar, high_baz, high_foo, myqueue, otherqueue, somequeue, low_bar, low_baz, low_foo
+
+If I set my patterns like:
+
+high\_\* (fairly checked)  
+default (fairly checked)  
+low\_\* (fairly checked)  
+
+Then, the worker will scan the queues for work in this order:
+
+\*[high_bar, high_baz, high_foo].shuffle, \*[myqueue, otherqueue, somequeue].shuffle, \*[low_bar, low_baz, low_foo].shuffle
+
+
+Contributors:
+
+Matt Conway ( https://github.com/wr0ngway )

data/Rakefile

@@ -0,0 +1,67 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task :my_release => ['changelog', 'release'] do
+end
+
+task :changelog do
+
+  helper = Bundler::GemHelper.new(Dir.pwd)
+  version = "v#{helper.gemspec.version}"
+
+  changelog_file = 'CHANGELOG'
+  entries = ""
+
+  # Get a list of current tags
+  tags = `git tag -l`.split
+  tags = tags.sort_by {|t| t[1..-1].split(".").collect {|s| s.to_i } }
+  newest_tag = tags[-1]
+  
+  if version == newest_tag
+    puts "You need to update version, same as most recent tag: #{version}"
+    exit
+  end
+
+  # If we already have a changelog, make the last tag be the
+  # last one in the changelog, and the next one be the one
+  # following that in the tag list
+  newest_changelog_version = nil
+  if File.exist?(changelog_file)
+    entries = File.read(changelog_file)
+    head = entries.split.first
+    if head =~ /\d\.\d\.\d/
+      newest_changelog_version = "v#{head}"
+
+      if version == newest_changelog_version
+        puts "You need to update version, same as most recent changelog: #{version}"
+        exit
+      end
+
+    end
+  end
+
+  # Generate changelog from repo
+  log=`git log --pretty='format:%s <%h> [%cn]' #{newest_tag}..HEAD`
+
+  # Strip out maintenance entries
+  log = log.lines.to_a.delete_if do |l|
+     l =~ /^Regenerated? gemspec/ ||
+         l =~ /^version bump/i ||
+         l =~ /^Updated changelog/ ||
+         l =~ /^Merged? branch/
+  end
+
+  # Write out changelog file
+  File.open(changelog_file, 'w') do |out|
+    out.puts version.gsub(/^v/, '')
+    out.puts "-----"
+    out.puts "\n"
+    out.puts log
+    out.puts "\n"
+    out.puts entries
+  end
+
+  # Commit and push
+  sh "git ci -m'Updated changelog' #{changelog_file}"
+  sh "git push"
+end

data/config.ru

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+require 'logger'
+
+$LOAD_PATH.unshift ::File.expand_path(::File.dirname(__FILE__) + '/lib')
+require 'resque/server'
+require 'resque-queue-priority-server'
+
+use Rack::ShowExceptions
+run Resque::Server.new

data/lib/resque-queue-priority-server.rb

@@ -0,0 +1,4 @@
+require 'resque-queue-priority'
+require 'resque/plugins/queue_priority/server'
+
+Resque::Server.register Resque::Plugins::QueuePriority::Server

data/lib/resque-queue-priority.rb

@@ -0,0 +1,8 @@
+require 'resque'
+require 'resque/worker'
+require 'resque/plugins/queue_priority/version'
+require 'resque/plugins/queue_priority/attributes'
+require 'resque/plugins/queue_priority/priority'
+
+Resque.send(:extend, Resque::Plugins::QueuePriority::Attributes)
+Resque::Worker.send(:include, Resque::Plugins::QueuePriority::Priority)

data/lib/resque/plugins/queue_priority/attributes.rb

@@ -0,0 +1,28 @@
+module Resque
+  module Plugins
+    module QueuePriority
+
+      PRIORITY_KEY = "queue_priority"
+
+      module Attributes
+
+        def priority_buckets
+          priorities = Array(redis.lrange(PRIORITY_KEY, 0, -1))
+          priorities = priorities.collect {|p| Resque.decode(p) }
+          priorities << {'pattern' => 'default'} unless priorities.find {|b| b['pattern'] == 'default' }
+          return priorities
+        end
+
+        def priority_buckets=(data)
+          redis.multi do
+            redis.del(PRIORITY_KEY)
+            Array(data).each do |v|
+               redis.rpush(PRIORITY_KEY, Resque.encode(v))
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/resque/plugins/queue_priority/priority.rb

@@ -0,0 +1,56 @@
+require 'resque/worker'
+
+module Resque
+  module Plugins
+    module QueuePriority
+
+      module Priority
+
+        def self.included(klass)
+          klass.instance_eval do
+            alias_method :queues_without_priority, :queues
+            alias_method :queues, :queues_with_priority
+          end
+        end
+
+        def queues_with_priority
+          all_queues = queues_without_priority
+          result = []
+          default_idx = -1, default_fairly = false;
+
+          # Walk the priority patterns, extract each into its own bucket
+          buckets = Resque.priority_buckets
+          buckets.each do |bucket|
+            bucket_pattern = bucket['pattern']
+            fairly = bucket['fairly']
+
+            # note the position of the default bucket for inserting the remaining queues at that location
+            if bucket_pattern == 'default'
+              default_idx = result.size
+              default_fairly = fairly
+              next
+            end
+
+            patstr = bucket_pattern.gsub(/\*/, ".*")
+            pattern = /^#{patstr}$/
+            bucket_queues, remaining = all_queues.partition {|q| q =~ pattern }
+
+            bucket_queues.shuffle! if fairly
+            all_queues = remaining
+
+            result << bucket_queues
+          end
+
+          # insert the remaining queues at the position the default item was at (or last)
+          all_queues.shuffle! if default_fairly
+          result.insert(default_idx, all_queues)
+          result.flatten!
+
+          return result
+        end
+
+      end
+
+    end
+  end
+end

data/lib/resque/plugins/queue_priority/server.rb

@@ -0,0 +1,37 @@
+require 'resque-queue-priority'
+
+module Resque
+  module Plugins
+    module QueuePriority
+
+      module Server
+
+        VIEW_PATH = File.join(File.dirname(__FILE__), 'server', 'views')
+
+        def self.registered(app)
+
+          app.get "/queuepriority" do
+            @priorities = Resque.priority_buckets
+            plugin_view :priorities
+          end
+
+          app.post "/queuepriority" do
+            priorities = params['priorities']
+            Resque.priority_buckets = priorities
+            redirect url(:queuepriority)
+          end
+
+          app.helpers do
+            def plugin_view(filename, options = {}, locals = {})
+              erb(File.read(File.join(::Resque::Plugins::QueuePriority::Server::VIEW_PATH, "#{filename}.erb")), options, locals)
+            end
+          end
+
+          app.tabs << "QueuePriority"
+        end
+
+      end
+
+    end
+  end
+end

data/lib/resque/plugins/queue_priority/server/views/priorities.erb

@@ -0,0 +1,65 @@
+<h1>Dynamic Queues</h1>
+<p class="intro">
+  The list below orders queue name patterns by the priority you wish them to be executed in.  The "Fairly" option allows you to indicate you want the queues within that pattern space be selected in a fair (random) manner, i.e. like resque-fairly.  The 'default' pattern must always exist, and matches against all queues that aren't in any of the other patterns.
+</p>
+
+<form action="/queuepriority" method="POST" style="float:none; margin-top:10px">
+
+  <table class="priorities">
+    <tr>
+      <th>Pattern</th>
+      <th>Fairly</th>
+      <th></th>
+    </tr>
+    <% @priorities.each_with_index do |priority, i| %>
+      <tr class="line">
+        <td><input type="text" id="input-<%= i %>-pattern" name="priorities[][pattern]" value="<%= priority["pattern"] %>" /></td>
+        <td><input type="checkbox" id="input-<%= i %>-fairly" name="priorities[][fairly]" value="true" <%= "checked" if priority["fairly"] %> /></td>
+        <td>
+          <a href="#up" class="up">Up</a> |
+          <a href="#down" class="down">Down</a> |
+          <a href="#remove" class="remove">Remove</a>
+        </td>
+      </tr>
+    <% end %>
+  </table>
+
+  <a href="#add" class="add">Add</a>
+  <input type="submit" value="Save"/>
+
+</form>
+
+<script type="text/javascript" charset="utf-8">
+  jQuery(function($) {
+
+    $("a.add").click(function(e) {
+      e.preventDefault();
+      var $table = $("table.priorities");
+      var $newRow = $table.find("tr.line:first").clone();
+      $newRow.find("input[type=text]").attr("value", "");
+      $newRow.find("input[type=checkbox]").attr("checked", false);
+      $newRow.appendTo($table);
+    });
+
+    $("a.remove").click(function(e) {
+      e.preventDefault();
+      var $link = $(this);
+      $link.parents("tr").remove();
+    });
+
+    $("a.up").click(function(e) {
+      e.preventDefault();
+      var $link = $(this);
+      var $row = $link.parents("tr");
+      $row.prev(".line").before($row);
+    });
+
+    $("a.down").click(function(e) {
+      e.preventDefault();
+      var $link = $(this);
+      var $row = $link.parents("tr");
+      $row.next(".line").after($row);
+    });
+
+  });
+</script>

data/lib/resque/plugins/queue_priority/version.rb

@@ -0,0 +1,7 @@
+module Resque
+  module Plugins
+    module QueuePriority
+      VERSION = "0.5.0"
+    end
+  end
+end

data/resque-queue-priority.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'resque/plugins/queue_priority/version'
+
+
+Gem::Specification.new do |s|
+  s.name        = "resque-queue-priority"
+  s.version     = Resque::Plugins::QueuePriority::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Matt Conway"]
+  s.email       = ["matt@conwaysplace.com"]
+  s.homepage    = "http://github.com/wr0ngway/resque-queue-priority"
+  s.summary     = %q{A resque plugin for specifying the priority between queues that workers use to determine what to work on next}
+  s.description = %q{A resque plugin for specifying the priority between queues that workers use to determine what to work on next}
+
+  s.rubyforge_project = "resque-queue-priority"
+
+  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"]
+
+  s.add_dependency("resque", '~> 1.10')
+  s.add_development_dependency('rake')
+  s.add_development_dependency('rspec', '~> 2.5')
+  s.add_development_dependency('rack-test', '~> 0.5.4')
+
+end
+

data/spec/priority_spec.rb

@@ -0,0 +1,167 @@
+require "spec_helper"
+
+describe "Queue Priority" do
+
+  before(:each) do
+    Resque.redis.flushall
+  end
+
+  context "basic resque behavior still works" do
+
+    it "can work on multiple queues" do
+      Resque::Job.create(:high, SomeJob)
+      Resque::Job.create(:critical, SomeJob)
+
+      worker = Resque::Worker.new(:critical, :high)
+
+      worker.process
+      Resque.size(:high).should == 1
+      Resque.size(:critical).should == 0
+
+      worker.process
+      Resque.size(:high).should == 0
+    end
+
+    it "can work on all queues" do
+      Resque::Job.create(:high, SomeJob)
+      Resque::Job.create(:critical, SomeJob)
+      Resque::Job.create(:blahblah, SomeJob)
+
+      worker = Resque::Worker.new("*")
+
+      worker.work(0)
+      Resque.size(:high).should == 0
+      Resque.size(:critical).should == 0
+      Resque.size(:blahblah).should == 0
+    end
+
+    it "processes * queues in alphabetical order" do
+      Resque::Job.create(:high, SomeJob)
+      Resque::Job.create(:critical, SomeJob)
+      Resque::Job.create(:blahblah, SomeJob)
+
+      worker = Resque::Worker.new("*")
+
+      worker.work(0) do |job|
+        Resque.redis.rpush("processed_queues", job.queue)
+      end
+
+      Resque.redis.lrange("processed_queues", 0, -1).should == %w( high critical blahblah ).sort
+    end
+
+    it "should pass lint" do
+      Resque::Plugin.lint(Resque::Plugins::QueuePriority)
+    end
+
+  end
+
+  context "queue patterns" do
+
+    before(:each) do
+      Resque.watch_queue("high_x")
+      Resque.watch_queue("foo")
+      Resque.watch_queue("high_y")
+      Resque.watch_queue("superhigh_z")
+    end
+
+    it "can specify simple queues" do
+      worker = Resque::Worker.new("foo")
+      worker.queues.should == ["foo"]
+
+      worker = Resque::Worker.new("foo", "bar")
+      worker.queues.should == ["foo", "bar"]
+    end
+
+    it "can specify simple wildcard" do
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["foo", "high_x", "high_y", "superhigh_z"]
+    end
+
+    it "should pick up all queues with default priority" do
+      Resque.priority_buckets = [{'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["foo", "high_x", "high_y", "superhigh_z"]
+    end
+
+    it "should pick up all queues fairly" do
+      Resque.priority_buckets = [{'pattern' => 'default', 'fairly' => true}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should_not == ["foo", "high_x", "high_y", "superhigh_z"]
+      worker.queues.sort.should == ["foo", "high_x", "high_y", "superhigh_z"]
+    end
+
+    it "should prioritize simple pattern" do
+      Resque.priority_buckets = [{'pattern' => 'superhigh_z', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["superhigh_z", "foo", "high_x", "high_y"]
+    end
+
+    it "should prioritize multiple simple patterns" do
+      Resque.priority_buckets = [{'pattern' => 'superhigh_z', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false},
+                                 {'pattern' => 'foo', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["superhigh_z", "high_x", "high_y", "foo"]
+    end
+
+    it "should prioritize simple wildcard pattern" do
+      Resque.priority_buckets = [{'pattern' => 'high*', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["high_x", "high_y", "foo", "superhigh_z"]
+    end
+
+    it "should prioritize fully inclusive wildcard pattern" do
+      Resque.priority_buckets = [{'pattern' => '*high*', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["high_x", "high_y", "superhigh_z", "foo"]
+    end
+
+    it "should handle empty default match" do
+      Resque.priority_buckets = [{'pattern' => '*', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.should == ["foo", "high_x", "high_y", "superhigh_z"]
+    end
+
+    it "should pickup wildcard queues fairly" do
+      others = 5.times.collect {|i| "other#{i}" }
+      others.map {|o| Resque.watch_queue(o)}
+
+      Resque.priority_buckets = [{'pattern' => 'other*', 'fairly' => true},
+                                 {'pattern' => 'default', 'fairly' => false}]
+      worker = Resque::Worker.new("*")
+      worker.queues.size
+      worker.queues[0..4].sort.should == others.sort
+      worker.queues[5..-1].should == ["foo", "high_x", "high_y", "superhigh_z"]
+      worker.queues.should_not == others.sort + ["foo", "high_x", "high_y", "superhigh_z"]
+    end
+
+  end
+
+  context "queue priority accessors" do
+
+    it "can lookup a default priority" do
+      Resque.priority_buckets.should == [{'pattern' => 'default'}]
+    end
+
+    it "can set priorities" do
+      Resque.priority_buckets = [{'pattern' => 'foo', 'fairly' => 'false'}]
+      Resque.priority_buckets.should == [{'pattern' => 'foo', 'fairly' => 'false'},
+                                         {'pattern' => 'default'}]
+    end
+
+    it "can set priorities including default" do
+      Resque.priority_buckets = [{'pattern' => 'foo', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false},
+                                 {'pattern' => 'bar', 'fairly' => true}]
+      Resque.priority_buckets.should == [{'pattern' => 'foo', 'fairly' => false},
+                                         {'pattern' => 'default', 'fairly' => false},
+                                         {'pattern' => 'bar', 'fairly' => true}]
+    end
+
+  end
+
+end

data/spec/redis-test.conf

@@ -0,0 +1,312 @@
+# Redis configuration file example
+
+# Note on units: when memory size is needed, it is possible to specifiy
+# it in the usual form of 1k 5GB 4M and so forth:
+#
+# 1k => 1000 bytes
+# 1kb => 1024 bytes
+# 1m => 1000000 bytes
+# 1mb => 1024*1024 bytes
+# 1g => 1000000000 bytes
+# 1gb => 1024*1024*1024 bytes
+#
+# units are case insensitive so 1GB 1Gb 1gB are all the same.
+
+# By default Redis does not run as a daemon. Use 'yes' if you need it.
+# Note that Redis will write a pid file in ./tmp/run/redis.pid when daemonized.
+daemonize yes
+
+# When running daemonized, Redis writes a pid file in ./tmp/run/redis.pid by
+# default. You can specify a custom pid file location here.
+pidfile ./redis.pid
+
+# Accept connections on the specified port, default is 6379
+port 9736
+
+# If you want you can bind a single interface, if the bind option is not
+# specified all the interfaces will listen for incoming connections.
+#
+bind 127.0.0.1
+
+# Close the connection after a client is idle for N seconds (0 to disable)
+timeout 300
+
+# Set server verbosity to 'debug'
+# it can be one of:
+# debug (a lot of information, useful for development/testing)
+# verbose (many rarely useful info, but not a mess like the debug level)
+# notice (moderately verbose, what you want in production probably)
+# warning (only very important / critical messages are logged)
+loglevel verbose
+
+# Specify the log file name. Also 'stdout' can be used to force
+# Redis to log on the standard output. Note that if you use standard
+# output for logging but daemonize, logs will be sent to /dev/null
+logfile ./redis-server.log
+
+# Set the number of databases. The default database is DB 0, you can select
+# a different one on a per-connection basis using SELECT <dbid> where
+# dbid is a number between 0 and 'databases'-1
+databases 16
+
+################################ SNAPSHOTTING  #################################
+#
+# Save the DB on disk:
+#
+#   save <seconds> <changes>
+#
+#   Will save the DB if both the given number of seconds and the given
+#   number of write operations against the DB occurred.
+#
+#   In the example below the behaviour will be to save:
+#   after 900 sec (15 min) if at least 1 key changed
+#   after 300 sec (5 min) if at least 10 keys changed
+#   after 60 sec if at least 10000 keys changed
+#
+#   Note: you can disable saving at all commenting all the "save" lines.
+
+save 900 1
+save 300 10
+save 60 10000
+
+# Compress string objects using LZF when dump .rdb databases?
+# For default that's set to 'yes' as it's almost always a win.
+# If you want to save some CPU in the saving child set it to 'no' but
+# the dataset will likely be bigger if you have compressible values or keys.
+rdbcompression yes
+
+# The filename where to dump the DB
+dbfilename dump.rdb
+
+# The working directory.
+#
+# The DB will be written inside this directory, with the filename specified
+# above using the 'dbfilename' configuration directive.
+# 
+# Also the Append Only File will be created inside this directory.
+# 
+# Note that you must specify a directory here, not a file name.
+dir .
+
+################################# REPLICATION #################################
+
+# Master-Slave replication. Use slaveof to make a Redis instance a copy of
+# another Redis server. Note that the configuration is local to the slave
+# so for example it is possible to configure the slave to save the DB with a
+# different interval, or to listen to another port, and so on.
+#
+# slaveof <masterip> <masterport>
+
+# If the master is password protected (using the "requirepass" configuration
+# directive below) it is possible to tell the slave to authenticate before
+# starting the replication synchronization process, otherwise the master will
+# refuse the slave request.
+#
+# masterauth <master-password>
+
+################################## SECURITY ###################################
+
+# Require clients to issue AUTH <PASSWORD> before processing any other
+# commands.  This might be useful in environments in which you do not trust
+# others with access to the host running redis-server.
+#
+# This should stay commented out for backward compatibility and because most
+# people do not need auth (e.g. they run their own servers).
+# 
+# Warning: since Redis is pretty fast an outside user can try up to
+# 150k passwords per second against a good box. This means that you should
+# use a very strong password otherwise it will be very easy to break.
+#
+# requirepass foobared
+
+################################### LIMITS ####################################
+
+# Set the max number of connected clients at the same time. By default there
+# is no limit, and it's up to the number of file descriptors the Redis process
+# is able to open. The special value '0' means no limits.
+# Once the limit is reached Redis will close all the new connections sending
+# an error 'max number of clients reached'.
+#
+# maxclients 128
+
+# Don't use more memory than the specified amount of bytes.
+# When the memory limit is reached Redis will try to remove keys with an
+# EXPIRE set. It will try to start freeing keys that are going to expire
+# in little time and preserve keys with a longer time to live.
+# Redis will also try to remove objects from free lists if possible.
+#
+# If all this fails, Redis will start to reply with errors to commands
+# that will use more memory, like SET, LPUSH, and so on, and will continue
+# to reply to most read-only commands like GET.
+#
+# WARNING: maxmemory can be a good idea mainly if you want to use Redis as a
+# 'state' server or cache, not as a real DB. When Redis is used as a real
+# database the memory usage will grow over the weeks, it will be obvious if
+# it is going to use too much memory in the long run, and you'll have the time
+# to upgrade. With maxmemory after the limit is reached you'll start to get
+# errors for write operations, and this may even lead to DB inconsistency.
+#
+# maxmemory <bytes>
+
+############################## APPEND ONLY MODE ###############################
+
+# By default Redis asynchronously dumps the dataset on disk. If you can live
+# with the idea that the latest records will be lost if something like a crash
+# happens this is the preferred way to run Redis. If instead you care a lot
+# about your data and don't want to that a single record can get lost you should
+# enable the append only mode: when this mode is enabled Redis will append
+# every write operation received in the file appendonly.aof. This file will
+# be read on startup in order to rebuild the full dataset in memory.
+#
+# Note that you can have both the async dumps and the append only file if you
+# like (you have to comment the "save" statements above to disable the dumps).
+# Still if append only mode is enabled Redis will load the data from the
+# log file at startup ignoring the dump.rdb file.
+#
+# IMPORTANT: Check the BGREWRITEAOF to check how to rewrite the append
+# log file in background when it gets too big.
+
+appendonly no
+
+# The name of the append only file (default: "appendonly.aof")
+# appendfilename appendonly.aof
+
+# The fsync() call tells the Operating System to actually write data on disk
+# instead to wait for more data in the output buffer. Some OS will really flush 
+# data on disk, some other OS will just try to do it ASAP.
+#
+# Redis supports three different modes:
+#
+# no: don't fsync, just let the OS flush the data when it wants. Faster.
+# always: fsync after every write to the append only log . Slow, Safest.
+# everysec: fsync only if one second passed since the last fsync. Compromise.
+#
+# The default is "everysec" that's usually the right compromise between
+# speed and data safety. It's up to you to understand if you can relax this to
+# "no" that will will let the operating system flush the output buffer when
+# it wants, for better performances (but if you can live with the idea of
+# some data loss consider the default persistence mode that's snapshotting),
+# or on the contrary, use "always" that's very slow but a bit safer than
+# everysec.
+#
+# If unsure, use "everysec".
+
+# appendfsync always
+appendfsync everysec
+# appendfsync no
+
+################################ VIRTUAL MEMORY ###############################
+
+# Virtual Memory allows Redis to work with datasets bigger than the actual
+# amount of RAM needed to hold the whole dataset in memory.
+# In order to do so very used keys are taken in memory while the other keys
+# are swapped into a swap file, similarly to what operating systems do
+# with memory pages.
+#
+# To enable VM just set 'vm-enabled' to yes, and set the following three
+# VM parameters accordingly to your needs.
+
+vm-enabled no
+# vm-enabled yes
+
+# This is the path of the Redis swap file. As you can guess, swap files
+# can't be shared by different Redis instances, so make sure to use a swap
+# file for every redis process you are running. Redis will complain if the
+# swap file is already in use.
+#
+# The best kind of storage for the Redis swap file (that's accessed at random) 
+# is a Solid State Disk (SSD).
+#
+# *** WARNING *** if you are using a shared hosting the default of putting
+# the swap file under /tmp is not secure. Create a dir with access granted
+# only to Redis user and configure Redis to create the swap file there.
+vm-swap-file ./tmp/redis.swap
+
+# vm-max-memory configures the VM to use at max the specified amount of
+# RAM. Everything that deos not fit will be swapped on disk *if* possible, that
+# is, if there is still enough contiguous space in the swap file.
+#
+# With vm-max-memory 0 the system will swap everything it can. Not a good
+# default, just specify the max amount of RAM you can in bytes, but it's
+# better to leave some margin. For instance specify an amount of RAM
+# that's more or less between 60 and 80% of your free RAM.
+vm-max-memory 0
+
+# Redis swap files is split into pages. An object can be saved using multiple
+# contiguous pages, but pages can't be shared between different objects.
+# So if your page is too big, small objects swapped out on disk will waste
+# a lot of space. If you page is too small, there is less space in the swap
+# file (assuming you configured the same number of total swap file pages).
+#
+# If you use a lot of small objects, use a page size of 64 or 32 bytes.
+# If you use a lot of big objects, use a bigger page size.
+# If unsure, use the default :)
+vm-page-size 32
+
+# Number of total memory pages in the swap file.
+# Given that the page table (a bitmap of free/used pages) is taken in memory,
+# every 8 pages on disk will consume 1 byte of RAM.
+#
+# The total swap size is vm-page-size * vm-pages
+#
+# With the default of 32-bytes memory pages and 134217728 pages Redis will
+# use a 4 GB swap file, that will use 16 MB of RAM for the page table.
+#
+# It's better to use the smallest acceptable value for your application,
+# but the default is large in order to work in most conditions.
+vm-pages 134217728
+
+# Max number of VM I/O threads running at the same time.
+# This threads are used to read/write data from/to swap file, since they
+# also encode and decode objects from disk to memory or the reverse, a bigger
+# number of threads can help with big objects even if they can't help with
+# I/O itself as the physical device may not be able to couple with many
+# reads/writes operations at the same time.
+#
+# The special value of 0 turn off threaded I/O and enables the blocking
+# Virtual Memory implementation.
+vm-max-threads 4
+
+############################### ADVANCED CONFIG ###############################
+
+# Glue small output buffers together in order to send small replies in a
+# single TCP packet. Uses a bit more CPU but most of the times it is a win
+# in terms of number of queries per second. Use 'yes' if unsure.
+glueoutputbuf yes
+
+# Hashes are encoded in a special way (much more memory efficient) when they
+# have at max a given numer of elements, and the biggest element does not
+# exceed a given threshold. You can configure this limits with the following
+# configuration directives.
+hash-max-zipmap-entries 64
+hash-max-zipmap-value 512
+
+# Active rehashing uses 1 millisecond every 100 milliseconds of CPU time in
+# order to help rehashing the main Redis hash table (the one mapping top-level
+# keys to values). The hash table implementation redis uses (see dict.c)
+# performs a lazy rehashing: the more operation you run into an hash table
+# that is rhashing, the more rehashing "steps" are performed, so if the
+# server is idle the rehashing is never complete and some more memory is used
+# by the hash table.
+# 
+# The default is to use this millisecond 10 times every second in order to
+# active rehashing the main dictionaries, freeing memory when possible.
+#
+# If unsure:
+# use "activerehashing no" if you have hard latency requirements and it is
+# not a good thing in your environment that Redis can reply form time to time
+# to queries with 2 milliseconds delay.
+#
+# use "activerehashing yes" if you don't have such hard requirements but
+# want to free memory asap when possible.
+activerehashing yes
+
+################################## INCLUDES ###################################
+
+# Include one or more other config files here.  This is useful if you
+# have a standard template that goes to all redis server but also need
+# to customize a few per-server settings.  Include files can include
+# other files, so use this wisely.
+#
+# include /path/to/local.conf
+# include /path/to/other.conf

data/spec/server_spec.rb

@@ -0,0 +1,118 @@
+ENV['RACK_ENV'] = 'test'
+
+require 'spec_helper'
+require 'rack'
+require 'rack/test'
+require 'resque/server'
+require 'resque-queue-priority-server'
+
+Sinatra::Base.set :environment, :test
+# ::Test::Unit::TestCase.send :include, Rack::Test::Methods
+
+
+describe "Queue Priority pages" do
+  include Rack::Test::Methods
+
+  def app
+    @app ||= Resque::Server.new
+  end
+
+  before(:each) do
+    Resque.redis.flushall
+  end
+
+  context "existence in application" do
+
+    it "should respond to it's url" do
+      get "/queuepriority"
+      last_response.should be_ok
+    end
+
+    it "should display its tab" do
+      get "/overview"
+      last_response.body.should include "<a href='/queuepriority'>QueuePriority</a>"
+    end
+
+  end
+
+  context "show queue priority table" do
+
+    before(:each) do
+      Resque.priority_buckets = [{'pattern' => 'foo', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false},
+                                 {'pattern' => 'bar', 'fairly' => true}]
+
+    end
+
+    it "should shows pattern input fields" do
+      get "/queuepriority"
+
+      last_response.body.should match /<input type="text" id="input-0-pattern" name="priorities\[\]\[pattern\]" value="foo"/
+      last_response.body.should match /<input type="text" id="input-1-pattern" name="priorities\[\]\[pattern\]" value="default"/
+      last_response.body.should match /<input type="text" id="input-2-pattern" name="priorities\[\]\[pattern\]" value="bar"/
+    end
+
+    it "should show fairly checkboxes" do
+      get "/queuepriority"
+
+      last_response.body.should match /<input type="checkbox" id="input-0-fairly" name="priorities\[\]\[fairly\]" value="true" *\/>/
+      last_response.body.should match /<input type="checkbox" id="input-1-fairly" name="priorities\[\]\[fairly\]" value="true" *\/>/
+      last_response.body.should match /<input type="checkbox" id="input-2-fairly" name="priorities\[\]\[fairly\]" value="true" checked *\/>/
+    end
+
+  end
+
+  context "edit links" do
+
+    before(:each) do
+      Resque.priority_buckets = [{'pattern' => 'foo', 'fairly' => false},
+                                 {'pattern' => 'default', 'fairly' => false},
+                                 {'pattern' => 'bar', 'fairly' => true}]
+
+    end
+
+    it "should show remove link for queue" do
+      get "/queuepriority"
+
+      last_response.body.should match /<a href="#remove"/
+    end
+
+    it "should show up link for queue" do
+      get "/queuepriority"
+
+      last_response.body.should match /<a href="#up"/
+    end
+
+    it "should show down link for queue" do
+      get "/queuepriority"
+
+      last_response.body.should match /<a href="#down"/
+    end
+
+  end
+
+  context "form to edit queues" do
+
+    it "should have form to edit queues" do
+      get "/queuepriority"
+
+      last_response.body.should match /<form action="\/queuepriority"/
+    end
+
+    it "should update queues" do
+      Resque.priority_buckets.should == [{'pattern' => 'default'}]
+
+      post "/queuepriority", {'priorities' => [{"pattern" => "foo"},
+                                              {"pattern" => "default"},
+                                              {"pattern" => "bar", "fairly" => "true"}]}
+
+      last_response.should be_redirect
+      last_response['Location'].should match /queuepriority/
+      Resque.priority_buckets.should == [{"pattern" => "foo"},
+                                         {"pattern" => "default"},
+                                         {"pattern" => "bar", "fairly" => "true"}]
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'rspec'
+require 'resque-queue-priority'
+
+spec_dir = File.dirname(File.expand_path(__FILE__))
+REDIS_CMD = "redis-server #{spec_dir}/redis-test.conf"
+
+puts "Starting redis for testing at localhost:9736..."
+puts `cd #{spec_dir}; #{REDIS_CMD}`
+Resque.redis = 'localhost:9736'
+
+# Schedule the redis server for shutdown when tests are all finished.
+at_exit do
+  pid = File.read("#{spec_dir}/redis.pid").to_i rescue nil
+  system ("kill #{pid}") if pid != 0
+end
+
+class SomeJob
+  def self.perform(*args)
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: resque-queue-priority
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+  prerelease: 
+platform: ruby
+authors:
+- Matt Conway
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-09 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: resque
+  requirement: &2220530200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2220530200
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2220525920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2220525920
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2220522620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: *2220522620
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: &2222721200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :development
+  prerelease: false
+  version_requirements: *2222721200
+description: A resque plugin for specifying the priority between queues that workers
+  use to determine what to work on next
+email:
+- matt@conwaysplace.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG
+- Gemfile
+- README.md
+- Rakefile
+- config.ru
+- lib/resque-queue-priority-server.rb
+- lib/resque-queue-priority.rb
+- lib/resque/plugins/queue_priority/attributes.rb
+- lib/resque/plugins/queue_priority/priority.rb
+- lib/resque/plugins/queue_priority/server.rb
+- lib/resque/plugins/queue_priority/server/views/priorities.erb
+- lib/resque/plugins/queue_priority/version.rb
+- resque-queue-priority.gemspec
+- spec/priority_spec.rb
+- spec/redis-test.conf
+- spec/server_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/wr0ngway/resque-queue-priority
+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: '0'
+requirements: []
+rubyforge_project: resque-queue-priority
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A resque plugin for specifying the priority between queues that workers use
+  to determine what to work on next
+test_files:
+- spec/priority_spec.rb
+- spec/redis-test.conf
+- spec/server_spec.rb
+- spec/spec_helper.rb
+has_rdoc: