1FATPACK(1) User Contributed Perl Documentation FATPACK(1)
2
3
4
6 fatpack - Command line frontend for App::FatPacker
7
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
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
74 See the corresponding sections in App::FatPacker.
75
76
77
78perl v5.28.1 2019-02-18 FATPACK(1)