pll.pod

NAME

pll - Create local::lib environment for Perl

SYNOPSIS

pll [--notest] /path/to/environment

DESCRIPTION

Pll is yet another virtualenv (http://pypi.python.org/pypi/virtualenv) alike tool for Perl. It is used to create isolated Perl environments with the help of the local::lib module (http://search.cpan.org/dist/local-lib/lib/local/lib.pm).

Features

It is a plain Bourne shell script.

The created Perl environment contains the local::lib module and App::cpanminus' cpanm(1) script (http://search.cpan.org/dist/App-cpanminus/bin/cpanm).

In each Perl environment created, it installs wrapper scripts bin/perl, bin/perldoc, bin/cpanm so that the commands they wrap use the isolated Perl environment via local::lib.

To ease the use of each Perl environment created, it installs the bin/activate.sh Bourne shell script. This script can be sourced to set the required environment variables. Similarly, the installed bin/deactivate.sh Bourne shell script can be sourced to restore the environment variables set by the former script. See local::lib documentation for details.

Creation of an isolated Perl environment

To create an isolated Perl environment, simply run a command like

$ ./pll /path/to/environment

The pll script needs an absolute pathname on a perl(1) executable. It defaults to /usr/bin/perl and can be specified with the PERL environment variable as follows:

$ env PERL=/usr/local/bin/perl ./pll /path/to/environment

If a pathname in which to create the environment is not specified as argument, it defaults to ${HOME}/perl5/local-V, where V is the used perl command's version.

The local::lib module is installed in /path/to/environment/lib/... and scripts in /path/to/environment/bin.

The local::lib module and its required modules, if any, are installed with the help of the cpanm script. The test of all these modules are run by cpanm during installation and any failure stops the installation. If needed the tests can be ignored by specifying the --notest argument.

About the bin/perl wrapper

In an isolated Perl environment the bin/perl script behavior's differs somewhat from the perl(1) command it wraps.

Without argument the bin/perl wrapper script outputs useful shell commands to run to setup the isolated Perl environment. See local::lib documentation for details.

If it is really needed to have the wrapped perl command running program from its standard input one of the following commands can be used, as appropriate:

$ /path/to/environment/bin/perl /dev/stdin


$ /path/to/environment/bin/perl /dev/tty

USAGE EXAMPLES

• To create a new Perl environment in /tmp/p

  $ ./pll /tmp/p

• To install Catalyst::Devel in the /tmp/p environment just created

  $ /tmp/p/bin/cpanm Catalyst::Devel

• To run installed catalyst.pl script just installed

  $ /tmp/p/bin/perl /tmp/p/bin/catalyst.pl

• To setup the current shell session to use the environment created earlier

  $ . /tmp/p/bin/activate.sh
  $ catalyst.pl
  ...
  $ type perl
  perl is /tmp/p/bin/perl
  $

• To create a new Perl environment in /tmp/p2 with a specific Perl

  $ env PERL=/usr/local/bin/perl ./pll /tmp/p2

INSTALLATION ONE-LINERS

Various way to install Perl environments while downloading the pll script from GitHub.

• Download with curl, install in default location

  $ curl -kL https://raw.github.com/stoned/pll/master/pll | sh

• Download with curl, install in a specific location

  $ curl -kL https://raw.github.com/stoned/pll/master/pll | sh -- /dev/stdin /tmp/p

• Download with wget, install in a specific location

  $ wget --no-check-certificate -O - https://raw.github.com/stoned/pll/master/pll | sh -- /dev/stdin /tmp/p

• Download with curl, install in a specific location with a specific Perl

  $ curl -kL https://raw.github.com/stoned/pll/master/pll | env PERL=/usr/pkg/bin/perl sh -- /dev/stdin /tmp/p

SEE ALSO

https://github.com/markpasc/localenv, http://terrarum.net/development/perl-virtual-environments.html, local::lib, App::cpanminus

AUTHOR

Stoned Elipot