NAME

PAR::Dist::FromCPAN - Create PAR distributions from CPAN

SYNOPSIS

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,
);

DESCRIPTION

This module creates PAR distributions from any number of modules from CPAN. It exports the cpan_to_par subroutine for this task.

EXPORT

By default, the cpan_to_par subroutine is exported to the callers namespace.

SUBROUTINES

This is a list of all public subroutines in the module.

cpan_to_par

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.

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.

SEE ALSO

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

AUTHOR

Steffen Mueller, <smueller at cpan dot org>

Jesse Vincent

COPYRIGHT AND LICENSE

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.