Manual Reference Pages - PIP (3)
pip - The Perl Installation Program, for scripted and third-party
The <B>pipB> (Perl Installation Program) console application is used to
install Perl distributions in a wide variety of formats, both from CPAN
and from external third-party locations, while supporting module
dependencies that go across the boundary from third-party to CPAN.
Using <B>pipB> you can install CPAN modules, arbitrary tarballs from both
the local file-system or across the internet from arbitrary URIs.
You can use <B>pipB> to ensure that specific versions of CPAN modules are
installed instead of the most current version.
And beyond just single installations, you script script a series of
these installations by creating a P5I (Perl 5 Installation) file.
A Perl 5 Installation (P5I) file is a small script-like file that
describes a set of distributions to install, and integrates the
installation of these distributions with the CPAN installer.
The primary use of P5I files are for installing proprietary or
non-CPAN software that may still require the installation of a
number of CPAN dependencies in order to function.
P5I files are also extensible, with the first line of the file
specifying the name of the Perl class that implements the plan.
For the moment, the class described at the top of the P5I file
must be installed.
The simple Module::Plan::Lite plan class is bundled with the main
distribution, and additional types can be installed if needed.
Also on the development schedule for <B>pipB> is the creation and
installation of distributions via P5Z files, which are tarballs
containing a P5I file, as well as all the distribution tarballs
referenced by the P5I file.
It is also anticipated that <B>pipB> will gain support for PAR
binary packages and potentially also for ActivePerl PPM files.
The primary use of pip is to install from a P5I script, with the
canonical use case as follows:
This command will load the plan file directory/myplan.p5i, create
the plan, and then execute it.
If only a directory name is given, pip will look for a default.p5i
plan in the directory. Thus, all of the following are equivalent
If no target is provided at all, then the current directory will be used.
Thus, the following are equivalent
Syntax of a plan file
Initially, the only plan is available is the Module::Plan::Lite
A typical MPL plan will look like the following
Direct installation of a single tarball
With the functionality available in pip, you can find that sometimes
you dont even want to make a file at all, you just want to install a
The -i option lets you pass the name of a single file and it will treat
it as an installer for that single file. Further, if the extension of the
tarball is .tar.gz, the <B>-iB> option is implied.
For example, the following are equivalent.
# Installing with the -i|--install option
> pip Process-0.17.tar.gz
> pip -i Process-0.17.tar.gz
> pip --install Process-0.17.tar.gz
# Installing from the file as normal
> pip ./default.p5i
The -i option can be used with any single value supported by
Module::Plan::Lite (see above).
This means you can also use <B>pipB> to install a distribution from any
arbitrary URI, including installing direct from a subversion repository.
> pip http://svn.ali.as/cpan/release/Process-0.17.tar.gz
This module is stored in an Open Repository at the following address.
Write access to the repository is made available automatically to any
published CPAN author, and to most other volunteers on request.
If you are able to submit your bug report in the form of new (failing)
unit tests, or can apply your fix directly instead of submitting a patch,
you are <B>stronglyB> encouraged to do so. The author currently maintains
over 100 modules and it may take some time to deal with non-Critical bug
reports or patches.
This will guarentee that your issue will be addressed in the next
release of the module.
If you cannot provide a direct test or fix, or dont have time to do so,
then regular bug reports are still accepted and appreciated via the CPAN
For other issues, for commercial enhancement and support, or to have your
write access enabled for the repository, contact the author at the email
Adam Kennedy <email@example.com>
Module::Plan::Base, Module::Plan::Lite, Module::Plan
Copyright 2006 - 2010 Adam Kennedy.
This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the
LICENSE file included with this module.
|perl v5.20.3 ||PIP (3) ||2010-11-29 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.