NAME

ExtUtils::InstallPAR - Install .par's into any installed perl

SYNOPSIS

  use ExtUtils::InstallPAR;
  
  # Install into the currently running perl:
  ExtUtils::InstallPAR::install(
    par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
  );
  
  # Install into a different perl on the system,
  # this requires the ExtUtils::Infer module.
  ExtUtils::InstallPAR::install(
    par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
    perl => '/path/to/perl.exe',
  );
  
  # If LWP::Simple is available, it works with URLs, too:
  ExtUtils::InstallPAR::install(
    par => 'http://foo.com/Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
  );

DESCRIPTION

This module installs PAR distributions (i.e. .par files) into any perl installation on the system. The PAR::Dist module can install into the currently running perl by default and provides the necessary parameters to override any installation directories. Figuring out how to use those overrides in order to install into an arbitrary perl installation on the system may be beyond most users, however. Hence this convenience wrapper using ExtUtils::InferConfig to automatically determine the typical site installation paths of any perl interpreter than can be executed by the current user.

FUNCTIONS

install

Install a PAR archive into any perl on the system. Takes named parameters:

par => '/path/to/foo.par' or par => 'http://URL/to/foo.par' specifies the path to the .par file to install or an URL to fetch it from (of LWP::Simple is available). This parameter is mandatory.

The perl => '/path/to/perl' parameter can be used to specify the perl interpreter to install into. If you omit this option or set it to undef, the currently running perl will be used as target. If you want to install into different perls, you will need to install the ExtUtils::InferConfig module.

verbosity => $value can be used to set the verbosity of the installation process. Defaults to 1.

CAVEATS

SEE ALSO

PAR and PAR::Dist for the gist on PAR distributions/archives.

ExtUtils::InferConfig for details on how the installation paths are determined.

ExtUtils::Install is used to install the files into the system.

PAR::Dist can use LWP::Simple to fetch from URLs.

AUTHOR

Steffen Mueller, <smueller@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 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.