Add spinner utility for asynchronous operations in commands

Author: andrew

lib/git/pkgs.rb

@@ -11,6 +11,7 @@
 require_relative "pkgs/ecosystems"
 require_relative "pkgs/osv_client"
 require_relative "pkgs/ecosystems_client"
+require_relative "pkgs/spinner"
 
 require_relative "pkgs/purl_helper"
 require_relative "pkgs/models/branch"

lib/git/pkgs/commands/licenses.rb

@@ -201,7 +201,9 @@ def enrich_packages(purls)
 
           client = EcosystemsClient.new
           begin
-            results = client.bulk_lookup(stale_purls)
+            results = Spinner.with_spinner("Fetching package metadata...") do
+              client.bulk_lookup(stale_purls)
+            end
             results.each do |purl, data|
               packages_by_purl[purl]&.enrich_from_api(data)
             end

lib/git/pkgs/commands/outdated.rb

@@ -158,7 +158,9 @@ def enrich_packages(purls)
 
           client = EcosystemsClient.new
           begin
-            results = client.bulk_lookup(stale_purls)
+            results = Spinner.with_spinner("Fetching package metadata...") do
+              client.bulk_lookup(stale_purls)
+            end
             results.each do |purl, data|
               packages_by_purl[purl]&.enrich_from_api(data)
             end

lib/git/pkgs/spinner.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Git
+  module Pkgs
+    class Spinner
+      FRAMES = %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏].freeze
+      INTERVAL = 0.08
+
+      def initialize(message)
+        @message = message
+        @running = false
+        @thread = nil
+      end
+
+      def start
+        return unless $stdout.tty? && !Git::Pkgs.quiet
+
+        @running = true
+        @frame_index = 0
+        @thread = Thread.new do
+          while @running
+            print "\r#{FRAMES[@frame_index]} #{@message}"
+            @frame_index = (@frame_index + 1) % FRAMES.length
+            sleep INTERVAL
+          end
+        end
+      end
+
+      def stop
+        return unless @thread
+
+        @running = false
+        @thread.join
+        print "\r#{" " * (@message.length + 3)}\r"
+      end
+
+      def self.with_spinner(message)
+        spinner = new(message)
+        spinner.start
+        yield
+      ensure
+        spinner.stop
+      end
+    end
+  end
+end