View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Martin Atkins > perl-local-env-0.03 > perl-local-env


Annotate this POD

View/Report Bugs


perl-local-env - Easily create and activate a local::lib environment


    perl-local-lib <environment-path> ...
         ... create
         ... activate
         ... run <command>


This tool provides a set of commands for creating and activating local environments created by local::lib.


Create a local environment

    perl-local-lib <environment-path> create

This will create a directory at the given path and configure it to work as a local environment. You only need to do this step once for each environment.

Activate your environment

Each time you want to run code in the context of the environment you must first activate it:

    perl-local-lib <environment-path> activate

This will start a new child shell with the right settings to make perl look for libraries only in the local environment, and add the environment's bin directory to the PATH so that local tools are available.

You can use that shell to run as many commands as you like in the context of the virtual environment, including cpanm to install new packages into the local environment.

Exit the environment

To leave the environment, just exit the shell that was launched by activate above. If you were already in a shell when you activated the environment, you will be returned to that shell.


Run an arbitrary command

Rather than launching a full shell, you can launch an individual command in the context of the environment using the "run" command:

    perl-local-lib <environment-path> run <command>

For example, you could use this to install Plack into your local environment without first launching a shell:

    perl-local-lib <environment-path> run cpanm Plack


This tool currently only works fully on UNIX systems. You may have limited success on other systems, but don't be surprised if things randomly go wrong.


local::lib, cpanm


Copyright 2010 Martin Atkins and Six Apart Ltd. All Rights Reserved.

This tool is redistributable under the same terms as perl itself.

syntax highlighting: