PAR::Dist::FromCPAN - Create PAR distributions from CPAN
use PAR::Dist::FromCPAN; # Creates a .par distribution of the Math::Symbolic module in the # current directory. cpan_to_par(pattern => '^Math::Symbolic$'); # The same, but also create .par distributions for Math::Symbolic's # dependencies and run all tests. cpan_to_par(pattern => '^Math::Symbolic$', follow => 1, test => 1); # Create distributions for all modules below the 'Math::Symbolic' # namespace in the 'par-dist/' subdirectory and be verbose about it. cpan_to_par( pattern => '^Math::Symbolic', out => 'par-dist/', verbose => 1, );
This module creates PAR distributions from any number of modules from CPAN. It exports the cpan_to_par subroutine for this task.
By default, the
cpan_to_par subroutine is exported to the callers namespace.
This is a list of all public subroutines in the module.
The only mandatory parameter is a pattern matching the modules you wish to create PAR distributions from. This works the same way as, for example
cpan install MODULEPATTERN.
pattern => 'patternstring' out => 'directory' (write distribution files to this directory) verbose => 1/0 (verbose mode on/off) test => 1/0 (run module tests on/off) follow => 1/0 (also create distributions for dependencies on/off) merge => 1/0 (merge everything into one .par archive) strip_docs => 1/0 (strip all man* and html documentation) skip => \@ary (skip all modules that match any of the regular expressions in @ary) auto_detect_pure_perl => 1/0 (Flags the PAR distribution platform and perl version agnostic if it is deemed pure-perl.) perl_version => Defaults to your version of Perl. Used to determine which modules are core perl and thus will be skipped. Set this to 0 to package all core modules as well.
PAR has a mailing list, <email@example.com>, that you can write to; send an empty mail to <firstname.lastname@example.org> to join the list and participate in the discussion.
Please send bug reports to <email@example.com>.
The official PAR website may be of help, too: http://par.perl.org
Steffen Mueller, <smueller at cpan dot org>
Copyright (C) 2006-2009 by Steffen Mueller
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6 or, at your option, any later version of Perl 5 you may have available.