NAME

App::runscript - Module that implements the runscript utility

SYNOPSIS

  runscript [ -V | -h ]

  runscript <perl application> <arguments passed to the perl application>

DESCRIPTION

This module assumes that you have deployed a "perl application" locally using the "Other-bootstrapping-options" in local::lib procedure. Usually you are able to execute the application only because the PERL5LIB environment variable was amended. This amendment is needed so that the application is able to locate the libraries it depends on. If the application does not find its dependencies it will fail with the message

  Can't locate ... in @INC (@INC contains: ...)

The runscript utility helps you to avoid the PERL5LIB amendment. It has the following processing steps:

1. It finds out the absolute path of a given perl application. If the application is in the PATH you may pass its basename to runscript.

2. It takes the dirname of the absolute path and removes the bin/ subdirectory. The result is the "install base".

3. It adds the directory lib/perl5/ to the install base.

4. It prepends the final library path to @INC before executing the application.

SEE ALSO

• App::rbinperl

• App::rlibperl

• App::local::lib::helper

• lib::relative

AUTHOR

Sven Willenbuecher <sven.willenbuecher@gmx.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2024 by Sven Willenbuecher.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.