NAME

PAX::Benchmark - internal benchmark helpers for PAX validation

SYNOPSIS

my $bench = PAX::Benchmark->new(iterations => 5);
my $result = $bench->run_runtime_benchmark(entrypoint => 'bin/app.pl');

DESCRIPTION

This module measures capture, reference runtime, and native-runtime behavior for validation gates. Under SOW-03 it calls compiler/runtime modules directly instead of shelling out to removed public diagnostic CLI commands.

METHODS

new

Creates a benchmark runner. iterations controls the number of samples.

run_capture_benchmark

Runs PAX::Capture directly and records timing plus process memory fields.

run_runtime_benchmark

Compares stock Perl timing, capture timing, and native execution timing where a native region can be emitted.

PURPOSE

This module exists to keep performance comparisons scripted and reproducible so PAX can measure where a build is faster, slower, or functionally different from stock Perl.