sideq 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ef82f3b0fe18b615a00dfc4964fd08ee922ec4d6
-  data.tar.gz: 1bd916c2d8de6ccd3dc43f6bfbf148e8fbe9d2f0
+  metadata.gz: 95870eb124f8f2adde844e2f60e789792f1bd625
+  data.tar.gz: ad25d13479358fa547fe22a73835aed32989e2ca
 SHA512:
-  metadata.gz: 418ef5d4b642057ef8c8c79048ccb9017b701b294a89cb23ab42df93f2a3f6ef11fdb658c1d41c623752963272d94841217281f00ff5a2bc3e26b807f70ce4da
-  data.tar.gz: 4b28505a489e29aba7781bc4257efaa7e3c1f27141316c80b0a64a40f9b3794f2562653edf911d3e209d80f29a9226ee596d4c4887da608e780576ee8f1d7233
+  metadata.gz: 811fd2cbbbc2a3f8998418e9fe1e7a83dd979aaac7c7ea966d00656d7aa7f071ca76e3ad92c043ed489bbbff481c55b5e6703209aa722ae7bf79fcaf24982fb6
+  data.tar.gz: d411abb0ca7d411b58efbdb9c1db0d0a3137b2b05845c7a2b01ba21eb609b0ada923ebd33ca496f7f904ccaf6960974521a6d3a023d67455dbadb4e774f2793d

data/CHANGELOG

@@ -0,0 +1,7 @@
+## 0.1.1
+- Add per-queue information and manipulation 
+- Rename 'queue list' command to 'queues list' to make place for the per-queue commands
+- Add next execution time to details of the retry set
+
+## 0.1.0
+- Initial release

data/README.md

@@ -2,9 +2,9 @@
 A CLI interface to the sidekiq api
 
 # usage
-    sideq.rb --help
+    sideq --help
 
-    Usage: ./sideq.rb [options] command [subcommand]
+    Usage: sideq [options] command [subcommand]
 
     Commands and subcommands:
     stats                    Print sidekiq statistics

data/bin/sideq

@@ -4,6 +4,8 @@ require 'optparse'
 require 'sidekiq'
 require 'sidekiq/api'
 
+require_relative '../lib/sideq'
+
 RACK_ENV = ENV['RACK_ENV'] || "development"
 
 class Parser
@@ -16,24 +18,28 @@ class Parser
       opts.banner = "Usage: #{$0} [options] command [subcommand]\n" <<
                     "\n" <<
                     "Commands and subcommands:\n" <<
-                    "stats                    Print sidekiq statistics\n" <<
-                    "queue list               List all known queues\n" <<
-                    "retry list               List contents of the retry set\n" <<
-                    "retry show jid [jid ...] Show details of entrie sin the retry set\n" <<
-                    "retry del jid [jid ...]  Delete entries from the retry set\n" <<
-                    "retry kill jid [jid ...] Move jobs from the retry set to the dead set\n" <<
-                    "retry now jid [jid ...]  Retry jobs in the retry set right now\n" <<
-                    "retry clear              Clears all entries in the retry set\n" <<
-                    "dead list                List contents of the dead set\n" <<
-                    "dead show jid [jid...]   Show details of entries in the dead set\n" <<
-                    "dead del jid [jid...]    Delete jobs from the dead set\n" <<
-                    "dead now jid [jid...]    Retry jobs from the dead set right now\n" <<
-                    "dead clear               Clears all entries of the dead set\n" <<
-                    "processes list           Lists all processes known to sidekiq\n" <<
-                    "processes quiet          Send the quiet signal to all sidekiq processes\n" <<
-                    "processes kill           Send the kill signal to all sidekiq processes\n" <<
-                    "processes clean          Clear dead process entries from the process list\n" <<
-                    "workers list             List all workers\n"
+                    "stats                        Print sidekiq statistics\n" <<
+                    "queue list                   List all known queues\n" <<
+                    "queue list name              List contents of named queue\n" <<
+                    "queue show name jid [jid...] Show details of jobs in named queue\n" <<
+                    "queue del name jid [jid...]  Delete jobs from the named queue\n" <<
+                    "queue clear name             Clear all jobs from the named queue\n" <<
+                    "retry list                   List contents of the retry set\n" <<
+                    "retry show jid [jid ...]     Show details of entrie sin the retry set\n" <<
+                    "retry del jid [jid ...]      Delete entries from the retry set\n" <<
+                    "retry kill jid [jid ...]     Move jobs from the retry set to the dead set\n" <<
+                    "retry now jid [jid ...]      Retry jobs in the retry set right now\n" <<
+                    "retry clear                  Clears all entries in the retry set\n" <<
+                    "dead list                    List contents of the dead set\n" <<
+                    "dead show jid [jid...]       Show details of entries in the dead set\n" <<
+                    "dead del jid [jid...]        Delete jobs from the dead set\n" <<
+                    "dead now jid [jid...]        Retry jobs from the dead set right now\n" <<
+                    "dead clear                   Clears all entries of the dead set\n" <<
+                    "processes list               Lists all processes known to sidekiq\n" <<
+                    "processes quiet              Send the quiet signal to all sidekiq processes\n" <<
+                    "processes kill               Send the kill signal to all sidekiq processes\n" <<
+                    "processes clean              Clear dead process entries from the process list\n" <<
+                    "workers list                 List all workers\n"
       opts.separator "\nOptions:\n"
 
       opts.on("-n redisdb", "--database=redisdb", "Number of the redis database") do |n|
@@ -63,311 +69,6 @@ class Parser
   end
 end
 
-class Stats
-  attr_reader :stats, :retry_set, :dead_set
-
-  def initialize
-    @stats = Sidekiq::Stats.new
-    @retry_set = Sidekiq::RetrySet.new
-    @dead_set = Sidekiq::DeadSet.new
-  end
-
-  def to_s
-    stat_ary = [ "Processed: #{stats.processed}",
-                 "Failed: #{stats.failed}",
-                 "Scheduled size: #{stats.scheduled_size}",
-                 "Retry size: #{stats.retry_size}",
-                 "Dead size: #{stats.dead_size}",
-                 "Enqueued: #{stats.enqueued}",
-                 "Processes: #{stats.processes_size}",
-                 "Workers: #{stats.workers_size}",
-                 "Default queue latency: #{stats.default_queue_latency}",
-
-                 "Queues: dead:  #{dead_set.size}",
-                 "        retry: #{retry_set.size}" ]
-    stats.queues.each do |(queue_name, queue_size)|
-      stat_ary << "        #{queue_name}: #{queue_size}"
-    end
-
-    stat_ary.join( "\n" )
-  end
-end
-
-class Queues
-  attr_reader :retry_set, :dead_set
-
-  def initialize
-    @retry_set = Sidekiq::RetrySet.new
-    @dead_set = Sidekiq::DeadSet.new
-  end
-
-  def to_s
-    ary = Sidekiq::Queue.all.each_with_object( [] ) do |queue, memo|
-      memo << sprintf( "%-30s %5d (%8.2f s latency), %spaused", 
-                      queue.name,
-                      queue.size,
-                      queue.latency,
-                      queue.paused? ? '' : "not " )
-    end
-    ary << sprintf( "%-30s %5d", "retry", retry_set.size )
-    ary << sprintf( "%-30s %5d", "dead", dead_set.size )
-    ary.join( "\n" )
-  end
-end
-
-class Retries
-  attr_reader :retry_set
-
-  def initialize
-    @retry_set = Sidekiq::RetrySet.new
-  end
-
-  def to_s
-    retry_set.each_with_object( [ "Retry entries: #{retry_set.size}" ] ) do |job, memo|
-      memo << sprintf( "%24s - %19s\n  %-22s - %-37s\n  e: %19s - f: %19s\n  retry (%2d) at %-19s Continue retries?: %s\n  %s\n", 
-                        job.jid,
-                        job.created_at.strftime( "%F %T" ),
-                        job.display_class,
-                        job.item["error_class"],
-                        job.enqueued_at.strftime( "%F %T" ),
-                        Time.at( job.item["failed_at"] ).strftime( "%F %T" ),
-                        job.item["retry_count"],
-                        job.item["retried_at"] ? Time.at( job.item["retried_at"] ).strftime( "%F %T" ) : "never",
-                        job.item["retry"],
-                        "#{job.item["error_class"]}: #{job.item["error_message"][0,77-job.item["error_class"].size]}" )
-    end.join( "\n" )
-  end
-
-  def details( job_ids )
-    retry_set.each_with_object( [] ) do |job, memo|
-      next unless job_ids.include?( job.jid )
-      memo << job_details( job )
-    end.join( "\n\n" )
-  end
-
-  def delete_entries( job_ids )
-    deleted = 0
-    job_ids.each do |job_id|
-      # TODO: Inefficient in the free(beer) sidekiq version; 
-      #       find something more efficient here (sr 2016-04-06)
-      job = retry_set.find_job( job_id )
-      if job
-        job.delete
-        puts "#{job_id}: deleted"
-        deleted += 1
-      else
-        puts "#{job_id}: not found"
-      end
-    end
-    puts "Retry Set: Deleted #{deleted} entries"
-  end
-
-  def kill_entries( job_ids )
-    killed = 0
-    job_ids.each do |job_id|
-      # TODO: Inefficient in the free(beer) sidekiq version; 
-      #       find something more efficient here (sr 2016-04-06)
-      job = retry_set.find_job( job_id )
-      if job
-        begin
-          job.kill
-          puts "#{job_id}: moved to dead set"
-          killed += 1
-        rescue
-          puts "#{job_id}: failed - #{$!.message}"
-        end
-      else
-        puts "#{job_id}: not found"
-      end
-    end
-
-    puts "Retry Set: Moved #{killed} entries to Dead Set"
-  end
-
-  def retry_entries( job_ids )
-    retried = 0
-    job_ids.each do |job_id|
-      # TODO: Inefficient in the free(beer) sidekiq version; 
-      #       find something more efficient here (sr 2016-04-06)
-      job = retry_set.find_job( job_id )
-      if job
-        begin
-          job.retry
-          puts "#{job_id}: retrying"
-          retried += 1
-        rescue
-          puts "#{job_id}: failed - #{$!.message}"
-        end
-      else
-        puts "#{job_id}: not found"
-      end
-    end
-
-    puts "Retry Set: Retried #{retried} entries"
-  end
-
-  def clear
-    puts "Retry Set: Deleted #{retry_set.clear} entries"
-  end
-
-  protected
-  def job_details( job )
-    [ "JobID:         #{job.jid}",
-      "Created at:    #{job.created_at.strftime( "%F %T" )}",
-      "Enqueued at:   #{job.enqueued_at.strftime( "%F %T")}",
-      "Worker class:  #{job.display_class}",
-      "Arguments:     #{job.display_args}",
-      "Failed at:     #{Time.at( job.item["failed_at"] ).strftime( "%F %T" )}",
-      "Retried at:    #{job.item["retried_at"] ? Time.at( job.item["retried_at"] ).strftime( "%F %T" ) : "never"}",
-      "Retries:       #{job.item["retry_count"]}",
-      "Retry?:        #{job.item["retry"]}",
-      "Error Class:   #{job.item["error_class"]}",
-      "Error Message: #{job.item["error_message"]}" ].join( "\n" )
-  end
-end
-
-class Dead
-  attr_reader :dead_set
-
-  def initialize
-    @dead_set = Sidekiq::DeadSet.new
-  end
-
-  def to_s
-    dead_set.each_with_object( [ "Dead entries: #{dead_set.size}" ] ) do |job, memo|
-      memo << sprintf( "%24s - %19s\n  %-22s - %-37s\n  e: %19s - f: %19s\n  retry (%2d) at %-19s Continue retries?: %s\n  %s\n", 
-                       job.jid,
-                       job.created_at.strftime( "%F %T" ),
-                       job.display_class,
-                       job.item["error_class"],
-                       job.enqueued_at.strftime( "%F %T" ),
-                       Time.at( job.item["failed_at"] ).strftime( "%F %T" ),
-                       job.item["retry_count"],
-                       job.item["retried_at"] ? Time.at( job.item["retried_at"] ).strftime( "%F %T" ) : "never",
-                       job.item["retry"],
-                       "#{job.item["error_class"]}: #{job.item["error_message"][0,77-job.item["error_class"].size]}" )
-    end.join( "\n" )
-  end
-
-  def details( job_ids )
-    dead_set.each_with_object( [] ) do |job, memo|
-      next unless job_ids.include?( job.jid )
-      memo << job_details( job )
-    end.join( "\n\n" )
-  end
-
-  def delete_entries( job_ids )
-    deleted = 0
-    job_ids.each do |job_id|
-      # TODO: Inefficient in the free(beer) sidekiq version; 
-      #       find something more efficient here (sr 2016-04-06)
-      job = dead_set.find_job( job_id )
-      if job
-        job.delete
-        puts "#{job_id}: deleted"
-        deleted += 1
-      else
-        puts "#{job_id}: not found"
-      end
-    end
-    puts "Dead Set: Deleted #{deleted} entries"
-  end
-
-  def retry_entries( job_ids )
-    retried = 0
-    job_ids.each do |job_id|
-      # TODO: Inefficient in the free(beer) sidekiq version; 
-      #       find something more efficient here (sr 2016-04-06)
-      job = dead_set.find_job( job_id )
-      if job
-        begin
-          job.retry
-          puts "#{job_id}: retrying"
-          retried += 1
-        rescue
-          puts "#{job_id}: failed - #{$!.message}"
-        end
-      else
-        puts "#{job_id}: not found"
-      end
-    end
-
-    puts "Dead Set: Retried #{retried} entries"
-  end
-
-  def clear
-    puts "Dead Set: Deleted #{dead_set.clear} entries"
-  end
-
-  protected
-  def job_details( job )
-    [ "JobID:         #{job.jid}",
-      "Created at:    #{job.created_at.strftime( "%F %T" )}",
-      "Enqueued at:   #{job.enqueued_at.strftime( "%F %T")}",
-      "Worker class:  #{job.display_class}",
-      "Arguments:     #{job.display_args}",
-      "Failed at:     #{Time.at( job.item["failed_at"] ).strftime( "%F %T" )}",
-      "Retried at:    #{job.item["retried_at"] ? Time.at( job.item["retried_at"] ).strftime( "%F %T" ) : "never"}",
-      "Retries:       #{job.item["retry_count"]}",
-      "Retry?:        #{job.item["retry"]}",
-      "Error Class:   #{job.item["error_class"]}",
-      "Error Message: #{job.item["error_message"]}"
-    ].join( "\n" ) 
-  end
-end
-
-class Processes
-  attr_reader :process_set
-
-  def initialize
-    @process_set = Sidekiq::ProcessSet.new
-  end
-
-  def to_s
-    process_set.each_with_object( ["Processes: #{process_set.size}"] ) do |process, memo|
-      memo << process.inspect
-    end.join( "\n" )
-  end
-
-  def quiet
-    size = process_set.size
-    process_set.each do |process|
-      process.quiet!
-    end
-    puts "Quieted #{size} processes"
-  end
-
-  def kill
-    size = process_set.size
-    process_set.each do |process|
-      process.kill!
-    end
-    puts "Killed #{size} processes"
-  end
-
-  def clean
-    cleaned_up = Sidekiq::ProcessSet.cleanup
-    puts "Cleaned up #{cleaned_up} processes"
-  end
-end
-
-class Workers
-  attr_reader :worker_set
-
-  def initialize
-    @worker_set = Sidekiq::Workers.new
-  end
-
-  def to_s
-    ary = [ "Workers: #{worker_set.size}" ]
-
-    worker_set.each do |key, tid, json|
-      ary << sprintf( "%15s %15s %20s\n", key, tid, json )
-    end
-
-    ary.join( "\n" )
-  end
-end
 
 options = Parser.parse( ARGV )
 
@@ -376,17 +77,31 @@ Sidekiq.configure_client do |config|
   config.redis = { :url  => url, :size => 1 }
 end
 
-case ARGV.shift
-  when "stats" then puts Stats.new
+object = ARGV.shift
+case object
+  when "stats" then puts Sideq::Stats.new
 
-  when "queue" 
+  when "queues" 
     case ARGV.shift
-      when "list" then puts Queues.new
+      when "list"  then puts Sideq::Queue.overview
+      else Parser.parse( %w[ --help ] )
+    end
+
+  when "queue"
+    command = ARGV.shift
+    queue_name = ARGV.shift
+    queue = Sideq::Queue.new( queue_name )
+
+    case command
+      when "list"  then puts queue
+      when "show"  then puts queue.details( ARGV )
+      when "del"   then queue.delete_entries( ARGV )
+      when "clear" then queue.clear
       else Parser.parse( %w[ --help ] )
     end
 
   when "retry" 
-    retries = Retries.new
+    retries = Sideq::Retries.new
 
     case ARGV.shift
       when "list"  then puts retries
@@ -399,7 +114,7 @@ case ARGV.shift
     end
 
   when "dead"
-    dead = Dead.new
+    dead = Sideq::Dead.new
 
     case ARGV.shift
       when "list"  then puts dead
@@ -411,7 +126,7 @@ case ARGV.shift
     end
 
   when "processes"
-    processes = Processes.new
+    processes = Sideq::Processes.new
 
     case ARGV.shift
       when "list"  then puts processes
@@ -422,7 +137,7 @@ case ARGV.shift
     end
 
   when "workers"
-    workers = Workers.new
+    workers = Sideq::Workers.new
     case ARGV.shift
       when "list" then puts workers
       else Parser.parse( %w[ --help ] )

data/lib/sideq.rb

@@ -0,0 +1,6 @@
+require_relative 'sideq/stats'
+require_relative 'sideq/queue'
+require_relative 'sideq/retries'
+require_relative 'sideq/dead'
+require_relative 'sideq/workers'
+require_relative 'sideq/processes'

data/lib/sideq/dead.rb

@@ -0,0 +1,88 @@
+module Sideq
+  class Dead
+    attr_reader :dead_set
+
+    def initialize
+      @dead_set = Sidekiq::DeadSet.new
+    end
+
+    def to_s
+      dead_set.each_with_object( [ "Dead entries: #{dead_set.size}" ] ) do |job, memo|
+        memo << sprintf( "%24s - %19s\n  %-22s - %-37s\n  e: %19s - f: %19s\n  retry (%2d) at %-19s Continue retries?: %s\n  %s\n", 
+                         job.jid,
+                         job.created_at.strftime( "%F %T" ),
+                         job.display_class,
+                         job["error_class"],
+                         job.enqueued_at.strftime( "%F %T" ),
+                         Time.at( job["failed_at"] ).strftime( "%F %T" ),
+                         job["retry_count"],
+                         job["retried_at"] ? Time.at( job["retried_at"] ).strftime( "%F %T" ) : "never",
+                         job["retry"],
+                         "#{job["error_class"]}: #{job["error_message"][0,77-job["error_class"].size]}" )
+      end.join( "\n" )
+    end
+
+    def details( job_ids )
+      dead_set.each_with_object( [] ) do |job, memo|
+        next unless job_ids.include?( job.jid )
+        memo << job_details( job )
+      end.join( "\n\n" )
+    end
+
+    def delete_entries( job_ids )
+      deleted = 0
+      each_job( job_ids ) do |job|
+        job.delete
+        puts "#{job_id}: deleted"
+        deleted += 1
+      end
+      puts "Dead Set: Deleted #{deleted} entries"
+    end
+
+    def retry_entries( job_ids )
+      retried = 0
+      each_job( job_ids ) do |job|
+        job.retry
+        puts "#{job_id}: retrying"
+        retried += 1
+      end
+
+      puts "Dead Set: Retried #{retried} entries"
+    end
+
+    def clear
+      puts "Dead Set: Deleted #{dead_set.clear} entries"
+    end
+
+    protected
+    def each_job( job_ids )
+      job_ids.each do |job_id|
+        job = dead_set.find_job( job_id )
+        if job
+          begin
+            yield( job )
+          rescue
+            puts "#{job_id}: failed - #{$!.message}"
+          end
+        else
+          puts "#{job_id}: not found"
+        end
+      end
+    end
+
+    def job_details( job )
+      [ "JobID:         #{job.jid}",
+        "Created at:    #{job.created_at.strftime( "%F %T" )}",
+        "Enqueued at:   #{job.enqueued_at.strftime( "%F %T")}",
+        "Worker class:  #{job.display_class}",
+        "Arguments:     #{job.display_args}",
+        "Failed at:     #{Time.at( job["failed_at"] ).strftime( "%F %T" )}",
+        "Retried at:    #{job["retried_at"] ? Time.at( job["retried_at"] ).strftime( "%F %T" ) : "never"}",
+        "Retries:       #{job["retry_count"]}",
+        "Retry?:        #{job["retry"]}",
+        "Error Class:   #{job["error_class"]}",
+        "Error Message: #{job["error_message"]}"
+      ].join( "\n" ) 
+    end
+  end
+end

data/lib/sideq/processes.rb

@@ -0,0 +1,36 @@
+module Sideq
+  class Processes
+    attr_reader :process_set
+
+    def initialize
+      @process_set = Sidekiq::ProcessSet.new
+    end
+
+    def to_s
+      process_set.each_with_object( ["Processes: #{process_set.size}"] ) do |process, memo|
+        memo << process.inspect
+      end.join( "\n" )
+    end
+
+    def quiet
+      size = process_set.size
+      process_set.each do |process|
+        process.quiet!
+      end
+      puts "Quieted #{size} processes"
+    end
+
+    def kill
+      size = process_set.size
+      process_set.each do |process|
+        process.kill!
+      end
+      puts "Killed #{size} processes"
+    end
+
+    def clean
+      cleaned_up = Sidekiq::ProcessSet.cleanup
+      puts "Cleaned up #{cleaned_up} processes"
+    end
+  end
+end

data/lib/sideq/queue.rb

@@ -0,0 +1,82 @@
+module Sideq
+  class Queue
+    attr_reader :queue, :name
+
+    def self.overview
+      retry_set = Sidekiq::RetrySet.new
+      dead_set = Sidekiq::DeadSet.new
+
+      ary = Sidekiq::Queue.all.each_with_object( [] ) do |queue, memo|
+        memo << sprintf( "%-30s %5d (%8.2f s latency), %spaused", 
+                        queue.name,
+                        queue.size,
+                        queue.latency,
+                        queue.paused? ? '' : "not " )
+      end
+      ary << sprintf( "%-30s %5d", "retry", retry_set.size )
+      ary << sprintf( "%-30s %5d", "dead", dead_set.size )
+      ary.join( "\n" )
+    end
+
+    def initialize( name )
+      @name = name
+      @queue = Sidekiq::Queue.new( name )
+    end
+
+    def to_s
+      queue.each_with_object( [ "Queue entries: #{queue.size}" ] ) do |job, memo|
+        memo << sprintf( "%24s - %19s\n  %-77s\n  e: %19s - lat: %19s\n",
+                          job.jid,
+                          job.created_at.strftime( "%F %T" ),
+                          job.display_class,
+                          job.enqueued_at.strftime( "%F %T" ),
+                          job.latency )
+      end.join( "\n" )
+    end
+
+    def details( job_ids )
+      queue.each_with_object( [] ) do |job, memo|
+        next unless job_ids.include?( job.jid )
+        memo << job_details( job )
+      end.join( "\n\n" )
+    end
+
+    def delete_entries( job_ids )
+      deleted = 0
+      each_job( job_ids ) do |job|
+        job.delete
+        puts "#{job_id}: deleted"
+        deleted += 1
+      end
+    end
+
+    def clear
+      puts "Queue #{name}: Deleted #{queue.clear.first} entries"
+    end
+
+    protected
+    def each_job( job_ids )
+      job_ids.each do |job_id|
+        job = queue.find_job( job_id )
+        if job
+          begin
+            yield( job )
+          rescue
+            puts "#{job_id}: failed - #{$!.message}"
+          end
+        else
+          puts "#{job_id}: not found"
+        end
+      end
+    end
+
+    def job_details( job )
+      [ "JobID:         #{job.jid}",
+        "Created at:    #{job.created_at.strftime( "%F %T" )}",
+        "Enqueued at:   #{job.enqueued_at.strftime( "%F %T")}",
+        "Latency:       #{job.latency}",
+        "Worker class:  #{job.display_class}",
+        "Arguments:     #{job.display_args}" ].join( "\n" )
+    end
+  end
+end

data/lib/sideq/retries.rb

@@ -0,0 +1,97 @@
+module Sideq
+  class Retries
+    attr_reader :retry_set
+
+    def initialize
+      @retry_set = Sidekiq::RetrySet.new
+    end
+
+    def to_s
+      retry_set.each_with_object( [ "Retry entries: #{retry_set.size}" ] ) do |job, memo|
+        memo << sprintf( "%24s - %19s\n  %-22s - %-37s\n  e: %19s - f: %19s\n  retry (%2d) at %-19s Continue retries?: %s\n  %s\n", 
+                          job.jid,
+                          job.created_at.strftime( "%F %T" ),
+                          job.display_class,
+                          job["error_class"],
+                          job.enqueued_at.strftime( "%F %T" ),
+                          Time.at( job["failed_at"] ).strftime( "%F %T" ),
+                          job["retry_count"],
+                          job["retried_at"] ? Time.at( job["retried_at"] ).strftime( "%F %T" ) : "never",
+                          job["retry"],
+                          "#{job["error_class"]}: #{job["error_message"][0,77-job["error_class"].size]}" )
+      end.join( "\n" )
+    end
+
+    def details( job_ids )
+      retry_set.each_with_object( [] ) do |job, memo|
+        next unless job_ids.include?( job.jid )
+        memo << job_details( job )
+      end.join( "\n\n" )
+    end
+
+    def delete_entries( job_ids )
+      deleted = 0
+      each_job( job_ids ) do |job_id|
+        job.delete
+        puts "#{job_id}: deleted"
+        deleted += 1
+      end
+      puts "Retry Set: Deleted #{deleted} entries"
+    end
+
+    def kill_entries( job_ids )
+      killed = 0
+      each_job( job_ids ) do |job|
+        job.kill
+        puts "#{job_id}: moved to dead set"
+        killed += 1
+      end
+      puts "Retry Set: Moved #{killed} entries to Dead Set"
+    end
+
+    def retry_entries( job_ids )
+      retried = 0
+      each_job( job_ids ) do |job|
+        job.retry
+        puts "#{job_id}: retrying"
+        retried += 1
+      end
+      puts "Retry Set: Retried #{retried} entries"
+    end
+
+    def clear
+      puts "Retry Set: Deleted #{retry_set.clear} entries"
+    end
+
+    protected
+    def each_job( job_ids )
+      job_ids.each do |job_id|
+        job = retry_set.find_job( job_id )
+        if job
+          begin
+            yield( job )
+          rescue
+            puts "#{job_id}: failed - #{$!.message}"
+          end
+        else
+          puts "#{job_id}: not found"
+        end
+      end
+    end
+
+    def job_details( job )
+      [ "JobID:         #{job.jid}",
+        "Created at:    #{job.created_at.strftime( "%F %T" )}",
+        "Enqueued at:   #{job.enqueued_at.strftime( "%F %T")}",
+        "Worker class:  #{job.display_class}",
+        "Arguments:     #{job.display_args}",
+        "Failed at:     #{Time.at( job.item["failed_at"] ).strftime( "%F %T" )}",
+        "Retried at:    #{job["retried_at"] ? Time.at( job["retried_at"] ).strftime( "%F %T" ) : "never"}",
+        "Retries:       #{job["retry_count"]}",
+        "Retry?:        #{job["retry"]}",
+        "Next retry at  #{job.at.strftime( "%F %T" )}",
+        "Error Class:   #{job["error_class"]}",
+        "Error Message: #{job["error_message"]}" ].join( "\n" )
+    end
+  end
+end

data/lib/sideq/stats.rb

@@ -0,0 +1,31 @@
+module Sideq
+  class Stats
+    attr_reader :stats, :retry_set, :dead_set
+
+    def initialize
+      @stats = Sidekiq::Stats.new
+      @retry_set = Sidekiq::RetrySet.new
+      @dead_set = Sidekiq::DeadSet.new
+    end
+
+    def to_s
+      stat_ary = [ "Processed: #{stats.processed}",
+                   "Failed: #{stats.failed}",
+                   "Scheduled size: #{stats.scheduled_size}",
+                   "Retry size: #{stats.retry_size}",
+                   "Dead size: #{stats.dead_size}",
+                   "Enqueued: #{stats.enqueued}",
+                   "Processes: #{stats.processes_size}",
+                   "Workers: #{stats.workers_size}",
+                   "Default queue latency: #{stats.default_queue_latency}",
+
+                   "Queues: dead:  #{dead_set.size}",
+                   "        retry: #{retry_set.size}" ]
+      stats.queues.each do |(queue_name, queue_size)|
+        stat_ary << "        #{queue_name}: #{queue_size}"
+      end
+
+      stat_ary.join( "\n" )
+    end
+  end
+end

data/lib/sideq/workers.rb

@@ -0,0 +1,19 @@
+module Sideq
+  class Workers
+    attr_reader :worker_set
+
+    def initialize
+      @worker_set = Sidekiq::Workers.new
+    end
+
+    def to_s
+      ary = [ "Workers: #{worker_set.size}" ]
+
+      worker_set.each do |key, tid, json|
+        ary << sprintf( "%15s %15s %20s\n", key, tid, json )
+      end
+
+      ary.join( "\n" )
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sideq
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Sven Riedel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-13 00:00:00.000000000 Z
+date: 2016-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sidekiq
@@ -38,8 +38,16 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG
 - README.md
 - bin/sideq
+- lib/sideq.rb
+- lib/sideq/dead.rb
+- lib/sideq/processes.rb
+- lib/sideq/queue.rb
+- lib/sideq/retries.rb
+- lib/sideq/stats.rb
+- lib/sideq/workers.rb
 homepage: https://github.com/sriedel/sideq
 licenses:
 - GPL-2.0