NAME

App::Pinto::Command::install - install stuff from the repository

VERSION

version 0.043

SYNOPSIS

  pinto --root=REPOSITORY_ROOT install [OPTIONS] TARGET...
  pinto --root=REPOSITORY_ROOT install [OPTIONS] < LIST_OF_TARGETS

DESCRIPTION

!! THIS COMMAND IS EXPERIMENTAL !!

Installs packages from the repository into your environment. This is just a thin wrapper around cpanm that is wired to fetch everything from the Pinto repository, rather than a public CPAN mirror. If the the --pull option is given, all prerequisites (including the targets themselves) will be pulled onto the stack before attempting to install them. If the repository does not contain a prerequisite, it will be pulled from one of the upstream repositories. If any prerequisite cannot be pulled because it does not exist or blocked by a pin, then the installation will not proceed.

COMMAND ARGUMENTS

Arguments are the things you want to install. These can be package names, distribution paths, URLs, local files, or directories. Look at the cpanm documentation to see all the different ways of specifying what to install.

You can also pipe arguments to this command over STDIN. In that case, blank lines and lines that look like comments (i.e. starting with "#" or ';') will be ignored.

COMMAND OPTIONS

--cpanm-exe PATH

--cpanm PATH

Sets the path to the cpanm executable. If not specified, the PATH will be searched for the executable. At present, cpanm version 1.500 or newer is required.

--cpanm-options NAME=VALUE

-o NAME=VALUE

These are options that you wish to pass to cpanm. Do not prefix the option name with a '-'. You can pass any option you like, but the --mirror and --mirror-only options will always be set to point to the Pinto repository.

--local-lib DIRECTORY

-l DIRECTORY

Shortcut for setting the --local-lib option on cpanm. Same as --cpanm-options local-lib=DIRECTORY or -o l=DIRECTORY.

--local-lib-contained DIRECTORY

-l DIRECTORY

Shortcut for setting the --local-lib-contained option on cpanm. Same as --cpanm-options local-lib-containted=DIRECTORY or -o L=DIRECTORY.

--pull

Recursively Pull prerequsiste packages (or the targets themselves) onto the stack before installing. Without the --pull option, all prerequisites must already be on the stack. See the pull command to explicitly pull packages onto a stack or the merge command to merge packages from one stack to another.

--stack=NAME

Use the stack with the given NAME as the repository index. Defaults to the name of whichever stack is currently marked as the default stack. Use the stacks command to see the stacks in the repository.

AUTHOR

Jeffrey Thalhammer <jeff@imaginative-software.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Imaginative Software Systems.

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