pvx

Perl Version eXecutor. Executes Perl code in isolated environments.

pvx [options] script.pl [args...]

Execution modes

Mode is auto-detected from the invocation:

1. Tool execution — recognized Perl tools invoked by name
2. Script execution — .pl or .pm files
3. Inline code execution — -e or -E flags

Options

Execution

-e, --execute <code>

Execute Perl code directly.

-E, --execute-features <code>

Execute with all features enabled (say, state, etc.).

-p, --perl <version>

Use a specific Perl version.

-f, --force

Force using the specified version.

Isolation

--isolation <level>

Set isolation level. One of: global, local, clean.

--isolation-dir <path>

Specify the isolation directory.

--no-cleanup

Keep the isolation directory after execution.

--name <name>

Create or reuse a named persistent isolation environment.

Module management

-a, --auto-install

Auto-install required modules.

--no-install

Don't install missing modules.

--require <module>

Require a specific module. Repeatable.

--with <dep>

Add an additional dependency. Repeatable.

--include-path <path>

Add a path to PERL5LIB. Repeatable.

--module-path <path>

Custom module installation path.

--auto-detect-deps

Auto-detect dependencies from use and require statements. Default: true.

Environment

--preserve-env <var>

Preserve a specific environment variable. Repeatable.

--clear-env <var>

Remove an environment variable. Repeatable.

Output

-v, --verbose

Show additional output.

-q, --quiet

Suppress non-error output.

--debug

Show detailed debug output.