1PAR::Filter(3)        User Contributed Perl Documentation       PAR::Filter(3)
2
3
4

NAME

6       PAR::Filter - Input filter for PAR
7

SYNOPSIS

9           $code = 'use strict; print "Hello, World!\n";';
10           $ref = PAR::Filter->new('PodStrip', 'Bleach')->apply(\$code);
11           print $code;    # pod-stripped and obfuscated code
12           print $$ref;    # same thing
13
14           $ref = PAR::Filter->new('PodStrip', 'Bleach')->apply('file.pl');
15           print $$ref;    # same thing, applied to file.pl
16

DESCRIPTION

18       Starting with PAR 0.76, "pp -f" takes a filter name, like "Bleach", and
19       invokes this module to transform the programs with PAR::Filter::Bleach.
20       Similarly, "pp -F Bleach" applies the Bleach filter to all included
21       modules.
22
23       It is possible to pass in multiple such filters, which are applied in
24       turn.
25
26       The output of each such filter is expected be semantically equivalent
27       to the input, although possibly obfuscated.
28
29       The default list of filters include:
30
31       •   PAR::Filter::Bleach
32
33           The archetypical obfuscating filter.
34
35       •   PAR::Filter::Obfuscate
36
37           Use B::Deobfuscate to strip away indents and comments, as well as
38           mangling variable names.
39
40       •   PAR::Filter::PatchContent
41
42           Fix PAR-incompatible modules, applied to modules by default.
43
44       •   PAR::Filter::PodStrip
45
46           Strip away POD sections, applied to modules by default.
47
48       •   PAR::Filter::Bytecode
49
50           Use B::Bytecode to strip away indents and comments.  This filter is
51           deprecated! For source hiding, have a look at PAR::Filter::Crypto
52           instead and make sure to read about its caveats.
53

AUTHORS

55       Audrey Tang <cpan@audreyt.org>
56
58       Copyright 2003-2009 by Audrey Tang <cpan@audreyt.org>.
59
60       This program is free software; you can redistribute it and/or modify it
61       under the same terms as Perl itself.
62
63       See LICENSE.
64
65
66
67perl v5.36.3                      2023-11-30                    PAR::Filter(3)
Impressum