1App::Pinto::Command::adUds(e3r)Contributed Perl DocumentAaptpi:o:nPinto::Command::add(3)
2
6 App::Pinto::Command::add - add local archives to the repository
7
9 version 0.14
10
12 pinto --root=REPOSITORY_ROOT add [OPTIONS] ARCHIVE_FILE ...
13
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 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
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 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
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 --cascade
42 !! THIS OPTION IS EXPERIMENTAL !!
43 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 --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 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 --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 --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 --no-fail
79 !! THIS OPTION IS EXPERIMENTAL !!
80 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 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 --no-index=PACKAGE
94 -x PACKAGE
95 --no-index=/PATTERN
96 -x /PATTERN
97 !! THIS OPTION IS EXPERIMENTAL !!
98 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 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 --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 --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 --skip-missing-prerequisite=PACKAGE
130 -k PACKAGE
131 !! THIS OPTION IS EXPERIMENTAL !!
132 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 --skip-all-missing-prerequisites
140 -K !! THIS OPTION IS EXPERIMENTAL !!
141 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 --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 --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 --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
170 Jeffrey Ryan Thalhammer <jeff@stratopan.com>
171
173 This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
174 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.
177perl v5.36.0 2023-01-20 App::Pinto::Command::add(3)