NAME perl-local-env - Easily create and activate a local::lib environment SYNOPSIS perl-local-lib ... ... create ... activate ... run DESCRIPTION This tool provides a set of commands for creating and activating local environments created by local::lib. WORKFLOW Create a local environment perl-local-lib 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 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. OTHER COMMANDS 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 run For example, you could use this to install Plack into your local environment without first launching a shell: perl-local-lib run cpanm Plack CAVEATS 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. SEE ALSO local::lib, cpanm AUTHOR Copyright 2010 Martin Atkins and Six Apart Ltd. All Rights Reserved. This tool is redistributable under the same terms as perl itself.