rspec-abq 1.2.0 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4981ef40bdbb50ac4e89c78713e13eb64dfa7527a828b6f748f914bedc6f4f00
-  data.tar.gz: ba3ab95a526e074b75bfdcbe6a5546230b9ee2b23fd4f2f0ec90a8b57ab86dfc
+  metadata.gz: 600f920ed258588d3e095996daf8b1b5a8ff67858d0c1df3dea3855740b747a5
+  data.tar.gz: a766fe3b12b746d82c9b794a4f2b605d083926b4f39101ba37c3549d422231b8
 SHA512:
-  metadata.gz: ac9cb3808e6fdaf81032bd2cc69ff388e06834f09594e9a0072276951417fe36ef6f5243b1f5edccc755b15603fde75a5261361a7368b40ec1fe01395b95680b
-  data.tar.gz: c5b702af12ad956ee040c45a4e8d7a8a84ab8278315dc1ccb968b681e96577aba986dfd6d39d9a22427985aa47249e0803d4d7f606afb8b427f62b640a2ff5ea
+  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/formatter.rb

@@ -41,7 +41,7 @@ module RSpec
           tags: tags,
           meta: meta,
           location: {
-            file: example.metadata[:file_path],
+            file: example.id.sub(FILE_REGEX, ".rb"),
             line: example.metadata[:line_number]
           },
           started_at: execution_result.started_at.utc.iso8601(6), # anything higher-prescision just yielded 0s
@@ -108,6 +108,9 @@ module RSpec
           }
         end
       end
+
+      FILE_REGEX = /\.rb(:.+|\[.+\])\z/
+      private_constant :FILE_REGEX
     end
   end
 end

data/lib/rspec/abq/version.rb

@@ -1,6 +1,6 @@
 module RSpec
   module Abq
     # current version!
-    VERSION = "1.2.0"
+    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.0
+  version: 1.2.2
 platform: ruby
 authors:
 - rwx
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-01 00:00:00.000000000 Z
+date: 2025-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core
@@ -80,70 +80,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.10.0
+        version: '4.32'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.10.0
+        version: '4.32'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
-- !ruby/object:Gem::Dependency
-  name: webdrivers
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.3'
+        version: '1.18'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.4'
+        version: '6.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.4'
+        version: '6.6'
 - !ruby/object:Gem::Dependency
   name: capybara-inline-screenshot
   requirement: !ruby/object:Gem::Requirement
@@ -184,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
@@ -208,14 +195,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: RSpec::Abq allows for parallel rspec runs using abq