rspec-abq 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c00fc46fa75e809e38059148813cad04792dded8e9b572e50876750a6b4a39cb
-  data.tar.gz: e389974965efdba61a3c26a6c2a2e866fb5d925a9040aad03161ba9a22fba719
+  metadata.gz: 600f920ed258588d3e095996daf8b1b5a8ff67858d0c1df3dea3855740b747a5
+  data.tar.gz: a766fe3b12b746d82c9b794a4f2b605d083926b4f39101ba37c3549d422231b8
 SHA512:
-  metadata.gz: 785a76c6f549cbd82b339f76fe8ec50ab5cead2934acefd7e074c37b7f53d5a7863d9626914ce98f585dca4de6706bad7da329929d83d7d3585a707b2e2ff4ad
-  data.tar.gz: 4abb71ba175be22c447d2b9e1fb53dd000bb80e08268cd3ff58369ad883a228df5cdf9da0f3eb89bdfc516d5a984b0495924f21477b738ecbebe88b5da693af3
+  metadata.gz: 8d48f7d704adb92e94f140abd282b8f607fc3f537bdcf090d49237392bf011ca465a2b25bcb255f2cf7aa1a0ee84dd077dcfecef41e684aace402444bec3e222
+  data.tar.gz: ddf5b9213ea7a18e5b3925ed481dd60df6dfeed7637230e549e3cbb2b54b958268e156e7f5de91cfc6566e81784c99947a98e60892b8bc411bbf2c5be541c1a1

data/lib/rspec/abq/debug_logger.rb

@@ -0,0 +1,90 @@
+module RSpec
+  module Abq
+    # @!visibility private
+    module DebugLogger
+      # @!visibility private
+      RSPEC_ABQ_DEBUG_LOG_DIR = "RSPEC_ABQ_DEBUG_LOG_DIR"
+
+      # @!visibility private
+      ABQ_RUNNER = "ABQ_RUNNER"
+
+      class << self
+        # @!visibility private
+        def enabled?
+          ENV.key?(RSPEC_ABQ_DEBUG_LOG_DIR) && !ENV[RSPEC_ABQ_DEBUG_LOG_DIR].to_s.empty?
+        end
+
+        # @!visibility private
+        def log(message)
+          return unless enabled?
+          file.puts("[#{timestamp}] #{message}")
+          file.flush
+        end
+
+        # @!visibility private
+        def log_start(operation)
+          return nil unless enabled?
+          start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          log("START #{operation}")
+          start_time
+        end
+
+        # @!visibility private
+        def log_end(operation, start_time)
+          return unless enabled? && start_time
+          elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
+          log("END #{operation} (#{format_duration(elapsed)})")
+        end
+
+        # @!visibility private
+        def log_operation(operation)
+          return yield unless enabled?
+
+          start_time = log_start(operation)
+          begin
+            result = yield
+            log_end(operation, start_time)
+            result
+          rescue => e
+            log("ERROR #{operation}: #{e.class} - #{e.message}")
+            raise
+          end
+        end
+
+        # @!visibility private
+        def close
+          return unless @file
+          @file.close
+          @file = nil
+        end
+
+        private
+
+        def file
+          @file ||= begin
+            dir = ENV[RSPEC_ABQ_DEBUG_LOG_DIR]
+            FileUtils.mkdir_p(dir)
+            runner = ENV[ABQ_RUNNER] || "unknown"
+            path = File.join(dir, "worker-#{runner}.log")
+            File.open(path, "a").tap do |f|
+              f.puts("[#{timestamp}] === rspec-abq logger started (pid=#{Process.pid}, runner=#{runner}) ===")
+              f.flush
+            end
+          end
+        end
+
+        def timestamp
+          Time.now.strftime("%Y-%m-%d %H:%M:%S.%6N")
+        end
+
+        def format_duration(seconds)
+          if seconds < 1
+            "#{(seconds * 1000).round(2)}ms"
+          else
+            "#{seconds.round(3)}s"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rspec/abq/version.rb

@@ -1,6 +1,6 @@
 module RSpec
   module Abq
     # current version!
-    VERSION = "1.2.1"
+    VERSION = "1.2.2"
   end
 end

data/lib/rspec/abq.rb

@@ -2,6 +2,8 @@ require "set"
 require "rspec/core"
 require "socket"
 require "json"
+require "fileutils"
+require "rspec/abq/debug_logger"
 require "rspec/abq/extensions"
 require "rspec/abq/manifest"
 require "rspec/abq/ordering"
@@ -145,7 +147,7 @@ module RSpec
     # @return [void]
     def self.setup_extensions_if_enabled!
       return unless enabled?
-      perform_handshake!
+      DebugLogger.log_operation("perform_handshake!") { perform_handshake! }
       Extensions.setup!
     end
 
@@ -213,7 +215,7 @@ module RSpec
       # information amongst worker processes. In RSpec, it is used to ensure that random ordering between workers
       # shares the same seed.
       init_message = protocol_read
-      protocol_write(INIT_SUCCESS_MESSAGE)
+      DebugLogger.log_operation("protocol_write(INIT_SUCCESS_MESSAGE)") { protocol_write(INIT_SUCCESS_MESSAGE) }
 
       if init_message["fast_exit"]
         @fast_exit = true
@@ -234,13 +236,17 @@ module RSpec
     # @!visibility private
     def self.socket(connect_timeout: 5)
       @socket ||= begin
-        Socket.tcp(*ENV[ABQ_SOCKET].split(":"), connect_timeout: connect_timeout).tap do |socket|
+        sock = DebugLogger.log_operation("socket_connect") do
+          Socket.tcp(*ENV[ABQ_SOCKET].split(":"), connect_timeout: connect_timeout)
+        end
+        sock.tap do |socket|
           # Messages sent to/received from the ABQ worker should be done so ASAP.
           # Since we're on a local network, we don't care about packet reduction here.
           socket.setsockopt(Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1)
           protocol_write(NATIVE_RUNNER_SPAWNED_MESSAGE, socket)
         end
-      rescue
+      rescue => e
+        DebugLogger.log("socket: connection failed - #{e.class}: #{e.message}")
         raise ConnectionFailed, "Unable to connect to ABQ socket #{ENV[ABQ_SOCKET]}"
       end
     end
@@ -275,11 +281,16 @@ module RSpec
     # @param msg
     def self.protocol_write(msg, socket = Abq.socket)
       json_msg = JSON.dump msg
-      socket.write [json_msg.bytesize].pack("N")
-      socket.write json_msg
-    rescue SystemCallError, IOError
+      msg_type = msg[:type] || msg["type"] || (msg[:test_result] ? "test_result" : "unknown")
+      DebugLogger.log_operation("protocol_write(#{msg_type})") do
+        socket.write [json_msg.bytesize].pack("N")
+        socket.write json_msg
+      end
+    rescue SystemCallError, IOError => e
+      DebugLogger.log("protocol_write: connection broken - #{e.class}: #{e.message}")
       raise ConnectionBroken
-    rescue
+    rescue => e
+      DebugLogger.log("protocol_write: error - #{e.class}: #{e.message}")
       raise Error
     end
 
@@ -287,18 +298,20 @@ module RSpec
     #
     # @param socket [TCPSocket]
     # @return msg
-    def self.protocol_read(socket = Abq.socket)
-      len_bytes = socket.read 4
+    def self.protocol_read(socket = Abq.socket, context: nil)
+      len_bytes = DebugLogger.log_operation("protocol_read(#{context || "unknown"}::len)") { socket.read 4 }
       return :abq_done if len_bytes.nil?
 
       len = len_bytes.unpack1("N")
-      json_msg = socket.read len
+      json_msg = DebugLogger.log_operation("protocol_read(#{context || "unknown"}::msg)") { socket.read len }
       return :abq_done if json_msg.nil?
 
       JSON.parse json_msg
-    rescue SystemCallError, IOError
+    rescue SystemCallError, IOError => e
+      DebugLogger.log("protocol_read: connection broken - #{e.class}: #{e.message}")
       raise ConnectionBroken
-    rescue
+    rescue => e
+      DebugLogger.log("protocol_read: error - #{e.class}: #{e.message}")
       raise Error
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rspec-abq
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - rwx
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-13 00:00:00.000000000 Z
+date: 2025-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core
@@ -170,6 +170,7 @@ files:
 - LICENSE.md
 - README.md
 - lib/rspec/abq.rb
+- lib/rspec/abq/debug_logger.rb
 - lib/rspec/abq/extensions.rb
 - lib/rspec/abq/formatter.rb
 - lib/rspec/abq/manifest.rb