NAME
App::MechaCPAN::Deploy - Mechanize the deployment of CPAN things.
SYNOPSIS
# Install perl and everything from the cpanfile into local/
# If cpanfile.snapshot exists, it will be consulted exclusivly
user@host:~$ mechacpan deploy
user@host:~$ mechacpan deploy git://git@example.com/MyApp.git
user@host:~$ zhuli do the thingDESCRIPTION
Deploy
user@host:~$ mechacpan deployThe deploy command is used for automating a deployment. It will install both perl and all the modules specified from the cpanfile.
cpanfile.snapshot
If there is a cpanfile.snapshot that was created by Carton, deploy will treat the modules listed in the snapshot file as the only modules available to install. If a module has a dependency not listed in the snapshot, the deployment will fail.
The option smart-tests is enabled by default when there is a cpanfile.snapshot file. See "smart-tests" in App::MechaCPAN::Install for more details.
Methods
go( \%opts, $cpanfile )
This is the entry point into deployment. It will deploy perl and modules into the local directory of the current directory. $cpanfile is optional and does not have to provided. If it is provided, it needs to be either a path to a directory that contains a file named cpanfile or the path to a file that can be used as a cpanfile.
$cpanfile can also refer to a git repository. In this case, App:MechaCPAN::Deploy will attempt to clone the repository if it's not already and checkout the branch specified branch if given. If there is a cpanfile in the checked out repository or inside a top-level directory, then that cpanfile and directory will be used.
The options available are listed below.
Arguments
skip-perl
The skip-perl boolean option will force deploy to not install perl, only the modules.
# Examples of skip-perl
mechacpan deploy --skip-perlupdate
Determines what to do with the installation of top-level dependencies. By default, deploy does not update the immediate prerequisites in the cpanfile. This overrides the same option in App::MechaCPAN::Install. See update in App::MechaCPAN::Install.
AUTHOR
Jon Gentle <cpan@atrodo.org>
COPYRIGHT
Copyright 2017- Jon Gentle
LICENSE
This is free software. You may redistribute copies of it under the terms of the Artistic License 2 as published by The Perl Foundation.