FATPACK(1) User Contributed Perl Documentation FATPACK(1)NAME
fatpack - Command line frontend for App::FatPacker
COMMANDS
pack
$ fatpack pack myscript.pl > myscript.packed.pl
A shortcut to do all the work of tracing, collecting packlists,
extracting modules in fatlib, then concatenating into a packed script -
in one shot. If you need more detailed controls for additional modules,
use the following commands separately (see "RECIPES").
trace
$ fatpack trace [--to=trace-file|--to-stderr] [--use=MODULE]
myscript.pl
Compiles myscript.pl (as in "perl -c") and writes out a trace file
containing every module require()d during the compilation.
The trace file is called 'fatpacker.trace' by default; the --to option
overrides this.
If you pass --to-stderr fatpack writes the trace to STDERR instead.
You cannot pass both --to and --to-stderr.
If the --use option specifies a module (or modules, if used multiple
times) those modules will be additionally included in the trace output.
packlists-for
$ fatpack packlists-for Module1 Module2 Module3
Searches your perl's @INC for .packlist files containing the .pm files
for the modules requested and emits a list of unique packlist files to
STDOUT.
These packlists will, in a pure cpan-installation environment, be all
non-core distributions required for those modules.
Unfortunately most vendors strip the .packlist files so if you
installed modules via e.g. apt-get you may be missing those modules;
installing your dependencies into a local::lib first is the preferred
workaround.
tree
$ fatpack tree fatlib packlist1 packlist2 packlist3
Takes a list of packlist files and copies their contents into a tree at
the requested location.
This tree should be sufficient to 'use lib' to make available all
modules provided by the distributions whose packlists were specified.
file
$ fatpack file
Recurses into the 'lib' and 'fatlib' directories and bundles all .pm
files found into a BEGIN block which adds a virtual @INC entry to load
these files from the bundled code rather than disk.
RECIPES
Current basic recipe for packing:
$ fatpack trace myscript.pl
$ fatpack packlists-for `cat fatpacker.trace` >packlists
$ fatpack tree `cat packlists`
$ fatpack file myscript.pl >myscript.packed.pl
COPYRIGHT, LICENSE, AUTHOR
See the corresponding sections in App::FatPacker.
perl v5.20.2 2013-09-22 FATPACK(1)