1Carton::Doc::Install(3)User Contributed Perl DocumentatioCnarton::Doc::Install(3)
2
3
4

NAME

6       Carton::Doc::Install - Install the dependencies
7

SYNOPSIS

9         carton install [--deployment] [--cached] [--path=PATH] [--without develop]
10

DESCRIPTION

12       Install the dependencies for your application. This command has two
13       modes and the behavior is slightly different.
14
15   DEVELOPMENT MODE
16       carton install
17           If you run "carton install" without any arguments and if cpanfile
18           exists, carton will scan dependencies from cpanfile and install the
19           modules.
20
21       If you run "carton install" for the first time (i.e. cpanfile.snapshot
22       does not exist), carton will fetch all the modules specified, resolve
23       dependencies and install all required modules from CPAN.
24
25       If cpanfile.snapshot file does exist, carton will still try to install
26       modules specified or updated in cpanfile, but uses cpanfile.snapshot
27       for the dependency resolution, and then cascades to CPAN.
28
29       carton will analyze all the dependencies and their version information,
30       and it is saved into cpanfile.snapshot file. It is important to add
31       cpanfile.snapshot file into a version controlled repository and commit
32       the changes as you update your dependencies.
33
34   DEPLOYMENT MODE
35       If you specify the "--deployment" command line option or the
36       cpanfile.snapshot exists, carton will only use the dependencies
37       specified in the cpanfile.snapshot instead of resolving dependencies.
38

OPTIONS

40       --deployment
41           Force the deployment mode. See "DEPLOYMENT MODE" above.
42
43       --cached
44           Locate distribution tarballs in "vendor/cache" rather than fetching
45           them from CPAN mirrors. This requires you to run "carton bundle"
46           prior to the deployment and commit or sync the content of "vendor"
47           directory to the other host you run "carton install" on.
48
49       --cpanfile
50           Specify the alternate path for cpanfile. By default, "carton
51           install" will look for the file "cpanfile" in the current
52           directory, then upwards till the root directory, in case the
53           command runs from a sub directory.
54
55           Carton assumes the directory where your cpanfile (or altenate path)
56           exists as a project root directory, and will look for the snapshot
57           file as well as install directory ("local") and "vendor/cache"
58           relative to it.
59
60       --path
61           Specify the path to install modules to. Defaults to local in the
62           directory relative to where "cpanfile" is.
63
64           NOTE: this option, as of version 1.0, is not preserved across
65           multiple runs of "carton install" or other commands such as "carton
66           list" or "carton exec". You can choose to set the path in
67           "PERL_CARTON_PATH" environment variable to persist it across
68           commands.
69
70       --without
71           By default, "carton install" will install all the phases for
72           dependencies, including "develop". You can specify phases or
73           features to exclude, in the comma separated list.
74
75             carton install --deployment --without develop
76
77           NOTE: "--without" for the initial installation (without
78           cpanfile.snapshot) is not supported at this moment.
79
80
81
82perl v5.38.0                      2023-07-20           Carton::Doc::Install(3)