/ 
PAX-0.031
/ PAX::StandaloneImage

NAME

PAX::StandaloneImage - build standalone PAX executable images

SYNOPSIS

my $image = PAX::StandaloneImage->new;
my $result = $image->build(
    entrypoint => 'bin/app.pl',
    lib_dirs   => ['lib'],
    output     => '/tmp/app',
);

DESCRIPTION

This module packages an entrypoint, compiled code units, runtime helpers, dependency payloads, native artifacts, and assets into one executable. Runtime helper discovery is independent of the current working directory, so pax build -o output bin/pax can be launched from a directory with no local lib/ directory.

METHODS

new

Constructs a standalone image builder.

build

Builds a standalone executable from entrypoint, library paths, source roots, cpanfile inputs, assets, output path, and runtime mode.

load

Loads a previously written standalone image manifest by name.

PURPOSE

This module owns the single-binary packaging path. It is where source planning, runtime payload selection, launcher generation, and manifest writing come together.

HOW TO USE

Build through this module when a workflow needs one standalone executable. Keep project-neutral packaging rules here rather than scattering them through the CLI or application-specific fixtures.