bundler 2.1.4 → 2.2.18
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of bundler might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/CHANGELOG.md +1790 -1430
- data/README.md +6 -8
- data/bundler.gemspec +5 -6
- data/exe/bundle +3 -0
- data/lib/bundler/build_metadata.rb +3 -11
- data/lib/bundler/cli/add.rb +1 -1
- data/lib/bundler/cli/binstubs.rb +6 -2
- data/lib/bundler/cli/cache.rb +2 -7
- data/lib/bundler/cli/clean.rb +1 -1
- data/lib/bundler/cli/common.rb +29 -2
- data/lib/bundler/cli/console.rb +1 -1
- data/lib/bundler/cli/doctor.rb +1 -1
- data/lib/bundler/cli/exec.rb +4 -4
- data/lib/bundler/cli/fund.rb +36 -0
- data/lib/bundler/cli/gem.rb +129 -28
- data/lib/bundler/cli/info.rb +15 -4
- data/lib/bundler/cli/init.rb +2 -2
- data/lib/bundler/cli/inject.rb +1 -1
- data/lib/bundler/cli/install.rb +13 -11
- data/lib/bundler/cli/issue.rb +2 -2
- data/lib/bundler/cli/list.rb +12 -10
- data/lib/bundler/cli/outdated.rb +94 -76
- data/lib/bundler/cli/plugin.rb +10 -0
- data/lib/bundler/cli/pristine.rb +5 -0
- data/lib/bundler/cli/show.rb +1 -1
- data/lib/bundler/cli/update.rb +3 -1
- data/lib/bundler/cli.rb +72 -56
- data/lib/bundler/compact_index_client/cache.rb +6 -14
- data/lib/bundler/compact_index_client/gem_parser.rb +28 -0
- data/lib/bundler/compact_index_client/updater.rb +13 -17
- data/lib/bundler/compact_index_client.rb +1 -1
- data/lib/bundler/current_ruby.rb +1 -0
- data/lib/bundler/definition.rb +117 -188
- data/lib/bundler/dep_proxy.rb +16 -9
- data/lib/bundler/dependency.rb +3 -10
- data/lib/bundler/dsl.rb +40 -33
- data/lib/bundler/endpoint_specification.rb +1 -1
- data/lib/bundler/env.rb +1 -1
- data/lib/bundler/environment_preserver.rb +26 -2
- data/lib/bundler/errors.rb +1 -0
- data/lib/bundler/feature_flag.rb +0 -6
- data/lib/bundler/fetcher/base.rb +1 -1
- data/lib/bundler/fetcher/compact_index.rb +1 -1
- data/lib/bundler/fetcher/downloader.rb +9 -5
- data/lib/bundler/fetcher/index.rb +3 -4
- data/lib/bundler/fetcher.rb +5 -4
- data/lib/bundler/friendly_errors.rb +22 -13
- data/lib/bundler/gem_helper.rb +51 -18
- data/lib/bundler/gem_helpers.rb +36 -25
- data/lib/bundler/gem_version_promoter.rb +4 -4
- data/lib/bundler/graph.rb +1 -1
- data/lib/bundler/index.rb +13 -9
- data/lib/bundler/injector.rb +23 -5
- data/lib/bundler/inline.rb +3 -2
- data/lib/bundler/installer/gem_installer.rb +3 -3
- data/lib/bundler/installer/parallel_installer.rb +46 -25
- data/lib/bundler/installer/standalone.rb +17 -2
- data/lib/bundler/installer.rb +37 -49
- data/lib/bundler/lazy_specification.rb +45 -25
- data/lib/bundler/lockfile_generator.rb +1 -1
- data/lib/bundler/lockfile_parser.rb +4 -14
- data/lib/bundler/man/.document +1 -0
- data/{man → lib/bundler/man}/bundle-add.1 +1 -1
- data/{man/bundle-add.ronn → lib/bundler/man/bundle-add.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-binstubs.1 +5 -3
- data/{man/bundle-binstubs.ronn → lib/bundler/man/bundle-binstubs.1.ronn} +2 -4
- data/{man → lib/bundler/man}/bundle-cache.1 +1 -1
- data/{man/bundle-cache.ronn → lib/bundler/man/bundle-cache.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-check.1 +1 -1
- data/{man/bundle-check.ronn → lib/bundler/man/bundle-check.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-clean.1 +1 -1
- data/{man/bundle-clean.ronn → lib/bundler/man/bundle-clean.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-config.1 +40 -38
- data/{man/bundle-config.ronn → lib/bundler/man/bundle-config.1.ronn} +50 -50
- data/{man → lib/bundler/man}/bundle-doctor.1 +1 -1
- data/{man/bundle-doctor.ronn → lib/bundler/man/bundle-doctor.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-exec.1 +1 -1
- data/{man/bundle-exec.ronn → lib/bundler/man/bundle-exec.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-gem.1 +25 -3
- data/{man/bundle-gem.ronn → lib/bundler/man/bundle-gem.1.ronn} +30 -7
- data/{man → lib/bundler/man}/bundle-info.1 +1 -1
- data/{man/bundle-info.ronn → lib/bundler/man/bundle-info.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-init.1 +1 -1
- data/{man/bundle-init.ronn → lib/bundler/man/bundle-init.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-inject.1 +1 -1
- data/{man/bundle-inject.ronn → lib/bundler/man/bundle-inject.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-install.1 +30 -3
- data/{man/bundle-install.ronn → lib/bundler/man/bundle-install.1.ronn} +25 -3
- data/{man → lib/bundler/man}/bundle-list.1 +7 -7
- data/{man/bundle-list.ronn → lib/bundler/man/bundle-list.1.ronn} +6 -6
- data/{man → lib/bundler/man}/bundle-lock.1 +1 -1
- data/{man/bundle-lock.ronn → lib/bundler/man/bundle-lock.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-open.1 +1 -1
- data/{man/bundle-open.ronn → lib/bundler/man/bundle-open.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-outdated.1 +1 -1
- data/{man/bundle-outdated.ronn → lib/bundler/man/bundle-outdated.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-platform.1 +1 -1
- data/{man/bundle-platform.ronn → lib/bundler/man/bundle-platform.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-pristine.1 +1 -1
- data/{man/bundle-pristine.ronn → lib/bundler/man/bundle-pristine.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-remove.1 +1 -1
- data/{man/bundle-remove.ronn → lib/bundler/man/bundle-remove.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-show.1 +1 -1
- data/{man/bundle-show.ronn → lib/bundler/man/bundle-show.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-update.1 +1 -1
- data/{man/bundle-update.ronn → lib/bundler/man/bundle-update.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle-viz.1 +1 -1
- data/{man/bundle-viz.ronn → lib/bundler/man/bundle-viz.1.ronn} +0 -0
- data/{man → lib/bundler/man}/bundle.1 +1 -1
- data/{man/bundle.ronn → lib/bundler/man/bundle.1.ronn} +0 -0
- data/{man → lib/bundler/man}/gemfile.5 +4 -4
- data/{man → lib/bundler/man}/gemfile.5.ronn +4 -4
- data/{man → lib/bundler/man}/index.txt +0 -0
- data/lib/bundler/mirror.rb +2 -2
- data/lib/bundler/plugin/api/source.rb +22 -1
- data/lib/bundler/plugin/dsl.rb +1 -1
- data/lib/bundler/plugin/index.rb +10 -1
- data/lib/bundler/plugin/installer/rubygems.rb +1 -1
- data/lib/bundler/plugin/installer.rb +9 -11
- data/lib/bundler/plugin/source_list.rb +5 -1
- data/lib/bundler/plugin.rb +33 -7
- data/lib/bundler/psyched_yaml.rb +0 -15
- data/lib/bundler/remote_specification.rb +5 -2
- data/lib/bundler/resolver/spec_group.rb +56 -53
- data/lib/bundler/resolver.rb +88 -115
- data/lib/bundler/retry.rb +2 -2
- data/lib/bundler/ruby_version.rb +1 -1
- data/lib/bundler/rubygems_ext.rb +71 -11
- data/lib/bundler/rubygems_gem_installer.rb +50 -9
- data/lib/bundler/rubygems_integration.rb +25 -60
- data/lib/bundler/runtime.rb +4 -14
- data/lib/bundler/settings.rb +107 -55
- data/lib/bundler/shared_helpers.rb +3 -3
- data/lib/bundler/similarity_detector.rb +1 -1
- data/lib/bundler/source/git/git_proxy.rb +82 -80
- data/lib/bundler/source/git.rb +24 -22
- data/lib/bundler/source/metadata.rb +0 -4
- data/lib/bundler/source/path/installer.rb +10 -10
- data/lib/bundler/source/path.rb +10 -4
- data/lib/bundler/source/rubygems/remote.rb +1 -1
- data/lib/bundler/source/rubygems.rb +60 -28
- data/lib/bundler/source/rubygems_aggregate.rb +64 -0
- data/lib/bundler/source.rb +16 -1
- data/lib/bundler/source_list.rb +52 -28
- data/lib/bundler/source_map.rb +58 -0
- data/lib/bundler/spec_set.rb +29 -17
- data/lib/bundler/stub_specification.rb +25 -7
- data/lib/bundler/templates/Gemfile +1 -1
- data/lib/bundler/templates/gems.rb +1 -1
- data/lib/bundler/templates/newgem/CHANGELOG.md.tt +5 -0
- data/lib/bundler/templates/newgem/CODE_OF_CONDUCT.md.tt +57 -47
- data/lib/bundler/templates/newgem/Gemfile.tt +9 -1
- data/lib/bundler/templates/newgem/README.md.tt +6 -5
- data/lib/bundler/templates/newgem/Rakefile.tt +19 -5
- data/lib/bundler/templates/newgem/bin/console.tt +1 -0
- data/lib/bundler/templates/newgem/circleci/config.yml.tt +13 -0
- data/lib/bundler/templates/newgem/ext/newgem/extconf.rb.tt +2 -0
- data/lib/bundler/templates/newgem/github/workflows/main.yml.tt +16 -0
- data/lib/bundler/templates/newgem/gitlab-ci.yml.tt +9 -0
- data/lib/bundler/templates/newgem/lib/newgem/version.rb.tt +2 -0
- data/lib/bundler/templates/newgem/lib/newgem.rb.tt +4 -2
- data/lib/bundler/templates/newgem/newgem.gemspec.tt +15 -7
- data/lib/bundler/templates/newgem/rubocop.yml.tt +13 -0
- data/lib/bundler/templates/newgem/spec/newgem_spec.rb.tt +2 -0
- data/lib/bundler/templates/newgem/spec/spec_helper.rb.tt +2 -1
- data/lib/bundler/templates/newgem/test/{newgem_test.rb.tt → minitest/newgem_test.rb.tt} +2 -0
- data/lib/bundler/templates/newgem/test/{test_helper.rb.tt → minitest/test_helper.rb.tt} +2 -0
- data/lib/bundler/templates/newgem/test/test-unit/newgem_test.rb.tt +15 -0
- data/lib/bundler/templates/newgem/test/test-unit/test_helper.rb.tt +6 -0
- data/lib/bundler/ui/shell.rb +5 -5
- data/lib/bundler/uri_credentials_filter.rb +3 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +7 -0
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +2 -2
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +11 -5
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +34 -2
- data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +3 -3
- data/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/modules/specification_provider.rb +12 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +49 -47
- data/lib/bundler/vendor/molinillo/lib/molinillo.rb +0 -1
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +82 -189
- data/lib/bundler/vendor/thor/lib/thor/actions/create_link.rb +2 -1
- data/lib/bundler/vendor/thor/lib/thor/actions/file_manipulation.rb +4 -2
- data/lib/bundler/vendor/thor/lib/thor/actions.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor/base.rb +9 -0
- data/lib/bundler/vendor/thor/lib/thor/error.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor/parser/arguments.rb +5 -1
- data/lib/bundler/vendor/thor/lib/thor/parser/options.rb +9 -8
- data/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +5 -2
- data/lib/bundler/vendor/thor/lib/thor/shell/color.rb +5 -1
- data/lib/bundler/vendor/thor/lib/thor/version.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor.rb +5 -13
- data/lib/bundler/vendor/tmpdir/lib/tmpdir.rb +154 -0
- data/lib/bundler/vendored_persistent.rb +0 -7
- data/lib/bundler/vendored_tmpdir.rb +4 -0
- data/lib/bundler/version.rb +1 -1
- data/lib/bundler/worker.rb +1 -1
- data/lib/bundler/yaml_serializer.rb +1 -1
- data/lib/bundler.rb +34 -9
- metadata +77 -86
- data/lib/bundler/vendor/molinillo/lib/molinillo/compatibility.rb +0 -26
- data/man/bundle-add.1.txt +0 -58
- data/man/bundle-binstubs.1.txt +0 -48
- data/man/bundle-cache.1.txt +0 -78
- data/man/bundle-check.1.txt +0 -33
- data/man/bundle-clean.1.txt +0 -26
- data/man/bundle-config.1.txt +0 -528
- data/man/bundle-doctor.1.txt +0 -44
- data/man/bundle-exec.1.txt +0 -178
- data/man/bundle-gem.1.txt +0 -91
- data/man/bundle-info.1.txt +0 -21
- data/man/bundle-init.1.txt +0 -34
- data/man/bundle-inject.1.txt +0 -32
- data/man/bundle-install.1.txt +0 -401
- data/man/bundle-list.1.txt +0 -43
- data/man/bundle-lock.1.txt +0 -93
- data/man/bundle-open.1.txt +0 -29
- data/man/bundle-outdated.1.txt +0 -131
- data/man/bundle-platform.1.txt +0 -57
- data/man/bundle-pristine.1.txt +0 -44
- data/man/bundle-remove.1.txt +0 -34
- data/man/bundle-show.1.txt +0 -27
- data/man/bundle-update.1.txt +0 -390
- data/man/bundle-viz.1.txt +0 -39
- data/man/bundle.1.txt +0 -116
- data/man/gemfile.5.txt +0 -649
@@ -11,7 +11,7 @@ This command allows you to interact with Bundler's configuration system.
|
|
11
11
|
|
12
12
|
Bundler loads configuration settings in this order:
|
13
13
|
|
14
|
-
1. Local config (
|
14
|
+
1. Local config (`<project_root>/.bundle/config` or `$BUNDLE_APP_CONFIG/config`)
|
15
15
|
2. Environmental variables (`ENV`)
|
16
16
|
3. Global config (`~/.bundle/config`)
|
17
17
|
4. Bundler default config
|
@@ -30,8 +30,10 @@ overridden and user will be warned.
|
|
30
30
|
|
31
31
|
Executing `bundle config set --global <name> <value>` works the same as above.
|
32
32
|
|
33
|
-
Executing `bundle config set --local <name> <value>` will set that configuration
|
34
|
-
the local application. The configuration will be stored in
|
33
|
+
Executing `bundle config set --local <name> <value>` will set that configuration
|
34
|
+
in the directory for the local application. The configuration will be stored in
|
35
|
+
`<project_root>/.bundle/config`. If `BUNDLE_APP_CONFIG` is set, the configuration
|
36
|
+
will be stored in `$BUNDLE_APP_CONFIG/config`.
|
35
37
|
|
36
38
|
Executing `bundle config unset <name>` will delete the configuration in both
|
37
39
|
local and global sources.
|
@@ -45,10 +47,6 @@ configuration only from the local application.
|
|
45
47
|
Executing bundle with the `BUNDLE_IGNORE_CONFIG` environment variable set will
|
46
48
|
cause it to ignore all configuration.
|
47
49
|
|
48
|
-
Executing `bundle config set disable_multisource true` upgrades the warning about
|
49
|
-
the Gemfile containing multiple primary sources to an error. Executing `bundle
|
50
|
-
config unset disable_multisource` downgrades this error to a warning.
|
51
|
-
|
52
50
|
## REMEMBERING OPTIONS
|
53
51
|
|
54
52
|
Flags passed to `bundle install` or the Bundler runtime, such as `--path foo` or
|
@@ -57,7 +55,7 @@ application's configuration (normally, `./.bundle/config`).
|
|
57
55
|
|
58
56
|
However, this will be changed in bundler 3, so it's better not to rely on this
|
59
57
|
behavior. If these options must be remembered, it's better to set them using
|
60
|
-
`bundle config` (e.g., `bundle config set path foo`).
|
58
|
+
`bundle config` (e.g., `bundle config set --local path foo`).
|
61
59
|
|
62
60
|
The options that can be configured are:
|
63
61
|
|
@@ -101,7 +99,7 @@ pass configuration flags to `gem install` to specify where to find the
|
|
101
99
|
Since the specific location of that executable can change from machine
|
102
100
|
to machine, you can specify these flags on a per-machine basis.
|
103
101
|
|
104
|
-
bundle config set build.mysql --with-mysql-config=/usr/local/mysql/bin/mysql_config
|
102
|
+
bundle config set --global build.mysql --with-mysql-config=/usr/local/mysql/bin/mysql_config
|
105
103
|
|
106
104
|
After running this command, every time bundler needs to install the
|
107
105
|
`mysql` gem, it will pass along the flags you specified.
|
@@ -131,9 +129,6 @@ the environment variable `BUNDLE_LOCAL__RACK`.
|
|
131
129
|
The following is a list of all configuration keys and their purpose. You can
|
132
130
|
learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
133
131
|
|
134
|
-
* `allow_bundler_dependency_conflicts` (`BUNDLE_ALLOW_BUNDLER_DEPENDENCY_CONFLICTS`):
|
135
|
-
Allow resolving to specifications that have dependencies on `bundler` that
|
136
|
-
are incompatible with the running Bundler version.
|
137
132
|
* `allow_deployment_source_credential_changes` (`BUNDLE_ALLOW_DEPLOYMENT_SOURCE_CREDENTIAL_CHANGES`):
|
138
133
|
When in deployment mode, allow changing the credentials to a gem's source.
|
139
134
|
Ex: `https://some.host.com/gems/path/` -> `https://user_name:password@some.host.com/gems/path`
|
@@ -148,7 +143,8 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
148
143
|
Install executables from gems in the bundle to the specified directory.
|
149
144
|
Defaults to `false`.
|
150
145
|
* `cache_all` (`BUNDLE_CACHE_ALL`):
|
151
|
-
Cache all gems, including path and git gems.
|
146
|
+
Cache all gems, including path and git gems. This needs to be explicitly
|
147
|
+
configured on bundler 1 and bundler 2, but will be the default on bundler 3.
|
152
148
|
* `cache_all_platforms` (`BUNDLE_CACHE_ALL_PLATFORMS`):
|
153
149
|
Cache gems for all platforms.
|
154
150
|
* `cache_path` (`BUNDLE_CACHE_PATH`):
|
@@ -175,12 +171,9 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
175
171
|
* `disable_local_branch_check` (`BUNDLE_DISABLE_LOCAL_BRANCH_CHECK`):
|
176
172
|
Allow Bundler to use a local git override without a branch specified in the
|
177
173
|
Gemfile.
|
178
|
-
* `
|
179
|
-
|
180
|
-
|
181
|
-
Use `bundle config unset disable_multisource` to unset.
|
182
|
-
* `disable_platform_warnings` (`BUNDLE_DISABLE_PLATFORM_WARNINGS`):
|
183
|
-
Disable warnings during bundle install when a dependency is unused on the current platform.
|
174
|
+
* `disable_local_revision_check` (`BUNDLE_DISABLE_LOCAL_REVISION_CHECK`):
|
175
|
+
Allow Bundler to use a local git override without checking if the revision
|
176
|
+
present in the lockfile is present in the repository.
|
184
177
|
* `disable_shared_gems` (`BUNDLE_DISABLE_SHARED_GEMS`):
|
185
178
|
Stop Bundler from accessing gems installed to RubyGems' normal location.
|
186
179
|
* `disable_version_check` (`BUNDLE_DISABLE_VERSION_CHECK`):
|
@@ -193,6 +186,10 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
193
186
|
Disallow changes to the `Gemfile`. When the `Gemfile` is changed and the
|
194
187
|
lockfile has not been updated, running Bundler commands will be blocked.
|
195
188
|
Defaults to `true` when `--deployment` is used.
|
189
|
+
* `gem.github_username` (`BUNDLE_GEM__GITHUB_USERNAME`):
|
190
|
+
Sets a GitHub username or organization to be used in `README` file when you
|
191
|
+
create a new gem via `bundle gem` command. It can be overridden by passing an
|
192
|
+
explicit `--github-username` flag to `bundle gem`.
|
196
193
|
* `gem.push_key` (`BUNDLE_GEM__PUSH_KEY`):
|
197
194
|
Sets the `--key` parameter for `gem push` when using the `rake release`
|
198
195
|
command with a private gemstash server.
|
@@ -205,20 +202,18 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
205
202
|
* `global_gem_cache` (`BUNDLE_GLOBAL_GEM_CACHE`):
|
206
203
|
Whether Bundler should cache all gems globally, rather than locally to the
|
207
204
|
installing Ruby installation.
|
208
|
-
* `ignore_messages` (`BUNDLE_IGNORE_MESSAGES`):
|
209
|
-
messages will be printed. To silence a single gem,
|
210
|
-
`ignore_messages.httparty true`.
|
211
|
-
* `init_gems_rb` (`BUNDLE_INIT_GEMS_RB`)
|
205
|
+
* `ignore_messages` (`BUNDLE_IGNORE_MESSAGES`):
|
206
|
+
When set, no post install messages will be printed. To silence a single gem,
|
207
|
+
use dot notation like `ignore_messages.httparty true`.
|
208
|
+
* `init_gems_rb` (`BUNDLE_INIT_GEMS_RB`):
|
212
209
|
Generate a `gems.rb` instead of a `Gemfile` when running `bundle init`.
|
213
210
|
* `jobs` (`BUNDLE_JOBS`):
|
214
|
-
The number of gems Bundler can install in parallel. Defaults to 1
|
211
|
+
The number of gems Bundler can install in parallel. Defaults to 1 on Windows,
|
212
|
+
and to the the number of processors on other platforms.
|
215
213
|
* `no_install` (`BUNDLE_NO_INSTALL`):
|
216
214
|
Whether `bundle package` should skip installing gems.
|
217
215
|
* `no_prune` (`BUNDLE_NO_PRUNE`):
|
218
216
|
Whether Bundler should leave outdated gems unpruned when caching.
|
219
|
-
* `only_update_to_newer_versions` (`BUNDLE_ONLY_UPDATE_TO_NEWER_VERSIONS`):
|
220
|
-
During `bundle update`, only resolve to newer versions of the gems in the
|
221
|
-
lockfile.
|
222
217
|
* `path` (`BUNDLE_PATH`):
|
223
218
|
The location on disk where all gems in your bundle will be located regardless
|
224
219
|
of `$GEM_HOME` or `$GEM_PATH` values. Bundle gems not found in this location
|
@@ -232,7 +227,7 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
232
227
|
Enable Bundler's experimental plugin system.
|
233
228
|
* `prefer_patch` (BUNDLE_PREFER_PATCH):
|
234
229
|
Prefer updating only to next patch version during updates. Makes `bundle update` calls equivalent to `bundler update --patch`.
|
235
|
-
* `print_only_version_number` (`BUNDLE_PRINT_ONLY_VERSION_NUMBER`)
|
230
|
+
* `print_only_version_number` (`BUNDLE_PRINT_ONLY_VERSION_NUMBER`):
|
236
231
|
Print only version number from `bundler --version`.
|
237
232
|
* `redirect` (`BUNDLE_REDIRECT`):
|
238
233
|
The number of redirects allowed for network requests. Defaults to `5`.
|
@@ -249,17 +244,6 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
249
244
|
be changed in the next major version.
|
250
245
|
* `silence_root_warning` (`BUNDLE_SILENCE_ROOT_WARNING`):
|
251
246
|
Silence the warning Bundler prints when installing gems as root.
|
252
|
-
* `skip_default_git_sources` (`BUNDLE_SKIP_DEFAULT_GIT_SOURCES`):
|
253
|
-
Whether Bundler should skip adding default git source shortcuts to the
|
254
|
-
Gemfile DSL.
|
255
|
-
* `specific_platform` (`BUNDLE_SPECIFIC_PLATFORM`):
|
256
|
-
Allow bundler to resolve for the specific running platform and store it in
|
257
|
-
the lockfile, instead of only using a generic platform.
|
258
|
-
A specific platform is the exact platform triple reported by
|
259
|
-
`Gem::Platform.local`, such as `x86_64-darwin-16` or `universal-java-1.8`.
|
260
|
-
On the other hand, generic platforms are those such as `ruby`, `mswin`, or
|
261
|
-
`java`. In this example, `x86_64-darwin-16` would map to `ruby` and
|
262
|
-
`universal-java-1.8` to `java`.
|
263
247
|
* `ssl_ca_cert` (`BUNDLE_SSL_CA_CERT`):
|
264
248
|
Path to a designated CA certificate file or folder containing multiple
|
265
249
|
certificates for trusted CAs in PEM format.
|
@@ -279,7 +263,7 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
|
|
279
263
|
* `unlock_source_unlocks_spec` (`BUNDLE_UNLOCK_SOURCE_UNLOCKS_SPEC`):
|
280
264
|
Whether running `bundle update --source NAME` unlocks a gem with the given
|
281
265
|
name. Defaults to `true`.
|
282
|
-
* `update_requires_all_flag` (`BUNDLE_UPDATE_REQUIRES_ALL_FLAG`)
|
266
|
+
* `update_requires_all_flag` (`BUNDLE_UPDATE_REQUIRES_ALL_FLAG`):
|
283
267
|
Require passing `--all` to `bundle update` when everything should be updated,
|
284
268
|
and disallow passing no options to `bundle update`.
|
285
269
|
* `user_agent` (`BUNDLE_USER_AGENT`):
|
@@ -302,11 +286,11 @@ Bundler also allows you to work against a git repository locally
|
|
302
286
|
instead of using the remote version. This can be achieved by setting
|
303
287
|
up a local override:
|
304
288
|
|
305
|
-
bundle config set local.GEM_NAME /path/to/local/git/repository
|
289
|
+
bundle config set --local local.GEM_NAME /path/to/local/git/repository
|
306
290
|
|
307
291
|
For example, in order to use a local Rack repository, a developer could call:
|
308
292
|
|
309
|
-
bundle config set local.rack ~/Work/git/rack
|
293
|
+
bundle config set --local local.rack ~/Work/git/rack
|
310
294
|
|
311
295
|
Now instead of checking out the remote git repository, the local
|
312
296
|
override will be used. Similar to a path source, every time the local
|
@@ -336,21 +320,21 @@ Bundler supports overriding gem sources with mirrors. This allows you to
|
|
336
320
|
configure rubygems.org as the gem source in your Gemfile while still using your
|
337
321
|
mirror to fetch gems.
|
338
322
|
|
339
|
-
bundle config set mirror.SOURCE_URL MIRROR_URL
|
323
|
+
bundle config set --global mirror.SOURCE_URL MIRROR_URL
|
340
324
|
|
341
325
|
For example, to use a mirror of rubygems.org hosted at rubygems-mirror.org:
|
342
326
|
|
343
|
-
bundle config set mirror.http://rubygems.org http://rubygems-mirror.org
|
327
|
+
bundle config set --global mirror.http://rubygems.org http://rubygems-mirror.org
|
344
328
|
|
345
329
|
Each mirror also provides a fallback timeout setting. If the mirror does not
|
346
330
|
respond within the fallback timeout, Bundler will try to use the original
|
347
331
|
server instead of the mirror.
|
348
332
|
|
349
|
-
bundle config set mirror.SOURCE_URL.fallback_timeout TIMEOUT
|
333
|
+
bundle config set --global mirror.SOURCE_URL.fallback_timeout TIMEOUT
|
350
334
|
|
351
335
|
For example, to fall back to rubygems.org after 3 seconds:
|
352
336
|
|
353
|
-
bundle config set mirror.https://rubygems.org.fallback_timeout 3
|
337
|
+
bundle config set --global mirror.https://rubygems.org.fallback_timeout 3
|
354
338
|
|
355
339
|
The default fallback timeout is 0.1 seconds, but the setting can currently
|
356
340
|
only accept whole seconds (for example, 1, 15, or 30).
|
@@ -360,12 +344,12 @@ only accept whole seconds (for example, 1, 15, or 30).
|
|
360
344
|
Bundler allows you to configure credentials for any gem source, which allows
|
361
345
|
you to avoid putting secrets into your Gemfile.
|
362
346
|
|
363
|
-
bundle config set SOURCE_HOSTNAME USERNAME:PASSWORD
|
347
|
+
bundle config set --global SOURCE_HOSTNAME USERNAME:PASSWORD
|
364
348
|
|
365
349
|
For example, to save the credentials of user `claudette` for the gem source at
|
366
350
|
`gems.longerous.com`, you would run:
|
367
351
|
|
368
|
-
bundle config set gems.longerous.com claudette:s00pers3krit
|
352
|
+
bundle config set --global gems.longerous.com claudette:s00pers3krit
|
369
353
|
|
370
354
|
Or you can set the credentials as an environment variable like this:
|
371
355
|
|
@@ -373,7 +357,7 @@ Or you can set the credentials as an environment variable like this:
|
|
373
357
|
|
374
358
|
For gems with a git source with HTTP(S) URL you can specify credentials like so:
|
375
359
|
|
376
|
-
bundle config set https://github.com/
|
360
|
+
bundle config set --global https://github.com/rubygems/rubygems.git username:password
|
377
361
|
|
378
362
|
Or you can set the credentials as an environment variable like so:
|
379
363
|
|
@@ -384,6 +368,23 @@ where you can use personal OAuth tokens:
|
|
384
368
|
|
385
369
|
export BUNDLE_GITHUB__COM=abcd0123generatedtoken:x-oauth-basic
|
386
370
|
|
371
|
+
Note that any configured credentials will be redacted by informative commands
|
372
|
+
such as `bundle config list` or `bundle config get`, unless you use the
|
373
|
+
`--parseable` flag. This is to avoid unintentially leaking credentials when
|
374
|
+
copy-pasting bundler output.
|
375
|
+
|
376
|
+
Also note that to guarantee a sane mapping between valid environment variable
|
377
|
+
names and valid host names, bundler makes the following transformations:
|
378
|
+
|
379
|
+
* Any `-` characters in a host name are mapped to a triple dash (`___`) in the
|
380
|
+
corresponding enviroment variable.
|
381
|
+
|
382
|
+
* Any `.` characters in a host name are mapped to a double dash (`__`) in the
|
383
|
+
corresponding environment variable.
|
384
|
+
|
385
|
+
This means that if you have a gem server named `my.gem-host.com`, you'll need to
|
386
|
+
use the `BUNDLE_MY__GEM___HOST__COM` variable to configure credentials for it
|
387
|
+
through ENV.
|
387
388
|
|
388
389
|
## CONFIGURE BUNDLER DIRECTORIES
|
389
390
|
|
@@ -396,4 +397,3 @@ outlines the available environment variables and their default values
|
|
396
397
|
BUNDLE_USER_CACHE : $BUNDLE_USER_HOME/cache
|
397
398
|
BUNDLE_USER_CONFIG : $BUNDLE_USER_HOME/config
|
398
399
|
BUNDLE_USER_PLUGIN : $BUNDLE_USER_HOME/plugin
|
399
|
-
|
File without changes
|
File without changes
|
@@ -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" "May 2021" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-gem\fR \- Generate a project skeleton for creating a rubygem
|
@@ -64,8 +64,30 @@ Add an MIT license to a \fBLICENSE\.txt\fR file in the root of the generated pro
|
|
64
64
|
Do not create a \fBLICENSE\.txt\fR (overrides \fB\-\-mit\fR specified in the global config)\.
|
65
65
|
.
|
66
66
|
.TP
|
67
|
-
\fB\-t\fR, \fB\-\-test=minitest\fR, \fB\-\-test=rspec\fR
|
68
|
-
Specify the test framework that Bundler should use when generating the project\. Acceptable values are \fBminitest\fR and \
|
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:
|
69
|
+
.
|
70
|
+
.IP
|
71
|
+
When Bundler is configured to generate tests, this defaults to Bundler\'s global config setting \fBgem\.test\fR\.
|
72
|
+
.
|
73
|
+
.IP
|
74
|
+
When Bundler is configured to not generate tests, an interactive prompt will be displayed and the answer will be used for the current rubygem project\.
|
75
|
+
.
|
76
|
+
.IP
|
77
|
+
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
|
+
.
|
79
|
+
.TP
|
80
|
+
\fB\-\-ci\fR, \fB\-\-ci=github\fR, \fB\-\-ci=travis\fR, \fB\-\-ci=gitlab\fR, \fB\-\-ci=circle\fR
|
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:
|
82
|
+
.
|
83
|
+
.IP
|
84
|
+
When Bundler is configured to generate CI files, this defaults to Bundler\'s global config setting \fBgem\.ci\fR\.
|
85
|
+
.
|
86
|
+
.IP
|
87
|
+
When Bundler is configured to not generate CI files, an interactive prompt will be displayed and the answer will be used for the current rubygem project\.
|
88
|
+
.
|
89
|
+
.IP
|
90
|
+
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\.
|
69
91
|
.
|
70
92
|
.TP
|
71
93
|
\fB\-e\fR, \fB\-\-edit[=EDITOR]\fR
|
@@ -60,14 +60,37 @@ configuration file using the following names:
|
|
60
60
|
Do not create a `LICENSE.txt` (overrides `--mit` specified in the global
|
61
61
|
config).
|
62
62
|
|
63
|
-
* `-t`, `--test=minitest`, `--test=rspec`:
|
63
|
+
* `-t`, `--test=minitest`, `--test=rspec`, `--test=test-unit`:
|
64
64
|
Specify the test framework that Bundler should use when generating the
|
65
|
-
project. Acceptable values are `minitest` and `
|
66
|
-
will be configured and a skeleton test/spec directory will
|
67
|
-
on this option.
|
68
|
-
|
69
|
-
|
70
|
-
|
65
|
+
project. Acceptable values are `minitest`, `rspec` and `test-unit`. The
|
66
|
+
`GEM_NAME.gemspec` will be configured and a skeleton test/spec directory will
|
67
|
+
be created based on this option. Given no option is specified:
|
68
|
+
|
69
|
+
When Bundler is configured to generate tests, this defaults to Bundler's
|
70
|
+
global config setting `gem.test`.
|
71
|
+
|
72
|
+
When Bundler is configured to not generate tests, an interactive prompt will
|
73
|
+
be displayed and the answer will be used for the current rubygem project.
|
74
|
+
|
75
|
+
When Bundler is unconfigured, an interactive prompt will be displayed and
|
76
|
+
the answer will be saved in Bundler's global config for future `bundle gem`
|
77
|
+
use.
|
78
|
+
|
79
|
+
* `--ci`, `--ci=github`, `--ci=travis`, `--ci=gitlab`, `--ci=circle`:
|
80
|
+
Specify the continuous integration service that Bundler should use when
|
81
|
+
generating the project. Acceptable values are `github`, `travis`, `gitlab`
|
82
|
+
and `circle`. A configuration file will be generated in the project directory.
|
83
|
+
Given no option is specified:
|
84
|
+
|
85
|
+
When Bundler is configured to generate CI files, this defaults to Bundler's
|
86
|
+
global config setting `gem.ci`.
|
87
|
+
|
88
|
+
When Bundler is configured to not generate CI files, an interactive prompt
|
89
|
+
will be displayed and the answer will be used for the current rubygem project.
|
90
|
+
|
91
|
+
When Bundler is unconfigured, an interactive prompt will be displayed and
|
92
|
+
the answer will be saved in Bundler's global config for future `bundle gem`
|
93
|
+
use.
|
71
94
|
|
72
95
|
* `-e`, `--edit[=EDITOR]`:
|
73
96
|
Open the resulting GEM_NAME.gemspec in EDITOR, or the default editor if not
|
File without changes
|
@@ -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" "May 2021" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-init\fR \- Generates a Gemfile into the current working directory
|
File without changes
|
@@ -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" "May 2021" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-inject\fR \- Add named gem(s) with version requirements to Gemfile
|
File without changes
|
@@ -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" "May 2021" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-install\fR \- Install the dependencies specified in your Gemfile
|
@@ -19,7 +19,7 @@ If a \fBGemfile\.lock\fR does exist, and you have not updated your Gemfile(5), B
|
|
19
19
|
If a \fBGemfile\.lock\fR does exist, and you have updated your Gemfile(5), Bundler will use the dependencies in the \fBGemfile\.lock\fR for all gems that you did not update, but will re\-resolve the dependencies of gems that you did update\. You can find more information about this update process below under \fICONSERVATIVE UPDATING\fR\.
|
20
20
|
.
|
21
21
|
.SH "OPTIONS"
|
22
|
-
|
22
|
+
The \fB\-\-clean\fR, \fB\-\-deployment\fR, \fB\-\-frozen\fR, \fB\-\-no\-prune\fR, \fB\-\-path\fR, \fB\-\-shebang\fR, \fB\-\-system\fR, \fB\-\-without\fR and \fB\-\-with\fR options are deprecated because they only make sense if they are applied to every subsequent \fBbundle install\fR run automatically and that requires \fBbundler\fR to silently remember them\. Since \fBbundler\fR will no longer remember CLI flags in future versions, \fBbundle config\fR (see bundle\-config(1)) should be used to apply them permanently\.
|
23
23
|
.
|
24
24
|
.TP
|
25
25
|
\fB\-\-binstubs[=<directory>]\fR
|
@@ -32,10 +32,16 @@ Creates a directory (defaults to \fB~/bin\fR) and places any executables from th
|
|
32
32
|
\fB\-\-clean\fR
|
33
33
|
On finishing the installation Bundler is going to remove any gems not present in the current Gemfile(5)\. Don\'t worry, gems currently in use will not be removed\.
|
34
34
|
.
|
35
|
+
.IP
|
36
|
+
This option is deprecated in favor of the \fBclean\fR setting\.
|
37
|
+
.
|
35
38
|
.TP
|
36
39
|
\fB\-\-deployment\fR
|
37
40
|
In \fIdeployment mode\fR, Bundler will \'roll\-out\' the bundle for production or CI use\. Please check carefully if you want to have this option enabled in your development environment\.
|
38
41
|
.
|
42
|
+
.IP
|
43
|
+
This option is deprecated in favor of the \fBdeployment\fR setting\.
|
44
|
+
.
|
39
45
|
.TP
|
40
46
|
\fB\-\-redownload\fR
|
41
47
|
Force download every gem, even if the required versions are already available locally\.
|
@@ -44,6 +50,9 @@ Force download every gem, even if the required versions are already available lo
|
|
44
50
|
\fB\-\-frozen\fR
|
45
51
|
Do not allow the Gemfile\.lock to be updated after this install\. Exits non\-zero if there are going to be changes to the Gemfile\.lock\.
|
46
52
|
.
|
53
|
+
.IP
|
54
|
+
This option is deprecated in favor of the \fBfrozen\fR setting\.
|
55
|
+
.
|
47
56
|
.TP
|
48
57
|
\fB\-\-full\-index\fR
|
49
58
|
Bundler will not call Rubygems\' API endpoint (default) but download and cache a (currently big) index file of all gems\. Performance can be improved for large bundles that seldom change by enabling this option\.
|
@@ -58,7 +67,7 @@ The maximum number of parallel download and install jobs\. The default is \fB1\f
|
|
58
67
|
.
|
59
68
|
.TP
|
60
69
|
\fB\-\-local\fR
|
61
|
-
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
|
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\.
|
62
71
|
.
|
63
72
|
.TP
|
64
73
|
\fB\-\-no\-cache\fR
|
@@ -68,10 +77,16 @@ Do not update the cache in \fBvendor/cache\fR with the newly bundled gems\. This
|
|
68
77
|
\fB\-\-no\-prune\fR
|
69
78
|
Don\'t remove stale gems from the cache when the installation finishes\.
|
70
79
|
.
|
80
|
+
.IP
|
81
|
+
This option is deprecated in favor of the \fBno_prune\fR setting\.
|
82
|
+
.
|
71
83
|
.TP
|
72
84
|
\fB\-\-path=<path>\fR
|
73
85
|
The location to install the specified gems to\. This defaults to Rubygems\' setting\. Bundler shares this location with Rubygems, \fBgem install \.\.\.\fR will have gem installed there, too\. Therefore, gems installed without a \fB\-\-path \.\.\.\fR setting will show up by calling \fBgem list\fR\. Accordingly, gems installed to other locations will not get listed\.
|
74
86
|
.
|
87
|
+
.IP
|
88
|
+
This option is deprecated in favor of the \fBpath\fR setting\.
|
89
|
+
.
|
75
90
|
.TP
|
76
91
|
\fB\-\-quiet\fR
|
77
92
|
Do not print progress information to the standard output\. Instead, Bundler will exit using a status code (\fB$?\fR)\.
|
@@ -84,6 +99,9 @@ Retry failed network or git requests for \fInumber\fR times\.
|
|
84
99
|
\fB\-\-shebang=<ruby\-executable>\fR
|
85
100
|
Uses the specified ruby executable (usually \fBruby\fR) to execute the scripts created with \fB\-\-binstubs\fR\. In addition, if you use \fB\-\-binstubs\fR together with \fB\-\-shebang jruby\fR these executables will be changed to execute \fBjruby\fR instead\.
|
86
101
|
.
|
102
|
+
.IP
|
103
|
+
This option is deprecated in favor of the \fBshebang\fR setting\.
|
104
|
+
.
|
87
105
|
.TP
|
88
106
|
\fB\-\-standalone[=<list>]\fR
|
89
107
|
Makes a bundle that can work without depending on Rubygems or Bundler at runtime\. A space separated list of groups to install has to be specified\. Bundler creates a directory named \fBbundle\fR and installs the bundle there\. It also generates a \fBbundle/bundler/setup\.rb\fR file to replace Bundler\'s own setup in the manner required\. Using this option implicitly sets \fBpath\fR, which is a [remembered option][REMEMBERED OPTIONS]\.
|
@@ -92,6 +110,9 @@ Makes a bundle that can work without depending on Rubygems or Bundler at runtime
|
|
92
110
|
\fB\-\-system\fR
|
93
111
|
Installs the gems specified in the bundle to the system\'s Rubygems location\. This overrides any previous configuration of \fB\-\-path\fR\.
|
94
112
|
.
|
113
|
+
.IP
|
114
|
+
This option is deprecated in favor of the \fBsystem\fR setting\.
|
115
|
+
.
|
95
116
|
.TP
|
96
117
|
\fB\-\-trust\-policy=[<policy>]\fR
|
97
118
|
Apply the Rubygems security policy \fIpolicy\fR, where policy is one of \fBHighSecurity\fR, \fBMediumSecurity\fR, \fBLowSecurity\fR, \fBAlmostNoSecurity\fR, or \fBNoSecurity\fR\. For more details, please see the Rubygems signing documentation linked below in \fISEE ALSO\fR\.
|
@@ -100,10 +121,16 @@ Apply the Rubygems security policy \fIpolicy\fR, where policy is one of \fBHighS
|
|
100
121
|
\fB\-\-with=<list>\fR
|
101
122
|
A space\-separated list of groups referencing gems to install\. If an optional group is given it is installed\. If a group is given that is in the remembered list of groups given to \-\-without, it is removed from that list\.
|
102
123
|
.
|
124
|
+
.IP
|
125
|
+
This option is deprecated in favor of the \fBwith\fR setting\.
|
126
|
+
.
|
103
127
|
.TP
|
104
128
|
\fB\-\-without=<list>\fR
|
105
129
|
A space\-separated list of groups referencing gems to skip during installation\. If a group is given that is in the remembered list of groups given to \-\-with, it is removed from that list\.
|
106
130
|
.
|
131
|
+
.IP
|
132
|
+
This option is deprecated in favor of the \fBwithout\fR setting\.
|
133
|
+
.
|
107
134
|
.SH "DEPLOYMENT MODE"
|
108
135
|
Bundler\'s defaults are optimized for development\. To switch to defaults optimized for deployment and for CI, use the \fB\-\-deployment\fR flag\. Do not activate deployment mode on development machines, as it will cause an error when the Gemfile(5) is modified\.
|
109
136
|
.
|
@@ -43,8 +43,12 @@ update process below under [CONSERVATIVE UPDATING][].
|
|
43
43
|
|
44
44
|
## OPTIONS
|
45
45
|
|
46
|
-
|
47
|
-
|
46
|
+
The `--clean`, `--deployment`, `--frozen`, `--no-prune`, `--path`, `--shebang`,
|
47
|
+
`--system`, `--without` and `--with` options are deprecated because they only
|
48
|
+
make sense if they are applied to every subsequent `bundle install` run
|
49
|
+
automatically and that requires `bundler` to silently remember them. Since
|
50
|
+
`bundler` will no longer remember CLI flags in future versions, `bundle config`
|
51
|
+
(see bundle-config(1)) should be used to apply them permanently.
|
48
52
|
|
49
53
|
* `--binstubs[=<directory>]`:
|
50
54
|
Binstubs are scripts that wrap around executables. Bundler creates a small Ruby
|
@@ -64,11 +68,15 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
64
68
|
in the current Gemfile(5). Don't worry, gems currently in use will not be
|
65
69
|
removed.
|
66
70
|
|
71
|
+
This option is deprecated in favor of the `clean` setting.
|
72
|
+
|
67
73
|
* `--deployment`:
|
68
74
|
In [deployment mode][DEPLOYMENT MODE], Bundler will 'roll-out' the bundle for
|
69
75
|
production or CI use. Please check carefully if you want to have this option
|
70
76
|
enabled in your development environment.
|
71
77
|
|
78
|
+
This option is deprecated in favor of the `deployment` setting.
|
79
|
+
|
72
80
|
* `--redownload`:
|
73
81
|
Force download every gem, even if the required versions are already available
|
74
82
|
locally.
|
@@ -77,6 +85,8 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
77
85
|
Do not allow the Gemfile.lock to be updated after this install. Exits
|
78
86
|
non-zero if there are going to be changes to the Gemfile.lock.
|
79
87
|
|
88
|
+
This option is deprecated in favor of the `frozen` setting.
|
89
|
+
|
80
90
|
* `--full-index`:
|
81
91
|
Bundler will not call Rubygems' API endpoint (default) but download and cache
|
82
92
|
a (currently big) index file of all gems. Performance can be improved for
|
@@ -95,7 +105,7 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
95
105
|
|
96
106
|
* `--local`:
|
97
107
|
Do not attempt to connect to `rubygems.org`. Instead, Bundler will use the
|
98
|
-
gems already present in Rubygems' cache or in `vendor/cache`. Note that if
|
108
|
+
gems already present in Rubygems' cache or in `vendor/cache`. Note that if an
|
99
109
|
appropriate platform-specific gem exists on `rubygems.org` it will not be
|
100
110
|
found.
|
101
111
|
|
@@ -107,6 +117,8 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
107
117
|
* `--no-prune`:
|
108
118
|
Don't remove stale gems from the cache when the installation finishes.
|
109
119
|
|
120
|
+
This option is deprecated in favor of the `no_prune` setting.
|
121
|
+
|
110
122
|
* `--path=<path>`:
|
111
123
|
The location to install the specified gems to. This defaults to Rubygems'
|
112
124
|
setting. Bundler shares this location with Rubygems, `gem install ...` will
|
@@ -114,6 +126,8 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
114
126
|
`--path ...` setting will show up by calling `gem list`. Accordingly, gems
|
115
127
|
installed to other locations will not get listed.
|
116
128
|
|
129
|
+
This option is deprecated in favor of the `path` setting.
|
130
|
+
|
117
131
|
* `--quiet`:
|
118
132
|
Do not print progress information to the standard output. Instead, Bundler
|
119
133
|
will exit using a status code (`$?`).
|
@@ -127,6 +141,8 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
127
141
|
`--shebang jruby` these executables will be changed to execute `jruby`
|
128
142
|
instead.
|
129
143
|
|
144
|
+
This option is deprecated in favor of the `shebang` setting.
|
145
|
+
|
130
146
|
* `--standalone[=<list>]`:
|
131
147
|
Makes a bundle that can work without depending on Rubygems or Bundler at
|
132
148
|
runtime. A space separated list of groups to install has to be specified.
|
@@ -139,6 +155,8 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
139
155
|
Installs the gems specified in the bundle to the system's Rubygems location.
|
140
156
|
This overrides any previous configuration of `--path`.
|
141
157
|
|
158
|
+
This option is deprecated in favor of the `system` setting.
|
159
|
+
|
142
160
|
* `--trust-policy=[<policy>]`:
|
143
161
|
Apply the Rubygems security policy <policy>, where policy is one of
|
144
162
|
`HighSecurity`, `MediumSecurity`, `LowSecurity`, `AlmostNoSecurity`, or
|
@@ -151,11 +169,15 @@ time `bundle install` is run, use `bundle config` (see bundle-config(1)).
|
|
151
169
|
in the remembered list of groups given to --without, it is removed
|
152
170
|
from that list.
|
153
171
|
|
172
|
+
This option is deprecated in favor of the `with` setting.
|
173
|
+
|
154
174
|
* `--without=<list>`:
|
155
175
|
A space-separated list of groups referencing gems to skip during installation.
|
156
176
|
If a group is given that is in the remembered list of groups given
|
157
177
|
to --with, it is removed from that list.
|
158
178
|
|
179
|
+
This option is deprecated in favor of the `without` setting.
|
180
|
+
|
159
181
|
## DEPLOYMENT MODE
|
160
182
|
|
161
183
|
Bundler's defaults are optimized for development. To switch to
|
@@ -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\-LIST" "1" "
|
4
|
+
.TH "BUNDLE\-LIST" "1" "May 2021" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-list\fR \- List all the gems in the bundle
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
-
\fBbundle list\fR [\-\-name\-only] [\-\-paths] [\-\-without\-group=GROUP] [\-\-only\-group=GROUP]
|
10
|
+
\fBbundle list\fR [\-\-name\-only] [\-\-paths] [\-\-without\-group=GROUP[ GROUP\.\.\.]] [\-\-only\-group=GROUP[ GROUP\.\.\.]]
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
13
|
Prints a list of all the gems in the bundle including their version\.
|
@@ -28,7 +28,7 @@ bundle list \-\-without\-group test
|
|
28
28
|
bundle list \-\-only\-group dev
|
29
29
|
.
|
30
30
|
.P
|
31
|
-
bundle list \-\-only\-group dev \-\-paths
|
31
|
+
bundle list \-\-only\-group dev test \-\-paths
|
32
32
|
.
|
33
33
|
.SH "OPTIONS"
|
34
34
|
.
|
@@ -41,10 +41,10 @@ Print only the name of each gem\.
|
|
41
41
|
Print the path to each gem in the bundle\.
|
42
42
|
.
|
43
43
|
.TP
|
44
|
-
\fB\-\-without\-group
|
45
|
-
|
44
|
+
\fB\-\-without\-group=<list>\fR
|
45
|
+
A space\-separated list of groups of gems to skip during printing\.
|
46
46
|
.
|
47
47
|
.TP
|
48
|
-
\fB\-\-only\-group
|
49
|
-
|
48
|
+
\fB\-\-only\-group=<list>\fR
|
49
|
+
A space\-separated list of groups of gems to print\.
|
50
50
|
|