sktop 0.1.0

data/lib/sktop/job_actions.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Sktop
+  module JobActions
+    class << self
+      def retry_job(jid, source)
+        job = find_job(jid, source)
+        raise "Job not found (JID: #{jid})" unless job
+
+        job.retry
+        true
+      end
+
+      def delete_job(jid, source)
+        job = find_job(jid, source)
+        raise "Job not found (JID: #{jid})" unless job
+
+        job.delete
+        true
+      end
+
+      def kill_job(jid, source)
+        job = find_job(jid, source)
+        raise "Job not found (JID: #{jid})" unless job
+
+        job.kill
+        true
+      end
+
+      def retry_all(source)
+        set = get_set(source)
+        count = set.size
+        set.retry_all
+        count
+      end
+
+      def delete_all(source)
+        set = get_set(source)
+        count = set.size
+        set.clear
+        count
+      end
+
+      def quiet_process(identity)
+        process = find_process(identity)
+        raise "Process not found (identity: #{identity})" unless process
+
+        process.quiet!
+        true
+      end
+
+      def stop_process(identity)
+        process = find_process(identity)
+        raise "Process not found (identity: #{identity})" unless process
+
+        process.stop!
+        true
+      end
+
+      private
+
+      def get_set(source)
+        case source
+        when :retry
+          Sidekiq::RetrySet.new
+        when :dead
+          Sidekiq::DeadSet.new
+        when :scheduled
+          Sidekiq::ScheduledSet.new
+        else
+          raise "Unknown source: #{source}"
+        end
+      end
+
+      def find_job(jid, source)
+        set = get_set(source)
+
+        # Try find_job first (available in newer Sidekiq versions)
+        if set.respond_to?(:find_job)
+          job = set.find_job(jid)
+          return job if job
+        end
+
+        # Fall back to iterating through the set
+        set.each do |entry|
+          return entry if entry.jid == jid
+        end
+
+        nil
+      end
+
+      def find_process(identity)
+        Sidekiq::ProcessSet.new.find { |p| p["identity"] == identity }
+      end
+    end
+  end
+end

data/lib/sktop/stats_collector.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Sktop
+  class StatsCollector
+    def initialize
+      @stats = Sidekiq::Stats.new
+    end
+
+    def refresh!
+      @stats = Sidekiq::Stats.new
+      self
+    end
+
+    def overview
+      {
+        processed: @stats.processed,
+        failed: @stats.failed,
+        scheduled_size: @stats.scheduled_size,
+        retry_size: @stats.retry_size,
+        dead_size: @stats.dead_size,
+        enqueued: @stats.enqueued,
+        default_queue_latency: @stats.default_queue_latency
+      }
+    end
+
+    def queues
+      Sidekiq::Queue.all.map do |queue|
+        {
+          name: queue.name,
+          size: queue.size,
+          latency: queue.latency,
+          paused: queue.paused?
+        }
+      end
+    end
+
+    def processes
+      Sidekiq::ProcessSet.new.map do |process|
+        # Use direct hash access for status flags - the method accessors
+        # like stopping? can have broader semantics in some Sidekiq versions
+        quiet_val = process["quiet"]
+        stopping_val = process["stopping"]
+
+        quiet_flag = quiet_val == true || quiet_val == "true"
+        stopping_flag = stopping_val == true || stopping_val == "true"
+
+        {
+          identity: process["identity"],
+          hostname: process["hostname"],
+          pid: process["pid"],
+          tag: process["tag"],
+          started_at: Time.at(process["started_at"]),
+          concurrency: process["concurrency"],
+          busy: process["busy"],
+          queues: process["queues"],
+          labels: process["labels"] || [],
+          quiet: quiet_flag,
+          stopping: stopping_flag,
+          rss: process["rss"]  # Memory in KB
+        }
+      end
+    end
+
+    def workers
+      Sidekiq::Workers.new.map do |process_id, thread_id, work|
+        {
+          process_id: process_id,
+          thread_id: thread_id,
+          queue: work["queue"],
+          class: work["payload"]["class"],
+          args: work["payload"]["args"],
+          run_at: Time.at(work["run_at"]),
+          elapsed: Time.now - Time.at(work["run_at"])
+        }
+      end
+    end
+
+    def scheduled_jobs(limit: 10)
+      Sidekiq::ScheduledSet.new.first(limit).map do |job|
+        {
+          class: job.klass,
+          queue: job.queue,
+          args: job.args,
+          scheduled_at: job.at,
+          created_at: job.created_at
+        }
+      end
+    end
+
+    def retry_jobs(limit: 10)
+      Sidekiq::RetrySet.new.first(limit).map do |job|
+        {
+          jid: job.jid,
+          class: job.klass,
+          queue: job.queue,
+          args: job.args,
+          failed_at: job["failed_at"] ? Time.at(job["failed_at"]) : nil,
+          retry_count: job["retry_count"],
+          error_class: job["error_class"],
+          error_message: job["error_message"]
+        }
+      end
+    end
+
+    def dead_jobs(limit: 10)
+      Sidekiq::DeadSet.new.first(limit).map do |job|
+        {
+          jid: job.jid,
+          class: job.klass,
+          queue: job.queue,
+          args: job.args,
+          failed_at: job["failed_at"] ? Time.at(job["failed_at"]) : nil,
+          error_class: job["error_class"],
+          error_message: job["error_message"]
+        }
+      end
+    end
+
+    def history(days: 7)
+      stats_history = Sidekiq::Stats::History.new(days)
+      {
+        processed: stats_history.processed,
+        failed: stats_history.failed
+      }
+    end
+  end
+end

data/lib/sktop/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sktop
+  VERSION = "0.1.0"
+end

data/lib/sktop.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "sidekiq"
+require "sidekiq/api"
+require "terminal-table"
+require "pastel"
+require "tty-cursor"
+require "tty-screen"
+
+require_relative "sktop/version"
+require_relative "sktop/stats_collector"
+require_relative "sktop/job_actions"
+require_relative "sktop/display"
+require_relative "sktop/cli"
+
+module Sktop
+  class Error < StandardError; end
+
+  class << self
+    def configure_redis(url: nil, namespace: nil)
+      options = {}
+      options[:url] = url if url
+
+      Sidekiq.configure_client do |config|
+        config.redis = options
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: sktop
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: A terminal-based dashboard for monitoring Sidekiq, similar to the web
+  UI but for the command line
+email:
+- james@example.com
+executables:
+- sktop
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/sktop
+- lib/sktop.rb
+- lib/sktop/cli.rb
+- lib/sktop/display.rb
+- lib/sktop/job_actions.rb
+- lib/sktop/stats_collector.rb
+- lib/sktop/version.rb
+homepage: https://github.com/james/sktop
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: CLI tool to monitor Sidekiq queues and processes
+test_files: []