1FATPACK(1)            User Contributed Perl Documentation           FATPACK(1)
2
3
4

NAME

6       fatpack - Command line frontend for App::FatPacker
7

COMMANDS

9   pack
10         $ fatpack pack myscript.pl > myscript.packed.pl
11
12       A shortcut to do all the work of tracing, collecting packlists,
13       extracting modules in fatlib, then concatenating into a packed script -
14       in one shot. If you need more detailed controls for additional modules,
15       use the following commands separately (see "RECIPES").
16
17   trace
18         $ fatpack trace [--to=trace-file|--to-stderr] [--use=MODULE]
19             myscript.pl
20
21       Compiles myscript.pl (as in "perl -c") and writes out a trace file
22       containing every module require()d during the compilation.
23
24       The trace file is called 'fatpacker.trace' by default; the --to option
25       overrides this.
26
27       If you pass --to-stderr fatpack writes the trace to STDERR instead.
28
29       You cannot pass both --to and --to-stderr.
30
31       If the --use option specifies a module (or modules, if used multiple
32       times) those modules will be additionally included in the trace output.
33
34   packlists-for
35         $ fatpack packlists-for Module1 Module2 Module3
36
37       Searches your perl's @INC for .packlist files containing the .pm files
38       for the modules requested and emits a list of unique packlist files to
39       STDOUT.
40
41       These packlists will, in a pure cpan-installation environment, be all
42       non-core distributions required for those modules.
43
44       Unfortunately most vendors strip the .packlist files so if you
45       installed modules via e.g. apt-get you may be missing those modules;
46       installing your dependencies into a local::lib first is the preferred
47       workaround.
48
49   tree
50         $ fatpack tree fatlib packlist1 packlist2 packlist3
51
52       Takes a list of packlist files and copies their contents into a tree at
53       the requested location.
54
55       This tree should be sufficient to 'use lib' to make available all
56       modules provided by the distributions whose packlists were specified.
57
58   file
59         $ fatpack file
60
61       Recurses into the 'lib' and 'fatlib' directories and bundles all .pm
62       files found into a BEGIN block which adds a virtual @INC entry to load
63       these files from the bundled code rather than disk.
64

RECIPES

66       Current basic recipe for packing:
67
68         $ fatpack trace myscript.pl
69         $ fatpack packlists-for `cat fatpacker.trace` >packlists
70         $ fatpack tree `cat packlists`
71         $ fatpack file myscript.pl >myscript.packed.pl
72

COPYRIGHT, LICENSE, AUTHOR

74       See the corresponding sections in App::FatPacker.
75
76
77
78perl v5.38.0                      2023-07-20                        FATPACK(1)
Impressum