bundler 2.3.12 → 2.4.6
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +367 -1
- data/README.md +2 -2
- data/bundler.gemspec +8 -10
- data/exe/bundle +1 -4
- data/lib/bundler/build_metadata.rb +2 -2
- data/lib/bundler/cli/add.rb +1 -1
- data/lib/bundler/cli/binstubs.rb +5 -1
- data/lib/bundler/cli/check.rb +1 -1
- data/lib/bundler/cli/common.rb +3 -1
- data/lib/bundler/cli/console.rb +2 -2
- data/lib/bundler/cli/doctor.rb +4 -6
- data/lib/bundler/cli/gem.rb +62 -40
- data/lib/bundler/cli/init.rb +5 -1
- data/lib/bundler/cli/install.rb +7 -5
- data/lib/bundler/cli/lock.rb +8 -5
- data/lib/bundler/cli/open.rb +6 -4
- data/lib/bundler/cli/outdated.rb +13 -6
- data/lib/bundler/cli/platform.rb +1 -1
- data/lib/bundler/cli/viz.rb +1 -1
- data/lib/bundler/cli.rb +52 -7
- data/lib/bundler/compact_index_client/cache.rb +1 -1
- data/lib/bundler/compact_index_client/updater.rb +53 -39
- data/lib/bundler/constants.rb +1 -1
- data/lib/bundler/current_ruby.rb +15 -6
- data/lib/bundler/definition.rb +203 -110
- data/lib/bundler/dependency.rb +21 -84
- data/lib/bundler/digest.rb +1 -1
- data/lib/bundler/dsl.rb +13 -18
- data/lib/bundler/endpoint_specification.rb +6 -10
- data/lib/bundler/env.rb +1 -1
- data/lib/bundler/environment_preserver.rb +1 -0
- data/lib/bundler/errors.rb +15 -15
- data/lib/bundler/feature_flag.rb +0 -1
- data/lib/bundler/fetcher/base.rb +6 -8
- data/lib/bundler/fetcher/compact_index.rb +9 -11
- data/lib/bundler/fetcher/dependency.rb +1 -1
- data/lib/bundler/fetcher/downloader.rb +2 -5
- data/lib/bundler/fetcher.rb +12 -12
- data/lib/bundler/force_platform.rb +18 -0
- data/lib/bundler/friendly_errors.rb +21 -7
- data/lib/bundler/gem_helpers.rb +9 -2
- data/lib/bundler/gem_version_promoter.rb +53 -98
- data/lib/bundler/graph.rb +3 -3
- data/lib/bundler/index.rb +11 -49
- data/lib/bundler/injector.rb +8 -3
- data/lib/bundler/inline.rb +9 -21
- data/lib/bundler/installer/gem_installer.rb +14 -1
- data/lib/bundler/installer/parallel_installer.rb +0 -31
- data/lib/bundler/installer/standalone.rb +41 -10
- data/lib/bundler/installer.rb +18 -39
- data/lib/bundler/lazy_specification.rb +53 -48
- data/lib/bundler/lockfile_generator.rb +1 -1
- data/lib/bundler/lockfile_parser.rb +9 -5
- data/lib/bundler/man/bundle-add.1 +13 -5
- data/lib/bundler/man/bundle-add.1.ronn +10 -4
- data/lib/bundler/man/bundle-binstubs.1 +1 -1
- data/lib/bundler/man/bundle-cache.1 +7 -1
- data/lib/bundler/man/bundle-cache.1.ronn +7 -0
- data/lib/bundler/man/bundle-check.1 +1 -1
- data/lib/bundler/man/bundle-clean.1 +2 -2
- data/lib/bundler/man/bundle-clean.1.ronn +1 -1
- data/lib/bundler/man/bundle-config.1 +26 -7
- data/lib/bundler/man/bundle-config.1.ronn +17 -7
- data/lib/bundler/man/bundle-console.1 +53 -0
- data/lib/bundler/man/bundle-console.1.ronn +44 -0
- data/lib/bundler/man/bundle-doctor.1 +1 -1
- data/lib/bundler/man/bundle-exec.1 +6 -6
- data/lib/bundler/man/bundle-exec.1.ronn +6 -6
- data/lib/bundler/man/bundle-gem.1 +27 -37
- data/lib/bundler/man/bundle-gem.1.ronn +5 -5
- data/lib/bundler/man/bundle-help.1 +13 -0
- data/lib/bundler/man/bundle-help.1.ronn +12 -0
- data/lib/bundler/man/bundle-info.1 +1 -1
- data/lib/bundler/man/bundle-init.1 +1 -1
- data/lib/bundler/man/bundle-inject.1 +5 -2
- data/lib/bundler/man/bundle-inject.1.ronn +3 -1
- data/lib/bundler/man/bundle-install.1 +5 -30
- data/lib/bundler/man/bundle-install.1.ronn +6 -29
- data/lib/bundler/man/bundle-list.1 +1 -1
- data/lib/bundler/man/bundle-lock.1 +1 -1
- data/lib/bundler/man/bundle-open.1 +22 -2
- data/lib/bundler/man/bundle-open.1.ronn +9 -1
- data/lib/bundler/man/bundle-outdated.1 +1 -1
- data/lib/bundler/man/bundle-platform.1 +16 -6
- data/lib/bundler/man/bundle-platform.1.ronn +14 -7
- data/lib/bundler/man/bundle-plugin.1 +81 -0
- data/lib/bundler/man/bundle-plugin.1.ronn +59 -0
- data/lib/bundler/man/bundle-pristine.1 +1 -1
- data/lib/bundler/man/bundle-remove.1 +1 -1
- data/lib/bundler/man/bundle-show.1 +1 -1
- data/lib/bundler/man/bundle-update.1 +1 -1
- data/lib/bundler/man/bundle-version.1 +35 -0
- data/lib/bundler/man/bundle-version.1.ronn +24 -0
- data/lib/bundler/man/bundle-viz.1 +4 -1
- data/lib/bundler/man/bundle-viz.1.ronn +2 -0
- data/lib/bundler/man/bundle.1 +15 -10
- data/lib/bundler/man/bundle.1.ronn +12 -7
- data/lib/bundler/man/gemfile.5 +92 -81
- data/lib/bundler/man/gemfile.5.ronn +98 -85
- data/lib/bundler/man/index.txt +4 -0
- data/lib/bundler/match_metadata.rb +13 -0
- data/lib/bundler/match_platform.rb +0 -1
- data/lib/bundler/match_remote_metadata.rb +29 -0
- data/lib/bundler/mirror.rb +5 -7
- data/lib/bundler/plugin/api/source.rb +3 -3
- data/lib/bundler/plugin/index.rb +4 -4
- data/lib/bundler/plugin/installer/git.rb +0 -4
- data/lib/bundler/plugin/installer/rubygems.rb +0 -8
- data/lib/bundler/plugin.rb +2 -0
- data/lib/bundler/process_lock.rb +1 -1
- data/lib/bundler/remote_specification.rb +8 -9
- data/lib/bundler/resolver/base.rb +77 -0
- data/lib/bundler/resolver/candidate.rb +94 -0
- data/lib/bundler/resolver/incompatibility.rb +15 -0
- data/lib/bundler/resolver/package.rb +72 -0
- data/lib/bundler/resolver/root.rb +25 -0
- data/lib/bundler/resolver/spec_group.rb +42 -70
- data/lib/bundler/resolver.rb +322 -326
- data/lib/bundler/ruby_dsl.rb +1 -1
- data/lib/bundler/ruby_version.rb +5 -5
- data/lib/bundler/rubygems_ext.rb +102 -12
- data/lib/bundler/rubygems_gem_installer.rb +32 -20
- data/lib/bundler/rubygems_integration.rb +12 -34
- data/lib/bundler/runtime.rb +1 -6
- data/lib/bundler/settings.rb +2 -8
- data/lib/bundler/shared_helpers.rb +7 -7
- data/lib/bundler/source/git/git_proxy.rb +193 -67
- data/lib/bundler/source/git.rb +21 -25
- data/lib/bundler/source/metadata.rb +1 -2
- data/lib/bundler/source/path/installer.rb +1 -22
- data/lib/bundler/source/path.rb +6 -6
- data/lib/bundler/source/rubygems.rb +75 -117
- data/lib/bundler/source.rb +3 -4
- data/lib/bundler/source_list.rb +12 -2
- data/lib/bundler/spec_set.rb +52 -34
- data/lib/bundler/stub_specification.rb +5 -3
- data/lib/bundler/templates/Executable +1 -1
- data/lib/bundler/templates/Executable.bundler +4 -9
- data/lib/bundler/templates/Executable.standalone +2 -0
- data/lib/bundler/templates/newgem/Cargo.toml.tt +7 -0
- data/lib/bundler/templates/newgem/Gemfile.tt +3 -0
- data/lib/bundler/templates/newgem/README.md.tt +6 -4
- data/lib/bundler/templates/newgem/Rakefile.tt +2 -1
- data/lib/bundler/templates/newgem/circleci/config.yml.tt +12 -0
- data/lib/bundler/templates/newgem/ext/newgem/Cargo.toml.tt +15 -0
- data/lib/bundler/templates/newgem/ext/newgem/extconf-rust.rb.tt +6 -0
- data/lib/bundler/templates/newgem/ext/newgem/src/lib.rs.tt +12 -0
- data/lib/bundler/templates/newgem/github/workflows/main.yml.tt +10 -0
- data/lib/bundler/templates/newgem/gitignore.tt +3 -0
- data/lib/bundler/templates/newgem/gitlab-ci.yml.tt +13 -4
- data/lib/bundler/templates/newgem/newgem.gemspec.tt +8 -2
- data/lib/bundler/ui/shell.rb +35 -12
- data/lib/bundler/ui/silent.rb +21 -5
- data/lib/bundler/vendor/connection_pool/lib/connection_pool/timed_stack.rb +3 -3
- data/lib/bundler/vendor/connection_pool/lib/connection_pool/wrapper.rb +0 -1
- data/lib/bundler/vendor/connection_pool/lib/connection_pool.rb +3 -1
- data/lib/bundler/vendor/fileutils/lib/fileutils.rb +1350 -408
- data/lib/bundler/vendor/net-http-persistent/README.rdoc +1 -1
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +1 -1
- data/lib/bundler/vendor/pub_grub/LICENSE.txt +21 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/assignment.rb +20 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/basic_package_source.rb +189 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/failure_writer.rb +182 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/incompatibility.rb +151 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/package.rb +43 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/partial_solution.rb +121 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/rubygems.rb +45 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/solve_failure.rb +19 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/static_package_source.rb +53 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/term.rb +105 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/version.rb +3 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb +128 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_range.rb +409 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb +240 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub/version_union.rb +178 -0
- data/lib/bundler/vendor/pub_grub/lib/pub_grub.rb +31 -0
- data/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +1 -1
- data/lib/bundler/vendor/uri/lib/uri/common.rb +64 -16
- data/lib/bundler/vendor/uri/lib/uri/file.rb +7 -1
- data/lib/bundler/vendor/uri/lib/uri/ftp.rb +2 -1
- data/lib/bundler/vendor/uri/lib/uri/generic.rb +27 -7
- data/lib/bundler/vendor/uri/lib/uri/http.rb +40 -2
- data/lib/bundler/vendor/uri/lib/uri/https.rb +2 -1
- data/lib/bundler/vendor/uri/lib/uri/ldap.rb +1 -1
- data/lib/bundler/vendor/uri/lib/uri/ldaps.rb +2 -1
- data/lib/bundler/vendor/uri/lib/uri/mailto.rb +2 -2
- data/lib/bundler/vendor/uri/lib/uri/rfc2396_parser.rb +13 -7
- data/lib/bundler/vendor/uri/lib/uri/rfc3986_parser.rb +10 -5
- data/lib/bundler/vendor/uri/lib/uri/version.rb +1 -1
- data/lib/bundler/vendor/uri/lib/uri/ws.rb +1 -2
- data/lib/bundler/vendor/uri/lib/uri/wss.rb +2 -1
- data/lib/bundler/vendor/uri/lib/uri.rb +3 -2
- data/lib/bundler/vendored_persistent.rb +1 -33
- data/lib/bundler/{vendored_tmpdir.rb → vendored_pub_grub.rb} +1 -1
- data/lib/bundler/version.rb +5 -1
- data/lib/bundler/worker.rb +5 -7
- data/lib/bundler.rb +35 -69
- metadata +45 -34
- data/lib/bundler/dep_proxy.rb +0 -55
- data/lib/bundler/templates/newgem/travis.yml.tt +0 -6
- data/lib/bundler/vendor/molinillo/LICENSE +0 -9
- data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/resolution_state.rb +0 -57
- data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +0 -88
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/action.rb +0 -36
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +0 -66
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +0 -62
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +0 -63
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +0 -61
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/log.rb +0 -126
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/set_payload.rb +0 -46
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +0 -36
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +0 -164
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +0 -255
- data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +0 -149
- data/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +0 -6
- data/lib/bundler/vendor/molinillo/lib/molinillo/modules/specification_provider.rb +0 -112
- data/lib/bundler/vendor/molinillo/lib/molinillo/modules/ui.rb +0 -67
- data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +0 -839
- data/lib/bundler/vendor/molinillo/lib/molinillo/resolver.rb +0 -46
- data/lib/bundler/vendor/molinillo/lib/molinillo/state.rb +0 -58
- data/lib/bundler/vendor/molinillo/lib/molinillo.rb +0 -11
- data/lib/bundler/vendor/tmpdir/lib/tmpdir.rb +0 -154
- data/lib/bundler/vendored_molinillo.rb +0 -4
- data/lib/bundler/version_ranges.rb +0 -122
- /data/lib/bundler/templates/newgem/ext/newgem/{extconf.rb.tt → extconf-c.rb.tt} +0 -0
@@ -3,7 +3,10 @@ bundle-config(1) -- Set bundler configuration options
|
|
3
3
|
|
4
4
|
## SYNOPSIS
|
5
5
|
|
6
|
-
`bundle config`
|
6
|
+
`bundle config` list<br>
|
7
|
+
`bundle config` [get] NAME<br>
|
8
|
+
`bundle config` [set] NAME VALUE<br>
|
9
|
+
`bundle config` unset NAME
|
7
10
|
|
8
11
|
## DESCRIPTION
|
9
12
|
|
@@ -16,7 +19,7 @@ Bundler loads configuration settings in this order:
|
|
16
19
|
3. Global config (`~/.bundle/config`)
|
17
20
|
4. Bundler default config
|
18
21
|
|
19
|
-
Executing `bundle config list`
|
22
|
+
Executing `bundle config list` will print a list of all bundler
|
20
23
|
configuration for the current bundle, and where that configuration
|
21
24
|
was set.
|
22
25
|
|
@@ -43,8 +46,8 @@ local and global sources.
|
|
43
46
|
Executing `bundle config unset --global <name>` will delete the configuration
|
44
47
|
only from the user configuration.
|
45
48
|
|
46
|
-
Executing `bundle config unset --local <name
|
47
|
-
|
49
|
+
Executing `bundle config unset --local <name>` will delete the configuration
|
50
|
+
only from the local application.
|
48
51
|
|
49
52
|
Executing bundle with the `BUNDLE_IGNORE_CONFIG` environment variable set will
|
50
53
|
cause it to ignore all configuration.
|
@@ -74,6 +77,9 @@ The options that can be configured are:
|
|
74
77
|
`production` use. Please check carefully if you want to have this option
|
75
78
|
enabled in `development` or `test` environments.
|
76
79
|
|
80
|
+
* `only`:
|
81
|
+
A space-separated list of groups to install only gems of the specified groups.
|
82
|
+
|
77
83
|
* `path`:
|
78
84
|
The location to install the specified gems to. This defaults to Rubygems'
|
79
85
|
setting. Bundler shares this location with Rubygems, `gem install ...` will
|
@@ -204,6 +210,8 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
204
210
|
* `global_gem_cache` (`BUNDLE_GLOBAL_GEM_CACHE`):
|
205
211
|
Whether Bundler should cache all gems globally, rather than locally to the
|
206
212
|
installing Ruby installation.
|
213
|
+
* `ignore_funding_requests` (`BUNDLE_IGNORE_FUNDING_REQUESTS`):
|
214
|
+
When set, no funding requests will be printed.
|
207
215
|
* `ignore_messages` (`BUNDLE_IGNORE_MESSAGES`):
|
208
216
|
When set, no post install messages will be printed. To silence a single gem,
|
209
217
|
use dot notation like `ignore_messages.httparty true`.
|
@@ -216,6 +224,8 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
216
224
|
Whether `bundle package` should skip installing gems.
|
217
225
|
* `no_prune` (`BUNDLE_NO_PRUNE`):
|
218
226
|
Whether Bundler should leave outdated gems unpruned when caching.
|
227
|
+
* `only` (`BUNDLE_ONLY`):
|
228
|
+
A space-separated list of groups to install only gems of the specified groups.
|
219
229
|
* `path` (`BUNDLE_PATH`):
|
220
230
|
The location on disk where all gems in your bundle will be located regardless
|
221
231
|
of `$GEM_HOME` or `$GEM_PATH` values. Bundle gems not found in this location
|
@@ -273,7 +283,7 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
273
283
|
A `:`-separated list of groups whose gems bundler should not install.
|
274
284
|
|
275
285
|
In general, you should set these settings per-application by using the applicable
|
276
|
-
flag to the [bundle install(1)](bundle-install.1.html) or [bundle
|
286
|
+
flag to the [bundle install(1)](bundle-install.1.html) or [bundle cache(1)](bundle-cache.1.html) command.
|
277
287
|
|
278
288
|
You can set them globally either via environment variables or `bundle config`,
|
279
289
|
whichever is preferable for your setup. If you use both, environment variables
|
@@ -321,9 +331,9 @@ mirror to fetch gems.
|
|
321
331
|
|
322
332
|
bundle config set --global mirror.SOURCE_URL MIRROR_URL
|
323
333
|
|
324
|
-
For example, to use a mirror of rubygems.org hosted at
|
334
|
+
For example, to use a mirror of https://rubygems.org hosted at https://example.org:
|
325
335
|
|
326
|
-
bundle config set --global mirror.
|
336
|
+
bundle config set --global mirror.https://rubygems.org https://example.org
|
327
337
|
|
328
338
|
Each mirror also provides a fallback timeout setting. If the mirror does not
|
329
339
|
respond within the fallback timeout, Bundler will try to use the original
|
@@ -0,0 +1,53 @@
|
|
1
|
+
.\" generated with Ronn/v0.7.3
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
+
.
|
4
|
+
.TH "BUNDLE\-CONSOLE" "1" "January 2023" "" ""
|
5
|
+
.
|
6
|
+
.SH "NAME"
|
7
|
+
\fBbundle\-console\fR \- Deprecated way to open an IRB session with the bundle pre\-loaded
|
8
|
+
.
|
9
|
+
.SH "SYNOPSIS"
|
10
|
+
\fBbundle console\fR [GROUP]
|
11
|
+
.
|
12
|
+
.SH "DESCRIPTION"
|
13
|
+
Starts an interactive Ruby console session in the context of the current bundle\.
|
14
|
+
.
|
15
|
+
.P
|
16
|
+
If no \fBGROUP\fR is specified, all gems in the \fBdefault\fR group in the Gemfile(5) \fIhttps://bundler\.io/man/gemfile\.5\.html\fR are preliminarily loaded\.
|
17
|
+
.
|
18
|
+
.P
|
19
|
+
If \fBGROUP\fR is specified, all gems in the given group in the Gemfile in addition to the gems in \fBdefault\fR group are loaded\. Even if the given group does not exist in the Gemfile, IRB console starts without any warning or error\.
|
20
|
+
.
|
21
|
+
.P
|
22
|
+
The environment variable \fBBUNDLE_CONSOLE\fR or \fBbundle config set console\fR can be used to change the shell from the following:
|
23
|
+
.
|
24
|
+
.IP "\(bu" 4
|
25
|
+
\fBirb\fR (default)
|
26
|
+
.
|
27
|
+
.IP "\(bu" 4
|
28
|
+
\fBpry\fR (https://github\.com/pry/pry)
|
29
|
+
.
|
30
|
+
.IP "\(bu" 4
|
31
|
+
\fBripl\fR (https://github\.com/cldwalker/ripl)
|
32
|
+
.
|
33
|
+
.IP "" 0
|
34
|
+
.
|
35
|
+
.P
|
36
|
+
\fBbundle console\fR uses irb by default\. An alternative Pry or Ripl can be used with \fBbundle console\fR by adjusting the \fBconsole\fR Bundler setting\. Also make sure that \fBpry\fR or \fBripl\fR is in your Gemfile\.
|
37
|
+
.
|
38
|
+
.SH "EXAMPLE"
|
39
|
+
.
|
40
|
+
.nf
|
41
|
+
|
42
|
+
$ bundle config set console pry
|
43
|
+
$ bundle console
|
44
|
+
Resolving dependencies\.\.\.
|
45
|
+
[1] pry(main)>
|
46
|
+
.
|
47
|
+
.fi
|
48
|
+
.
|
49
|
+
.SH "NOTES"
|
50
|
+
This command was deprecated in Bundler 2\.1 and will be removed in 3\.0\. Use \fBbin/console\fR script, which can be generated by \fBbundle gem <NAME>\fR\.
|
51
|
+
.
|
52
|
+
.SH "SEE ALSO"
|
53
|
+
Gemfile(5) \fIhttps://bundler\.io/man/gemfile\.5\.html\fR
|
@@ -0,0 +1,44 @@
|
|
1
|
+
bundle-console(1) -- Deprecated way to open an IRB session with the bundle pre-loaded
|
2
|
+
=====================================================================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
`bundle console` [GROUP]
|
7
|
+
|
8
|
+
## DESCRIPTION
|
9
|
+
|
10
|
+
Starts an interactive Ruby console session in the context of the current bundle.
|
11
|
+
|
12
|
+
If no `GROUP` is specified, all gems in the `default` group in the [Gemfile(5)](https://bundler.io/man/gemfile.5.html) are
|
13
|
+
preliminarily loaded.
|
14
|
+
|
15
|
+
If `GROUP` is specified, all gems in the given group in the Gemfile in addition
|
16
|
+
to the gems in `default` group are loaded. Even if the given group does not
|
17
|
+
exist in the Gemfile, IRB console starts without any warning or error.
|
18
|
+
|
19
|
+
The environment variable `BUNDLE_CONSOLE` or `bundle config set console` can be used to change
|
20
|
+
the shell from the following:
|
21
|
+
|
22
|
+
* `irb` (default)
|
23
|
+
* `pry` (https://github.com/pry/pry)
|
24
|
+
* `ripl` (https://github.com/cldwalker/ripl)
|
25
|
+
|
26
|
+
`bundle console` uses irb by default. An alternative Pry or Ripl can be used with
|
27
|
+
`bundle console` by adjusting the `console` Bundler setting. Also make sure that
|
28
|
+
`pry` or `ripl` is in your Gemfile.
|
29
|
+
|
30
|
+
## EXAMPLE
|
31
|
+
|
32
|
+
$ bundle config set console pry
|
33
|
+
$ bundle console
|
34
|
+
Resolving dependencies...
|
35
|
+
[1] pry(main)>
|
36
|
+
|
37
|
+
## NOTES
|
38
|
+
|
39
|
+
This command was deprecated in Bundler 2.1 and will be removed in 3.0.
|
40
|
+
Use `bin/console` script, which can be generated by `bundle gem <NAME>`.
|
41
|
+
|
42
|
+
## SEE ALSO
|
43
|
+
|
44
|
+
[Gemfile(5)](https://bundler.io/man/gemfile.5.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\-EXEC" "1" "
|
4
|
+
.TH "BUNDLE\-EXEC" "1" "January 2023" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-exec\fR \- Execute a command in the context of the bundle
|
@@ -74,13 +74,13 @@ Finally, \fBbundle exec\fR also implicitly modifies \fBGemfile\.lock\fR if the l
|
|
74
74
|
By default, when attempting to \fBbundle exec\fR to a file with a ruby shebang, Bundler will \fBKernel\.load\fR that file instead of using \fBKernel\.exec\fR\. For the vast majority of cases, this is a performance improvement\. In a rare few cases, this could cause some subtle side\-effects (such as dependence on the exact contents of \fB$0\fR or \fB__FILE__\fR) and the optimization can be disabled by enabling the \fBdisable_exec_load\fR setting\.
|
75
75
|
.
|
76
76
|
.SS "Shelling out"
|
77
|
-
Any Ruby code that opens a subshell (like \fBsystem\fR, backticks, or \fB%x{}\fR) will automatically use the current Bundler environment\. If you need to shell out to a Ruby command that is not part of your current bundle, use the \
|
77
|
+
Any Ruby code that opens a subshell (like \fBsystem\fR, backticks, or \fB%x{}\fR) will automatically use the current Bundler environment\. If you need to shell out to a Ruby command that is not part of your current bundle, use the \fBwith_unbundled_env\fR method with a block\. Any subshells created inside the block will be given the environment present before Bundler was activated\. For example, Homebrew commands run Ruby, but don\'t work inside a bundle:
|
78
78
|
.
|
79
79
|
.IP "" 4
|
80
80
|
.
|
81
81
|
.nf
|
82
82
|
|
83
|
-
Bundler\.
|
83
|
+
Bundler\.with_unbundled_env do
|
84
84
|
`brew install wget`
|
85
85
|
end
|
86
86
|
.
|
@@ -89,13 +89,13 @@ end
|
|
89
89
|
.IP "" 0
|
90
90
|
.
|
91
91
|
.P
|
92
|
-
Using \
|
92
|
+
Using \fBwith_unbundled_env\fR is also necessary if you are shelling out to a different bundle\. Any Bundler commands run in a subshell will inherit the current Gemfile, so commands that need to run in the context of a different bundle also need to use \fBwith_unbundled_env\fR\.
|
93
93
|
.
|
94
94
|
.IP "" 4
|
95
95
|
.
|
96
96
|
.nf
|
97
97
|
|
98
|
-
Bundler\.
|
98
|
+
Bundler\.with_unbundled_env do
|
99
99
|
Dir\.chdir "/other/bundler/project" do
|
100
100
|
`bundle exec \./script`
|
101
101
|
end
|
@@ -155,7 +155,7 @@ You can find a list of all the gems containing gem plugins by running
|
|
155
155
|
.
|
156
156
|
.nf
|
157
157
|
|
158
|
-
ruby \-
|
158
|
+
ruby \-e "puts Gem\.find_files(\'rubygems_plugin\.rb\')"
|
159
159
|
.
|
160
160
|
.fi
|
161
161
|
.
|
@@ -84,20 +84,20 @@ the `disable_exec_load` setting.
|
|
84
84
|
Any Ruby code that opens a subshell (like `system`, backticks, or `%x{}`) will
|
85
85
|
automatically use the current Bundler environment. If you need to shell out to
|
86
86
|
a Ruby command that is not part of your current bundle, use the
|
87
|
-
`
|
87
|
+
`with_unbundled_env` method with a block. Any subshells created inside the block
|
88
88
|
will be given the environment present before Bundler was activated. For
|
89
89
|
example, Homebrew commands run Ruby, but don't work inside a bundle:
|
90
90
|
|
91
|
-
Bundler.
|
91
|
+
Bundler.with_unbundled_env do
|
92
92
|
`brew install wget`
|
93
93
|
end
|
94
94
|
|
95
|
-
Using `
|
95
|
+
Using `with_unbundled_env` is also necessary if you are shelling out to a different
|
96
96
|
bundle. Any Bundler commands run in a subshell will inherit the current
|
97
97
|
Gemfile, so commands that need to run in the context of a different bundle also
|
98
|
-
need to use `
|
98
|
+
need to use `with_unbundled_env`.
|
99
99
|
|
100
|
-
Bundler.
|
100
|
+
Bundler.with_unbundled_env do
|
101
101
|
Dir.chdir "/other/bundler/project" do
|
102
102
|
`bundle exec ./script`
|
103
103
|
end
|
@@ -145,7 +145,7 @@ their plugins.
|
|
145
145
|
You can find a list of all the gems containing gem plugins
|
146
146
|
by running
|
147
147
|
|
148
|
-
ruby -
|
148
|
+
ruby -e "puts Gem.find_files('rubygems_plugin.rb')"
|
149
149
|
|
150
150
|
At the very least, you should remove all but the newest
|
151
151
|
version of each gem plugin, and also remove all gem plugins
|
@@ -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\-GEM" "1" "
|
4
|
+
.TH "BUNDLE\-GEM" "1" "January 2023" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-gem\fR \- Generate a project skeleton for creating a rubygem
|
@@ -31,41 +31,32 @@ The generated project skeleton can be customized with OPTIONS, as explained belo
|
|
31
31
|
.
|
32
32
|
.SH "OPTIONS"
|
33
33
|
.
|
34
|
-
.
|
35
|
-
\fB\-\-exe\fR or \fB\-b\fR or \fB\-\-bin\fR
|
36
|
-
Specify that Bundler should create a binary executable (as \fBexe/GEM_NAME\fR) in the generated rubygem project\. This binary will also be added to the \fBGEM_NAME\.gemspec\fR manifest\. This behavior is disabled by default\.
|
34
|
+
.IP "\(bu" 4
|
35
|
+
\fB\-\-exe\fR or \fB\-b\fR or \fB\-\-bin\fR: Specify that Bundler should create a binary executable (as \fBexe/GEM_NAME\fR) in the generated rubygem project\. This binary will also be added to the \fBGEM_NAME\.gemspec\fR manifest\. This behavior is disabled by default\.
|
37
36
|
.
|
38
|
-
.
|
39
|
-
\fB\-\-no\-exe\fR
|
40
|
-
Do not create a binary (overrides \fB\-\-exe\fR specified in the global config)\.
|
37
|
+
.IP "\(bu" 4
|
38
|
+
\fB\-\-no\-exe\fR: Do not create a binary (overrides \fB\-\-exe\fR specified in the global config)\.
|
41
39
|
.
|
42
|
-
.
|
43
|
-
\fB\-\-coc\fR
|
44
|
-
Add a \fBCODE_OF_CONDUCT\.md\fR file to the root of the generated project\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
40
|
+
.IP "\(bu" 4
|
41
|
+
\fB\-\-coc\fR: Add a \fBCODE_OF_CONDUCT\.md\fR file to the root of the generated project\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
45
42
|
.
|
46
|
-
.
|
47
|
-
\fB\-\-no\-coc\fR
|
48
|
-
Do not create a \fBCODE_OF_CONDUCT\.md\fR (overrides \fB\-\-coc\fR specified in the global config)\.
|
43
|
+
.IP "\(bu" 4
|
44
|
+
\fB\-\-no\-coc\fR: Do not create a \fBCODE_OF_CONDUCT\.md\fR (overrides \fB\-\-coc\fR specified in the global config)\.
|
49
45
|
.
|
50
|
-
.
|
51
|
-
\fB\-\-ext\fR
|
52
|
-
Add boilerplate for C extension code to the generated project\. This behavior is disabled by default\.
|
46
|
+
.IP "\(bu" 4
|
47
|
+
\fB\-\-ext=c\fR, \fB\-\-ext=rust\fR Add boilerplate for C or Rust (currently magnus \fIhttps://docs\.rs/magnus\fR based) extension code to the generated project\. This behavior is disabled by default\.
|
53
48
|
.
|
54
|
-
.
|
55
|
-
\fB\-\-no\-ext\fR
|
56
|
-
Do not add C extension code (overrides \fB\-\-ext\fR specified in the global config)\.
|
49
|
+
.IP "\(bu" 4
|
50
|
+
\fB\-\-no\-ext\fR: Do not add extension code (overrides \fB\-\-ext\fR specified in the global config)\.
|
57
51
|
.
|
58
|
-
.
|
59
|
-
\fB\-\-mit\fR
|
60
|
-
Add an MIT license to a \fBLICENSE\.txt\fR file in the root of the generated project\. Your name from the global git config is used for the copyright statement\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
52
|
+
.IP "\(bu" 4
|
53
|
+
\fB\-\-mit\fR: Add an MIT license to a \fBLICENSE\.txt\fR file in the root of the generated project\. Your name from the global git config is used for the copyright statement\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
61
54
|
.
|
62
|
-
.
|
63
|
-
\fB\-\-no\-mit\fR
|
64
|
-
Do not create a \fBLICENSE\.txt\fR (overrides \fB\-\-mit\fR specified in the global config)\.
|
55
|
+
.IP "\(bu" 4
|
56
|
+
\fB\-\-no\-mit\fR: Do not create a \fBLICENSE\.txt\fR (overrides \fB\-\-mit\fR specified in the global config)\.
|
65
57
|
.
|
66
|
-
.
|
67
|
-
\fB\-t\fR, \fB\-\-test=minitest\fR, \fB\-\-test=rspec\fR, \fB\-\-test=test\-unit\fR
|
68
|
-
Specify the test framework that Bundler should use when generating the project\. Acceptable values are \fBminitest\fR, \fBrspec\fR and \fBtest\-unit\fR\. The \fBGEM_NAME\.gemspec\fR will be configured and a skeleton test/spec directory will be created based on this option\. Given no option is specified:
|
58
|
+
.IP "\(bu" 4
|
59
|
+
\fB\-t\fR, \fB\-\-test=minitest\fR, \fB\-\-test=rspec\fR, \fB\-\-test=test\-unit\fR: Specify the test framework that Bundler should use when generating the project\. Acceptable values are \fBminitest\fR, \fBrspec\fR and \fBtest\-unit\fR\. The \fBGEM_NAME\.gemspec\fR will be configured and a skeleton test/spec directory will be created based on this option\. Given no option is specified:
|
69
60
|
.
|
70
61
|
.IP
|
71
62
|
When Bundler is configured to generate tests, this defaults to Bundler\'s global config setting \fBgem\.test\fR\.
|
@@ -76,9 +67,8 @@ When Bundler is configured to not generate tests, an interactive prompt will be
|
|
76
67
|
.IP
|
77
68
|
When Bundler is unconfigured, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
78
69
|
.
|
79
|
-
.
|
80
|
-
\fB\-\-ci\fR, \fB\-\-ci=github\fR, \fB\-\-ci=
|
81
|
-
Specify the continuous integration service that Bundler should use when generating the project\. Acceptable values are \fBgithub\fR, \fBtravis\fR, \fBgitlab\fR and \fBcircle\fR\. A configuration file will be generated in the project directory\. Given no option is specified:
|
70
|
+
.IP "\(bu" 4
|
71
|
+
\fB\-\-ci\fR, \fB\-\-ci=github\fR, \fB\-\-ci=gitlab\fR, \fB\-\-ci=circle\fR: Specify the continuous integration service that Bundler should use when generating the project\. Acceptable values are \fBgithub\fR, \fBgitlab\fR and \fBcircle\fR\. A configuration file will be generated in the project directory\. Given no option is specified:
|
82
72
|
.
|
83
73
|
.IP
|
84
74
|
When Bundler is configured to generate CI files, this defaults to Bundler\'s global config setting \fBgem\.ci\fR\.
|
@@ -89,9 +79,8 @@ When Bundler is configured to not generate CI files, an interactive prompt will
|
|
89
79
|
.IP
|
90
80
|
When Bundler is unconfigured, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
91
81
|
.
|
92
|
-
.
|
93
|
-
\fB\-\-linter\fR, \fB\-\-linter=rubocop\fR, \fB\-\-linter=standard\fR
|
94
|
-
Specify the linter and code formatter that Bundler should add to the project\'s development dependencies\. Acceptable values are \fBrubocop\fR and \fBstandard\fR\. A configuration file will be generated in the project directory\. Given no option is specified:
|
82
|
+
.IP "\(bu" 4
|
83
|
+
\fB\-\-linter\fR, \fB\-\-linter=rubocop\fR, \fB\-\-linter=standard\fR: Specify the linter and code formatter that Bundler should add to the project\'s development dependencies\. Acceptable values are \fBrubocop\fR and \fBstandard\fR\. A configuration file will be generated in the project directory\. Given no option is specified:
|
95
84
|
.
|
96
85
|
.IP
|
97
86
|
When Bundler is configured to add a linter, this defaults to Bundler\'s global config setting \fBgem\.linter\fR\.
|
@@ -102,9 +91,10 @@ When Bundler is configured not to add a linter, an interactive prompt will be di
|
|
102
91
|
.IP
|
103
92
|
When Bundler is unconfigured, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
104
93
|
.
|
105
|
-
.
|
106
|
-
\fB\-e\fR, \fB\-\-edit[=EDITOR]\fR
|
107
|
-
|
94
|
+
.IP "\(bu" 4
|
95
|
+
\fB\-e\fR, \fB\-\-edit[=EDITOR]\fR: Open the resulting GEM_NAME\.gemspec in EDITOR, or the default editor if not specified\. The default is \fB$BUNDLER_EDITOR\fR, \fB$VISUAL\fR, or \fB$EDITOR\fR\.
|
96
|
+
.
|
97
|
+
.IP "" 0
|
108
98
|
.
|
109
99
|
.SH "SEE ALSO"
|
110
100
|
.
|
@@ -41,12 +41,12 @@ configuration file using the following names:
|
|
41
41
|
Do not create a `CODE_OF_CONDUCT.md` (overrides `--coc` specified in the
|
42
42
|
global config).
|
43
43
|
|
44
|
-
* `--ext
|
45
|
-
Add boilerplate for C extension code to the generated project. This behavior
|
44
|
+
* `--ext=c`, `--ext=rust`
|
45
|
+
Add boilerplate for C or Rust (currently [magnus](https://docs.rs/magnus) based) extension code to the generated project. This behavior
|
46
46
|
is disabled by default.
|
47
47
|
|
48
48
|
* `--no-ext`:
|
49
|
-
Do not add
|
49
|
+
Do not add extension code (overrides `--ext` specified in the global
|
50
50
|
config).
|
51
51
|
|
52
52
|
* `--mit`:
|
@@ -76,9 +76,9 @@ configuration file using the following names:
|
|
76
76
|
the answer will be saved in Bundler's global config for future `bundle gem`
|
77
77
|
use.
|
78
78
|
|
79
|
-
* `--ci`, `--ci=github`, `--ci=
|
79
|
+
* `--ci`, `--ci=github`, `--ci=gitlab`, `--ci=circle`:
|
80
80
|
Specify the continuous integration service that Bundler should use when
|
81
|
-
generating the project. Acceptable values are `github`, `
|
81
|
+
generating the project. Acceptable values are `github`, `gitlab`
|
82
82
|
and `circle`. A configuration file will be generated in the project directory.
|
83
83
|
Given no option is specified:
|
84
84
|
|
@@ -0,0 +1,13 @@
|
|
1
|
+
.\" generated with Ronn/v0.7.3
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
+
.
|
4
|
+
.TH "BUNDLE\-HELP" "1" "January 2023" "" ""
|
5
|
+
.
|
6
|
+
.SH "NAME"
|
7
|
+
\fBbundle\-help\fR \- Displays detailed help for each subcommand
|
8
|
+
.
|
9
|
+
.SH "SYNOPSIS"
|
10
|
+
\fBbundle help\fR [COMMAND]
|
11
|
+
.
|
12
|
+
.SH "DESCRIPTION"
|
13
|
+
Displays detailed help for the given subcommand\. You can specify a single \fBCOMMAND\fR at the same time\. When \fBCOMMAND\fR is omitted, help for \fBhelp\fR command will be displayed\.
|
@@ -0,0 +1,12 @@
|
|
1
|
+
bundle-help(1) -- Displays detailed help for each subcommand
|
2
|
+
============================================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
`bundle help` [COMMAND]
|
7
|
+
|
8
|
+
## DESCRIPTION
|
9
|
+
|
10
|
+
Displays detailed help for the given subcommand.
|
11
|
+
You can specify a single `COMMAND` at the same time.
|
12
|
+
When `COMMAND` is omitted, help for `help` command will be displayed.
|
@@ -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\-INIT" "1" "
|
4
|
+
.TH "BUNDLE\-INIT" "1" "January 2023" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-init\fR \- Generates a Gemfile into the current working directory
|
@@ -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\-INJECT" "1" "
|
4
|
+
.TH "BUNDLE\-INJECT" "1" "January 2023" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-inject\fR \- Add named gem(s) with version requirements to Gemfile
|
@@ -30,4 +30,7 @@ bundle inject \'rack\' \'> 0\'
|
|
30
30
|
.IP "" 0
|
31
31
|
.
|
32
32
|
.P
|
33
|
-
This will inject the \'rack\' gem with a version greater than 0 in your [\fBGemfile(5)\fR][Gemfile(5)] and Gemfile\.lock
|
33
|
+
This will inject the \'rack\' gem with a version greater than 0 in your [\fBGemfile(5)\fR][Gemfile(5)] and Gemfile\.lock\.
|
34
|
+
.
|
35
|
+
.P
|
36
|
+
The \fBbundle inject\fR command was deprecated in Bundler 2\.1 and will be removed in Bundler 3\.0\.
|
@@ -19,4 +19,6 @@ Example:
|
|
19
19
|
bundle inject 'rack' '> 0'
|
20
20
|
|
21
21
|
This will inject the 'rack' gem with a version greater than 0 in your
|
22
|
-
[`Gemfile(5)`][Gemfile(5)] and Gemfile.lock
|
22
|
+
[`Gemfile(5)`][Gemfile(5)] and Gemfile.lock.
|
23
|
+
|
24
|
+
The `bundle inject` command was deprecated in Bundler 2.1 and will be removed in Bundler 3.0.
|
@@ -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" "
|
4
|
+
.TH "BUNDLE\-INSTALL" "1" "January 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,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" "
|
4
|
+
.TH "BUNDLE\-OPEN" "1" "January 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
|
+
|