sktop 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1e0891fc2a69763f5784c7cc96fc69103d14362aa67a08b82b6c13aa578985b
-  data.tar.gz: fea7b7284c37d666516d42c2bcc97e0f6b3db4cbb53628e2e3b35c6521c44845
+  metadata.gz: ca4fae6f1476e43b4393759a8e1b6108d6d5a7629b9601d951b7f385ede63e49
+  data.tar.gz: 56350127188d3cd045a03f087cbbd67b25f4f402f8ab2e9f374d63661ab1fede
 SHA512:
-  metadata.gz: 59b4378e2dae18d69bcbd9c3a6492ff0bcad4d830ad9d0c893fa0b9f70f6845d87b6652dcc850d7a02efaea10c00343203d8b495c8eded6318a9b6c648e1fb5e
-  data.tar.gz: eb54c39df9aa1ec70bcb719b11a7ab0aac88970586345793e890b67dda9f753f207e8f7e5ea0923153118b66c59952f60ff46309e28da281e2bc4f87cbd48c4a
+  metadata.gz: d5456687d96c071a4919e9069ecf1c7778e47c74d20082113c1e43d3a507559175990bca6c6fd4c9c22a36769c33560f2ae2fca9ad861810bc020974de4a206e
+  data.tar.gz: 2c61aec794743e8239dafcfef96ee7ba92099bfbea3d5dd03fa71ddc5c18b3017025f732b785b8aefdcd46b3bd7e5abc1f04cdcf1010585f63cd97c4119b243a

data/lib/sktop/cli.rb

@@ -120,6 +120,14 @@ module Sktop
           @options[:initial_view] = :dead
         end
 
+        opts.on("-b", "--batches", "Batches view (Pro/Enterprise)") do
+          @options[:initial_view] = :batches
+        end
+
+        opts.on("-c", "--cron", "Periodic/Cron jobs view (Enterprise)") do
+          @options[:initial_view] = :periodic
+        end
+
         opts.separator ""
 
         opts.on("-1", "--once", "Display once and exit (no auto-refresh)") do
@@ -223,7 +231,11 @@ module Sktop
               workers: collector.workers,
               retry_jobs: collector.retry_jobs(limit: 500),
               scheduled_jobs: collector.scheduled_jobs(limit: 500),
-              dead_jobs: collector.dead_jobs(limit: 500)
+              dead_jobs: collector.dead_jobs(limit: 500),
+              # Enterprise/Pro features
+              edition: collector.edition,
+              batches: collector.batches(limit: 500),
+              periodic_jobs: collector.periodic_jobs
             }
 
             # If viewing queue jobs, refresh that data too
@@ -331,6 +343,10 @@ module Sktop
         @display.current_view = :scheduled
       when 'd', 'D'
         @display.current_view = :dead
+      when 'b', 'B'
+        @display.current_view = :batches
+      when 'c', 'C'
+        @display.current_view = :periodic
       when 'm', 'M'
         @display.current_view = :main
       when "\r", "\n"  # Enter key

data/lib/sktop/display.rb

@@ -71,7 +71,7 @@ module Sktop
     # Check if the current view supports item selection.
     # @return [Boolean] true if the view supports selection
     def selectable_view?
-      [:queues, :queue_jobs, :processes, :retries, :dead].include?(@current_view)
+      [:queues, :queue_jobs, :processes, :retries, :dead, :batches].include?(@current_view)
     end
 
     # Move up by one page in the current view.
@@ -135,8 +135,9 @@ module Sktop
     end
 
     # Ordered list of views for cycling with arrow keys.
+    # Enterprise/Pro views (batches, periodic) are at the end.
     # @return [Array<Symbol>] the view order
-    VIEW_ORDER = [:main, :queues, :processes, :workers, :retries, :scheduled, :dead].freeze
+    VIEW_ORDER = [:main, :queues, :processes, :workers, :retries, :scheduled, :dead, :batches, :periodic].freeze
 
     # Switch to the next view in the cycle.
     # @return [Symbol] the new current view
@@ -274,6 +275,31 @@ module Sktop
       def queue_jobs_cache
         @data[:queue_jobs] || []
       end
+
+      # @return [Array<Hash>] batch information (Pro/Enterprise)
+      def batches
+        @data[:batches] || []
+      end
+
+      # @return [Array<Hash>] periodic job information (Enterprise)
+      def periodic_jobs
+        @data[:periodic_jobs] || []
+      end
+
+      # @return [String] Sidekiq edition ("Enterprise", "Pro", or "OSS")
+      def edition
+        @data[:edition] || "OSS"
+      end
+
+      # @return [Boolean] true if Pro features available
+      def pro?
+        %w[Pro Enterprise].include?(edition)
+      end
+
+      # @return [Boolean] true if Enterprise features available
+      def enterprise?
+        edition == "Enterprise"
+      end
     end
 
     private
@@ -294,6 +320,10 @@ module Sktop
         build_scheduled_detail(collector)
       when :dead
         build_dead_detail(collector)
+      when :batches
+        build_batches_detail(collector)
+      when :periodic
+        build_periodic_detail(collector)
       else
         build_main_view(collector)
       end
@@ -434,6 +464,30 @@ module Sktop
       lines
     end
 
+    def build_batches_detail(collector)
+      lines = []
+      lines << header_bar
+      lines << ""
+      stats_meters(collector.overview, collector.processes).each_line(chomp: true) { |l| lines << l }
+      lines << ""
+      max_rows = terminal_height - 12
+      batches_selectable(collector.batches, max_rows, collector.pro?).each_line(chomp: true) { |l| lines << l }
+      lines << :footer
+      lines
+    end
+
+    def build_periodic_detail(collector)
+      lines = []
+      lines << header_bar
+      lines << ""
+      stats_meters(collector.overview, collector.processes).each_line(chomp: true) { |l| lines << l }
+      lines << ""
+      max_rows = terminal_height - 12
+      periodic_scrollable(collector.periodic_jobs, max_rows, collector.enterprise?).each_line(chomp: true) { |l| lines << l }
+      lines << :footer
+      lines
+    end
+
     def render_with_overwrite(content_parts)
       width = terminal_width
       height = terminal_height
@@ -1343,6 +1397,139 @@ module Sktop
       lines.join("\n")
     end
 
+    # Selectable batches view (Pro/Enterprise)
+    def batches_selectable(batches, max_rows, pro_available)
+      width = terminal_width
+      lines = []
+
+      unless pro_available
+        lines << section_bar("Batches - Requires Sidekiq Pro or Enterprise")
+        lines << @pastel.dim("  Sidekiq Pro or Enterprise is required for batch support.")
+        lines << @pastel.dim("  Visit https://sidekiq.org for more information.")
+        return lines.join("\n")
+      end
+
+      scroll_offset = @scroll_offsets[@current_view]
+      data_rows = max_rows - 3
+      max_scroll = [batches.length - data_rows, 0].max
+      scroll_offset = [[scroll_offset, 0].max, max_scroll].min
+      @scroll_offsets[@current_view] = scroll_offset
+
+      @selected_index[@current_view] = [[@selected_index[@current_view], 0].max, [batches.length - 1, 0].max].min
+
+      selected = @selected_index[@current_view]
+      if selected < scroll_offset
+        scroll_offset = selected
+        @scroll_offsets[@current_view] = scroll_offset
+      elsif selected >= scroll_offset + data_rows
+        scroll_offset = selected - data_rows + 1
+        @scroll_offsets[@current_view] = scroll_offset
+      end
+
+      scroll_indicator = batches.length > data_rows ? " [#{scroll_offset + 1}-#{[scroll_offset + data_rows, batches.length].min}/#{batches.length}]" : ""
+      lines << section_bar("Batches#{scroll_indicator} - ↑↓ select, m=main")
+
+      if batches.empty?
+        lines << @pastel.dim("  No active batches")
+        return lines.join("\n")
+      end
+
+      desc_width = [30, (width - 70) / 2].max
+      bid_width = 24
+
+      header = sprintf("  %-#{bid_width}s %-#{desc_width}s %8s %8s %8s %10s", "BID", "DESCRIPTION", "TOTAL", "PENDING", "FAILED", "STATUS")
+      lines << format_table_header(header)
+
+      batches.drop(scroll_offset).first(data_rows).each_with_index do |batch, idx|
+        actual_idx = scroll_offset + idx
+        bid = truncate(batch[:bid], bid_width)
+        desc = truncate(batch[:description] || "(no description)", desc_width)
+        total = batch[:total].to_s
+        pending = batch[:pending].to_s
+        failures = batch[:failures].to_s
+        status = batch[:complete] ? "COMPLETE" : "RUNNING"
+
+        pending_colored = batch[:pending] > 0 ? @pastel.yellow(sprintf("%8s", pending)) : sprintf("%8s", pending)
+        failures_colored = batch[:failures] > 0 ? @pastel.red(sprintf("%8s", failures)) : sprintf("%8s", failures)
+        status_colored = batch[:complete] ? @pastel.green(sprintf("%10s", status)) : @pastel.cyan(sprintf("%10s", status))
+
+        row = sprintf("  %-#{bid_width}s %-#{desc_width}s %8s %s %s %s", bid, desc, total, pending_colored, failures_colored, status_colored)
+
+        if actual_idx == selected
+          lines << @pastel.black.on_white(row + " " * [width - visible_string_length(row), 0].max)
+        else
+          lines << row
+        end
+      end
+
+      remaining = batches.length - scroll_offset - data_rows
+      if remaining > 0
+        lines << @pastel.dim("  ↓ #{remaining} more")
+      end
+
+      if @status_message && @status_time && (Time.now - @status_time) < 3
+        lines << @pastel.green("  #{@status_message}")
+      end
+
+      lines.join("\n")
+    end
+
+    # Scrollable periodic jobs view (Enterprise)
+    def periodic_scrollable(jobs, max_rows, enterprise_available)
+      width = terminal_width
+      lines = []
+
+      unless enterprise_available
+        lines << section_bar("Periodic Jobs - Requires Sidekiq Enterprise")
+        lines << @pastel.dim("  Sidekiq Enterprise is required for periodic job support.")
+        lines << @pastel.dim("  Visit https://sidekiq.org for more information.")
+        return lines.join("\n")
+      end
+
+      scroll_offset = @scroll_offsets[@current_view]
+      data_rows = max_rows - 2
+      max_scroll = [jobs.length - data_rows, 0].max
+      scroll_offset = [[scroll_offset, 0].max, max_scroll].min
+      @scroll_offsets[@current_view] = scroll_offset
+
+      scroll_indicator = jobs.length > data_rows ? " [#{scroll_offset + 1}-#{[scroll_offset + data_rows, jobs.length].min}/#{jobs.length}]" : ""
+      lines << section_bar("Periodic Jobs#{scroll_indicator} - ↑↓ to scroll, m=main")
+
+      if jobs.empty?
+        lines << @pastel.dim("  No periodic jobs configured")
+        return lines.join("\n")
+      end
+
+      klass_width = [40, (width - 50) / 2].max
+      schedule_width = 20
+      queue_width = 15
+
+      header = sprintf("  %-#{klass_width}s %-#{schedule_width}s %-#{queue_width}s %s", "JOB CLASS", "SCHEDULE", "QUEUE", "LAST RUN")
+      lines << format_table_header(header)
+
+      jobs.drop(scroll_offset).first(data_rows).each do |job|
+        klass = truncate(job[:klass], klass_width)
+        schedule = truncate(job[:schedule], schedule_width)
+        queue = truncate(job[:options]["queue"] || "default", queue_width)
+        last_run = if job[:history].any?
+                     last = job[:history].first
+                     last.is_a?(Hash) ? (last["enqueued_at"] || "N/A") : last.to_s
+                   else
+                     "Never"
+                   end
+        last_run = truncate(last_run.to_s, 20)
+
+        lines << sprintf("  %-#{klass_width}s %-#{schedule_width}s %-#{queue_width}s %s", klass, @pastel.cyan(schedule), queue, last_run)
+      end
+
+      remaining = jobs.length - scroll_offset - data_rows
+      if remaining > 0
+        lines << @pastel.dim("  ↓ #{remaining} more")
+      end
+
+      lines.join("\n")
+    end
+
     def function_bar
       # Map keys to views for highlighting
       view_keys = {
@@ -1352,7 +1539,9 @@ module Sktop
         "w" => :workers,
         "r" => :retries,
         "s" => :scheduled,
-        "d" => :dead
+        "d" => :dead,
+        "b" => :batches,
+        "c" => :periodic
       }
 
       items = [
@@ -1363,6 +1552,8 @@ module Sktop
         ["r", "Retries"],
         ["s", "Sched"],
         ["d", "Dead"],
+        ["b", "Batch"],
+        ["c", "Cron"],
         ["^C", "Quit"]
       ]
 

data/lib/sktop/stats_collector.rb

@@ -289,5 +289,109 @@ module Sktop
         failed: stats_history.failed
       }
     end
+
+    # Check if Sidekiq Enterprise is loaded.
+    #
+    # @return [Boolean] true if Enterprise features are available
+    def enterprise?
+      defined?(Sidekiq::Enterprise)
+    end
+
+    # Check if Sidekiq Pro is loaded.
+    #
+    # @return [Boolean] true if Pro features are available
+    def pro?
+      defined?(Sidekiq::Pro) || enterprise?
+    end
+
+    # Get the Sidekiq edition name.
+    #
+    # @return [String] "Enterprise", "Pro", or "OSS"
+    def edition
+      if enterprise?
+        "Enterprise"
+      elsif pro?
+        "Pro"
+      else
+        "OSS"
+      end
+    end
+
+    # Get information about active batches (requires Sidekiq Pro or Enterprise).
+    #
+    # @param limit [Integer] maximum number of batches to return (default: 50)
+    # @return [Array<Hash>] array of batch information hashes
+    # @option return [String] :bid the batch ID
+    # @option return [String, nil] :description batch description
+    # @option return [Integer] :total total jobs in batch
+    # @option return [Integer] :pending jobs not yet completed
+    # @option return [Integer] :failures failed jobs
+    # @option return [Time, nil] :created_at when the batch was created
+    # @option return [Boolean] :complete whether all jobs have run
+    # @return [Array] empty array if Pro/Enterprise not available
+    def batches(limit: 50)
+      return [] unless pro? && defined?(Sidekiq::BatchSet)
+
+      Sidekiq::BatchSet.new.first(limit).map do |status|
+        {
+          bid: status.bid,
+          description: status.description,
+          total: status.total,
+          pending: status.pending,
+          failures: status.failures,
+          created_at: status.created_at,
+          complete: status.complete?
+        }
+      end
+    rescue StandardError
+      []
+    end
+
+    # Get information about periodic jobs (requires Sidekiq Enterprise).
+    #
+    # @return [Array<Hash>] array of periodic job information hashes
+    # @option return [String] :lid the loop identifier
+    # @option return [String] :schedule the cron expression
+    # @option return [String] :klass the worker class name
+    # @option return [Hash] :options job options (queue, retry, etc.)
+    # @option return [Array] :history recent execution history
+    # @return [Array] empty array if Enterprise not available
+    def periodic_jobs
+      return [] unless enterprise? && defined?(Sidekiq::Periodic::LoopSet)
+
+      Sidekiq::Periodic::LoopSet.new.map do |lop|
+        {
+          lid: lop.lid,
+          schedule: lop.schedule,
+          klass: lop.klass,
+          options: lop.options || {},
+          history: lop.history || []
+        }
+      end
+    rescue StandardError
+      []
+    end
+
+    # Get the total count of active batches (requires Sidekiq Pro or Enterprise).
+    #
+    # @return [Integer] number of active batches, or 0 if not available
+    def batch_count
+      return 0 unless pro? && defined?(Sidekiq::BatchSet)
+
+      Sidekiq::BatchSet.new.size
+    rescue StandardError
+      0
+    end
+
+    # Get the count of periodic jobs (requires Sidekiq Enterprise).
+    #
+    # @return [Integer] number of periodic jobs, or 0 if not available
+    def periodic_count
+      return 0 unless enterprise? && defined?(Sidekiq::Periodic::LoopSet)
+
+      Sidekiq::Periodic::LoopSet.new.size
+    rescue StandardError
+      0
+    end
   end
 end

data/lib/sktop/version.rb

@@ -4,5 +4,5 @@ module Sktop
   # Current version of the Sktop gem.
   # Follows semantic versioning (major.minor.patch).
   # @return [String] the version string
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sktop
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - James
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-30 00:00:00.000000000 Z
+date: 2026-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sidekiq