bundler 2.3.12 → 2.4.17

Sign up to get free protection for your applications and to get access to all the features.
Files changed (235) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +521 -1
  3. data/README.md +3 -6
  4. data/bundler.gemspec +8 -10
  5. data/exe/bundle +5 -16
  6. data/lib/bundler/build_metadata.rb +2 -2
  7. data/lib/bundler/cli/add.rb +1 -1
  8. data/lib/bundler/cli/binstubs.rb +5 -1
  9. data/lib/bundler/cli/check.rb +1 -1
  10. data/lib/bundler/cli/common.rb +3 -1
  11. data/lib/bundler/cli/console.rb +2 -2
  12. data/lib/bundler/cli/doctor.rb +4 -6
  13. data/lib/bundler/cli/gem.rb +62 -40
  14. data/lib/bundler/cli/init.rb +6 -2
  15. data/lib/bundler/cli/install.rb +7 -5
  16. data/lib/bundler/cli/lock.rb +8 -5
  17. data/lib/bundler/cli/open.rb +6 -4
  18. data/lib/bundler/cli/outdated.rb +13 -6
  19. data/lib/bundler/cli/platform.rb +1 -1
  20. data/lib/bundler/cli/viz.rb +1 -1
  21. data/lib/bundler/cli.rb +53 -7
  22. data/lib/bundler/compact_index_client/cache.rb +1 -1
  23. data/lib/bundler/compact_index_client/updater.rb +53 -39
  24. data/lib/bundler/constants.rb +1 -1
  25. data/lib/bundler/current_ruby.rb +17 -6
  26. data/lib/bundler/definition.rb +277 -139
  27. data/lib/bundler/dependency.rb +21 -84
  28. data/lib/bundler/digest.rb +1 -1
  29. data/lib/bundler/dsl.rb +13 -18
  30. data/lib/bundler/endpoint_specification.rb +2 -10
  31. data/lib/bundler/env.rb +1 -1
  32. data/lib/bundler/environment_preserver.rb +3 -2
  33. data/lib/bundler/errors.rb +15 -15
  34. data/lib/bundler/feature_flag.rb +0 -2
  35. data/lib/bundler/fetcher/base.rb +6 -8
  36. data/lib/bundler/fetcher/compact_index.rb +9 -11
  37. data/lib/bundler/fetcher/dependency.rb +2 -6
  38. data/lib/bundler/fetcher/downloader.rb +2 -5
  39. data/lib/bundler/fetcher.rb +14 -14
  40. data/lib/bundler/force_platform.rb +18 -0
  41. data/lib/bundler/friendly_errors.rb +21 -7
  42. data/lib/bundler/gem_helpers.rb +9 -2
  43. data/lib/bundler/gem_version_promoter.rb +53 -98
  44. data/lib/bundler/graph.rb +3 -3
  45. data/lib/bundler/index.rb +13 -51
  46. data/lib/bundler/injector.rb +9 -4
  47. data/lib/bundler/inline.rb +9 -21
  48. data/lib/bundler/installer/gem_installer.rb +14 -1
  49. data/lib/bundler/installer/parallel_installer.rb +3 -33
  50. data/lib/bundler/installer/standalone.rb +42 -11
  51. data/lib/bundler/installer.rb +19 -40
  52. data/lib/bundler/lazy_specification.rb +55 -54
  53. data/lib/bundler/lockfile_generator.rb +3 -3
  54. data/lib/bundler/lockfile_parser.rb +21 -16
  55. data/lib/bundler/man/bundle-add.1 +13 -5
  56. data/lib/bundler/man/bundle-add.1.ronn +10 -4
  57. data/lib/bundler/man/bundle-binstubs.1 +1 -1
  58. data/lib/bundler/man/bundle-cache.1 +9 -3
  59. data/lib/bundler/man/bundle-cache.1.ronn +9 -2
  60. data/lib/bundler/man/bundle-check.1 +1 -1
  61. data/lib/bundler/man/bundle-clean.1 +2 -2
  62. data/lib/bundler/man/bundle-clean.1.ronn +1 -1
  63. data/lib/bundler/man/bundle-config.1 +26 -10
  64. data/lib/bundler/man/bundle-config.1.ronn +17 -10
  65. data/lib/bundler/man/bundle-console.1 +53 -0
  66. data/lib/bundler/man/bundle-console.1.ronn +44 -0
  67. data/lib/bundler/man/bundle-doctor.1 +1 -1
  68. data/lib/bundler/man/bundle-exec.1 +6 -6
  69. data/lib/bundler/man/bundle-exec.1.ronn +6 -6
  70. data/lib/bundler/man/bundle-gem.1 +27 -37
  71. data/lib/bundler/man/bundle-gem.1.ronn +5 -5
  72. data/lib/bundler/man/bundle-help.1 +13 -0
  73. data/lib/bundler/man/bundle-help.1.ronn +12 -0
  74. data/lib/bundler/man/bundle-info.1 +1 -1
  75. data/lib/bundler/man/bundle-init.1 +5 -1
  76. data/lib/bundler/man/bundle-init.1.ronn +2 -0
  77. data/lib/bundler/man/bundle-inject.1 +5 -2
  78. data/lib/bundler/man/bundle-inject.1.ronn +3 -1
  79. data/lib/bundler/man/bundle-install.1 +5 -30
  80. data/lib/bundler/man/bundle-install.1.ronn +6 -29
  81. data/lib/bundler/man/bundle-list.1 +1 -1
  82. data/lib/bundler/man/bundle-lock.1 +1 -1
  83. data/lib/bundler/man/bundle-open.1 +22 -2
  84. data/lib/bundler/man/bundle-open.1.ronn +9 -1
  85. data/lib/bundler/man/bundle-outdated.1 +1 -1
  86. data/lib/bundler/man/bundle-platform.1 +16 -6
  87. data/lib/bundler/man/bundle-platform.1.ronn +14 -7
  88. data/lib/bundler/man/bundle-plugin.1 +81 -0
  89. data/lib/bundler/man/bundle-plugin.1.ronn +59 -0
  90. data/lib/bundler/man/bundle-pristine.1 +1 -1
  91. data/lib/bundler/man/bundle-remove.1 +1 -1
  92. data/lib/bundler/man/bundle-show.1 +1 -1
  93. data/lib/bundler/man/bundle-update.1 +1 -1
  94. data/lib/bundler/man/bundle-version.1 +35 -0
  95. data/lib/bundler/man/bundle-version.1.ronn +24 -0
  96. data/lib/bundler/man/bundle-viz.1 +4 -1
  97. data/lib/bundler/man/bundle-viz.1.ronn +2 -0
  98. data/lib/bundler/man/bundle.1 +15 -10
  99. data/lib/bundler/man/bundle.1.ronn +12 -7
  100. data/lib/bundler/man/gemfile.5 +93 -82
  101. data/lib/bundler/man/gemfile.5.ronn +99 -86
  102. data/lib/bundler/man/index.txt +4 -0
  103. data/lib/bundler/match_metadata.rb +13 -0
  104. data/lib/bundler/match_platform.rb +0 -1
  105. data/lib/bundler/match_remote_metadata.rb +29 -0
  106. data/lib/bundler/mirror.rb +5 -7
  107. data/lib/bundler/plugin/api/source.rb +3 -3
  108. data/lib/bundler/plugin/index.rb +4 -4
  109. data/lib/bundler/plugin/installer/git.rb +0 -4
  110. data/lib/bundler/plugin/installer/rubygems.rb +0 -8
  111. data/lib/bundler/plugin/installer.rb +5 -2
  112. data/lib/bundler/plugin.rb +3 -1
  113. data/lib/bundler/process_lock.rb +1 -1
  114. data/lib/bundler/remote_specification.rb +7 -12
  115. data/lib/bundler/resolver/base.rb +107 -0
  116. data/lib/bundler/resolver/candidate.rb +94 -0
  117. data/lib/bundler/resolver/incompatibility.rb +15 -0
  118. data/lib/bundler/resolver/package.rb +72 -0
  119. data/lib/bundler/resolver/root.rb +25 -0
  120. data/lib/bundler/resolver/spec_group.rb +42 -70
  121. data/lib/bundler/resolver.rb +333 -326
  122. data/lib/bundler/ruby_dsl.rb +1 -1
  123. data/lib/bundler/ruby_version.rb +6 -6
  124. data/lib/bundler/rubygems_ext.rb +107 -15
  125. data/lib/bundler/rubygems_gem_installer.rb +32 -20
  126. data/lib/bundler/rubygems_integration.rb +13 -35
  127. data/lib/bundler/runtime.rb +2 -7
  128. data/lib/bundler/safe_marshal.rb +31 -0
  129. data/lib/bundler/settings.rb +6 -12
  130. data/lib/bundler/setup.rb +4 -1
  131. data/lib/bundler/shared_helpers.rb +8 -8
  132. data/lib/bundler/source/git/git_proxy.rb +237 -74
  133. data/lib/bundler/source/git.rb +54 -38
  134. data/lib/bundler/source/metadata.rb +1 -2
  135. data/lib/bundler/source/path/installer.rb +1 -22
  136. data/lib/bundler/source/path.rb +7 -7
  137. data/lib/bundler/source/rubygems.rb +85 -128
  138. data/lib/bundler/source.rb +4 -5
  139. data/lib/bundler/source_list.rb +12 -2
  140. data/lib/bundler/spec_set.rb +62 -34
  141. data/lib/bundler/stub_specification.rb +5 -3
  142. data/lib/bundler/templates/Executable +1 -1
  143. data/lib/bundler/templates/Executable.bundler +5 -10
  144. data/lib/bundler/templates/Executable.standalone +2 -0
  145. data/lib/bundler/templates/newgem/Cargo.toml.tt +7 -0
  146. data/lib/bundler/templates/newgem/Gemfile.tt +3 -0
  147. data/lib/bundler/templates/newgem/README.md.tt +6 -4
  148. data/lib/bundler/templates/newgem/Rakefile.tt +12 -1
  149. data/lib/bundler/templates/newgem/bin/console.tt +0 -4
  150. data/lib/bundler/templates/newgem/circleci/config.yml.tt +12 -0
  151. data/lib/bundler/templates/newgem/ext/newgem/Cargo.toml.tt +15 -0
  152. data/lib/bundler/templates/newgem/ext/newgem/extconf-c.rb.tt +10 -0
  153. data/lib/bundler/templates/newgem/ext/newgem/extconf-rust.rb.tt +6 -0
  154. data/lib/bundler/templates/newgem/ext/newgem/newgem.c.tt +1 -1
  155. data/lib/bundler/templates/newgem/ext/newgem/src/lib.rs.tt +12 -0
  156. data/lib/bundler/templates/newgem/github/workflows/main.yml.tt +10 -0
  157. data/lib/bundler/templates/newgem/gitignore.tt +3 -0
  158. data/lib/bundler/templates/newgem/gitlab-ci.yml.tt +13 -4
  159. data/lib/bundler/templates/newgem/newgem.gemspec.tt +9 -2
  160. data/lib/bundler/ui/shell.rb +35 -12
  161. data/lib/bundler/ui/silent.rb +21 -5
  162. data/lib/bundler/uri_normalizer.rb +23 -0
  163. data/lib/bundler/vendor/connection_pool/lib/connection_pool/timed_stack.rb +3 -3
  164. data/lib/bundler/vendor/connection_pool/lib/connection_pool/wrapper.rb +0 -1
  165. data/lib/bundler/vendor/connection_pool/lib/connection_pool.rb +3 -1
  166. data/lib/bundler/vendor/fileutils/lib/fileutils.rb +1350 -408
  167. data/lib/bundler/vendor/net-http-persistent/README.rdoc +1 -1
  168. data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +1 -1
  169. data/lib/bundler/vendor/pub_grub/LICENSE.txt +21 -0
  170. data/lib/bundler/vendor/pub_grub/lib/pub_grub/assignment.rb +20 -0
  171. data/lib/bundler/vendor/pub_grub/lib/pub_grub/basic_package_source.rb +189 -0
  172. data/lib/bundler/vendor/pub_grub/lib/pub_grub/failure_writer.rb +182 -0
  173. data/lib/bundler/vendor/pub_grub/lib/pub_grub/incompatibility.rb +150 -0
  174. data/lib/bundler/vendor/pub_grub/lib/pub_grub/package.rb +43 -0
  175. data/lib/bundler/vendor/pub_grub/lib/pub_grub/partial_solution.rb +121 -0
  176. data/lib/bundler/vendor/pub_grub/lib/pub_grub/rubygems.rb +45 -0
  177. data/lib/bundler/vendor/pub_grub/lib/pub_grub/solve_failure.rb +19 -0
  178. data/lib/bundler/vendor/pub_grub/lib/pub_grub/static_package_source.rb +60 -0
  179. data/lib/bundler/vendor/pub_grub/lib/pub_grub/term.rb +105 -0
  180. data/lib/bundler/vendor/pub_grub/lib/pub_grub/version.rb +3 -0
  181. data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb +129 -0
  182. data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_range.rb +411 -0
  183. data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb +248 -0
  184. data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_union.rb +178 -0
  185. data/lib/bundler/vendor/pub_grub/lib/pub_grub.rb +31 -0
  186. data/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +1 -1
  187. data/lib/bundler/vendor/uri/lib/uri/common.rb +64 -16
  188. data/lib/bundler/vendor/uri/lib/uri/file.rb +7 -1
  189. data/lib/bundler/vendor/uri/lib/uri/ftp.rb +2 -1
  190. data/lib/bundler/vendor/uri/lib/uri/generic.rb +27 -7
  191. data/lib/bundler/vendor/uri/lib/uri/http.rb +40 -2
  192. data/lib/bundler/vendor/uri/lib/uri/https.rb +2 -1
  193. data/lib/bundler/vendor/uri/lib/uri/ldap.rb +1 -1
  194. data/lib/bundler/vendor/uri/lib/uri/ldaps.rb +2 -1
  195. data/lib/bundler/vendor/uri/lib/uri/mailto.rb +2 -2
  196. data/lib/bundler/vendor/uri/lib/uri/rfc2396_parser.rb +13 -7
  197. data/lib/bundler/vendor/uri/lib/uri/rfc3986_parser.rb +10 -5
  198. data/lib/bundler/vendor/uri/lib/uri/version.rb +1 -1
  199. data/lib/bundler/vendor/uri/lib/uri/ws.rb +1 -2
  200. data/lib/bundler/vendor/uri/lib/uri/wss.rb +2 -1
  201. data/lib/bundler/vendor/uri/lib/uri.rb +3 -2
  202. data/lib/bundler/vendored_persistent.rb +1 -33
  203. data/lib/bundler/{vendored_tmpdir.rb → vendored_pub_grub.rb} +1 -1
  204. data/lib/bundler/version.rb +5 -1
  205. data/lib/bundler/worker.rb +5 -7
  206. data/lib/bundler.rb +36 -77
  207. metadata +47 -35
  208. data/lib/bundler/dep_proxy.rb +0 -55
  209. data/lib/bundler/templates/gems.rb +0 -5
  210. data/lib/bundler/templates/newgem/ext/newgem/extconf.rb.tt +0 -5
  211. data/lib/bundler/templates/newgem/travis.yml.tt +0 -6
  212. data/lib/bundler/vendor/molinillo/LICENSE +0 -9
  213. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/resolution_state.rb +0 -57
  214. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +0 -88
  215. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/action.rb +0 -36
  216. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +0 -66
  217. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +0 -62
  218. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +0 -63
  219. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +0 -61
  220. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/log.rb +0 -126
  221. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/set_payload.rb +0 -46
  222. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +0 -36
  223. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +0 -164
  224. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +0 -255
  225. data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +0 -149
  226. data/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +0 -6
  227. data/lib/bundler/vendor/molinillo/lib/molinillo/modules/specification_provider.rb +0 -112
  228. data/lib/bundler/vendor/molinillo/lib/molinillo/modules/ui.rb +0 -67
  229. data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +0 -839
  230. data/lib/bundler/vendor/molinillo/lib/molinillo/resolver.rb +0 -46
  231. data/lib/bundler/vendor/molinillo/lib/molinillo/state.rb +0 -58
  232. data/lib/bundler/vendor/molinillo/lib/molinillo.rb +0 -11
  233. data/lib/bundler/vendor/tmpdir/lib/tmpdir.rb +0 -154
  234. data/lib/bundler/vendored_molinillo.rb +0 -4
  235. data/lib/bundler/version_ranges.rb +0 -122
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-INSTALL" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-INSTALL" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-install\fR \- Install the dependencies specified in your Gemfile
@@ -70,6 +70,10 @@ The maximum number of parallel download and install jobs\. The default is the nu
70
70
  Do not attempt to connect to \fBrubygems\.org\fR\. Instead, Bundler will use the gems already present in Rubygems\' cache or in \fBvendor/cache\fR\. Note that if an appropriate platform\-specific gem exists on \fBrubygems\.org\fR it will not be found\.
71
71
  .
72
72
  .TP
73
+ \fB\-\-prefer\-local\fR
74
+ Force using locally installed gems, or gems already present in Rubygems\' cache or in \fBvendor/cache\fR, when resolving, even if newer versions are available remotely\. Only attempt to connect to \fBrubygems\.org\fR for gems that are not present locally\.
75
+ .
76
+ .TP
73
77
  \fB\-\-no\-cache\fR
74
78
  Do not update the cache in \fBvendor/cache\fR with the newly bundled gems\. This does not remove any gems in the cache but keeps the newly bundled gems from being cached during the install\.
75
79
  .
@@ -166,35 +170,6 @@ As a result, \fBbundle install \-\-deployment\fR installs gems to the \fBvendor/
166
170
  .
167
171
  .IP "" 0
168
172
  .
169
- .SH "SUDO USAGE"
170
- By default, Bundler installs gems to the same location as \fBgem install\fR\.
171
- .
172
- .P
173
- In some cases, that location may not be writable by your Unix user\. In that case, Bundler will stage everything in a temporary directory, then ask you for your \fBsudo\fR password in order to copy the gems into their system location\.
174
- .
175
- .P
176
- From your perspective, this is identical to installing the gems directly into the system\.
177
- .
178
- .P
179
- You should never use \fBsudo bundle install\fR\. This is because several other steps in \fBbundle install\fR must be performed as the current user:
180
- .
181
- .IP "\(bu" 4
182
- Updating your \fBGemfile\.lock\fR
183
- .
184
- .IP "\(bu" 4
185
- Updating your \fBvendor/cache\fR, if necessary
186
- .
187
- .IP "\(bu" 4
188
- Checking out private git repositories using your user\'s SSH keys
189
- .
190
- .IP "" 0
191
- .
192
- .P
193
- Of these three, the first two could theoretically be performed by \fBchown\fRing the resulting files to \fB$SUDO_USER\fR\. The third, however, can only be performed by invoking the \fBgit\fR command as the current user\. Therefore, git gems are downloaded and installed into \fB~/\.bundle\fR rather than $GEM_HOME or $BUNDLE_PATH\.
194
- .
195
- .P
196
- As a result, you should run \fBbundle install\fR as the current user, and Bundler will ask for your password if it is needed to put the gems into their final location\.
197
- .
198
173
  .SH "INSTALLING GROUPS"
199
174
  By default, \fBbundle install\fR will install all gems in all groups in your Gemfile(5), except those declared for a different platform\.
200
175
  .
@@ -109,6 +109,12 @@ automatically and that requires `bundler` to silently remember them. Since
109
109
  appropriate platform-specific gem exists on `rubygems.org` it will not be
110
110
  found.
111
111
 
112
+ * `--prefer-local`:
113
+ Force using locally installed gems, or gems already present in Rubygems' cache
114
+ or in `vendor/cache`, when resolving, even if newer versions are available
115
+ remotely. Only attempt to connect to `rubygems.org` for gems that are not
116
+ present locally.
117
+
112
118
  * `--no-cache`:
113
119
  Do not update the cache in `vendor/cache` with the newly bundled gems. This
114
120
  does not remove any gems in the cache but keeps the newly bundled gems from
@@ -218,35 +224,6 @@ will cause an error when the Gemfile(5) is modified.
218
224
  the `vendor/bundle` directory in the application. This may be
219
225
  overridden using the `--path` option.
220
226
 
221
- ## SUDO USAGE
222
-
223
- By default, Bundler installs gems to the same location as `gem install`.
224
-
225
- In some cases, that location may not be writable by your Unix user. In
226
- that case, Bundler will stage everything in a temporary directory,
227
- then ask you for your `sudo` password in order to copy the gems into
228
- their system location.
229
-
230
- From your perspective, this is identical to installing the gems
231
- directly into the system.
232
-
233
- You should never use `sudo bundle install`. This is because several
234
- other steps in `bundle install` must be performed as the current user:
235
-
236
- * Updating your `Gemfile.lock`
237
- * Updating your `vendor/cache`, if necessary
238
- * Checking out private git repositories using your user's SSH keys
239
-
240
- Of these three, the first two could theoretically be performed by
241
- `chown`ing the resulting files to `$SUDO_USER`. The third, however,
242
- can only be performed by invoking the `git` command as
243
- the current user. Therefore, git gems are downloaded and installed
244
- into `~/.bundle` rather than $GEM_HOME or $BUNDLE_PATH.
245
-
246
- As a result, you should run `bundle install` as the current user,
247
- and Bundler will ask for your password if it is needed to put the
248
- gems into their final location.
249
-
250
227
  ## INSTALLING GROUPS
251
228
 
252
229
  By default, `bundle install` will install all gems in all groups
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-LIST" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-LIST" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-list\fR \- List all the gems in the bundle
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-LOCK" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-LOCK" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-lock\fR \- Creates / Updates a lockfile without installing
@@ -1,13 +1,13 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-OPEN" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-OPEN" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-open\fR \- Opens the source directory for a gem in your bundle
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- \fBbundle open\fR [GEM]
10
+ \fBbundle open\fR [GEM] [\-\-path=PATH]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  Opens the source directory of the provided GEM in your editor\.
@@ -30,3 +30,23 @@ bundle open \'rack\'
30
30
  .
31
31
  .P
32
32
  Will open the source directory for the \'rack\' gem in your bundle\.
33
+ .
34
+ .IP "" 4
35
+ .
36
+ .nf
37
+
38
+ bundle open \'rack\' \-\-path \'README\.md\'
39
+ .
40
+ .fi
41
+ .
42
+ .IP "" 0
43
+ .
44
+ .P
45
+ Will open the README\.md file of the \'rack\' gem source in your bundle\.
46
+ .
47
+ .SH "OPTIONS"
48
+ .
49
+ .TP
50
+ \fB\-\-path\fR
51
+ Specify GEM source relative path to open\.
52
+
@@ -3,7 +3,7 @@ bundle-open(1) -- Opens the source directory for a gem in your bundle
3
3
 
4
4
  ## SYNOPSIS
5
5
 
6
- `bundle open` [GEM]
6
+ `bundle open` [GEM] [--path=PATH]
7
7
 
8
8
  ## DESCRIPTION
9
9
 
@@ -17,3 +17,11 @@ Example:
17
17
  bundle open 'rack'
18
18
 
19
19
  Will open the source directory for the 'rack' gem in your bundle.
20
+
21
+ bundle open 'rack' --path 'README.md'
22
+
23
+ Will open the README.md file of the 'rack' gem source in your bundle.
24
+
25
+ ## OPTIONS
26
+ * `--path`:
27
+ Specify GEM source relative path to open.
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-OUTDATED" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-OUTDATED" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-outdated\fR \- List installed gems with newer versions available
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-PLATFORM" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-PLATFORM" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-platform\fR \- Displays platform compatibility information
@@ -10,7 +10,7 @@
10
10
  \fBbundle platform\fR [\-\-ruby]
11
11
  .
12
12
  .SH "DESCRIPTION"
13
- \fBplatform\fR will display information from your Gemfile, Gemfile\.lock, and Ruby VM about your platform\.
13
+ \fBplatform\fR displays information from your Gemfile, Gemfile\.lock, and Ruby VM about your platform\.
14
14
  .
15
15
  .P
16
16
  For instance, using this Gemfile(5):
@@ -21,7 +21,7 @@ For instance, using this Gemfile(5):
21
21
 
22
22
  source "https://rubygems\.org"
23
23
 
24
- ruby "1\.9\.3"
24
+ ruby "3\.1\.2"
25
25
 
26
26
  gem "rack"
27
27
  .
@@ -30,7 +30,7 @@ gem "rack"
30
30
  .IP "" 0
31
31
  .
32
32
  .P
33
- If you run \fBbundle platform\fR on Ruby 1\.9\.3, it will display the following output:
33
+ If you run \fBbundle platform\fR on Ruby 3\.1\.2, it displays the following output:
34
34
  .
35
35
  .IP "" 4
36
36
  .
@@ -39,10 +39,13 @@ If you run \fBbundle platform\fR on Ruby 1\.9\.3, it will display the following
39
39
  Your platform is: x86_64\-linux
40
40
 
41
41
  Your app has gems that work on these platforms:
42
+ * arm64\-darwin\-21
42
43
  * ruby
44
+ * x64\-mingw\-ucrt
45
+ * x86_64\-linux
43
46
 
44
47
  Your Gemfile specifies a Ruby version requirement:
45
- * ruby 1\.9\.3
48
+ * ruby 3\.1\.2
46
49
 
47
50
  Your current platform satisfies the Ruby version requirement\.
48
51
  .
@@ -51,11 +54,18 @@ Your current platform satisfies the Ruby version requirement\.
51
54
  .IP "" 0
52
55
  .
53
56
  .P
54
- \fBplatform\fR will list all the platforms in your \fBGemfile\.lock\fR as well as the \fBruby\fR directive if applicable from your Gemfile(5)\. It will also let you know if the \fBruby\fR directive requirement has been met\. If \fBruby\fR directive doesn\'t match the running Ruby VM, it will tell you what part does not\.
57
+ \fBplatform\fR lists all the platforms in your \fBGemfile\.lock\fR as well as the \fBruby\fR directive if applicable from your Gemfile(5)\. It also lets you know if the \fBruby\fR directive requirement has been met\. If \fBruby\fR directive doesn\'t match the running Ruby VM, it tells you what part does not\.
55
58
  .
56
59
  .SH "OPTIONS"
57
60
  .
58
61
  .TP
59
62
  \fB\-\-ruby\fR
60
63
  It will display the ruby directive information, so you don\'t have to parse it from the Gemfile(5)\.
64
+ .
65
+ .SH "SEE ALSO"
66
+ .
67
+ .IP "\(bu" 4
68
+ bundle\-lock(1) \fIbundle\-lock\.1\.html\fR
69
+ .
70
+ .IP "" 0
61
71
 
@@ -7,36 +7,43 @@ bundle-platform(1) -- Displays platform compatibility information
7
7
 
8
8
  ## DESCRIPTION
9
9
 
10
- `platform` will display information from your Gemfile, Gemfile.lock, and Ruby
10
+ `platform` displays information from your Gemfile, Gemfile.lock, and Ruby
11
11
  VM about your platform.
12
12
 
13
13
  For instance, using this Gemfile(5):
14
14
 
15
15
  source "https://rubygems.org"
16
16
 
17
- ruby "1.9.3"
17
+ ruby "3.1.2"
18
18
 
19
19
  gem "rack"
20
20
 
21
- If you run `bundle platform` on Ruby 1.9.3, it will display the following output:
21
+ If you run `bundle platform` on Ruby 3.1.2, it displays the following output:
22
22
 
23
23
  Your platform is: x86_64-linux
24
24
 
25
25
  Your app has gems that work on these platforms:
26
+ * arm64-darwin-21
26
27
  * ruby
28
+ * x64-mingw-ucrt
29
+ * x86_64-linux
27
30
 
28
31
  Your Gemfile specifies a Ruby version requirement:
29
- * ruby 1.9.3
32
+ * ruby 3.1.2
30
33
 
31
34
  Your current platform satisfies the Ruby version requirement.
32
35
 
33
- `platform` will list all the platforms in your `Gemfile.lock` as well as the
34
- `ruby` directive if applicable from your Gemfile(5). It will also let you know
36
+ `platform` lists all the platforms in your `Gemfile.lock` as well as the
37
+ `ruby` directive if applicable from your Gemfile(5). It also lets you know
35
38
  if the `ruby` directive requirement has been met. If `ruby` directive doesn't
36
- match the running Ruby VM, it will tell you what part does not.
39
+ match the running Ruby VM, it tells you what part does not.
37
40
 
38
41
  ## OPTIONS
39
42
 
40
43
  * `--ruby`:
41
44
  It will display the ruby directive information, so you don't have to
42
45
  parse it from the Gemfile(5).
46
+
47
+ ## SEE ALSO
48
+
49
+ * [bundle-lock(1)](bundle-lock.1.html)
@@ -0,0 +1,81 @@
1
+ .\" generated with Ronn/v0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
+ .
4
+ .TH "BUNDLE\-PLUGIN" "1" "July 2023" "" ""
5
+ .
6
+ .SH "NAME"
7
+ \fBbundle\-plugin\fR \- Manage Bundler plugins
8
+ .
9
+ .SH "SYNOPSIS"
10
+ \fBbundle plugin\fR install PLUGINS [\-\-source=\fISOURCE\fR] [\-\-version=\fIversion\fR] [\-\-git|\-\-local_git=\fIgit\-url\fR] [\-\-branch=\fIbranch\fR|\-\-ref=\fIrev\fR]
11
+ .
12
+ .br
13
+ \fBbundle plugin\fR uninstall PLUGINS
14
+ .
15
+ .br
16
+ \fBbundle plugin\fR list
17
+ .
18
+ .br
19
+ \fBbundle plugin\fR help [COMMAND]
20
+ .
21
+ .SH "DESCRIPTION"
22
+ You can install, uninstall, and list plugin(s) with this command to extend functionalities of Bundler\.
23
+ .
24
+ .SH "SUB\-COMMANDS"
25
+ .
26
+ .SS "install"
27
+ Install the given plugin(s)\.
28
+ .
29
+ .IP "\(bu" 4
30
+ \fBbundle plugin install bundler\-graph\fR: Install bundler\-graph gem from RubyGems\.org\. The global source, specified in source in Gemfile is ignored\.
31
+ .
32
+ .IP "\(bu" 4
33
+ \fBbundle plugin install bundler\-graph \-\-source https://example\.com\fR: Install bundler\-graph gem from example\.com\. The global source, specified in source in Gemfile is not considered\.
34
+ .
35
+ .IP "\(bu" 4
36
+ \fBbundle plugin install bundler\-graph \-\-version 0\.2\.1\fR: You can specify the version of the gem via \fB\-\-version\fR\.
37
+ .
38
+ .IP "\(bu" 4
39
+ \fBbundle plugin install bundler\-graph \-\-git https://github\.com/rubygems/bundler\-graph\fR: Install bundler\-graph gem from Git repository\. \fB\-\-git\fR can be replaced with \fB\-\-local\-git\fR\. You cannot use both \fB\-\-git\fR and \fB\-\-local\-git\fR\. You can use standard Git URLs like:
40
+ .
41
+ .IP "\(bu" 4
42
+ \fBssh://[user@]host\.xz[:port]/path/to/repo\.git\fR
43
+ .
44
+ .IP "\(bu" 4
45
+ \fBhttp[s]://host\.xz[:port]/path/to/repo\.git\fR
46
+ .
47
+ .IP "\(bu" 4
48
+ \fB/path/to/repo\fR
49
+ .
50
+ .IP "\(bu" 4
51
+ \fBfile:///path/to/repo\fR
52
+ .
53
+ .IP "" 0
54
+ .
55
+ .IP
56
+ When you specify \fB\-\-git\fR/\fB\-\-local\-git\fR, you can use \fB\-\-branch\fR or \fB\-\-ref\fR to specify any branch, tag, or commit hash (revision) to use\. When you specify both, only the latter is used\.
57
+ .
58
+ .IP "" 0
59
+ .
60
+ .SS "uninstall"
61
+ Uninstall the plugin(s) specified in PLUGINS\.
62
+ .
63
+ .SS "list"
64
+ List the installed plugins and available commands\.
65
+ .
66
+ .P
67
+ No options\.
68
+ .
69
+ .SS "help"
70
+ Describe subcommands or one specific subcommand\.
71
+ .
72
+ .P
73
+ No options\.
74
+ .
75
+ .SH "SEE ALSO"
76
+ .
77
+ .IP "\(bu" 4
78
+ How to write a Bundler plugin \fIhttps://bundler\.io/guides/bundler_plugins\.html\fR
79
+ .
80
+ .IP "" 0
81
+
@@ -0,0 +1,59 @@
1
+ bundle-plugin(1) -- Manage Bundler plugins
2
+ ==========================================
3
+
4
+ ## SYNOPSIS
5
+
6
+ `bundle plugin` install PLUGINS [--source=<SOURCE>] [--version=<version>]
7
+ [--git|--local_git=<git-url>] [--branch=<branch>|--ref=<rev>]<br>
8
+ `bundle plugin` uninstall PLUGINS<br>
9
+ `bundle plugin` list<br>
10
+ `bundle plugin` help [COMMAND]
11
+
12
+ ## DESCRIPTION
13
+
14
+ You can install, uninstall, and list plugin(s) with this command to extend functionalities of Bundler.
15
+
16
+ ## SUB-COMMANDS
17
+
18
+ ### install
19
+
20
+ Install the given plugin(s).
21
+
22
+ * `bundle plugin install bundler-graph`:
23
+ Install bundler-graph gem from RubyGems.org. The global source, specified in source in Gemfile is ignored.
24
+
25
+ * `bundle plugin install bundler-graph --source https://example.com`:
26
+ Install bundler-graph gem from example.com. The global source, specified in source in Gemfile is not considered.
27
+
28
+ * `bundle plugin install bundler-graph --version 0.2.1`:
29
+ You can specify the version of the gem via `--version`.
30
+
31
+ * `bundle plugin install bundler-graph --git https://github.com/rubygems/bundler-graph`:
32
+ Install bundler-graph gem from Git repository. `--git` can be replaced with `--local-git`. You cannot use both `--git` and `--local-git`. You can use standard Git URLs like:
33
+
34
+ * `ssh://[user@]host.xz[:port]/path/to/repo.git`
35
+ * `http[s]://host.xz[:port]/path/to/repo.git`
36
+ * `/path/to/repo`
37
+ * `file:///path/to/repo`
38
+
39
+ When you specify `--git`/`--local-git`, you can use `--branch` or `--ref` to specify any branch, tag, or commit hash (revision) to use. When you specify both, only the latter is used.
40
+
41
+ ### uninstall
42
+
43
+ Uninstall the plugin(s) specified in PLUGINS.
44
+
45
+ ### list
46
+
47
+ List the installed plugins and available commands.
48
+
49
+ No options.
50
+
51
+ ### help
52
+
53
+ Describe subcommands or one specific subcommand.
54
+
55
+ No options.
56
+
57
+ ## SEE ALSO
58
+
59
+ * [How to write a Bundler plugin](https://bundler.io/guides/bundler_plugins.html)
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-PRISTINE" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-PRISTINE" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-pristine\fR \- Restores installed gems to their pristine condition
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-REMOVE" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-REMOVE" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-remove\fR \- Removes gems from the Gemfile
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-SHOW" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-SHOW" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-show\fR \- Shows all the gems in your bundle, or the path to a gem
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-UPDATE" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-UPDATE" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-update\fR \- Update your gems to the latest available versions
@@ -0,0 +1,35 @@
1
+ .\" generated with Ronn/v0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
+ .
4
+ .TH "BUNDLE\-VERSION" "1" "July 2023" "" ""
5
+ .
6
+ .SH "NAME"
7
+ \fBbundle\-version\fR \- Prints Bundler version information
8
+ .
9
+ .SH "SYNOPSIS"
10
+ \fBbundle version\fR
11
+ .
12
+ .SH "DESCRIPTION"
13
+ Prints Bundler version information\.
14
+ .
15
+ .SH "OPTIONS"
16
+ No options\.
17
+ .
18
+ .SH "EXAMPLE"
19
+ Print the version of Bundler with build date and commit hash of the in the Git source\.
20
+ .
21
+ .IP "" 4
22
+ .
23
+ .nf
24
+
25
+ bundle version
26
+ .
27
+ .fi
28
+ .
29
+ .IP "" 0
30
+ .
31
+ .P
32
+ shows \fBBundler version 2\.3\.21 (2022\-08\-24 commit d54be5fdd8)\fR for example\.
33
+ .
34
+ .P
35
+ cf\. \fBbundle \-\-version\fR shows \fBBundler version 2\.3\.21\fR\.
@@ -0,0 +1,24 @@
1
+ bundle-version(1) -- Prints Bundler version information
2
+ =======================================================
3
+
4
+ ## SYNOPSIS
5
+
6
+ `bundle version`
7
+
8
+ ## DESCRIPTION
9
+
10
+ Prints Bundler version information.
11
+
12
+ ## OPTIONS
13
+
14
+ No options.
15
+
16
+ ## EXAMPLE
17
+
18
+ Print the version of Bundler with build date and commit hash of the in the Git source.
19
+
20
+ bundle version
21
+
22
+ shows `Bundler version 2.3.21 (2022-08-24 commit d54be5fdd8)` for example.
23
+
24
+ cf. `bundle --version` shows `Bundler version 2.3.21`.
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-VIZ" "1" "March 2022" "" ""
4
+ .TH "BUNDLE\-VIZ" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-viz\fR \- Generates a visual dependency graph for your Gemfile
@@ -15,6 +15,9 @@
15
15
  .P
16
16
  The associated gems must also be installed via \fBbundle install(1)\fR \fIbundle\-install\.1\.html\fR\.
17
17
  .
18
+ .P
19
+ \fBviz\fR command was deprecated in Bundler 2\.2\. Use bundler\-graph plugin \fIhttps://github\.com/rubygems/bundler\-graph\fR instead\.
20
+ .
18
21
  .SH "OPTIONS"
19
22
  .
20
23
  .TP
@@ -16,6 +16,8 @@ bundle-viz(1) -- Generates a visual dependency graph for your Gemfile
16
16
 
17
17
  The associated gems must also be installed via [`bundle install(1)`](bundle-install.1.html).
18
18
 
19
+ `viz` command was deprecated in Bundler 2.2. Use [bundler-graph plugin](https://github.com/rubygems/bundler-graph) instead.
20
+
19
21
  ## OPTIONS
20
22
 
21
23
  * `--file`, `-f`:
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE" "1" "March 2022" "" ""
4
+ .TH "BUNDLE" "1" "July 2023" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\fR \- Ruby Dependency Management
@@ -43,8 +43,8 @@ Install the gems specified by the \fBGemfile\fR or \fBGemfile\.lock\fR
43
43
  Update dependencies to their latest versions
44
44
  .
45
45
  .TP
46
- \fBbundle package(1)\fR \fIbundle\-package\.1\.html\fR
47
- Package the \.gem files required by your application into the \fBvendor/cache\fR directory
46
+ \fBbundle cache(1)\fR \fIbundle\-cache\.1\.html\fR
47
+ Package the \.gem files required by your application into the \fBvendor/cache\fR directory (aliases: \fBbundle package\fR, \fBbundle pack\fR)
48
48
  .
49
49
  .TP
50
50
  \fBbundle exec(1)\fR \fIbundle\-exec\.1\.html\fR
@@ -55,7 +55,7 @@ Execute a script in the current bundle
55
55
  Specify and read configuration options for Bundler
56
56
  .
57
57
  .TP
58
- \fBbundle help(1)\fR
58
+ \fBbundle help(1)\fR \fIbundle\-help\.1\.html\fR
59
59
  Display detailed help for each subcommand
60
60
  .
61
61
  .SH "UTILITIES"
@@ -81,7 +81,7 @@ Show the source location of a particular gem in the bundle
81
81
  Show all of the outdated gems in the current bundle
82
82
  .
83
83
  .TP
84
- \fBbundle console(1)\fR
84
+ \fBbundle console(1)\fR (deprecated)
85
85
  Start an IRB session in the current bundle
86
86
  .
87
87
  .TP
@@ -93,7 +93,7 @@ Open an installed gem in the editor
93
93
  Generate a lockfile for your dependencies
94
94
  .
95
95
  .TP
96
- \fBbundle viz(1)\fR \fIbundle\-viz\.1\.html\fR
96
+ \fBbundle viz(1)\fR \fIbundle\-viz\.1\.html\fR (deprecated)
97
97
  Generate a visual representation of your dependencies
98
98
  .
99
99
  .TP
@@ -120,6 +120,14 @@ Display warnings about common problems
120
120
  \fBbundle remove(1)\fR \fIbundle\-remove\.1\.html\fR
121
121
  Removes gems from the Gemfile
122
122
  .
123
+ .TP
124
+ \fBbundle plugin(1)\fR \fIbundle\-plugin\.1\.html\fR
125
+ Manage Bundler plugins
126
+ .
127
+ .TP
128
+ \fBbundle version(1)\fR \fIbundle\-version\.1\.html\fR
129
+ Prints Bundler version information
130
+ .
123
131
  .SH "PLUGINS"
124
132
  When running a command that isn\'t listed in PRIMARY COMMANDS or UTILITIES, Bundler will try to find an executable on your path named \fBbundler\-<command>\fR and execute it, passing down any extra arguments to it\.
125
133
  .
@@ -127,10 +135,7 @@ When running a command that isn\'t listed in PRIMARY COMMANDS or UTILITIES, Bund
127
135
  These commands are obsolete and should no longer be used:
128
136
  .
129
137
  .IP "\(bu" 4
130
- \fBbundle cache(1)\fR
131
- .
132
- .IP "\(bu" 4
133
- \fBbundle show(1)\fR
138
+ \fBbundle inject(1)\fR
134
139
  .
135
140
  .IP "" 0
136
141