1App::Pinto::Command::adUds(e3r)Contributed Perl DocumentAaptpi:o:nPinto::Command::add(3)
2
3
4

NAME

6       App::Pinto::Command::add - add local archives to the repository
7

VERSION

9       version 0.14
10

SYNOPSIS

12         pinto --root=REPOSITORY_ROOT add [OPTIONS] ARCHIVE_FILE ...
13

DESCRIPTION

15       This command adds local distribution archives to the repository and
16       registers their packages on a stack. Then it recursively pulls all the
17       distributions that are necessary to satisfy their prerequisites.
18
19       When locating prerequisite packages, Pinto first looks at the packages
20       that already exist in the local repository, then Pinto looks at the
21       packages that are available on the upstream repositories.
22

COMMAND ARGUMENTS

24       Arguments to this command are paths to the distribution archives that
25       you wish to add.  Each of these files must exist and must be readable.
26
27       You can also pipe arguments to this command over STDIN.  In that case,
28       blank lines and lines that look like comments (i.e. starting with "#"
29       or ';') will be ignored.
30

COMMAND OPTIONS

32       --author NAME
33           Set the identity of the distribution author.  The "NAME" is
34           automatically forced to uppercase and must match
35           "/^[A-Z]{2}[-A-Z0-9]*$/" (that means two ASCII letters followed by
36           zero or more ASCII letters, digits, or hyphens). Defaults to the
37           "user" attribute specified in your ~/.pause configuration file if
38           such file exists.  Otherwise, defaults to your current login
39           username.
40
41       --cascade
42           !! THIS OPTION IS EXPERIMENTAL !!
43
44           When searching for a prerequisite package, always take the latest
45           satisfactory version of the package found amongst all the upstream
46           repositories, rather than just taking the first satisfactory
47           version that is found.  Remember that Pinto only searches the
48           upstream repositories when the local repository does not already
49           contain a satisfactory version of the package.
50
51       --diff-style=STYLE
52           Controls the style of the diff reports.  STYLE must be either
53           "concise" or "detailed".  Concise reports show only one record for
54           each distribution added or deleted.  Detailed reports show one
55           record for every package added or deleted.
56
57           The default style is "concise".  However, the default style can
58           changed by setting the "PINTO_DIFF_STYLE" environment variable to
59           your preferred STYLE.  This variable affects the default style for
60           diff reports generated by all other commands too.
61
62       --dry-run
63           Go through all the motions, but do not actually commit any changes
64           to the repository.  At the conclusion, a diff showing the changes
65           that would have been made will be displayed.  Use this option to
66           see how upgrades would potentially impact the stack.
67
68       --message=TEXT
69       -m TEXT
70           Use TEXT as the revision history log message.  If you do not use
71           the "--message" option or the "--use-default-message" option, then
72           you will be prompted to enter the message via your text editor.
73           Use the "PINTO_EDITOR" or "EDITOR" or "VISUAL" environment
74           variables to control which editor is used.  A log message is not
75           required whenever the "--dry-run" option is set, or if the action
76           did not yield any changes to the repository.
77
78       --no-fail
79           !! THIS OPTION IS EXPERIMENTAL !!
80
81           Normally, failure to add an archive (or its prerequisites) causes
82           the command to immediately abort and rollback the changes to the
83           repository.  But if "--no-fail" is set, then only the changes
84           caused by the failed archive (and its prerequisites) will be rolled
85           back and the command will continue processing the remaining
86           archives.
87
88           This option is useful if you want to throw a list of archives into
89           a repository and see which ones are problematic.  Once you've fixed
90           the broken ones, you can throw the whole list at the repository
91           again.
92
93       --no-index=PACKAGE
94       -x PACKAGE
95       --no-index=/PATTERN
96       -x /PATTERN
97           !! THIS OPTION IS EXPERIMENTAL !!
98
99           Exclude the PACKAGE from the index.  If the argument starts with a
100           slash, then it is interpreted as a regular expression, and all
101           packages matching the pattern will be excluded.  Exclusions only
102           apply to the added distributions (i.e. the arguments to this
103           command) so they do not affect any prerequisited distributions that
104           may also get pulled.  You can repeat this option to specify
105           multiple PACKAGES or PATTERNS.
106
107           This option is useful when Pinto's indexing is to aggressive and
108           finds packages that it probably should not.  Remember that Pinto
109           does not promise to index exactly as PAUSE would.  When using a
110           PATTERN, take care to use a conservative one so you don't exclude
111           the wrong packages.  Pinto will throw an exception if you exclude
112           every package in the distribution.
113
114       --pin
115           Pins all the packages in the added distributions to the stack, so
116           they cannot be changed until you unpin them.  The pin does not
117           apply to any prerequisites that are pulled in for this
118           distribution.  However, you may pin them separately with the pin
119           command, if you so desire.
120
121       --recurse
122       --no-recurse
123           Recursively pull any distributions required to satisfy
124           prerequisites for the targets.  The default value for this option
125           can be configured in the pinto.ini configuration file for the
126           repository (it is usually set to 1).  To disable recursion, use
127           "--no-recurse".
128
129       --skip-missing-prerequisite=PACKAGE
130       -k PACKAGE
131           !! THIS OPTION IS EXPERIMENTAL !!
132
133           Skip any prerequisite with name PACKAGE if a satisfactory version
134           cannot be found.  However, a warning will be given whenever this
135           occurrs.  This option only has effect when recursively fetching
136           prerequisites for the targets (See also the "--recurse" option).
137           This option can be repeated.
138
139       --skip-all-missing-prerequisites
140       -K  !! THIS OPTION IS EXPERIMENTAL !!
141
142           Skips all missing prerequisites if a satisfactory version cannot be
143           found.  However, a warning will be given whenever this occurrs.
144           This option will silently override the
145           "--skip-missing-prerequisite" option and only has effect when
146           recursively fetching prerequisites for the targets (See also the
147           "--recurse" option).
148
149       --stack=NAME
150       -s NAME
151           Puts all the packages onto the stack with the given NAME.  Defaults
152           to the name of whichever stack is currently marked as the default
153           stack.  Use the stacks command to see the stacks in the repository.
154
155       --use-default-message
156       -M  Use the default value for the revision history log message.  Pinto
157           will generate a semi-informative log message just based on the
158           command and its arguments.  If you set an explicit message with
159           "--message", the "--use-default-message" option will be silently
160           ignored.
161
162       --with-development-prerequisites
163       --wd
164           Also pull development prerequisites so you'll have everything you
165           need to work on those distributions, in the event that you need to
166           patch them in the future.  Be aware that most distributions do not
167           actually declare their development prerequisites.
168

AUTHOR

170       Jeffrey Ryan Thalhammer <jeff@stratopan.com>
171
173       This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
174
175       This is free software; you can redistribute it and/or modify it under
176       the same terms as the Perl 5 programming language system itself.
177
178
179
180perl v5.36.0                      2023-01-20       App::Pinto::Command::add(3)
Impressum