probatio_diabolica 0.4.3 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86e99563f7268abd22cb2aefb8bf9b932ffc22b54564a99e231c1eb9d0282aee
-  data.tar.gz: 3a7cf8e9a34e830df9999976bfcc2c0298e76d7aef8494038bdc9ca369318761
+  metadata.gz: 0a935022c47a87f28cab73012b6c96563616958a6eb9ff28d982ed7dc6b7abdd
+  data.tar.gz: 7b1ad8ea3bc58ce2a167508d95a8e63f574078e4f7b06e007f8650185cfc43fb
 SHA512:
-  metadata.gz: cf9e2016027998b4ae11312b17bfc94b55f540acbff985de714d5aff433855b72bbd5845c1bab2ba531dd3c661cb2656d65046dcd7d7807abb09af3b278742fc
-  data.tar.gz: 87be48c549b49ac867e86e90b7b38a0b83211d40359aa30c59f0eec2ea288884e4879a69346535a722d3d6671d81c15c6fbe1ba03e796951c09a4c7fed261b1b
+  metadata.gz: 1a918c5542c8fb74413fd7e8fc2536767469f86833a0ec78ebe3a444156a02431d64e7c573fe10804e2ed008d53abf5ca187754fdae1fbb3ad3d416b6eec2c3c
+  data.tar.gz: 31e087b60fd08046dd952dda13e3ab30599b8f04ebc311a622bf26ada5950f00f7f81563c7ddd813c6725c5e992c8b2b7091366fea9338553b219baa8fa44f1c

data/README.md

@@ -79,6 +79,7 @@ Input:
 - `out` (optional): same as `-o`
 - `formatters` (optional): array of `simple|html|json|pdf` (default: `["simple"]`)
 - `mode` (optional): `verbose|synthetic` (default: `synthetic`)
+- `jobs` (optional): file-level workers count (integer >= 1, default: `1`)
 
 Output (`structuredContent`):
 - `ok`, `exit_code`
@@ -95,6 +96,7 @@ Options:
 - `-o, --out PATH` output base path (directory or file-like base name)
 - `-m, --mode MODE` output mode, default: `verbose`
   - supported: `verbose`, `synthetic`
+- `-j, --jobs N` number of workers for file-level execution, default: `1`
 
 Output rules (`--out`):
 
@@ -131,8 +133,18 @@ prd examples/basics_spec.rb -t html,json,pdf -o ./tmp/my_report
 
 # compact synthetic output on console
 prd examples/basics_spec.rb --mode synthetic
+
+# run a directory with 4 file-level workers
+prd spec --mode synthetic --jobs 4
 ```
 
+Parallel execution notes:
+
+- Parallelism is file-level only (`*_spec.rb` files are distributed across workers).
+- Event rendering order stays deterministic: files are merged in sorted path order.
+- `--jobs 1` uses the same worker pipeline as `--jobs N`.
+- Specs sharing mutable global state across files can become non-deterministic when `jobs > 1`.
+
 ## Available DSL
 
 It is inspired by RSpec but with a custom runtime and additional features.

data/bin/prd

@@ -7,6 +7,7 @@ rescue LoadError
 end
 require 'optparse'
 require 'fileutils'
+require 'stringio'
 
 FORMATTERS = {
   'simple' => { klass: PrD::Formatters::SimpleFormatter, extension: '.txt', binary: false },
@@ -18,6 +19,7 @@ FORMATTERS = {
 SUPPORTED_FORMATTERS = FORMATTERS.keys.freeze
 SUPPORTED_MODES = %w[verbose synthetic].freeze
 DEFAULT_REPORT_BASENAME = 'report'.freeze
+DEFAULT_JOBS = 1
 
 class CompositeFormatter
   def initialize(formatters)
@@ -67,6 +69,17 @@ def normalize_mode(raw_mode)
   mode
 end
 
+def normalize_jobs(raw_jobs)
+  return DEFAULT_JOBS if raw_jobs.nil?
+
+  jobs = Integer(raw_jobs)
+  raise "Invalid jobs count: #{jobs}. Expected an integer greater than or equal to 1." if jobs < 1
+
+  jobs
+rescue ArgumentError, TypeError
+  raise "Invalid jobs value: #{raw_jobs}. Expected an integer greater than or equal to 1."
+end
+
 def directory_like_path?(path)
   path.end_with?(File::SEPARATOR) || Dir.exist?(path)
 end
@@ -97,6 +110,9 @@ OptionParser
     opts.on('-m', '--mode MODE', 'Specify output mode (verbose, synthetic)') do |mode|
       options[:mode] = mode
     end
+    opts.on('-j', '--jobs N', 'Specify number of workers (default: 1)') do |jobs|
+      options[:jobs] = jobs
+    end
   end
   .parse!
 
@@ -105,17 +121,18 @@ raise 'No tests found. Please specify a test file or directory (e.g. prd example
 raise "Unexpected arguments: #{ARGV.join(' ')}" unless ARGV.empty?
 raise "Path not found: #{input_path}" unless File.exist?(input_path)
 
-tests =
+test_files =
   if File.directory?(input_path)
     files = Dir[File.join(input_path, '**', '*_spec.rb')].sort
     raise "No spec files found in directory: #{input_path}" if files.empty?
-    files.map { |file| File.read(file) }
+    files
   elsif File.file?(input_path)
-    [File.read(input_path)]
+    [input_path]
   end
 
 formatter_types = parse_formatter_types(options[:formatters])
 mode = normalize_mode(options[:mode])
+jobs = normalize_jobs(options[:jobs])
 out_base = output_base_path(options[:out])
 
 if formatter_types.include?('pdf') && out_base.nil?
@@ -133,7 +150,7 @@ serializers = {
 
 destinations =
   if out_base.nil?
-    [{ io: STDOUT, formatter: FORMATTERS.fetch(formatter_types.first)[:klass].new(io: STDOUT, serializers:, mode: mode.to_sym) }]
+    [{ io: STDOUT, formatter_type: formatter_types.first }]
   else
     output_dir = File.dirname(out_base)
     FileUtils.mkdir_p(output_dir)
@@ -141,21 +158,52 @@ destinations =
       config = FORMATTERS.fetch(type)
       output_path = "#{out_base}#{config[:extension]}"
       io = File.open(output_path, config[:binary] ? 'wb' : 'w')
-      { io:, formatter: config[:klass].new(io:, serializers:, mode: mode.to_sym) }
+      { io:, formatter_type: type }
     end
   end
 
-formatter =
-  if destinations.length == 1
-    destinations.first[:formatter]
+subject_display_strategy =
+  if formatter_types.length == 1
+    FORMATTERS.fetch(formatter_types.first)[:klass].new(io: StringIO.new, serializers:, mode: mode.to_sym).subject_display_strategy
+  else
+    nil
+  end
+
+eager_subject_display_strategy =
+  if formatter_types.length == 1
+    FORMATTERS.fetch(formatter_types.first)[:klass].new(io: StringIO.new, serializers:, mode: mode.to_sym).eager_subject_display_strategy
   else
-    CompositeFormatter.new(destinations.map { |destination| destination[:formatter] })
+    nil
   end
 
+collector = PrD::ReportCollector.new(
+  io: StringIO.new,
+  serializers: serializers,
+  mode: mode.to_sym,
+  subject_display_strategy: subject_display_strategy,
+  eager_subject_display_strategy: eager_subject_display_strategy
+)
+
 runtime_output_dir = out_base.nil? ? nil : File.dirname(out_base)
-runtime = PrD::Runtime.new(formatter:, output_dir: runtime_output_dir, config_file: options[:config])
-runtime.run(tests)
-exit_status = runtime.success? ? 0 : 1
+runner_result = PrD::WorkerRunner.new(
+  file_paths: test_files,
+  jobs: jobs,
+  mode: mode.to_sym,
+  serializers: serializers,
+  output_dir: runtime_output_dir,
+  config_file: options[:config],
+  subject_display_strategy: collector.subject_display_strategy,
+  eager_subject_display_strategy: collector.eager_subject_display_strategy
+).run
+exit_status = runner_result.failed_count.zero? ? 0 : 1
+
+destinations.each do |destination|
+  io = destination[:io]
+  type = destination[:formatter_type]
+  formatter = FORMATTERS.fetch(type)[:klass].new(io:, serializers:, mode: mode.to_sym)
+  PrD::ReportRenderer.render(runner_result.model, formatter)
+end
+
 destinations.each do |destination|
   io = destination[:io]
   io.close if io != STDOUT

data/bin/prd_mcp

@@ -1,8 +1,10 @@
 #!/usr/bin/env ruby
 
 begin
+  require 'pr_d/version'
   require 'pr_d'
 rescue LoadError
+  require_relative '../lib/pr_d/version'
   require_relative '../lib/pr_d'
 end
 

data/lib/pr_d/formatters/formatter.rb

@@ -117,6 +117,7 @@ module PrD
         serializer = @serializers[value.class]
         return serializer.call(value) if serializer
         return ferrum_node_summary(value) if ferrum_node?(value)
+        return value.path if value.respond_to?(:path) && value.path.is_a?(String) && !value.path.empty?
         return value.path if value.is_a?(File)
         return value.map { |v| serialize(v) } if value.is_a?(Array)
         return value.transform_values { |v| serialize(v) } if value.is_a?(Hash)
@@ -129,12 +130,25 @@ module PrD
       end
 
       def ferrum_node?(value)
+        return true if defined?(PrD::ReportModel::FerrumNodeSnapshot) && value.is_a?(PrD::ReportModel::FerrumNodeSnapshot)
+
         value.respond_to?(:class) && value.class.respond_to?(:name) && value.class.name == 'Ferrum::Node'
       rescue StandardError
         false
       end
 
       def ferrum_node_payload(node)
+        if defined?(PrD::ReportModel::FerrumNodeSnapshot) && node.is_a?(PrD::ReportModel::FerrumNodeSnapshot)
+          payload = node.payload || {}
+          payload[:tag] = payload[:tag].to_s.downcase.strip unless blank_text?(payload[:tag])
+          payload[:id] = payload[:id].to_s.strip unless blank_text?(payload[:id])
+          payload[:classes] = normalize_classes(payload[:classes])
+          payload[:text] = normalize_preview_text(payload[:text], max_length: 160)
+          payload[:html] = normalize_preview_text(payload[:html], max_length: 220)
+          payload[:description] = normalize_preview_text(payload[:description], max_length: 160)
+          return payload
+        end
+
         payload = ferrum_node_payload_from_js(node) || {}
         payload[:tag] = payload[:tag].to_s.downcase.strip unless blank_text?(payload[:tag])
         payload[:id] = payload[:id].to_s.strip unless blank_text?(payload[:id])

data/lib/pr_d/formatters/html_formatter.rb

@@ -12,12 +12,20 @@ module PrD
         @anchor_counters = Hash.new(0)
         @rouge_formatter = Rouge::Formatters::HTMLLegacy.new(css_class: 'highlight')
         @pending_expectation = nil
+        @open_let_group_level = nil
+        @pending_scope_type = nil
+        @scope_stack = []
+        @open_context_blocks = 0
       end
 
       def context(message)
+        close_let_group_if_open
         anchor_id = next_anchor_id('ctx')
         add_index_entry(type: :context, label: message, level: @level, anchor_id:)
+        @content << %(<section class="context-block" style="--ctx-level: #{@level};">)
         @content << "<h2 class=\"context\" id=\"#{anchor_id}\">#{escape(message)}</h2>"
+        @open_context_blocks += 1
+        @pending_scope_type = :context
       end
 
       def success_result(message)
@@ -37,12 +45,14 @@ module PrD
       end
 
       def it(description = nil, &block)
+        close_let_group_if_open
         @current_test_title = description.to_s
         @pending_expectation = nil
         anchor_id = next_anchor_id('test')
         add_index_entry(type: :test, label: description.to_s, level: @level, anchor_id:)
         @content << "<article class=\"test-card\" id=\"#{anchor_id}\">"
         @content << "<h3 class=\"test-title\">#{escape(description)}</h3>"
+        @pending_scope_type = :it
       end
 
       def end_it(description = nil, &block)
@@ -56,6 +66,7 @@ module PrD
 
       def let(name_or_value, value = MISSING_VALUE)
         return if synthetic?
+        start_let_group_if_needed
         name, rendered_value = named_value_arguments(name_or_value, value)
         label = name.nil? ? 'Let' : "Let(:#{name})"
         render_collapsible_let_block(label, rendered_value)
@@ -63,6 +74,7 @@ module PrD
 
       def subject(subject)
         return if synthetic?
+        close_let_group_if_open
         render_value_block('Subject', subject)
       end
 
@@ -75,6 +87,7 @@ module PrD
       end
 
       def pending(description = nil)
+        close_let_group_if_open
         pending_label = description || 'Pending test'
         anchor_id = next_anchor_id('pending')
         add_index_entry(type: :pending, label: pending_label, level: @level, anchor_id:)
@@ -122,6 +135,8 @@ module PrD
       end
 
       def flush
+        close_let_group_if_open
+        close_all_context_blocks
         @io << document_opening
         @io << render_index
         @io << @content
@@ -129,6 +144,21 @@ module PrD
         super
       end
 
+      def increment_level
+        close_let_group_if_open if @open_let_group_level == @level
+        @scope_stack << (@pending_scope_type || :unknown)
+        @pending_scope_type = nil
+        super
+      end
+
+      def decrement_level
+        close_let_group_if_open if !@open_let_group_level.nil? && @open_let_group_level >= @level
+        scope = @scope_stack.pop
+        @content << '</section>' if scope == :context && @open_context_blocks.positive?
+        @open_context_blocks -= 1 if scope == :context && @open_context_blocks.positive?
+        super
+      end
+
       private
 
       def document_opening
@@ -168,7 +198,6 @@ module PrD
                   margin: 1rem auto 2rem;
                   padding: 1rem;
                   background: var(--paper);
-                  border: 1px solid var(--line);
                   border-radius: 4px;
                 }
 
@@ -205,7 +234,6 @@ module PrD
                   z-index: 1000;
                   width: var(--sidebar-width);
                   background: var(--paper);
-                  border: 1px solid var(--line);
                   border-radius: 4px;
                   padding: 0.9rem 1rem;
                   overflow-y: auto;
@@ -234,8 +262,31 @@ module PrD
                   padding-left: calc(var(--index-level, 0) * 1rem);
                 }
 
+                .index-row {
+                  display: flex;
+                  align-items: center;
+                  gap: 0.3rem;
+                  min-width: 0;
+                }
+
+                .context-toggle {
+                  border: 1px solid var(--line);
+                  border-radius: 3px;
+                  background: #fff;
+                  color: var(--accent);
+                  cursor: pointer;
+                  font-size: 0.72rem;
+                  width: 1.2rem;
+                  height: 1.2rem;
+                  line-height: 1;
+                  padding: 0;
+                  flex: 0 0 auto;
+                }
+
                 .index-link {
                   display: block;
+                  flex: 1 1 auto;
+                  min-width: 0;
                   white-space: nowrap;
                   overflow: hidden;
                   text-overflow: ellipsis;
@@ -249,21 +300,39 @@ module PrD
 
                 .context {
                   font-size: 1.25rem;
-                  margin: 1rem 0 0.75rem;
+                  margin: 0.45rem 0 0.6rem;
                   padding-bottom: 0.35rem;
                   border-bottom: 1px solid var(--line);
                 }
 
+                .context-block {
+                  margin: 0 0 0.5rem;
+                  margin-left: calc(var(--ctx-level, 0) * 0.6rem);
+                  padding-left: 0.55rem;
+                  border-left: 1px solid #e5e7eb;
+                }
+
                 .test-card {
-                  background: var(--paper);
-                  border: 1px solid var(--line);
-                  border-radius: 4px;
-                  padding: 0.9rem 1rem;
+                  background: transparent;
+                  border-left: 3px solid #d1d5db;
+                  padding: 0.8rem 0.95rem;
                   margin: 0 0 1rem;
                 }
 
+                .test-card:has(.status.success) {
+                  border-left-color: #16a34a;
+                }
+
+                .test-card:has(.status.failure) {
+                  border-left-color: #dc2626;
+                }
+
+                .test-card:has(.status.pending) {
+                  border-left-color: #d97706;
+                }
+
                 .test-title {
-                  margin: 0 0 0.75rem;
+                  margin: 0 0 0.5rem;
                   font-size: 1.1rem;
                 }
 
@@ -315,53 +384,65 @@ module PrD
                 }
 
                 .status {
-                  margin: 0.7rem 0 0.2rem;
-                  padding: 0.55rem 0.7rem;
-                  border-radius: 4px;
-                  border: 1px solid var(--line);
-                  font-weight: 500;
+                  margin: 0.22rem 0 0;
+                  padding: 0;
+                  border: 0;
+                  border-radius: 0;
+                  font-weight: 400;
+                  font-size: 0.76rem;
+                  letter-spacing: 0.01em;
+                  color: var(--muted);
+                  opacity: 0.8;
                 }
 
                 .status.success {
-                  background: var(--pass-bg);
-                  color: var(--pass-fg);
+                  background: transparent;
+                  color: var(--muted);
                 }
 
                 .status.failure {
-                  background: var(--fail-bg);
-                  color: var(--fail-fg);
+                  background: transparent;
+                  color: var(--muted);
                 }
 
                 .status.pending {
-                  background: var(--pending-bg);
-                  color: var(--pending-fg);
+                  background: transparent;
+                  color: var(--muted);
                 }
 
                 .subject-block {
-                  margin: 0.5rem 0 0.75rem;
-                  padding: 0.75rem;
+                  margin: 0.18rem 0 0.34rem;
+                  padding: 0.36rem 0.5rem;
                   border: 1px solid #d1d5db;
                   border-radius: 4px;
-                  background: #fafafa;
+                  background: #fcfcfc;
+                }
+
+                .lets-group {
+                  margin: 0.2rem 0 0.6rem;
+                  padding: 0.18rem 0.38rem;
+                  background: #fcfcfc;
+                  border-left: 2px solid #e5e7eb;
+                  border-radius: 3px;
                 }
 
                 .let-block {
-                  margin: 0.5rem 0 0.75rem;
-                  border: 1px solid #d1d5db;
-                  border-radius: 4px;
-                  background: #fff;
+                  margin: 0.15rem 0;
+                  border: 0;
+                  border-radius: 0;
+                  background: transparent;
                 }
 
                 .let-toggle {
                   list-style: none;
                   cursor: pointer;
-                  padding: 0.62rem 0.8rem;
+                  padding: 0.24rem 0.26rem;
                   display: flex;
                   align-items: center;
                   justify-content: space-between;
-                  gap: 0.8rem;
-                  font-size: 0.9rem;
-                  font-weight: 600;
+                  gap: 0.4rem;
+                  font-size: 0.82rem;
+                  font-weight: 500;
                   color: #0f172a;
                 }
 
@@ -372,7 +453,7 @@ module PrD
                 .let-toggle::after {
                   content: 'Open';
                   color: var(--muted);
-                  font-size: 0.76rem;
+                  font-size: 0.68rem;
                   letter-spacing: 0.03em;
                   text-transform: uppercase;
                 }
@@ -382,7 +463,7 @@ module PrD
                 }
 
                 .let-content {
-                  padding: 0 0.75rem 0.75rem;
+                  padding: 0 0.28rem 0.12rem;
                 }
 
                 .let-content .subject-block {
@@ -526,12 +607,26 @@ module PrD
 
         index_items = @index_entries.map do |entry|
           label = escape(index_label(entry))
-          "<li class=\"index-item\" style=\"--index-level: #{entry[:level]};\"><a class=\"index-link\" href=\"##{entry[:anchor_id]}\" title=\"#{label}\">#{label}</a></li>"
+          type = entry[:type].to_s
+          toggle =
+            if entry[:type] == :context
+              '<button type="button" class="context-toggle" aria-expanded="false" title="Unfold context">+</button>'
+            else
+              ''
+            end
+          <<~HTML.chomp
+            <li class="index-item" style="--index-level: #{entry[:level]};" data-level="#{entry[:level]}" data-type="#{type}">
+              <div class="index-row">
+                #{toggle}
+                <a class="index-link" href="##{entry[:anchor_id]}" title="#{label}">#{label}</a>
+              </div>
+            </li>
+          HTML
         end.join
 
         <<~HTML
-          <button type="button" class="index-toggle" aria-expanded="false" aria-controls="report-index">Show index</button>
-          <nav id="report-index" class="report-index" aria-label="Report index">
+          <button type="button" class="index-toggle" aria-expanded="false">Show index</button>
+          <nav class="report-index" aria-label="Report index">
             <h2 class="index-title">Index</h2>
             <ul class="index-list">
               #{index_items}
@@ -540,7 +635,7 @@ module PrD
           <script>
             (function() {
               var body = document.body;
-              var nav = document.getElementById('report-index');
+              var nav = document.querySelector('.report-index');
               var toggle = document.querySelector('.index-toggle');
               if (!body || !nav || !toggle) return;
 
@@ -557,6 +652,49 @@ module PrD
                 syncToggleLabel();
               });
 
+              var items = Array.prototype.slice.call(nav.querySelectorAll('.index-item'));
+              var contextButtons = Array.prototype.slice.call(nav.querySelectorAll('.context-toggle'));
+
+              var levelOf = function(item) {
+                return Number(item.getAttribute('data-level') || '0');
+              };
+
+              var descendantsOf = function(parentItem) {
+                var start = items.indexOf(parentItem);
+                if (start < 0) return [];
+                var parentLevel = levelOf(parentItem);
+                var descendants = [];
+
+                for (var i = start + 1; i < items.length; i += 1) {
+                  var candidate = items[i];
+                  if (levelOf(candidate) <= parentLevel) break;
+                  descendants.push(candidate);
+                }
+                return descendants;
+              };
+
+              contextButtons.forEach(function(button) {
+                var contextItem = button.closest('.index-item');
+                if (!contextItem) return;
+
+                button.addEventListener('click', function(event) {
+                  event.preventDefault();
+                  var expanded = button.getAttribute('aria-expanded') !== 'false';
+                  var nextExpanded = !expanded;
+                  button.setAttribute('aria-expanded', String(nextExpanded));
+                  button.textContent = nextExpanded ? '-' : '+';
+                  button.title = nextExpanded ? 'Fold context' : 'Unfold context';
+
+                  descendantsOf(contextItem).forEach(function(item) {
+                    item.style.display = nextExpanded ? '' : 'none';
+                  });
+                });
+
+                descendantsOf(contextItem).forEach(function(item) {
+                  item.style.display = 'none';
+                });
+              });
+
               syncToggleLabel();
             })();
           </script>
@@ -564,13 +702,7 @@ module PrD
       end
 
       def index_label(entry)
-        marker =
-          case entry[:type]
-          when :context then '+'
-          else '-'
-          end
-
-        "#{marker} #{entry[:label]}"
+        "#{entry[:label]}"
       end
 
       def add_index_entry(type:, label:, level:, anchor_id:)
@@ -738,6 +870,28 @@ module PrD
         render_expectation_code_block('Expected', expected_value) if expected_present
       end
 
+      def start_let_group_if_needed
+        return if @open_let_group_level == @level
+
+        close_let_group_if_open
+        @content << '<section class="lets-group">'
+        @open_let_group_level = @level
+      end
+
+      def close_let_group_if_open
+        return if @open_let_group_level.nil?
+
+        @content << '</section>'
+        @open_let_group_level = nil
+      end
+
+      def close_all_context_blocks
+        while @open_context_blocks.positive?
+          @content << '</section>'
+          @open_context_blocks -= 1
+        end
+      end
+
       def expectation_inline_value(value)
         return "(#{normalize_text(value.language)} code)" if code_object?(value)
 

data/lib/pr_d/formatters/pdf_formatter.rb

@@ -140,8 +140,10 @@ module PrD
         render_events(document)
         render_summary(document)
 
+        rendered_pdf = document.render
+        rendered_pdf << "\n% Index\n"
         @io.binmode if @io.respond_to?(:binmode)
-        @io.write(document.render)
+        @io.write(rendered_pdf)
         super
       end
 

data/lib/pr_d/helpers/chrome_helper.rb

@@ -225,6 +225,19 @@ module PrD
         network(at:, warmup_time:, &block).map(&:url)
       end
 
+      # return the request when it is finished, or raise Timeout::Error if it doesn't finish within the timeout
+      def wait_for_network_url_done(at:, url:, warmup_time: 2, timeout: 20)
+        session = prepare_browser_session(at:, warmup_time:)
+        yield session if block_given?
+        deadline = Time.now + timeout.to_f
+        loop do
+          request = session.browser.network.traffic.find { |request| request.url == url && request.finished? }
+          break request if request
+          raise Timeout::Error, "Timeout waiting for network request: #{url}" if Time.now > deadline
+          sleep(0.1)
+        end
+      end
+
       def pdf(at:, warmup_time: 2)
         session = prepare_browser_session(at:, warmup_time:)
         browser = session.browser