Steffen Müller > ExtUtils-InstallPAR > ExtUtils::InstallPAR

Download:
ExtUtils-InstallPAR-0.03.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.03   Source  

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.

syntax highlighting: