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.
cpan_to_par
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.
cpan install MODULEPATTERN
Arguments:
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.
The PAR::Dist module is used to create .par distributions from an unpacked CPAN distribution. The CPAN module is used to fetch the distributions from the CPAN.
PAR has a mailing list, <par@perl.org>, that you can write to; send an empty mail to <par-subscribe@perl.org> to join the list and participate in the discussion.
Please send bug reports to <bug-par-dist-fromcpan@rt.cpan.org>.
The official PAR website may be of help, too: http://par.perl.org
Steffen Mueller, <smueller at cpan dot org>
Jesse Vincent
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.
To install PAR::Dist::FromCPAN, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PAR::Dist::FromCPAN
CPAN shell
perl -MCPAN -e shell install PAR::Dist::FromCPAN
For more information on module installation, please visit the detailed CPAN module installation guide.