The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
App-plenv-v1.3.0
2 ++
/ plenv

NAME

plenv - perl binary manager

SYNOPSIS

    plenv help

    # list available perl versions
    plenv available

    # install perl5 binary
    plenv install 5.16.2 -- -Dusethreads

    # execute command on current perl
    plenv exec ack

    # change global default perl to 5.16.2
    plenv global 5.16.2

    # change local perl to 5.14.0
    plenv local 5.14.0

    # run this command after install cpan module, contains executable script.
    plenv rehash

    # install cpanm to current perl
    plenv install-cpanm

    # migrate modules(install all installed modules for 5.8.9 to 5.16.2 environment.)
    plenv migrate-modules 5.8.9 5.16.2

    # locate a program file in the plenv's path
    plenv which cpanm

DESCRIPTION

Use plenv to pick a Perl version for your application and guarantee that your development environment matches production. Put plenv to work with [Carton](http://github.com/miyagawa/carton/) for painless Perl upgrades and bulletproof deployments.

plenv vs. perlbrew

plenv supports project local version determination.

i.e. .perl-version file support.

INSTALLATION

INSTALL FROM CPAN

Install plenv with CPAN.

    $ sudo -H cpan -i App::plenv

INSTALL FROM Homebrew

You can use homebrew to install plenv.

    $ brew install plenv

INSTALL WITH GIT

1. Check out plenv into ~/.plenv/

    $ git clone git://github.com/tokuhirom/plenv.git ~/.plenv

2. Add ~/.plenv/bin/ to your $PATH for access to the `plenv` command-line utility.

    $ echo 'export PATH="$HOME/.plenv/bin:$PATH"' >> ~/.bash_profile

    **Ubuntu note**: Modify your `~/.profile` instead of `~/.bash_profile`.

    **Zsh note**: Modify your `~/.zshrc` file instead of `~/.bash_profile`.

SETUP SHELL SETTINGS

Add `plenv init` to your shell to enable shims and autocompletion.
    $ echo 'eval "$(plenv init -)"' >> ~/.bash_profile

Same as in previous step, use `~/.profile` on Ubuntu, `~/.zshrc` for Zsh.

Restart your shell as a login shell so the path changes take effect.

You can now begin using plenv.

    $ exec $SHELL -l

Perl version detection

plenv detects current perl version with following order.

PLENV_VERSION environment variable
.perl-version file in current and upper directories.
global settings(~/.plenv/version)
use system perl

DEPENDENCIES

  * Perl 5.8.1+
  * wget or curl or fetch.

FAQ

How can I install cpanm?

Try to use following command.

    % plenv install-cpanm

This command install cpanm to current environment.

What should I do for installing the module which I used for new Perl until now?

You can use migrate-modules subcommand.

    % plenv migrate-modules 5.8.2 5.16.2

It make a list of installed modules in 5.8.2, and install these modules to 5.16.2 environment.

How can I enable -g option without slowing down binary?

Use following command.

    % plenv install 5.16.2 -DDEBUGGING=-g

BUG REPORTING

Plese use github issues: http://github.com/tokuhirom/plenv/.

AUTHOR

Tokuhiro Matsuno <tokuhirom AAJKLFJEF@ GMAIL COM>

SEE ALSO

App::perlbrew provides same feature. But plenv provides project local file: .perl-version .

Most of part was inspired from rbenv.

LICENSE

Copyright (C) Tokuhiro Matsuno

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.