bidi2pdf 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d71c88a5941411b13770993de9b38f6321c263765ffce1a9bbd347fb960855ac
-  data.tar.gz: aa64333d4dc4de54f6e1b627287a5d11661634f3244a8e3a213428c243f155f1
+  metadata.gz: 3d7fa3c853f53e21a110cadb25fcd66bf97b890eb00663f90e73e8ee9d1ce07e
+  data.tar.gz: 5900568c47f526e9b00d95a15f8293abeaee88f6c0f323bc6e79cdcb3aba38ef
 SHA512:
-  metadata.gz: 1d598fe002552f46e53f803f46577adceeeb087b377a40b486d5d2ef7bf713463f429aa26b2687fb7d0b865d73aacf3262be71e17db154794ac82e1e4a245986
-  data.tar.gz: 3b7cb02b0e857e551c720a665ac31d3669a9a27e8c9e3e5c1cdc497517b8fbcd3e917d6b0735113e3b956b23ded042b44c72bfff637cfdbf2431642bd98aaa2b
+  metadata.gz: 9ecffa81a6358c413dd24b1cef48c3b2282518f5934710558b2ea834a362b198d5a1e3f01a2b3eb8ed163dedffaae61fe2bb0c5f3edec5e3850ad375daf10304
+  data.tar.gz: 0b9d4b19f9d2d01a8babfe2a13c4256b9f93d34f2fcdc1ea2942fb780ce4ad02962050f1adffd9d2c5731e2e6c6d1dd83deaa3d31b348157197c982701a8995b

data/CHANGELOG.md

@@ -11,6 +11,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- generated by git-cliff end -->
 
+## [0.1.9] - 2025-05-04
+
+### 🎨 Refactored
+
+- Enhance reader thread management in Chromedriver by @dieter-medium
+- Improve event listener logging by @dieter-medium
+- Improve event listener management by @dieter-medium
+- Centralize chromedriver test helpers for reuse in other projects by @dieter-medium
+
+### 🐛 Fixed
+
+- Close event socket during session cleanup by @dieter-medium
+- Add test for generating PDFs in parallel by @dieter-medium
+
+### 💄 Style
+
+- Update Bootstrap stylesheet link by @dieter-medium
+
+### 🔧 Build
+
+- Update Ruby version in action.yml by @dieter-medium
+- Update Dockerfile.chromedriver and chromedriver.yml for enhancements by @dieter-medium
+- Update Dockerfile.chromedriver for improved environment setup and vnc support by @dieter-medium
+
+### 🚀 Added
+
+- Enhance testcontainers with shared network support by @dieter-medium
+
 ## [0.1.8] - 2025-04-22
 
 ### 🎨 Refactored
@@ -173,7 +201,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial release
 
 
-- [unreleased](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.8..HEAD)
+- [unreleased](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.9..HEAD)
+- [0.1.9](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.8..v0.1.9)
 - [0.1.8](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.7..v0.1.8)
 - [0.1.7](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.6..v0.1.7)
 - [0.1.6](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.5..v0.1.6)

data/docker/Dockerfile.chromedriver

@@ -1,13 +1,16 @@
-FROM ruby:3.3
+FROM debian:bookworm-slim
 
 ARG CHROMEDRIVER_PORT=3000
 
 ENV DEBIAN_FRONTEND=noninteractive
+ENV LANG=en_US.UTF-8
 
 # Install dependencies
-RUN apt-get update && apt-get upgrade -y && \
+RUN echo "deb http://deb.debian.org/debian bookworm contrib non-free" > /etc/apt/sources.list.d/contrib.list &&\
+    echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | debconf-set-selections &&\
+    apt-get update && apt-get upgrade -y && \
     apt-get install -y --no-install-recommends\
-    chromium chromium-driver\
+    chromium chromium-driver chromium-l10n chromium-sandbox\
     libglib2.0-0 \
     libnss3 \
     libxss1 \
@@ -18,10 +21,21 @@ RUN apt-get update && apt-get upgrade -y && \
     curl \
     unzip \
     xvfb \
+    x11vnc \
+    fluxbox \
+    xterm \
+    wmctrl \
+    net-tools xauth \
+    fonts-liberation fonts-dejavu-core  fonts-noto-core fonts-noto-cjk fonts-noto-color-emoji fonts-symbola fontconfig ttf-mscorefonts-installer\
+    libnss3 libatk1.0-0 \
+    libx11-6 libxss1 libgtk-3-0 libgbm1 \
+    locales sed \
+    && sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen \
+    && locale-gen en_US.UTF-8 \
     && rm -rf /var/lib/apt/lists/*
 
 # Create a non-root user
-RUN groupadd -r appuser && useradd -r -g appuser -m -d /home/appuser appuser
+RUN groupadd -r appuser && useradd -r -g appuser -G audio,video -m -d /home/appuser appuser
 
 COPY ./docker/entrypoint.sh /usr/local/bin/entrypoint.sh
 RUN chmod +x /usr/local/bin/entrypoint.sh
@@ -36,12 +50,16 @@ RUN mkdir -p /home/appuser/.webdrivers && ln -s /usr/bin/chromedriver /home/appu
 # Set working directory
 WORKDIR /app
 
+RUN mkdir -p /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix
+
 # Switch to non-root user
 USER appuser
 
-RUN gem install chromedriver-binary && ruby -e 'require "chromedriver/binary"; puts Chromedriver::Binary::ChromedriverDownloader.update'
+# RUN gem install chromedriver-binary && ruby -e 'require "chromedriver/binary"; puts Chromedriver::Binary::ChromedriverDownloader.update'
 
 ENV CHROMEDRIVER_PORT=${CHROMEDRIVER_PORT}
 EXPOSE ${CHROMEDRIVER_PORT}
+# VNC
+EXPOSE 5900
 
 CMD ["/usr/local/bin/entrypoint.sh"]

data/docker/entrypoint.sh

@@ -3,6 +3,47 @@
 USER_DATA_DIR=/home/appuser/.cache
 mkdir -p ${USER_DATA_DIR}
 
+if [ "$ENABLE_XVFB" = "true" ]; then
+  rm -rf /tmp/.X99-lock
+
+  export DISPLAY=:99
+  Xvfb :99 -screen 0 1920x1080x24 &
+
+  old_umask=$(umask)
+  umask 077
+
+  touch /home/appuser/.Xauthority
+  export XAUTHORITY=/home/appuser/.Xauthority
+
+  xauth generate :99 . trusted
+
+  umask $old_umask
+
+
+
+  until xdpyinfo -display ${DISPLAY} >/dev/null 2>&1; do
+      sleep 0.2
+  done
+
+  fluxbox &
+
+  until wmctrl -m > /dev/null 2>&1; do
+    sleep 0.2
+  done
+fi
+
+if [ "$ENABLE_VNC" = "true" ]; then
+  VNC_PASS=${VNC_PASS:-$(tr -dc A-Za-z0-9 </dev/urandom | head -c 12)}
+  echo "VNC password: $VNC_PASS"
+  old_umask=$(umask)
+  umask 077
+  mkdir -p /home/appuser/.vnc
+  x11vnc -storepasswd $VNC_PASS /home/appuser/.vnc/passwd
+  umask $old_umask
+  x11vnc -display WAIT:99 -xkb -noxrecord -noxfixes -noxdamage -forever -shared -noshm -usepw -rfbauth /home/appuser/.vnc/passwd &
+fi
+
+# DISPLAY=:99 /home/appuser/.webdrivers/chromedriver --port=33259 --whitelisted-ips=""  --allowed-origins="*" --disable-dev-shm-usage --disable-gpu  --verbose
 /home/appuser/.webdrivers/chromedriver --port=${CHROMEDRIVER_PORT} \
                                        --headless \
                                        --whitelisted-ips="" \

data/lib/bidi2pdf/bidi/browser_tab.rb

@@ -141,7 +141,7 @@ module Bidi2pdf
         headers:,
         url_patterns:
       )
-        AddHeadersInterceptor.new(
+        @header_interceptor = AddHeadersInterceptor.new(
           context: browsing_context_id,
           url_patterns: url_patterns,
           headers: headers
@@ -155,7 +155,7 @@ module Bidi2pdf
       # @param [Array<String>] url_patterns The URL patterns to match.
       # @return [AuthInterceptor] The interceptor instance.
       def basic_auth(username:, password:, url_patterns:)
-        AuthInterceptor.new(
+        @basic_auth_interceptor = AuthInterceptor.new(
           context: browsing_context_id,
           url_patterns: url_patterns,
           username: username, password: password
@@ -430,14 +430,14 @@ module Bidi2pdf
         return if @event_handlers_registered
 
         @event_handlers_registered = true
+        @listener_refs ||= {}
 
-        client.on_event("network.beforeRequestSent", "network.responseStarted", "network.responseCompleted", "network.fetchError",
-                        &network_events.method(:handle_event))
+        @listener_refs[:network] = client.on_event("network.beforeRequestSent", "network.responseStarted", "network.responseCompleted", "network.fetchError",
+                                                   &network_events.method(:handle_event))
 
-        client.on_event("log.entryAdded",
-                        &logger_events.method(:handle_event))
+        @listener_refs[:logger] = client.on_event("log.entryAdded", &logger_events.method(:handle_event))
 
-        client.on_event("browsingContext.navigationFailed", &navigation_failed_events.method(:handle_event))
+        @listener_refs[:navigation_failed] = client.on_event("browsingContext.navigationFailed", &navigation_failed_events.method(:handle_event))
       end
 
       def handle_injection_exception(response, url, exception_class)
@@ -568,16 +568,27 @@ module Bidi2pdf
       end
 
       # Removes event listeners for the browser tab.
+      # rubocop:disable Metrics/AbcSize
       def remove_event_listeners
+        return if @listener_refs.nil? || @listener_refs.empty?
+
         Bidi2pdf.logger.debug2 "Network events: #{network_events.all_events.map(&:to_s)}"
 
-        client.remove_event_listener "network.responseStarted", "network.responseCompleted", "network.fetchError",
-                                     &network_events.method(:handle_event)
+        client.remove_event_listener("network.beforeRequestSent", "network.responseStarted", "network.responseCompleted", "network.fetchError",
+                                     @listener_refs[:network])
+
+        client.remove_event_listener("log.entryAdded", @listener_refs[:logger])
 
-        client.remove_event_listener("log.entryAdded",
-                                     &logger_events.method(:handle_event))
+        @header_interceptor&.unregister_with_client(client: client)
+        @basic_auth_interceptor&.unregister_with_client(client: client)
+
+        @header_interceptor = nil
+        @basic_auth_interceptor = nil
+        @listener_refs = {}
       end
 
+      # rubocop:enable Metrics/AbcSize
+
       # Closes all tabs associated with the browser tab.
       def close_tabs
         tabs.each do |tab|

data/lib/bidi2pdf/bidi/client.rb

@@ -125,23 +125,25 @@ module Bidi2pdf
       #
       # @param [Array<String>] names The names of the events to subscribe to.
       # @yield [event_data] A block to handle the event data.
-      def on_event(*names, &block)
-        names.each { |name| dispatcher.on_event(name, &block) }
+      def on_event(*names, &)
+        listener = dispatcher.on_event(*names, &)
         cmd = Bidi2pdf::Bidi::Commands::SessionSubscribe.new(events: names)
         send_cmd(cmd) if names.any?
+
+        listener
       end
 
       # Removes a message listener.
       #
       # @param [Proc] block The listener block to remove.
-      def remove_message_listener(block) = dispatcher.remove_message_listener(block)
+      def remove_message_listener(listener) = dispatcher.remove_message_listener(listener)
 
       # Removes event listeners for specific events.
       #
       # @param [Array<String>] names The names of the events to unsubscribe from.
       # @param [Proc] block The listener block to remove.
-      def remove_event_listener(*names, &block)
-        names.each { |event_name| dispatcher.remove_event_listener(event_name, block) }
+      def remove_event_listener(*names, listener)
+        names.each { |event_name| dispatcher.remove_event_listener(event_name, listener) }
       end
 
       # Closes the WebSocket connection.

data/lib/bidi2pdf/bidi/event_manager.rb

@@ -3,6 +3,27 @@
 module Bidi2pdf
   module Bidi
     class EventManager
+      Listener = Struct.new(:block, :id, :source_location) do
+        def initialize(block, id = SecureRandom.uuid)
+          super
+          self.source_location = block.source_location
+        end
+
+        def call(*args)
+          block.call(*args)
+        end
+
+        def ==(other)
+          other.is_a?(Listener) && id == other.id
+        end
+
+        alias_method :eql?, :==
+
+        def hash
+          id.hash
+        end
+      end
+
       attr_reader :type
 
       def initialize(type)
@@ -11,12 +32,21 @@ module Bidi2pdf
       end
 
       def on(*event_names, &block)
-        event_names.each { |event_name| @listeners[event_name.to_sym] << block }
-
-        block
+        Listener.new(block).tap do |listener|
+          event_names.each do |event_name|
+            @listeners[event_name.to_sym] << listener
+            log_msg("Adding #{event_name} listener", listener)
+          end
+        end
       end
 
-      def off(event_name, block) = @listeners[event_name.to_sym].delete(block)
+      def off(event_name, listener)
+        raise ArgumentError, "Listener not registered" unless listener.is_a?(Listener)
+
+        log_msg("Removing #{event_name} listener", listener)
+
+        @listeners[event_name.to_sym].delete(listener)
+      end
 
       def dispatch(event_name, *args)
         listeners = @listeners[event_name.to_sym] || []

data/lib/bidi2pdf/bidi/interceptor.rb

@@ -27,14 +27,24 @@ module Bidi2pdf
         client.send_cmd_and_wait(cmd) do |response|
           @interceptor_id = response["result"]["intercept"]
 
-          Bidi2pdf.logger.debug "Interceptor added: #{@interceptor_id}"
+          Bidi2pdf.logger.debug2 "Interceptor added: #{@interceptor_id}"
 
-          client.on_event(*self.class.events, &method(:handle_event))
+          @handle_event_listener = client.on_event(*self.class.events, &method(:handle_event))
 
           self
         end
       end
 
+      def unregister_with_client(client:)
+        return unless @handle_event_listener
+
+        client.remove_event_listener(*self.class.events, @handle_event_listener)
+
+        Bidi2pdf.logger.debug2 "Interceptor removed: #{@interceptor_id}"
+
+        @handle_event_listener = nil
+      end
+
       # rubocop: disable Metrics/AbcSize
       def handle_event(response)
         event_response = response["params"]

data/lib/bidi2pdf/bidi/session.rb

@@ -165,6 +165,7 @@ module Bidi2pdf
         Bidi2pdf.logger.info "Subscribing to events"
 
         Bidi::Client.new(websocket_url).tap do |event_client|
+          @event_socket = event_client
           event_client.start
           event_client.wait_until_open
 
@@ -320,6 +321,7 @@ module Bidi2pdf
       # Cleans up resources associated with the session.
       def cleanup
         @client&.close
+        @event_socket&.close
         @client = @websocket_url = @browser = nil
       end
     end

data/lib/bidi2pdf/bidi/web_socket_dispatcher.rb

@@ -24,7 +24,7 @@ module Bidi2pdf
 
       def on_message(&) = socket_events.on(:message, &)
 
-      def on_event(name, &) = session_events.on(name, &)
+      def on_event(*event_names, &) = session_events.on(*event_names, &)
 
       def on_open(&) = socket_events.on(:open, &)
 
@@ -34,13 +34,13 @@ module Bidi2pdf
 
       def remove_message_listener(block) = socket_events.off(:message, block)
 
-      def remove_event_listener(name, block) = session_events.off(name, block)
+      def remove_event_listener(name, listener) = session_events.off(name, listener)
 
-      def remove_open_listener(block) = socket_events.off(:open, block)
+      def remove_open_listener(listener) = socket_events.off(:open, listener)
 
-      def remove_close_listener(block) = socket_events.off(:close, block)
+      def remove_close_listener(listener) = socket_events.off(:close, listener)
 
-      def remove_error_listener(block) = socket_events.off(:error, block)
+      def remove_error_listener(listener) = socket_events.off(:error, listener)
 
       private
 

data/lib/bidi2pdf/chromedriver_manager.rb

@@ -8,6 +8,7 @@ module Bidi2pdf
     include Chromedriver::Binary::Platform
 
     attr_reader :port, :pid, :started, :headless, :chrome_args, :shutdown_mutex
+    attr_accessor :reader_thread
 
     def initialize(port: 0, headless: true, chrome_args: Bidi::Session::DEFAULT_CHROME_ARGS)
       @port = port
@@ -49,10 +50,20 @@ module Bidi2pdf
       "http://localhost:#{@port}/session"
     end
 
+    # rubocop: disable Metrics/AbcSize
     def stop(timeout: 5)
       shutdown_mutex.synchronize do
         return unless @pid
 
+        if reader_thread&.alive?
+          begin
+            reader_thread.kill
+            reader_thread.join
+          rescue StandardError => e
+            Bidi2pdf.logger.error "Error killing reader thread: #{e.message}"
+          end
+        end
+
         @started = false
 
         close_session
@@ -72,6 +83,8 @@ module Bidi2pdf
       end
     end
 
+    # rubocop: enable Metrics/AbcSize
+
     private
 
     def spawn_process(cmd)
@@ -184,25 +197,26 @@ module Bidi2pdf
 
     # rubocop: disable Metrics/AbcSize
     def parse_port_from_output(io, timeout: 5)
-      Thread.new do
-        io.each_line do |line|
-          Bidi2pdf.logger.debug1 line.chomp
+      port_event = Concurrent::Event.new
 
-          next unless line =~ /ChromeDriver was started successfully on port (\d+)/
-
-          Bidi2pdf.logger.debug "Found port: #{::Regexp.last_match(1).to_i} setup port: #{@port}"
-
-          @port = ::Regexp.last_match(1).to_i if @port.nil? || @port.zero?
+      self.reader_thread = Thread.new do
+        io.each_line do |line|
+          Bidi2pdf.logger.info "[chromedriver] #{line.chomp}"
 
-          break
+          if line =~ /ChromeDriver was started successfully on port (\d+)/
+            @port = ::Regexp.last_match(1).to_i if @port.nil? || @port.zero?
+            port_event.set
+          end
         end
       rescue IOError
         # reader closed
       ensure
         io.close unless io.closed?
-      end.join(timeout)
+      end
+
+      return if port_event.wait(timeout)
 
-      raise "Chromedriver did not report a usable port in #{timeout}s" if @port.nil?
+      raise "Chromedriver did not report a usable port in #{timeout}s"
     end
 
     # rubocop: enable Metrics/AbcSize

data/lib/bidi2pdf/test_helpers/testcontainers/chromedriver_container.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-begin
-  require "testcontainers"
-rescue LoadError
-  warn "Missing #{dep}. Add it to your Gemfile if you're using Bidi2pdf test helpers."
-end
-
 module Bidi2pdf
   module TestHelpers
     module Testcontainers

data/lib/bidi2pdf/test_helpers/testcontainers/chromedriver_test_helper.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative "shared_docker_network"
+
+module Bidi2pdf
+  module TestHelpers
+    module Testcontainers
+      module ChromedriverTestHelper
+        def session_url
+          chromedriver_container.session_url
+        end
+
+        def chromedriver_container
+          RSpec.configuration.chromedriver_container
+        end
+      end
+
+      module SessionTestHelper
+        def chrome_args
+          chrome_args = Bidi2pdf::Bidi::Session::DEFAULT_CHROME_ARGS.dup
+
+          # within github actions, the sandbox is not supported, when we start our own container
+          # some privileges are not available ???
+          if ENV["DISABLE_CHROME_SANDBOX"]
+            chrome_args << "--no-sandbox"
+
+            puts "🚨 Chrome sandbox disabled"
+          end
+          chrome_args
+        end
+
+        def create_session(session_url)
+          Bidi2pdf::Bidi::Session.new(session_url: session_url, headless: true, chrome_args: chrome_args)
+        end
+      end
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.add_setting :chromedriver_container, default: nil
+
+  config.include Bidi2pdf::TestHelpers::Testcontainers::ChromedriverTestHelper, chromedriver: true
+  config.include Bidi2pdf::TestHelpers::Testcontainers::SessionTestHelper, session: true
+
+  config.before(:suite) do
+    if chromedriver_tests_present?
+      config.chromedriver_container = start_chromedriver_container(
+        build_dir: File.join(config.docker_dir, ".."),
+        mounts: config.respond_to?(:chromedriver_mounts) ? config.chromedriver_mounts : {},
+        shared_network: config.shared_network
+      )
+
+      puts "🚀 chromedriver container started for tests"
+    end
+  end
+
+  config.after(:suite) do
+    stop_container config.chromedriver_container
+  end
+end
+
+def stop_container(container)
+  if container&.running?
+
+    if ENV["SHOW_CONTAINER_LOGS"]
+      puts "Container logs:"
+      logs_std, logs_error = container.logs
+
+      puts logs_error
+      puts logs_std
+    end
+
+    puts "🧹 #{container.image} stopping container..."
+    container.stop
+  end
+  container&.remove
+end
+
+def chromedriver_tests_present?
+  test_of_kind_present? :chromedriver
+end
+
+def test_of_kind_present?(type)
+  RSpec.world.filtered_examples.values.flatten.any? { |example| example.metadata[type] }
+end
+
+# alias the long class name
+ChromedriverTestcontainer = Bidi2pdf::TestHelpers::Testcontainers::ChromedriverContainer
+
+def start_chromedriver_container(build_dir:, mounts:, shared_network:)
+  container = ChromedriverTestcontainer.new(ChromedriverTestcontainer::DEFAULT_IMAGE,
+                                            build_dir: build_dir,
+                                            docker_file: "docker/Dockerfile.chromedriver")
+                                       .with_network(shared_network)
+                                       .with_network_aliases("remote-chrome")
+
+  container.with_filesystem_binds(mounts) if mounts&.any?
+
+  container.start
+
+  container
+end

data/lib/bidi2pdf/test_helpers/testcontainers/shared_docker_network.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+RSpec.configure do |config|
+  config.add_setting :shared_network, default: nil
+
+  config.before(:suite) do
+    examples = RSpec.world.filtered_examples.values.flatten
+    uses_containers = examples.any? do |ex|
+      ex.metadata[:nginx] || ex.metadata[:chrome] || ex.metadata[:chromedriver] || ex.metadata[:container]
+    end
+
+    if uses_containers
+      config.shared_network = Docker::Network.create("bidi2pdf-test-net-#{SecureRandom.hex(4)}")
+      puts "🕸️  started shared network #{config.shared_network}"
+    end
+  end
+
+  config.after(:suite) do
+    config.shared_network&.remove
+  end
+end

data/lib/bidi2pdf/test_helpers/testcontainers/testcontainers_refinement.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Bidi2pdf
+  module TestHelpers
+    module TestcontainersRefinement
+      def id
+        @_id
+      end
+
+      def aliases
+        @aliases ||= []
+      end
+
+      def aliases=(aliases)
+        @aliases = aliases
+      end
+
+      def network
+        @_network
+      end
+
+      def with_network(network)
+        @_network = network
+        self
+      end
+
+      def with_network_aliases(*aliases)
+        self.aliases += aliases
+        self
+      end
+
+      def _container_create_options
+        opts = super
+        network_name = network ? network.info["Name"] : nil
+        opts["HostConfig"]["NetworkMode"] = network_name
+
+        if network && aliases.any?
+          opts["NetworkingConfig"] = {
+            "EndpointsConfig" => {
+              network_name => {
+                "Aliases" => aliases
+              }
+            }
+          }
+        end
+
+        opts.compact
+      end
+    end
+  end
+end
+
+Testcontainers::DockerContainer.prepend(Bidi2pdf::TestHelpers::TestcontainersRefinement)

data/lib/bidi2pdf/test_helpers/testcontainers.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+%w[docker testcontainers].each do |dep|
+  require dep
+rescue LoadError
+  warn "Missing #{dep}. Add it to your Gemfile if you're using Bidi2pdf test helpers."
+end
+
+module Bidi2pdf
+  module TestHelpers
+    module Testcontainers
+      require_relative "testcontainers/testcontainers_refinement"
+      require_relative "testcontainers/chromedriver_container"
+      require_relative "testcontainers/chromedriver_test_helper"
+    end
+  end
+end

data/lib/bidi2pdf/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bidi2pdf
-  VERSION = "0.1.8"
+  VERSION = "0.1.9"
 end

data/sig/bidi2pdf/bidi/event_manager.rbs

@@ -1,29 +1,35 @@
 module Bidi2pdf
   module Bidi
     class EventManager
-      @browser: Bidi2pdf::Bidi::Browser
-      @listeners: Hash[String, Array[Proc]]
-      @active: bool
+      class Listener
+        attr_reader block: untyped
+        attr_reader id: String
 
-      def initialize: (browser: Bidi2pdf::Bidi::Browser) -> void
+        def initialize: (untyped block, ?String id) -> void
 
-      def on: (String event_name) { (Hash[String, untyped]) -> void } -> void
+        def call: (*untyped args) -> untyped
 
-      def off: (String event_name) -> void
+        def ==: (untyped other) -> bool
 
-      def emit: (String event_name, Hash[String, untyped] params) -> void
+        def eql?: (untyped other) -> bool
 
-      def start_listening: () -> void
+        def hash: () -> Integer
+      end
 
-      def stop_listening: () -> void
+      @listeners: untyped
+      @type: untyped
 
-      private
+      attr_reader type: untyped
 
-      def register_browser_events: () -> void
+      def initialize: (untyped type) -> void
 
-      def handle_event: (String event_name, Hash[String, untyped] params) -> void
+      def on: (*untyped event_names, &untyped block) -> Listener
 
-      def process_event: (String event_name, Hash[String, untyped] params) -> void
+      def off: (untyped event_name, Listener listener) -> void
+
+      def dispatch: (untyped event_name, *untyped args) -> void
+
+      def clear: (?untyped event_name) -> void
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bidi2pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Dieter S.
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -425,7 +424,11 @@ files:
 - lib/bidi2pdf/test_helpers/matchers/match_pdf_text.rb
 - lib/bidi2pdf/test_helpers/pdf_reader_utils.rb
 - lib/bidi2pdf/test_helpers/pdf_text_sanitizer.rb
+- lib/bidi2pdf/test_helpers/testcontainers.rb
 - lib/bidi2pdf/test_helpers/testcontainers/chromedriver_container.rb
+- lib/bidi2pdf/test_helpers/testcontainers/chromedriver_test_helper.rb
+- lib/bidi2pdf/test_helpers/testcontainers/shared_docker_network.rb
+- lib/bidi2pdf/test_helpers/testcontainers/testcontainers_refinement.rb
 - lib/bidi2pdf/verbose_logger.rb
 - lib/bidi2pdf/version.rb
 - sig/bidi2pdf.rbs
@@ -484,7 +487,6 @@ metadata:
   source_code_uri: https://github.com/dieter-medium/bidi2pdf
   changelog_uri: https://github.com/dieter-medium/bidi2pdf/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -499,8 +501,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.8
 specification_version: 4
 summary: A Ruby gem that generates PDFs from web pages using Chrome's BiDi protocol,
   providing high-quality PDF documents from any URL with full support for modern web