require 'resque'
require 'redisk'
require 'uuid'
module Resque
# Resque::Status is a Hash object that has helper methods for dealing with
# the common status attributes. It also has a number of class methods for
# creating/updating/retrieving status objects from Redis
class Status < Hash
VERSION = '0.1.3'
extend Resque::Helpers
# Create a status, generating a new UUID, passing the message to the status
# Returns the UUID of the new status.
def self.create(message = nil)
uuid = generate_uuid
set(uuid, message)
redis.zadd(set_key, Time.now.to_i, uuid)
redis.zremrangebyscore(set_key, 0, Time.now.to_i - @expire_in) if @expire_in
uuid
end
# Get a status by UUID. Returns a Resque::Status
def self.get(uuid)
val = redis.get(status_key(uuid))
val ? Resque::Status.new(uuid, decode(val)) : nil
end
# set a status by UUID. messages can be any number of stirngs or hashes
# that are merged in order to create a single status.
def self.set(uuid, *messages)
val = Resque::Status.new(uuid, *messages)
redis.set(status_key(uuid), encode(val))
if expire_in
redis.expire(status_key(uuid), expire_in)
end
val
end
def self.clear
status_ids.each do |id|
redis.del(status_key(id))
redis.zrem(set_key, id)
end
end
# returns a Redisk::Logger scoped to the UUID. Any options passed are passed
# to the logger initialization.
def self.logger(uuid, options = {})
Redisk::Logger.new(logger_key(uuid), options)
end
# Return num Resque::Status objects in reverse chronological order.
# By default returns the entire set.
def self.statuses(num = -1)
status_ids(num).collect do |id|
get(id)
end.compact
end
# Return the num most recent status/job UUIDs in reverse chronological order.
def self.status_ids(num = -1)
redis.zrevrange set_key, 0, num
end
# Kill the job at UUID on its next iteration this works by adding the UUID to a
# kill list (a.k.a. a list of jobs to be killed. Each iteration the job checks
# if it _should_ be killed by calling tick or at. If so, it raises
# a Resque::JobWithStatus::Killed error and sets the status to 'killed'.
def self.kill(uuid)
redis.sadd(kill_key, uuid)
end
# Remove the job at UUID from the kill list
def self.killed(uuid)
redis.srem(kill_key, uuid)
end
# Return the UUIDs of the jobs on the kill list
def self.kill_ids
redis.smembers(kill_key)
end
# Check whether a job with UUID is on the kill list
def self.should_kill?(uuid)
redis.sismember(kill_key, uuid)
end
# The time in seconds that jobs and statuses should expire from Redis (after
# the last time they are touched/updated)
def self.expire_in
@expire_in
end
# Set the expire_in time in seconds
def self.expire_in=(seconds)
@expire_in = seconds.nil? ? nil : seconds.to_i
end
def self.status_key(uuid)
"status:#{uuid}"
end
def self.set_key
"_statuses"
end
def self.kill_key
"_kill"
end
def self.logger_key(uuid)
"_log:#{uuid}"
end
def self.generate_uuid
UUID.generate(:compact)
end
def self.hash_accessor(name, options = {})
options[:default] ||= nil
coerce = options[:coerce] ? ".#{options[:coerce]}" : ""
module_eval <<-EOT
def #{name}
value = (self['#{name}'] ? self['#{name}']#{coerce} : #{options[:default].inspect})
yield value if block_given?
value
end
def #{name}=(value)
self['#{name}'] = value
end
def #{name}?
!!self['#{name}']
end
EOT
end
STATUSES = %w{queued working completed failed killed}.freeze
hash_accessor :uuid
hash_accessor :name
hash_accessor :status
hash_accessor :message
hash_accessor :time
hash_accessor :num
hash_accessor :total
# Create a new Resque::Status object. If multiple arguments are passed
# it is assumed the first argument is the UUID and the rest are status objects.
# All arguments are subsequentily merged in order. Strings are assumed to
# be messages.
def initialize(*args)
super nil
base_status = {
'time' => Time.now.to_i,
'status' => 'queued'
}
base_status['uuid'] = args.shift if args.length > 1
status_hash = args.inject(base_status) do |final, m|
m = {'message' => m} if m.is_a?(String)
final.merge(m || {})
end
self.replace(status_hash)
end
# calculate the % completion of the job based on status, num
# and total
def pct_complete
case status
when 'completed' then 100
when 'queued' then 0
when 'failed' then 100
else
t = (total == 0 || total.nil?) ? 1 : total
(((num || 0).to_f / t.to_f) * 100).to_i
end
end
# Return the time of the status initialization. If set returns a Time
# object, otherwise returns nil
def time
time? ? Time.at(self['time']) : nil
end
STATUSES.each do |status|
define_method("#{status}?") do
self['status'] === status
end
end
# Can the job be killed? 'failed', 'completed', and 'killed' jobs cant be killed
# (for pretty obvious reasons)
def killable?
!['failed', 'completed', 'killed'].include?(self.status)
end
unless method_defined?(:to_json)
def to_json(*args)
json
end
end
# Return a JSON representation of the current object.
def json
h = self.dup
h['pct_complete'] = pct_complete
self.class.encode(h)
end
def inspect
"#"
end
end
end