NAME

Perl::Strip - reduce file size by stripping whitespace, comments, pod etc.

SYNOPSIS

   use Perl::Strip;

DESCRIPTION

This module transforms perl sources into a more compact format. It does this by removing most whitespace, comments, pod, and by some other means.

The resulting code looks obfuscated, but perl (and the deparser) don't have any problems with that. Depending on the source file you can expect about 30-60% "compression".

The main target for this module is low-diskspace environments, such as App::Staticperl, boot floppy/CDs/flash environments and so on.

See also the commandline utility perlstrip.

METHODS

The Perl::Strip class is a subclsass of PPI::Transform, and as such inherits all of it's methods, even the ones not documented here.

my $transform = new Perl::Strip key => value...

Creates a new Perl::Strip transform object. It supports the following parameters:

optimise_size => $bool

By default, this module optimises compressability, not raw size. This switch changes that (and makes it slower).

keep_nl => $bool

By default, whitespace will either be stripped or replaced by a space. If this option is enabled, then newlines will not be removed. This has the advantage of keeping line number information intact (e.g. for backtraces), but of course doesn't compress as well.

cache => $path

Since this module can take a very long time (minutes for the larger files in the perl distribution), it can utilise a cache directory. The directory will be created if it doesn't exist, and can be deleted at any time.

$perl = $transform->strip ($perl)

Strips the perl source in $perl and returns the stripped source.

SEE ALSO

App::Staticperl, Perl::Squish.

AUTHOR

   Marc Lehmann <schmorp@schmorp.de>
   http://home.schmorp.de/