bidi2pdf 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b92ff566ca3ae322033cd9602818c94ae30da2594c7075bbb86f4c16351d58ce
-  data.tar.gz: 1b4d46aa7fe35c1810522a51400c3558f04d8fdc4093c7b3efa0f507a4959392
+  metadata.gz: 541e9193b3285383b2a82065b173af87c68edeb08ec157125761f44285118dff
+  data.tar.gz: ab12e33ad21e8377ef964aa12d0d9b0ba757ee941c217febe6d46fb1cc381d5e
 SHA512:
-  metadata.gz: 63aa303c4dc6245510cb212adaf22523190d8e00892f4ffe9dc9ba9b65e966f74517ee748f4a232736701a3271ae086879fcbf0adc02ce9f9cd82d103ea3e70d
-  data.tar.gz: 320a0a03c399541157bd192b6389fecf5541c994cdcaa186694085887ecc8de0829b63badc2be5fa0cd2b8c9baa4ee60bfe7a2f457743d4f21506f1d4bb44850
+  metadata.gz: 91be15b3310098c7f16153331fa0a27a8b869dfebc9f3720a7da26d2c59b8444f266e21e93d74891b423e50d8223b01b2198f230753d38ad523b8c846c12150f
+  data.tar.gz: 504516ecc1eac40e6c6e159c5f14aafdeb9d23bc587fcf6914ab60d8676a930a7866d6d0c07998398359c402780584f1e5b317c274dd6f3dba0ba50c1a73cbe6

data/CHANGELOG.md

@@ -6,10 +6,34 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 [unreleased]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.5..HEAD
 
 <!-- generated by git-cliff end -->
 
+## [0.1.6]
+
+### ⚠️ Breaking Changes
+
+- Rename view_html_page to render_html by @dieter-medium
+- Rename wait_until_all_finished to wait_until_network_idle by @dieter-medium
+
+### 📝 Docs
+
+- Update Docker instructions in README by @dieter-medium
+
+### 🔄 Changed
+
+- Add details on network logging and console capture by @dieter-medium
+
+### 🚀 Added
+
+- Add PDF network log formatting and customizable outputs by @dieter-medium
+- Add option to log network traffic and handle failures within the cli command by @dieter-medium
+- Add structured network traffic logging by @dieter-medium
+- Add slim variant Dockerfile and build matrix for CI by @dieter-medium
+- Add official image at [Docker Hub](https://hub.docker.com/r/dieters877565/bidi2pdf) by @dieter-medium
+
 ## [0.1.5] - 2025-04-10
 
 ### 📝 Docs
@@ -92,3 +116,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2025-03-26
 
 - Initial release
+
+[unreleased]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.6..HEAD
+
+[0.1.6]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.5..v0.1.6
+
+[0.1.5]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.4..v0.1.5
+
+[0.1.4]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.3..v0.1.4 

data/README.md

@@ -7,8 +7,8 @@
 
 # 📄 Bidi2pdf – Bulletproof PDF generation via Chrome's BiDi Protocol
 
-**Bidi2pdf** is a powerful Ruby gem that transforms modern web pages into high-fidelity PDFs using Chrome’s *
-*BiDirectional (BiDi)** protocol. Whether you're automating reports, archiving websites, or shipping documentation,
+**Bidi2pdf** is a powerful Ruby gem that transforms modern web pages into high-fidelity PDFs using Chrome’s
+**BiDirectional (BiDi)** protocol. Whether you're automating reports, archiving websites, or shipping documentation,
 Bidi2pdf gives you **precision, flexibility, and full control**.
 
 ---
@@ -20,7 +20,9 @@ Bidi2pdf gives you **precision, flexibility, and full control**.
 ✅ **Smart waiting** – Wait for complete page load or network idle  
 ✅ **Headless support** – Run quietly in the background  
 ✅ **Docker-ready** – Plug and play with containers  
-✅ **Modern architecture** – Built on Chrome's next-gen BiDi protocol
+✅ **Modern architecture** – Built on Chrome's next-gen BiDi protocol  
+✅ **Network logging** – Know which requests fail during rendering  
+✅ **Console log capture** – See what goes wrong inside the browser
 
 ---
 
@@ -96,8 +98,8 @@ launcher.launch
 require "bidi2pdf"
 
 Bidi2pdf::DSL.with_tab(headless: true) do |tab|
-  tab.open_page("https://example.com")
-  tab.wait_until_all_finished
+  tab.navigate_to("https://example.com")
+  tab.wait_until_network_idle
   tab.print("example.pdf")
 end
 ```
@@ -142,12 +144,12 @@ tab.basic_auth(url_patterns: [{ type: "pattern", protocol: "https", hostname: "e
                username: "username", password: "secret")
 
 # 4. Render PDF
-tab.open_page "https://example.com"
+tab.navigate_to "https://example.com"
 
 # Alternative: send html code to the browser
-# tab.view_html_page("<html>...</html>")
+# tab.render_html_content("<html>...</html>")
 
-tab.wait_until_all_finished
+tab.wait_until_network_idle
 tab.print("my.pdf")
 
 # 5. Cleanup
@@ -162,15 +164,36 @@ session.close
 
 ## 🐳 Docker Support
 
-### Build & Run
+### 🛠️ Build & Run Locally
 
 ```bash
+# Prepare the environment
 rake build
+
+# Build the Docker image
 docker build -t bidi2pdf -f docker/Dockerfile .
-docker run -it --rm -v ./output:/reports bidi2pdf \
+
+# Run the container and generate a PDF
+docker run -it --rm \
+  -v ./output:/reports \
+  bidi2pdf \
+  bidi2pdf render --url=https://example.com --output /reports/example.pdf
+
+```
+
+### ⚡ Use the Prebuilt Image (Recommended for Fast Start)
+
+Grab it directly from [Docker Hub](https://hub.docker.com/r/dieters877565/bidi2pdf)
+
+```bash
+docker run -it --rm \
+  -v ./output:/reports \
+  dieters877565/bidi2pdf:main-slim \
   bidi2pdf render --url=https://example.com --output /reports/example.pdf
 ```
 
+✅ Tip: Mount your local directory (e.g. ./output) to /reports in the container to easily access the generated PDFs.
+
 ### Docker Compose
 
 ```bash

data/docker/Dockerfile

@@ -1,9 +1,11 @@
 FROM ruby:3.3
 
+ENV DEBIAN_FRONTEND=noninteractive
+
 # Install dependencies
-RUN apt-get update && \
-    apt-get install -y \
-    chromium \
+RUN apt-get update && apt-get upgrade &&\
+    apt-get install -y --no-install-recommends\
+    chromium chromium-driver\
     libglib2.0-0 \
     libnss3 \
     libxss1 \
@@ -19,6 +21,12 @@ RUN apt-get update && \
 # Create a non-root user
 RUN groupadd -r appuser && useradd -r -g appuser -m -d /home/appuser appuser
 
+# ARM compatibility workaround:
+# On ARM architectures (such as Apple Silicon), downloading chromedriver via automated scripts may fail or cause ELF binary errors,
+# such as "rosetta error: failed to open elf at /lib64/ld-linux-x86-64.so.2".
+# To avoid these issues, we directly install 'chromium-driver' via the package manager and explicitly create a symlink in the expected location.
+
+RUN mkdir -p /home/appuser/.webdrivers && ln -s /usr/bin/chromedriver /home/appuser/.webdrivers/chromedriver
 
 # Set working directory
 WORKDIR /app

data/docker/Dockerfile.chromedriver

@@ -2,9 +2,11 @@ FROM ruby:3.3
 
 ARG CHROMEDRIVER_PORT=3000
 
+ENV DEBIAN_FRONTEND=noninteractive
+
 # Install dependencies
-RUN apt-get update && \
-    apt-get install -y \
+RUN apt-get update && apt-get upgrade && \
+    apt-get install -y --no-install-recommends\
     chromium \
     libglib2.0-0 \
     libnss3 \

data/docker/Dockerfile.slim

@@ -0,0 +1,75 @@
+FROM ruby:3.3-slim AS builder
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install dependencies
+RUN apt-get update && apt-get upgrade && \
+    apt-get install -y --no-install-recommends \
+    chromium \
+    libglib2.0-0 \
+    libnss3 \
+    libxss1 \
+    libasound2 \
+    libatk-bridge2.0-0 \
+    libgtk-3-0 \
+    libdrm2 \
+    curl \
+    unzip \
+    xvfb \
+    build-essential \
+    libpq-dev pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy your gem into container
+COPY ./pkg/bidi2pdf-*.gem ./
+
+RUN gem install ./bidi2pdf-*.gem
+
+
+# Stage 2
+
+FROM ruby:3.3-slim
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install dependencies
+RUN apt-get update && apt-get upgrade &&\
+    apt-get install -y --no-install-recommends\
+    chromium chromium-driver\
+    libglib2.0-0 \
+    libnss3 \
+    libxss1 \
+    libasound2 \
+    libatk-bridge2.0-0 \
+    libgtk-3-0 \
+    libdrm2 \
+    curl \
+    unzip \
+    xvfb \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /usr/local/bundle /usr/local/bundle
+
+# Create a non-root user
+RUN groupadd -r appuser && useradd -r -g appuser -m -d /home/appuser appuser
+
+# ARM compatibility workaround:
+# On ARM architectures (such as Apple Silicon), downloading chromedriver via automated scripts may fail or cause ELF binary errors,
+# such as "rosetta error: failed to open elf at /lib64/ld-linux-x86-64.so.2".
+# To avoid these issues, we directly install 'chromium-driver' via the package manager and explicitly create a symlink in the expected location.
+
+RUN mkdir -p /home/appuser/.webdrivers && ln -s /usr/bin/chromedriver /home/appuser/.webdrivers/chromedriver
+
+# Set working directory
+WORKDIR /app
+
+RUN chown -R appuser:appuser /app
+
+# Switch to non-root user
+USER appuser
+
+CMD ["/usr/bin/bash"]
+

data/lib/bidi2pdf/bidi/browser_tab.rb

@@ -3,13 +3,14 @@
 require "base64"
 
 require_relative "network_events"
+require_relative "logger_events"
 require_relative "auth_interceptor"
 require_relative "add_headers_interceptor"
 
 module Bidi2pdf
   module Bidi
     class BrowserTab
-      attr_reader :client, :browsing_context_id, :user_context_id, :tabs, :network_events, :open
+      attr_reader :client, :browsing_context_id, :user_context_id, :tabs, :network_events, :open, :logger_events
 
       def initialize(client, browsing_context_id, user_context_id)
         @client = client
@@ -17,6 +18,7 @@ module Bidi2pdf
         @user_context_id = user_context_id
         @tabs = []
         @network_events = NetworkEvents.new browsing_context_id
+        @logger_events = LoggerEvents.new browsing_context_id
         @open = true
       end
 
@@ -77,10 +79,13 @@ module Bidi2pdf
         ).tap { |interceptor| interceptor.register_with_client(client: client) }
       end
 
-      def open_page(url)
-        client.on_event("network.responseStarted", "network.responseCompleted", "network.fetchError",
+      def navigate_to(url)
+        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))
+
         cmd = Bidi2pdf::Bidi::Commands::BrowsingContextNavigate.new url: url, context: browsing_context_id
 
         client.send_cmd_and_wait(cmd) do |response|
@@ -88,11 +93,11 @@ module Bidi2pdf
         end
       end
 
-      def view_html_page(html_content)
+      def render_html_content(html_content)
         base64_encoded = Base64.strict_encode64(html_content)
         data_url = "data:text/html;charset=utf-8;base64,#{base64_encoded}"
 
-        open_page(data_url)
+        navigate_to(data_url)
       end
 
       def execute_script(script)
@@ -104,8 +109,29 @@ module Bidi2pdf
         end
       end
 
-      def wait_until_all_finished(timeout: 10, poll_interval: 0.1)
-        network_events.wait_until_all_finished(timeout: timeout, poll_interval: poll_interval)
+      def wait_until_network_idle(timeout: 10, poll_interval: 0.1)
+        network_events.wait_until_network_idle(timeout: timeout, poll_interval: poll_interval)
+      end
+
+      def log_network_traffic(format: :console, output: nil, print_options: { background: true }, &block)
+        format = format.to_sym
+
+        if format == :console
+          network_events.log_network_traffic format: :console
+        elsif format == :pdf
+          html_content = network_events.log_network_traffic format: :html
+
+          return unless html_content
+
+          logging_tab = create_browser_tab
+
+          logging_tab.render_html_content(html_content)
+          logging_tab.wait_until_network_idle
+
+          logging_tab.print(output, print_options: print_options, &block)
+
+          logging_tab.close
+        end
       end
 
       def close

data/lib/bidi2pdf/bidi/logger_events.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "network_event"
+
+module Bidi2pdf
+  module Bidi
+    class LoggerEvents
+      attr_reader :context_id
+
+      def initialize(context_id)
+        @context_id = context_id
+      end
+
+      def handle_event(data)
+        event = data["params"]
+        method = data["method"]
+
+        if event.dig("source", "context") == context_id
+          handle_response(method, event)
+        else
+          Bidi2pdf.logger.debug "Ignoring Log event: #{method}, context_id: #{context_id}, params: #{event}"
+        end
+      rescue StandardError => e
+        Bidi2pdf.logger.error "Error handling Log event: #{e.message}\n#{e.backtrace&.join("\n")}"
+      end
+
+      def handle_response(_method, event)
+        level = resolve_log_level(event["level"])
+        text = event["text"]
+        args = event["args"] || []
+        stack_trace = event["stackTrace"]
+        timestamp = format_timestamp(event["timestamp"])
+        prefix = log_prefix(timestamp)
+
+        log_message(level, prefix, text)
+        log_args(prefix, args)
+        log_stack_trace(prefix, stack_trace) if stack_trace && level == :error
+      end
+
+      private
+
+      def log_message(level, prefix, text)
+        return unless text
+
+        Bidi2pdf.logger.send(level, "#{prefix} #{text}")
+      end
+
+      def log_args(prefix, args)
+        return if args.empty?
+
+        Bidi2pdf.logger.debug("#{prefix} Args: #{args.inspect}")
+      end
+
+      def log_stack_trace(prefix, trace)
+        formatted_trace = format_stack_trace(trace)
+        Bidi2pdf.logger.error("#{prefix} Stack trace captured:\n#{formatted_trace}")
+      end
+
+      def format_timestamp(timestamp)
+        return "N/A" unless timestamp
+
+        Time.at(timestamp.to_f / 1000).utc.strftime("%Y-%m-%d %H:%M:%S.%L UTC")
+      end
+
+      def format_stack_trace(trace)
+        trace["callFrames"].each_with_index.map do |frame, index|
+          function = frame["functionName"].to_s.empty? ? "(anonymous)" : frame["functionName"]
+          "##{index} #{function} at #{frame["url"]}:#{frame["lineNumber"]}:#{frame["columnNumber"]}"
+        end.join("\n")
+      end
+
+      def resolve_log_level(js_level)
+        case js_level
+        when "info", "warn", "error"
+          js_level.to_sym
+        else
+          :debug
+        end
+      end
+
+      def log_prefix(timestamp)
+        "[#{timestamp}][Browser Console Log]"
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/network_event.rb

@@ -3,7 +3,8 @@
 module Bidi2pdf
   module Bidi
     class NetworkEvent
-      attr_reader :id, :url, :state, :start_timestamp, :end_timestamp, :timing
+      attr_reader :id, :url, :state, :start_timestamp, :end_timestamp, :timing, :http_status_code,
+                  :http_method, :bytes_received
 
       STATE_MAP = {
         "network.responseStarted" => "started",
@@ -11,18 +12,22 @@ module Bidi2pdf
         "network.fetchError" => "error"
       }.freeze
 
-      def initialize(id:, url:, timestamp:, timing:, state:)
+      def initialize(id:, url:, timestamp:, timing:, state:, http_status_code: nil, http_method: nil)
         @id = id
         @url = url
         @start_timestamp = timestamp
         @timing = timing
         @state = map_state(state)
+        @http_status_code = http_status_code
+        @http_method = http_method
       end
 
-      def update_state(new_state, timestamp: nil, timing: nil)
+      def update_state(new_state, timestamp: nil, timing: nil, http_status_code: nil, bytes_received: nil)
         @state = map_state(new_state)
         @end_timestamp = timestamp if timestamp
         @timing = timing if timing
+        @http_status_code = http_status_code if http_status_code
+        @bytes_received = bytes_received if bytes_received
       end
 
       def map_state(state)
@@ -44,10 +49,23 @@ module Bidi2pdf
       def in_progress? = state == "started"
 
       def to_s
-        took_str = duration_seconds ? "took #{duration_seconds} sec" : "in progress"
-        "#<NetworkEvent id=#{@id} url=#{@url} state=#{@state} " \
-          "start=#{format_timestamp(@start_timestamp)} " \
-          "end=#{format_timestamp(@end_timestamp)} #{took_str}>"
+        took_str = duration_seconds ? "#{duration_seconds.round(2)} sec" : "in progress"
+        http_status = @http_status_code ? "HTTP #{@http_status_code}" : "HTTP (N/A)"
+        start_str = format_timestamp(@start_timestamp) || "N/A"
+        end_str = format_timestamp(@end_timestamp) || "N/A"
+        method_str = @http_method || "N/A"
+        bytes_str = @bytes_received ? "#{@bytes_received} bytes" : "0 bytes"
+
+        "#<NetworkEvent " \
+          "id=#{@id.inspect}, " \
+          "method=#{method_str.inspect}, " \
+          "url=#{@url.inspect}, " \
+          "state=#{@state.inspect}, " \
+          "#{http_status}, " \
+          "bytes_received=#{bytes_str}, " \
+          "start=#{start_str}, " \
+          "end=#{end_str}, " \
+          "duration=#{took_str}>"
       end
     end
   end

data/lib/bidi2pdf/bidi/network_event_formatters/network_event_console_formatter.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Bidi2pdf
+  module Bidi
+    module NetworkEventFormatters
+      # rubocop: disable  Metrics/AbcSize
+      class NetworkEventConsoleFormatter
+        include NetworkEventFormatterUtils
+
+        attr_reader :color_enabled
+
+        # ANSI styles
+        RESET = "\e[0m"
+        BOLD = "\e[1m"
+        DIM = "\e[2m"
+        RED = "\e[31m"
+        GREEN = "\e[32m"
+        YELLOW = "\e[33m"
+        CYAN = "\e[36m"
+        GRAY = "\e[90m"
+
+        def initialize(color: true)
+          @color_enabled = color
+        end
+
+        def log(events)
+          events.each { |event| pretty_log(event).each_line { |line| Bidi2pdf.network_events_logger.info(line.chomp) } }
+        end
+
+        def pretty_log(event)
+          status = event.http_status_code ? "HTTP #{event.http_status_code}" : "pending"
+          status_color = color_for_status(event.http_status_code)
+          start = event.format_timestamp(event.start_timestamp)
+          finish = event.end_timestamp ? event.format_timestamp(event.end_timestamp) : dim("...")
+          duration = event.duration_seconds ? cyan("#{event.duration_seconds}s") : dim("in progress")
+          timing_details = format_timing(event)
+          bytes = event.bytes_received ? format_bytes(event.bytes_received) : dim("N/A")
+          displayed_url = shorten_url(event.url)
+
+          <<~LOG.strip
+            #{bold("┌─ Network Event ──────────────────────────────────────")}
+            #{bold("│ Request: ")}#{event.http_method || "?"} #{displayed_url}#{"          "}
+            #{bold("│ State:   ")}#{event.state}
+            #{bold("│ Status:  ")}#{status_color}#{status}#{reset}
+            #{bold("│ Started: ")}#{start}
+            #{bold("│ Ended:   ")}#{finish}
+            #{bold("│ Duration:")} #{duration}
+            #{bold("│ Received:")} #{bytes}
+            #{timing_details}
+            #{bold("└──────────────────────────────────────────────────────")}
+          LOG
+        end
+
+        private
+
+        def format_timing(event)
+          return "" unless event.timing.is_a?(Hash)
+
+          keys = %w[
+          requestTime proxyStart proxyEnd dnsStart dnsEnd connectStart connectEnd
+          sslStart sslEnd workerStart workerReady sendStart sendEnd receiveHeadersEnd
+        ]
+
+          visible = keys.map do |key|
+            next unless event.timing[key]
+
+            label = key.gsub(/([A-Z])/, ' \1').capitalize
+            "#{dim("│")} #{label.ljust(20)}: #{event.timing[key].round(2)} ms#{reset}"
+          end.compact
+
+          return "" if visible.empty?
+
+          [dim("│").to_s, dim("│ Timing Phases:").to_s].concat(visible).join("\n")
+        end
+
+        # === Color Helpers ===
+
+        def color_for_status(code)
+          return gray unless code
+
+          case code.to_i
+          when 200..299 then green
+          when 300..499 then yellow
+          when 500..599 then red
+          else gray
+          end
+        end
+
+        def bold(str) = color_enabled ? "#{BOLD}#{str}#{RESET}" : str
+
+        def dim(str) = color_enabled ? "#{DIM}#{str}#{RESET}" : str
+
+        def green(str = "") = color_enabled ? "#{GREEN}#{str}" : str
+
+        def yellow(str = "") = color_enabled ? "#{YELLOW}#{str}" : str
+
+        def red(str = "") = color_enabled ? "#{RED}#{str}" : str
+
+        def cyan(str = "") = color_enabled ? "#{CYAN}#{str}" : str
+
+        def gray(str = "") = color_enabled ? "#{GRAY}#{str}" : str
+
+        def reset = color_enabled ? RESET : ""
+
+        # rubocop: enable  Metrics/AbcSize
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/network_event_formatters/network_event_formatter_utils.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module Bidi2pdf
+  module Bidi
+    module NetworkEventFormatters
+      module NetworkEventFormatterUtils
+        def format_bytes(size)
+          return "N/A" unless size.is_a?(Numeric)
+
+          units = %w[B KB MB GB TB]
+          idx = 0
+          while size >= 1024 && idx < units.size - 1
+            size /= 1024.0
+            idx += 1
+          end
+          format("%<size>.2f %<unit>s", size: size, unit: units[idx])
+        end
+
+        def parse_timing(event)
+          return [] unless event.timing.is_a?(Hash)
+
+          keys = %w[
+          requestTime proxyStart proxyEnd dnsStart dnsEnd connectStart connectEnd
+          sslStart sslEnd workerStart workerReady sendStart sendEnd receiveHeadersEnd
+        ]
+
+          keys.filter_map do |key|
+            next unless event.timing[key]
+
+            label = key.gsub(/([A-Z])/, ' \1').capitalize
+            { label: label, key: key, ms: event.timing[key].round(2) }
+          end
+        end
+
+        def format_timestamp(timestamp)
+          return "N/A" unless timestamp
+
+          Time.at(timestamp.to_f / 1000).utc.strftime("%Y-%m-%d %H:%M:%S.%L UTC")
+        end
+
+        def shorten_url(url)
+          sanitized_url = CGI.escapeHTML(url)
+
+          return sanitized_url unless sanitized_url.start_with?("data:text/html")
+
+          "data:text/html,..."
+        end
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/network_event_formatters/network_event_html_formatter.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Bidi2pdf
+  module Bidi
+    module NetworkEventFormatters
+      class NetworkEventHtmlFormatter
+        include NetworkEventFormatterUtils
+
+        def render(events)
+          return unless Bidi2pdf.network_events_logger.info?
+
+          <<~HTML
+            <!DOCTYPE html>
+            <html lang="en" data-bs-theme="light">
+            <head>
+              <meta charset="UTF-8">
+              <title>Network Events</title>
+              <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
+              <style>
+                body { font-family: monospace; padding: 2rem; }
+                .event { background: var(--bs-body-bg); border: 1px solid var(--bs-border-color); padding: 1rem; margin-bottom: 2rem; border-radius: .5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+                .bar-container { position: relative; height: 20px; background: var(--bs-secondary-bg); border-radius: 4px; }
+                .bar { position: absolute; top: 0; height: 100%; background-color: #0d6efd; opacity: 0.8; }
+                .toc a { text-decoration: none; display: block; margin-bottom: 0.5rem; }
+
+                @media print {
+                  .no-break {
+                    page-break-inside: avoid;
+                  }
+            #{"    "}
+            #{"     "}
+                  .form-select, .form-label, #theme-select {
+                    display: none !important; /* Hide theme selector when printing */
+                  }
+                }
+
+                .event {
+                  word-break: break-word;
+                  overflow-wrap: anywhere;
+                }
+              </style>
+              <script>
+                function toggleTheme(value) {
+                  document.documentElement.setAttribute('data-bs-theme', value);
+                }
+              </script>
+            </head>
+            <body>
+              <h1>Network Events</h1>
+              <div class="mb-4">
+                <label for="theme-select" class="form-label">Theme:</label>
+                <select id="theme-select" class="form-select w-auto d-inline-block" onchange="toggleTheme(this.value)">
+                  <option value="light">Light</option>
+                  <option value="dark">Dark</option>
+                </select>
+              </div>
+
+              <h2>Index</h2>
+              <div class="toc mb-4">
+                #{events.map.with_index { |e, i| toc_entry(e, i) }.join("\n")}
+              </div>
+
+              #{events.map.with_index { |e, i| render_event(e, i) }.join("\n")}
+            </body>
+            </html>
+          HTML
+        end
+
+        def toc_entry(event, index)
+          "<a href=\"#event-#{index}\">[#{index + 1}] #{event.http_method} #{event.url}</a>"
+        end
+
+        # rubocop: disable Metrics/AbcSize
+        def render_event(event, index)
+          timing = parse_timing(event)
+          duration = event.duration_seconds || 0
+          duration_str = event.in_progress? ? "in progress" : "#{duration}s"
+          status = event.http_status_code || "?"
+          method = event.http_method || "?"
+          start = format_timestamp(event.start_timestamp)
+          finish = event.end_timestamp ? format_timestamp(event.end_timestamp) : "..."
+          bytes = event.bytes_received ? format_bytes(event.bytes_received) : "N/A"
+          bars = render_timing_bars(timing)
+          displayed_url = shorten_url(event.url)
+
+          <<~HTML
+            <div class="event no-break" id="event-#{index}">
+              <div><strong>Request:</strong> #{method} #{displayed_url}</div>
+              <div><strong>Status:</strong> HTTP #{status}</div>
+              <div><strong>State:</strong> #{event.state}</div>
+              <div><strong>Start:</strong> #{start}</div>
+              <div><strong>End:</strong> #{finish}</div>
+              <div><strong>Duration:</strong> #{duration_str}</div>
+              <div><strong>Received:</strong> #{bytes}</div>
+              #{bars}
+            </div>
+          HTML
+        end
+
+        # rubocop: enable Metrics/AbcSize
+
+        def render_timing_bars(timing)
+          return "" if timing.empty?
+
+          max_ms = timing.map { |t| t[:ms] }.max
+          scale = max_ms.zero? ? 0 : 100.0 / max_ms
+
+          bars = timing.map do |t|
+            width = (t[:ms] * scale).clamp(1, 100).round(2)
+            <<~HTML
+              <div>
+                <small>#{t[:label]} (#{t[:ms]} ms)</small>
+                <div class="bar-container mb-2">
+                  <div class="bar" style="width: #{width}%"></div>
+                </div>
+              </div>
+            HTML
+          end
+
+          "<div class=\"mt-3\"><strong>Timing Waterfall</strong>#{bars.join}</div>"
+        end
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/network_event_formatters.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Bidi2pdf
+  module Bidi
+    module NetworkEventFormatters
+      require_relative "network_event_formatters/network_event_formatter_utils"
+      require_relative "network_event_formatters/network_event_console_formatter"
+      require_relative "network_event_formatters/network_event_html_formatter"
+    end
+  end
+end

data/lib/bidi2pdf/bidi/network_events.rb

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
 
 require_relative "network_event"
+require_relative "network_event_formatters"
 
 module Bidi2pdf
   module Bidi
     class NetworkEvents
-      attr_reader :context_id, :events
+      attr_reader :context_id, :events, :network_event_formatter
 
       def initialize(context_id)
         @context_id = context_id
         @events = {}
+        @network_event_formatter = NetworkEventFormatters::NetworkEventConsoleFormatter.new
       end
 
       def handle_event(data)
@@ -30,23 +32,28 @@ module Bidi2pdf
         return unless event && event["request"]
 
         request = event["request"]
+        response = event["response"]
+        http_status_code = response&.dig("status")
+        bytes_received = response&.dig("bytesReceived")
 
         id = request["request"]
         url = request["url"]
         timing = request["timings"]
+        http_method = request["method"]
 
         timestamp = event["timestamp"]
 
-        if method == "network.responseStarted"
+        if method == "network.beforeRequestSent"
           events[id] ||= NetworkEvent.new(
             id: id,
             url: url,
             timestamp: timestamp,
             timing: timing,
-            state: method
+            state: method,
+            http_method: http_method
           )
         elsif events.key?(id)
-          events[id].update_state(method, timestamp: timestamp, timing: timing)
+          events[id].update_state(method, timestamp: timestamp, timing: timing, http_status_code: http_status_code, bytes_received: bytes_received)
         else
           Bidi2pdf.logger.warn "Received response for unknown request ID: #{id}, URL: #{url}"
         end
@@ -58,7 +65,19 @@ module Bidi2pdf
         events.values.sort_by(&:start_timestamp)
       end
 
-      def wait_until_all_finished(timeout: 10, poll_interval: 0.1)
+      def log_network_traffic(format: :console)
+        format = format.to_sym
+
+        if format == :console
+          NetworkEventFormatters::NetworkEventConsoleFormatter.new.log all_events
+        elsif format == :html
+          NetworkEventFormatters::NetworkEventHtmlFormatter.new.render(all_events)
+        else
+          raise ArgumentError, "Unknown network event format: #{format}"
+        end
+      end
+
+      def wait_until_network_idle(timeout: 10, poll_interval: 0.1)
         start_time = Time.now
 
         loop do

data/lib/bidi2pdf/bidi/session.rb

@@ -10,7 +10,7 @@ require_relative "user_context"
 module Bidi2pdf
   module Bidi
     class Session
-      SUBSCRIBE_EVENTS = %w[log script].freeze
+      SUBSCRIBE_EVENTS = %w[script].freeze
       DEFAULT_CHROME_ARGS = %w[--disable-gpu --disable-popup-blocking --disable-hang-monitor].freeze
 
       attr_reader :session_uri, :started, :chrome_args

data/lib/bidi2pdf/cli.rb

@@ -51,6 +51,12 @@ module Bidi2pdf
     option :log_level,
            type: :string,
            default: "info", enum: %w[debug info warn error fatal unknown], desc: "Set log level"
+    option :log_network_traffic, type: :boolean, default: false, desc: "Log network traffic", aliases: "-n"
+    option :network_log_format,
+           type: :string,
+           default: "console",
+           enum: %w[console pdf],
+           desc: "Choose network log format: console or pdf", aliases: "-f"
 
     option :background, type: :boolean, default: true, desc: "Print background graphics"
     option :margin_top, type: :numeric, default: 1.0, desc: "Top margin in inches"
@@ -64,6 +70,12 @@ module Bidi2pdf
     option :scale, type: :numeric, default: 1.0, desc: "Scale between 0.1 and 2.0"
     option :shrink_to_fit, type: :boolean, default: true, desc: "Shrink content to fit page"
 
+    class << self
+      def exit_on_failure?
+        true
+      end
+    end
+
     def render
       load_config
 
@@ -198,7 +210,8 @@ module Bidi2pdf
                         headless: merged_options[:headless],
                         wait_window_loaded: merged_options[:wait_window_loaded],
                         wait_network_idle: merged_options[:wait_network_idle],
-                        print_options: print_options
+                        print_options: print_options,
+                        network_log_format: merged_options[:network_log_format]
                       )
                     end
     end
@@ -208,6 +221,9 @@ module Bidi2pdf
     def configure
       Bidi2pdf.configure do |config|
         config.logger.level = log_level
+
+        config.network_events_logger.level = Logger::INFO if merged_options[:log_network_traffic]
+
         config.default_timeout = merged_options[:default_timeout]
 
         Chromedriver::Binary.configure do |c|

data/lib/bidi2pdf/launcher.rb

@@ -8,7 +8,7 @@ module Bidi2pdf
   class Launcher
     # rubocop:disable Metrics/ParameterLists
     def initialize(url:, inputfile:, output:, cookies:, headers:, auth:, headless: true, port: 0, wait_window_loaded: false,
-                   wait_network_idle: false, print_options: {}, remote_browser_url: nil)
+                   wait_network_idle: false, print_options: {}, remote_browser_url: nil, network_log_format: :console)
       @url = url
       @inputfile = inputfile
       @port = port
@@ -23,6 +23,7 @@ module Bidi2pdf
       @print_options = print_options || {}
       @remote_browser_url = remote_browser_url
       @custom_session = nil
+      @network_log_format = network_log_format
     end
 
     # rubocop:enable Metrics/ParameterLists
@@ -38,7 +39,8 @@ module Bidi2pdf
         auth: @auth,
         wait_window_loaded: @wait_window_loaded,
         wait_network_idle: @wait_network_idle,
-        print_options: @print_options
+        print_options: @print_options,
+        network_log_format: @network_log_format
       )
       runner.run
     end

data/lib/bidi2pdf/session_runner.rb

@@ -2,8 +2,9 @@
 
 module Bidi2pdf
   class SessionRunner
+    # rubocop: disable Metrics/ParameterLists
     def initialize(session:, url:, inputfile:, output:, cookies: {}, headers: {}, auth: {}, wait_window_loaded: false,
-                   wait_network_idle: false, print_options: {})
+                   wait_network_idle: false, print_options: {}, network_log_format: :console)
       @session = session
       @url = url
       @inputfile = inputfile
@@ -14,8 +15,11 @@ module Bidi2pdf
       @wait_window_loaded = wait_window_loaded
       @wait_network_idle = wait_network_idle
       @print_options = print_options || {}
+      @network_log_format = network_log_format
     end
 
+    # rubocop: enable Metrics/ParameterLists
+
     def run
       @session.start
       @session.client.on_close { Bidi2pdf.logger.info "WebSocket closed" }
@@ -72,23 +76,27 @@ module Bidi2pdf
       )
     end
 
+    # rubocop: disable Metrics/AbcSize
     def run_flow
       @session.status
       @session.user_contexts
 
       if @url
-        @tab.open_page(@url)
+        @tab.navigate_to(@url)
       else
         Bidi2pdf.logger.info "Loading HTML file #{@inputfile}"
         data = File.read(@inputfile)
-        @tab.view_html_page(data)
+        @tab.render_html_content(data)
       end
 
       if @wait_network_idle
         Bidi2pdf.logger.info "Waiting for network idle"
-        @tab.wait_until_all_finished
+        @tab.wait_until_network_idle
       end
 
+      log_output_file = (@output || "report").sub(/\.pdf$/, "-network.pdf") # only need, when html output
+      @tab.log_network_traffic format: @network_log_format, output: log_output_file
+
       if @wait_window_loaded
         Bidi2pdf.logger.info "Waiting for window to be loaded"
         @tab.execute_script <<-EOF_SCRIPT
@@ -102,6 +110,8 @@ module Bidi2pdf
       @window.close
     end
 
+    # rubocop: enable Metrics/AbcSize
+
     def uri
       @uri ||= URI(@url)
     end

data/lib/bidi2pdf/version.rb

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

data/lib/bidi2pdf.rb

@@ -26,12 +26,14 @@ module Bidi2pdf
   class PrintError < Error; end
 
   @logger = Logger.new($stdout)
+  @network_events_logger = Logger.new($stdout)
   @logger.level = Logger::INFO
+  @network_events_logger.level = Logger::FATAL
 
   @default_timeout = 60
 
   class << self
-    attr_accessor :logger, :default_timeout
+    attr_accessor :logger, :default_timeout, :network_events_logger
 
     # Allow configuration through a block
     def configure

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bidi2pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Dieter S.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-10 00:00:00.000000000 Z
+date: 2025-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -310,6 +310,7 @@ files:
 - cliff.toml
 - docker/Dockerfile
 - docker/Dockerfile.chromedriver
+- docker/Dockerfile.slim
 - docker/docker-compose.yml
 - docker/entrypoint.sh
 - docker/nginx/default.conf
@@ -346,7 +347,12 @@ files:
 - lib/bidi2pdf/bidi/connection_manager.rb
 - lib/bidi2pdf/bidi/event_manager.rb
 - lib/bidi2pdf/bidi/interceptor.rb
+- lib/bidi2pdf/bidi/logger_events.rb
 - lib/bidi2pdf/bidi/network_event.rb
+- lib/bidi2pdf/bidi/network_event_formatters.rb
+- lib/bidi2pdf/bidi/network_event_formatters/network_event_console_formatter.rb
+- lib/bidi2pdf/bidi/network_event_formatters/network_event_formatter_utils.rb
+- lib/bidi2pdf/bidi/network_event_formatters/network_event_html_formatter.rb
 - lib/bidi2pdf/bidi/network_events.rb
 - lib/bidi2pdf/bidi/session.rb
 - lib/bidi2pdf/bidi/user_context.rb