NAME

App::FatPacker - pack your dependencies onto your script file

SYNOPSIS

  $ fatpack pack myscript.pl >myscript.packed.pl

Or, with more step-by-step control:

  $ fatpack trace myscript.pl
  $ fatpack packlists-for `cat fatpacker.trace` >packlists
  $ fatpack tree `cat packlists`
  $ fatpack file myscript.pl >myscript.packed.pl

Each command is designed to be simple and self-contained so that you can modify the input/output of each step as needed. See the documentation for the fatpack script itself for more information.

The programmatic API for this code is not yet fully decided, hence the 0.x release version. Expect that to be cleaned up for 1.0.

CAVEATS

As dependency module code is copied into the resulting file as text, only pure-perl dependencies can be packed, not compiled XS code.

The currently-installed dependencies to pack are found via .packlist files, which are generally only included in non-core distributions that were installed by a CPAN installer. This is a feature; see "packlists-for" in fatpack for details. (a notable exception to this is FreeBSD, which, since its packaging system is designed to work equivalently to a source install, does preserve the packlist files)

SEE ALSO

article for Perl Advent 2012 <http://www.perladvent.org/2012/2012-12-14.html>

pp - PAR Packager, a much more complex architecture-dependent packer that can pack compiled code and even a Perl interpreter

SUPPORT

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=App-FatPacker> (or bug-App-FatPacker@rt.cpan.org <mailto:bug-App-FatPacker@rt.cpan.org>).

You can normally also obtain assistance on irc, in #toolchain on irc.perl.org.

AUTHOR

Matt S. Trout (mst) <mst@shadowcat.co.uk>

COPYRIGHT

Copyright (c) 2010 the App::FatPacker "AUTHOR" and "CONTRIBUTORS" as listed above.

LICENSE

This library is free software and may be distributed under the same terms as perl itself.