NAME

cpm - a fast CPAN module installer

SYNOPSIS

# install modules into local/
> cpm install Module1 Module2 ...

# install modules with verbose messages
> cpm install -v Module

# from cpanfile (with cpanfile.snapshot if any)
> cpm install

# install module into current @INC istead of local/
> cpm install -g Module

# prefer TRIAL release
> cpm install --dev Moose

# install modules as if version of your perl is 5.8.5
# so that modules which are not core in 5.8.5 will be installed
> cpm install --target-perl 5.8.5

# query/fetch distributions for your local or remote darkpan only
> cpm install --mirror file:///path/to/darkpan   --mirror-only Your::Module
> cpm install --mirror http:/example.com/darkpan --mirror-only Your::Module

# use your custom resolver, see `perldoc App::cpm::Resolver`
> cpm install --resolver /path/to/resolver.pl Youde::Module

OPTIONS

-w, --workers=N
      number of workers, default: 5
-L, --local-lib-contained=DIR
      directory to install modules into, default: local/
-g, --global
      install modules into current @INC instead of local/
-v, --verbose
      verbose mode; you can see what is going on
    --target-perl=VERSION  (EXPERIMENTAL)
      install modules as if verison is your perl is VERSION
    --mirror=URL
      base url for the CPAN mirror to use, you can use --mirror multiple times
      default: http://www.cpan.org and http://backpan.perl.org
    --mirror-only (EXPERIMENTAL, will be removed or renamed)
      query 02packages.details.txt.gz instead of cpanmetadb
    --resolver=SCRIPT (EXPERIMENTAL, will be removed or renamed)
      use your own resolver, see `perldoc App::cpm::Resolver`
    --dev (EXPERIMENTAL)
      resolve TRIAL distributions too
    --color, --no-color
      turn on/off color output, default: on
    --test, --no-test
      run test cases, default: no
-V, --version
      show version
-h, --help
      show this help