bundler 1.17.2 → 2.1.0
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 +799 -571
- data/LICENSE.md +18 -19
- data/README.md +9 -8
- data/bundler.gemspec +8 -25
- data/exe/bundle +19 -3
- data/lib/bundler.rb +202 -87
- data/lib/bundler/build_metadata.rb +3 -3
- data/lib/bundler/capistrano.rb +4 -4
- data/lib/bundler/cli.rb +178 -140
- data/lib/bundler/cli/add.rb +28 -16
- data/lib/bundler/cli/cache.rb +25 -13
- data/lib/bundler/cli/common.rb +11 -12
- data/lib/bundler/cli/config.rb +161 -86
- data/lib/bundler/cli/console.rb +1 -1
- data/lib/bundler/cli/doctor.rb +4 -4
- data/lib/bundler/cli/exec.rb +15 -18
- data/lib/bundler/cli/gem.rb +5 -5
- data/lib/bundler/cli/info.rb +17 -5
- data/lib/bundler/cli/init.rb +1 -1
- data/lib/bundler/cli/install.rb +11 -10
- data/lib/bundler/cli/issue.rb +3 -3
- data/lib/bundler/cli/open.rb +10 -6
- data/lib/bundler/cli/outdated.rb +85 -81
- data/lib/bundler/cli/plugin.rb +9 -2
- data/lib/bundler/cli/pristine.rb +1 -1
- data/lib/bundler/cli/show.rb +1 -1
- data/lib/bundler/cli/update.rb +32 -12
- data/lib/bundler/compact_index_client.rb +25 -9
- data/lib/bundler/compact_index_client/updater.rb +2 -6
- data/lib/bundler/current_ruby.rb +9 -7
- data/lib/bundler/definition.rb +35 -26
- data/lib/bundler/dependency.rb +16 -4
- data/lib/bundler/deployment.rb +1 -1
- data/lib/bundler/dsl.rb +16 -40
- data/lib/bundler/env.rb +8 -13
- data/lib/bundler/environment_preserver.rb +0 -1
- data/lib/bundler/feature_flag.rb +23 -34
- data/lib/bundler/fetcher.rb +16 -13
- data/lib/bundler/fetcher/compact_index.rb +26 -12
- data/lib/bundler/fetcher/dependency.rb +1 -1
- data/lib/bundler/fetcher/downloader.rb +5 -2
- data/lib/bundler/fetcher/index.rb +5 -3
- data/lib/bundler/friendly_errors.rb +6 -7
- data/lib/bundler/gem_helper.rb +40 -25
- data/lib/bundler/gem_helpers.rb +2 -4
- data/lib/bundler/gem_tasks.rb +1 -1
- data/lib/bundler/gem_version_promoter.rb +3 -3
- data/lib/bundler/graph.rb +2 -2
- data/lib/bundler/injector.rb +10 -8
- data/lib/bundler/inline.rb +40 -30
- data/lib/bundler/installer.rb +7 -14
- data/lib/bundler/installer/gem_installer.rb +5 -1
- data/lib/bundler/installer/parallel_installer.rb +4 -8
- data/lib/bundler/installer/standalone.rb +1 -2
- data/lib/bundler/lazy_specification.rb +2 -3
- data/lib/bundler/lockfile_parser.rb +14 -21
- data/lib/bundler/match_platform.rb +1 -1
- data/lib/bundler/mirror.rb +3 -3
- data/lib/bundler/plugin.rb +42 -29
- data/lib/bundler/plugin/api.rb +1 -1
- data/lib/bundler/plugin/api/source.rb +4 -6
- data/lib/bundler/plugin/index.rb +14 -3
- data/lib/bundler/plugin/installer.rb +28 -15
- data/lib/bundler/psyched_yaml.rb +1 -1
- data/lib/bundler/remote_specification.rb +0 -2
- data/lib/bundler/resolver.rb +72 -24
- data/lib/bundler/resolver/spec_group.rb +3 -2
- data/lib/bundler/retry.rb +2 -2
- data/lib/bundler/ruby_version.rb +4 -19
- data/lib/bundler/rubygems_ext.rb +11 -67
- data/lib/bundler/rubygems_gem_installer.rb +1 -1
- data/lib/bundler/rubygems_integration.rb +142 -402
- data/lib/bundler/runtime.rb +2 -9
- data/lib/bundler/settings.rb +22 -51
- data/lib/bundler/setup.rb +7 -13
- data/lib/bundler/shared_helpers.rb +51 -77
- data/lib/bundler/similarity_detector.rb +2 -2
- data/lib/bundler/source.rb +5 -5
- data/lib/bundler/source/git.rb +24 -17
- data/lib/bundler/source/git/git_proxy.rb +38 -41
- data/lib/bundler/source/metadata.rb +9 -5
- data/lib/bundler/source/path.rb +13 -8
- data/lib/bundler/source/rubygems.rb +14 -8
- data/lib/bundler/source/rubygems/remote.rb +2 -3
- data/lib/bundler/source_list.rb +9 -12
- data/lib/bundler/spec_set.rb +23 -12
- data/lib/bundler/stub_specification.rb +18 -30
- data/lib/bundler/templates/Executable.bundler +23 -14
- data/lib/bundler/templates/newgem/CODE_OF_CONDUCT.md.tt +3 -3
- data/lib/bundler/templates/newgem/Gemfile.tt +8 -2
- data/lib/bundler/templates/newgem/README.md.tt +4 -3
- data/lib/bundler/templates/newgem/newgem.gemspec.tt +6 -27
- data/lib/bundler/templates/newgem/test/test_helper.rb.tt +1 -1
- data/lib/bundler/templates/newgem/travis.yml.tt +0 -1
- data/lib/bundler/ui.rb +3 -3
- data/lib/bundler/ui/rg_proxy.rb +1 -1
- data/lib/bundler/ui/shell.rb +4 -8
- data/lib/bundler/uri_credentials_filter.rb +7 -3
- data/lib/bundler/vendor/connection_pool/lib/connection_pool.rb +161 -0
- data/lib/bundler/vendor/connection_pool/lib/connection_pool/monotonic_time.rb +66 -0
- data/lib/bundler/vendor/connection_pool/lib/connection_pool/timed_stack.rb +176 -0
- data/lib/bundler/vendor/connection_pool/lib/connection_pool/version.rb +3 -0
- data/lib/bundler/vendor/fileutils/lib/fileutils.rb +273 -147
- data/lib/bundler/vendor/molinillo/lib/molinillo.rb +6 -6
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +2 -2
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/log.rb +6 -6
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/set_payload.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +30 -8
- data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +1 -1
- data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +4 -4
- data/lib/bundler/vendor/molinillo/lib/molinillo/resolver.rb +2 -2
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +273 -304
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent/connection.rb +40 -0
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent/pool.rb +53 -0
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent/timed_stack_multi.rb +79 -0
- data/lib/bundler/vendor/thor/lib/thor.rb +19 -4
- data/lib/bundler/vendor/thor/lib/thor/actions.rb +27 -12
- data/lib/bundler/vendor/thor/lib/thor/actions/create_file.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor/actions/create_link.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor/actions/directory.rb +7 -17
- data/lib/bundler/vendor/thor/lib/thor/actions/file_manipulation.rb +16 -7
- data/lib/bundler/vendor/thor/lib/thor/actions/inject_into_file.rb +19 -8
- data/lib/bundler/vendor/thor/lib/thor/base.rb +54 -43
- data/lib/bundler/vendor/thor/lib/thor/command.rb +21 -14
- data/lib/bundler/vendor/thor/lib/thor/error.rb +78 -0
- data/lib/bundler/vendor/thor/lib/thor/group.rb +3 -3
- data/lib/bundler/vendor/thor/lib/thor/invocation.rb +1 -0
- data/lib/bundler/vendor/thor/lib/thor/line_editor.rb +2 -2
- data/lib/bundler/vendor/thor/lib/thor/line_editor/basic.rb +1 -1
- data/lib/bundler/vendor/thor/lib/thor/line_editor/readline.rb +6 -6
- data/lib/bundler/vendor/thor/lib/thor/nested_context.rb +29 -0
- data/lib/bundler/vendor/thor/lib/thor/parser.rb +4 -4
- data/lib/bundler/vendor/thor/lib/thor/parser/arguments.rb +2 -2
- data/lib/bundler/vendor/thor/lib/thor/parser/option.rb +20 -7
- data/lib/bundler/vendor/thor/lib/thor/parser/options.rb +20 -5
- data/lib/bundler/vendor/thor/lib/thor/rake_compat.rb +1 -0
- data/lib/bundler/vendor/thor/lib/thor/runner.rb +15 -14
- data/lib/bundler/vendor/thor/lib/thor/shell.rb +4 -4
- data/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +62 -8
- data/lib/bundler/vendor/thor/lib/thor/shell/color.rb +6 -2
- data/lib/bundler/vendor/thor/lib/thor/shell/html.rb +3 -3
- data/lib/bundler/vendor/thor/lib/thor/util.rb +18 -2
- data/lib/bundler/vendor/thor/lib/thor/version.rb +1 -1
- data/lib/bundler/vendor/uri/lib/uri.rb +104 -0
- data/lib/bundler/vendor/uri/lib/uri/common.rb +744 -0
- data/lib/bundler/vendor/uri/lib/uri/file.rb +94 -0
- data/lib/bundler/vendor/uri/lib/uri/ftp.rb +267 -0
- data/lib/bundler/vendor/uri/lib/uri/generic.rb +1568 -0
- data/lib/bundler/vendor/uri/lib/uri/http.rb +88 -0
- data/lib/bundler/vendor/uri/lib/uri/https.rb +23 -0
- data/lib/bundler/vendor/uri/lib/uri/ldap.rb +261 -0
- data/lib/bundler/vendor/uri/lib/uri/ldaps.rb +21 -0
- data/lib/bundler/vendor/uri/lib/uri/mailto.rb +294 -0
- data/lib/bundler/vendor/uri/lib/uri/rfc2396_parser.rb +546 -0
- data/lib/bundler/vendor/uri/lib/uri/rfc3986_parser.rb +125 -0
- data/lib/bundler/vendor/uri/lib/uri/version.rb +6 -0
- data/lib/bundler/vendored_fileutils.rb +1 -6
- data/lib/bundler/vendored_molinillo.rb +1 -1
- data/lib/bundler/vendored_persistent.rb +7 -5
- data/lib/bundler/vendored_thor.rb +2 -2
- data/lib/bundler/vendored_uri.rb +4 -0
- data/lib/bundler/version.rb +1 -20
- data/lib/bundler/version_ranges.rb +51 -5
- data/lib/bundler/vlad.rb +2 -2
- data/lib/bundler/worker.rb +1 -3
- data/lib/bundler/yaml_serializer.rb +2 -3
- data/man/bundle-add.1 +10 -2
- data/man/bundle-add.1.txt +11 -5
- data/man/bundle-add.ronn +7 -1
- data/man/bundle-binstubs.1 +2 -2
- data/man/bundle-binstubs.1.txt +2 -2
- data/man/bundle-binstubs.ronn +1 -1
- data/man/bundle-cache.1 +55 -0
- data/man/bundle-cache.1.txt +78 -0
- data/man/{bundle-package.ronn → bundle-cache.ronn} +15 -15
- data/man/bundle-check.1 +1 -1
- data/man/bundle-check.1.txt +6 -6
- data/man/bundle-clean.1 +1 -1
- data/man/bundle-clean.1.txt +1 -1
- data/man/bundle-config.1 +36 -36
- data/man/bundle-config.1.txt +66 -67
- data/man/bundle-config.ronn +42 -40
- data/man/bundle-doctor.1 +1 -1
- data/man/bundle-doctor.1.txt +1 -1
- data/man/bundle-exec.1 +2 -2
- data/man/bundle-exec.1.txt +2 -2
- data/man/bundle-exec.ronn +1 -1
- data/man/bundle-gem.1 +1 -1
- data/man/bundle-gem.1.txt +3 -3
- data/man/bundle-info.1 +1 -1
- data/man/bundle-info.1.txt +1 -1
- data/man/bundle-init.1 +2 -2
- data/man/bundle-init.1.txt +2 -2
- data/man/bundle-init.ronn +1 -1
- data/man/bundle-inject.1 +1 -1
- data/man/bundle-inject.1.txt +1 -1
- data/man/bundle-install.1 +8 -5
- data/man/bundle-install.1.txt +56 -51
- data/man/bundle-install.ronn +9 -4
- data/man/bundle-list.1 +1 -1
- data/man/bundle-list.1.txt +1 -1
- data/man/bundle-lock.1 +1 -1
- data/man/bundle-lock.1.txt +16 -16
- data/man/bundle-open.1 +1 -1
- data/man/bundle-open.1.txt +1 -1
- data/man/bundle-outdated.1 +1 -1
- data/man/bundle-outdated.1.txt +1 -1
- data/man/bundle-platform.1 +1 -1
- data/man/bundle-platform.1.txt +1 -1
- data/man/bundle-pristine.1 +1 -1
- data/man/bundle-pristine.1.txt +1 -1
- data/man/bundle-remove.1 +1 -1
- data/man/bundle-remove.1.txt +1 -1
- data/man/bundle-show.1 +1 -1
- data/man/bundle-show.1.txt +1 -1
- data/man/bundle-update.1 +4 -4
- data/man/bundle-update.1.txt +64 -65
- data/man/bundle-update.ronn +3 -3
- data/man/bundle-viz.1 +1 -1
- data/man/bundle-viz.1.txt +1 -1
- data/man/bundle.1 +7 -3
- data/man/bundle.1.txt +11 -8
- data/man/bundle.ronn +5 -2
- data/man/gemfile.5 +17 -20
- data/man/gemfile.5.ronn +14 -18
- data/man/gemfile.5.txt +108 -112
- data/man/index.txt +1 -1
- metadata +34 -110
- data/exe/bundle_ruby +0 -60
- data/lib/bundler/cli/package.rb +0 -49
- data/lib/bundler/compatibility_guard.rb +0 -14
- data/lib/bundler/gem_remote_fetcher.rb +0 -43
- data/lib/bundler/ssl_certs/.document +0 -1
- data/lib/bundler/ssl_certs/certificate_manager.rb +0 -66
- data/lib/bundler/ssl_certs/index.rubygems.org/GlobalSignRootCA.pem +0 -21
- data/lib/bundler/ssl_certs/rubygems.global.ssl.fastly.net/DigiCertHighAssuranceEVRootCA.pem +0 -23
- data/lib/bundler/ssl_certs/rubygems.org/AddTrustExternalCARoot.pem +0 -25
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/faster.rb +0 -27
- data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent/ssl_reuse.rb +0 -129
- data/lib/bundler/vendor/thor/lib/thor/core_ext/io_binary_read.rb +0 -12
- data/lib/bundler/vendor/thor/lib/thor/core_ext/ordered_hash.rb +0 -129
- data/man/bundle-package.1 +0 -55
- data/man/bundle-package.1.txt +0 -79
data/man/bundle-update.ronn
CHANGED
@@ -12,8 +12,8 @@ bundle-update(1) -- Update your gems to the latest available versions
|
|
12
12
|
[--full-index]
|
13
13
|
[--jobs=JOBS]
|
14
14
|
[--quiet]
|
15
|
-
[--force]
|
16
15
|
[--patch|--minor|--major]
|
16
|
+
[--redownload]
|
17
17
|
[--strict]
|
18
18
|
[--conservative]
|
19
19
|
|
@@ -64,8 +64,8 @@ gem.
|
|
64
64
|
* `--quiet`:
|
65
65
|
Only output warnings and errors.
|
66
66
|
|
67
|
-
* `--
|
68
|
-
Force downloading every gem.
|
67
|
+
* `--redownload`:
|
68
|
+
Force downloading every gem.
|
69
69
|
|
70
70
|
* `--patch`:
|
71
71
|
Prefer updating only to next patch version.
|
data/man/bundle-viz.1
CHANGED
@@ -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" "
|
4
|
+
.TH "BUNDLE\-VIZ" "1" "December 2019" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-viz\fR \- Generates a visual dependency graph for your Gemfile
|
data/man/bundle-viz.1.txt
CHANGED
data/man/bundle.1
CHANGED
@@ -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" "
|
4
|
+
.TH "BUNDLE" "1" "December 2019" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\fR \- Ruby Dependency Management
|
@@ -13,7 +13,7 @@
|
|
13
13
|
Bundler manages an \fBapplication\'s dependencies\fR through its entire life across many machines systematically and repeatably\.
|
14
14
|
.
|
15
15
|
.P
|
16
|
-
See the bundler website \
|
16
|
+
See the bundler website \fIhttps://bundler\.io\fR for information on getting started, and Gemfile(5) for more information on the \fBGemfile\fR format\.
|
17
17
|
.
|
18
18
|
.SH "OPTIONS"
|
19
19
|
.
|
@@ -89,7 +89,7 @@ Start an IRB session in the current bundle
|
|
89
89
|
Open an installed gem in the editor
|
90
90
|
.
|
91
91
|
.TP
|
92
|
-
\fBbundle lock(1)\fR \fIbundle\-lock\.1\.
|
92
|
+
\fBbundle lock(1)\fR \fIbundle\-lock\.1\.html\fR
|
93
93
|
Generate a lockfile for your dependencies
|
94
94
|
.
|
95
95
|
.TP
|
@@ -116,6 +116,10 @@ Clean up unused gems in your Bundler directory
|
|
116
116
|
\fBbundle doctor(1)\fR \fIbundle\-doctor\.1\.html\fR
|
117
117
|
Display warnings about common problems
|
118
118
|
.
|
119
|
+
.TP
|
120
|
+
\fBbundle remove(1)\fR \fIbundle\-remove\.1\.html\fR
|
121
|
+
Removes gems from the Gemfile
|
122
|
+
.
|
119
123
|
.SH "PLUGINS"
|
120
124
|
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\.
|
121
125
|
.
|
data/man/bundle.1.txt
CHANGED
@@ -12,7 +12,7 @@ DESCRIPTION
|
|
12
12
|
Bundler manages an application's dependencies through its entire life
|
13
13
|
across many machines systematically and repeatably.
|
14
14
|
|
15
|
-
See the bundler website
|
15
|
+
See the bundler website https://bundler.io for information on getting
|
16
16
|
started, and Gemfile(5) for more information on the Gemfile format.
|
17
17
|
|
18
18
|
OPTIONS
|
@@ -36,7 +36,7 @@ PRIMARY COMMANDS
|
|
36
36
|
Update dependencies to their latest versions
|
37
37
|
|
38
38
|
bundle package(1) bundle-package.1.html
|
39
|
-
Package
|
39
|
+
Package the .gem files required by your application into the
|
40
40
|
vendor/cache directory
|
41
41
|
|
42
42
|
bundle exec(1) bundle-exec.1.html
|
@@ -56,7 +56,7 @@ UTILITIES
|
|
56
56
|
Generate binstubs for executables in a gem
|
57
57
|
|
58
58
|
bundle check(1) bundle-check.1.html
|
59
|
-
Determine
|
59
|
+
Determine whether the requirements for your application are
|
60
60
|
installed and available to Bundler
|
61
61
|
|
62
62
|
bundle show(1) bundle-show.1.html
|
@@ -71,7 +71,7 @@ UTILITIES
|
|
71
71
|
bundle open(1) bundle-open.1.html
|
72
72
|
Open an installed gem in the editor
|
73
73
|
|
74
|
-
bundle lock(1) bundle-lock.1.
|
74
|
+
bundle lock(1) bundle-lock.1.html
|
75
75
|
Generate a lockfile for your dependencies
|
76
76
|
|
77
77
|
bundle viz(1) bundle-viz.1.html
|
@@ -92,10 +92,13 @@ UTILITIES
|
|
92
92
|
bundle doctor(1) bundle-doctor.1.html
|
93
93
|
Display warnings about common problems
|
94
94
|
|
95
|
+
bundle remove(1) bundle-remove.1.html
|
96
|
+
Removes gems from the Gemfile
|
97
|
+
|
95
98
|
PLUGINS
|
96
|
-
When
|
97
|
-
TIES,
|
98
|
-
bundler-<command>
|
99
|
+
When running a command that isn't listed in PRIMARY COMMANDS or UTILI-
|
100
|
+
TIES, Bundler will try to find an executable on your path named
|
101
|
+
bundler-<command> and execute it, passing down any extra arguments to
|
99
102
|
it.
|
100
103
|
|
101
104
|
OBSOLETE
|
@@ -110,4 +113,4 @@ OBSOLETE
|
|
110
113
|
|
111
114
|
|
112
115
|
|
113
|
-
|
116
|
+
December 2019 BUNDLE(1)
|
data/man/bundle.ronn
CHANGED
@@ -10,7 +10,7 @@ bundle(1) -- Ruby Dependency Management
|
|
10
10
|
Bundler manages an `application's dependencies` through its entire life
|
11
11
|
across many machines systematically and repeatably.
|
12
12
|
|
13
|
-
See [the bundler website](
|
13
|
+
See [the bundler website](https://bundler.io) for information on getting
|
14
14
|
started, and Gemfile(5) for more information on the `Gemfile` format.
|
15
15
|
|
16
16
|
## OPTIONS
|
@@ -73,7 +73,7 @@ We divide `bundle` subcommands into primary commands and utilities:
|
|
73
73
|
* [`bundle open(1)`](bundle-open.1.html):
|
74
74
|
Open an installed gem in the editor
|
75
75
|
|
76
|
-
* [`bundle lock(1)`](bundle-lock.1.
|
76
|
+
* [`bundle lock(1)`](bundle-lock.1.html):
|
77
77
|
Generate a lockfile for your dependencies
|
78
78
|
|
79
79
|
* [`bundle viz(1)`](bundle-viz.1.html):
|
@@ -94,6 +94,9 @@ We divide `bundle` subcommands into primary commands and utilities:
|
|
94
94
|
* [`bundle doctor(1)`](bundle-doctor.1.html):
|
95
95
|
Display warnings about common problems
|
96
96
|
|
97
|
+
* [`bundle remove(1)`](bundle-remove.1.html):
|
98
|
+
Removes gems from the Gemfile
|
99
|
+
|
97
100
|
## PLUGINS
|
98
101
|
|
99
102
|
When running a command that isn't listed in PRIMARY COMMANDS or UTILITIES,
|
data/man/gemfile.5
CHANGED
@@ -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 "GEMFILE" "5" "
|
4
|
+
.TH "GEMFILE" "5" "December 2019" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBGemfile\fR \- A format for describing gem dependencies for Ruby programs
|
@@ -158,7 +158,7 @@ Each \fIgem\fR \fBMAY\fR specify files that should be used when autorequiring vi
|
|
158
158
|
|
159
159
|
gem "redis", :require => ["redis/connection/hiredis", "redis"]
|
160
160
|
gem "webmock", :require => false
|
161
|
-
gem "
|
161
|
+
gem "byebug", :require => true
|
162
162
|
.
|
163
163
|
.fi
|
164
164
|
.
|
@@ -218,27 +218,27 @@ Bundler\.require(:test) # requires the _test_ group
|
|
218
218
|
.IP "" 0
|
219
219
|
.
|
220
220
|
.P
|
221
|
-
The Bundler CLI allows you to specify a list of groups whose gems \fBbundle install\fR should not install with the \
|
221
|
+
The Bundler CLI allows you to specify a list of groups whose gems \fBbundle install\fR should not install with the \fBwithout\fR configuration\.
|
222
|
+
.
|
223
|
+
.P
|
224
|
+
To specify multiple groups to ignore, specify a list of groups separated by spaces\.
|
222
225
|
.
|
223
226
|
.IP "" 4
|
224
227
|
.
|
225
228
|
.nf
|
226
229
|
|
227
|
-
bundle
|
228
|
-
bundle
|
230
|
+
bundle config set without test
|
231
|
+
bundle config set without development test
|
229
232
|
.
|
230
233
|
.fi
|
231
234
|
.
|
232
235
|
.IP "" 0
|
233
236
|
.
|
234
237
|
.P
|
235
|
-
After running \fBbundle install \-\-without test\fR, bundler will remember that you excluded the test group in the last installation\. The next time you run \fBbundle install\fR, without any \fB\-\-without option\fR, bundler will recall it\.
|
236
|
-
.
|
237
|
-
.P
|
238
238
|
Also, calling \fBBundler\.setup\fR with no parameters, or calling \fBrequire "bundler/setup"\fR will setup all groups except for the ones you excluded via \fB\-\-without\fR (since they are not available)\.
|
239
239
|
.
|
240
240
|
.P
|
241
|
-
Note that on \fBbundle install\fR, bundler downloads and evaluates all gems, in order to create a single canonical list of all of the required gems and their dependencies\. This means that you cannot list different versions of the same gems in different groups\. For more details, see Understanding Bundler \
|
241
|
+
Note that on \fBbundle install\fR, bundler downloads and evaluates all gems, in order to create a single canonical list of all of the required gems and their dependencies\. This means that you cannot list different versions of the same gems in different groups\. For more details, see Understanding Bundler \fIhttps://bundler\.io/rationale\.html\fR\.
|
242
242
|
.
|
243
243
|
.SS "PLATFORMS"
|
244
244
|
If a gem should only be used in a particular platform or set of platforms, you can specify them\. Platforms are essentially identical to groups, except that you do not need to use the \fB\-\-without\fR install\-time flag to exclude groups of gems for other platforms\.
|
@@ -299,19 +299,19 @@ The full list of platforms and supported versions includes:
|
|
299
299
|
.
|
300
300
|
.TP
|
301
301
|
\fBruby\fR
|
302
|
-
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5
|
302
|
+
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5, 2\.6
|
303
303
|
.
|
304
304
|
.TP
|
305
305
|
\fBmri\fR
|
306
|
-
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5
|
306
|
+
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5, 2\.6
|
307
307
|
.
|
308
308
|
.TP
|
309
309
|
\fBmingw\fR
|
310
|
-
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5
|
310
|
+
1\.8, 1\.9, 2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5, 2\.6
|
311
311
|
.
|
312
312
|
.TP
|
313
313
|
\fBx64_mingw\fR
|
314
|
-
2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5
|
314
|
+
2\.0, 2\.1, 2\.2, 2\.3, 2\.4, 2\.5, 2\.6
|
315
315
|
.
|
316
316
|
.P
|
317
317
|
As with groups, you can specify one or more platforms:
|
@@ -409,19 +409,16 @@ Git repositories support a number of additional options\.
|
|
409
409
|
.
|
410
410
|
.TP
|
411
411
|
\fBbranch\fR, \fBtag\fR, and \fBref\fR
|
412
|
-
You \fBMUST\fR only specify at most one of these options\. The default is \fB:branch => "master"\fR
|
413
|
-
.
|
414
|
-
.TP
|
415
|
-
For example:
|
412
|
+
You \fBMUST\fR only specify at most one of these options\. The default is \fB:branch => "master"\fR\. For example:
|
416
413
|
.
|
417
414
|
.IP
|
418
|
-
git "https://github\.com/rails/rails\.git", :branch => "5\-0\-stable"
|
415
|
+
gem "rails", :git => "https://github\.com/rails/rails\.git", :branch => "5\-0\-stable"
|
419
416
|
.
|
420
417
|
.IP
|
421
|
-
git "https://github\.com/rails/rails\.git", :tag => "v5\.0\.0"
|
418
|
+
gem "rails", :git => "https://github\.com/rails/rails\.git", :tag => "v5\.0\.0"
|
422
419
|
.
|
423
420
|
.IP
|
424
|
-
git "https://github\.com/rails/rails\.git", :ref => "4aded"
|
421
|
+
gem "rails", :git => "https://github\.com/rails/rails\.git", :ref => "4aded"
|
425
422
|
.
|
426
423
|
.TP
|
427
424
|
\fBsubmodules\fR
|
data/man/gemfile.5.ronn
CHANGED
@@ -126,7 +126,7 @@ prevent any file from being autorequired.
|
|
126
126
|
|
127
127
|
gem "redis", :require => ["redis/connection/hiredis", "redis"]
|
128
128
|
gem "webmock", :require => false
|
129
|
-
gem "
|
129
|
+
gem "byebug", :require => true
|
130
130
|
|
131
131
|
The argument defaults to the name of the gem. For example, these are identical:
|
132
132
|
|
@@ -159,15 +159,12 @@ The Bundler runtime allows its two main methods, `Bundler.setup` and
|
|
159
159
|
Bundler.require(:test) # requires the _test_ group
|
160
160
|
|
161
161
|
The Bundler CLI allows you to specify a list of groups whose gems `bundle install` should
|
162
|
-
not install with the
|
163
|
-
list of groups separated by spaces.
|
162
|
+
not install with the `without` configuration.
|
164
163
|
|
165
|
-
|
166
|
-
bundle install --without development test
|
164
|
+
To specify multiple groups to ignore, specify a list of groups separated by spaces.
|
167
165
|
|
168
|
-
|
169
|
-
|
170
|
-
without any `--without option`, bundler will recall it.
|
166
|
+
bundle config set without test
|
167
|
+
bundle config set without development test
|
171
168
|
|
172
169
|
Also, calling `Bundler.setup` with no parameters, or calling `require "bundler/setup"`
|
173
170
|
will setup all groups except for the ones you excluded via `--without` (since they
|
@@ -176,7 +173,7 @@ are not available).
|
|
176
173
|
Note that on `bundle install`, bundler downloads and evaluates all gems, in order to
|
177
174
|
create a single canonical list of all of the required gems and their dependencies.
|
178
175
|
This means that you cannot list different versions of the same gems in different
|
179
|
-
groups. For more details, see [Understanding Bundler](
|
176
|
+
groups. For more details, see [Understanding Bundler](https://bundler.io/rationale.html).
|
180
177
|
|
181
178
|
### PLATFORMS
|
182
179
|
|
@@ -216,13 +213,13 @@ used on platforms with Ruby 2.3, use:
|
|
216
213
|
The full list of platforms and supported versions includes:
|
217
214
|
|
218
215
|
* `ruby`:
|
219
|
-
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
216
|
+
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
220
217
|
* `mri`:
|
221
|
-
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
218
|
+
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
222
219
|
* `mingw`:
|
223
|
-
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
220
|
+
1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
224
221
|
* `x64_mingw`:
|
225
|
-
2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
222
|
+
2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
226
223
|
|
227
224
|
As with groups, you can specify one or more platforms:
|
228
225
|
|
@@ -310,14 +307,13 @@ Git repositories support a number of additional options.
|
|
310
307
|
|
311
308
|
* `branch`, `tag`, and `ref`:
|
312
309
|
You `MUST` only specify at most one of these options. The default
|
313
|
-
is `:branch => "master"
|
314
|
-
* For example:
|
310
|
+
is `:branch => "master"`. For example:
|
315
311
|
|
316
|
-
git "https://github.com/rails/rails.git", :branch => "5-0-stable"
|
312
|
+
gem "rails", :git => "https://github.com/rails/rails.git", :branch => "5-0-stable"
|
317
313
|
|
318
|
-
git "https://github.com/rails/rails.git", :tag => "v5.0.0"
|
314
|
+
gem "rails", :git => "https://github.com/rails/rails.git", :tag => "v5.0.0"
|
319
315
|
|
320
|
-
git "https://github.com/rails/rails.git", :ref => "4aded"
|
316
|
+
gem "rails", :git => "https://github.com/rails/rails.git", :ref => "4aded"
|
321
317
|
|
322
318
|
* `submodules`:
|
323
319
|
For reference, a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules)
|
data/man/gemfile.5.txt
CHANGED
@@ -99,13 +99,13 @@ RUBY
|
|
99
99
|
exist. Some of the more well-known implementations include Rubinius
|
100
100
|
https://rubinius.com/, and JRuby http://jruby.org/. Rubinius is an
|
101
101
|
alternative implementation of Ruby written in Ruby. JRuby is an
|
102
|
-
implementation of Ruby on the JVM, short for Java Virtual
|
102
|
+
implementation of Ruby on the JVM, short for Java Virtual Machine.
|
103
103
|
|
104
104
|
|
105
105
|
|
106
106
|
ENGINE VERSION
|
107
|
-
Each
|
108
|
-
sion
|
107
|
+
Each application may specify a Ruby engine version. If an engine ver-
|
108
|
+
sion is specified, an engine must also be specified. If the engine is
|
109
109
|
"ruby" the engine version specified must match the Ruby version.
|
110
110
|
|
111
111
|
|
@@ -147,20 +147,20 @@ GEMS
|
|
147
147
|
|
148
148
|
|
149
149
|
REQUIRE AS
|
150
|
-
Each
|
151
|
-
Bundler.require.
|
152
|
-
file
|
150
|
+
Each gem MAY specify files that should be used when autorequiring via
|
151
|
+
Bundler.require. You may pass an array with multiple files or true if
|
152
|
+
file you want required has same name as gem or false to prevent any
|
153
153
|
file from being autorequired.
|
154
154
|
|
155
155
|
|
156
156
|
|
157
157
|
gem "redis", :require => ["redis/connection/hiredis", "redis"]
|
158
158
|
gem "webmock", :require => false
|
159
|
-
gem "
|
159
|
+
gem "byebug", :require => true
|
160
160
|
|
161
161
|
|
162
162
|
|
163
|
-
The
|
163
|
+
The argument defaults to the name of the gem. For example, these are
|
164
164
|
identical:
|
165
165
|
|
166
166
|
|
@@ -172,8 +172,8 @@ GEMS
|
|
172
172
|
|
173
173
|
|
174
174
|
GROUPS
|
175
|
-
Each
|
176
|
-
does
|
175
|
+
Each gem MAY specify membership in one or more groups. Any gem that
|
176
|
+
does not specify membership in any group is placed in the default
|
177
177
|
group.
|
178
178
|
|
179
179
|
|
@@ -183,7 +183,7 @@ GEMS
|
|
183
183
|
|
184
184
|
|
185
185
|
|
186
|
-
The
|
186
|
+
The Bundler runtime allows its two main methods, Bundler.setup and
|
187
187
|
Bundler.require, to limit their impact to particular groups.
|
188
188
|
|
189
189
|
|
@@ -203,37 +203,33 @@ GEMS
|
|
203
203
|
|
204
204
|
|
205
205
|
|
206
|
-
The
|
207
|
-
dle install should not install with the
|
208
|
-
multiple groups to ignore, specify a list of groups separated by spa-
|
209
|
-
ces.
|
206
|
+
The Bundler CLI allows you to specify a list of groups whose gems bun-
|
207
|
+
dle install should not install with the without configuration.
|
210
208
|
|
209
|
+
To specify multiple groups to ignore, specify a list of groups sepa-
|
210
|
+
rated by spaces.
|
211
211
|
|
212
212
|
|
213
|
-
bundle install --without test
|
214
|
-
bundle install --without development test
|
215
213
|
|
214
|
+
bundle config set without test
|
215
|
+
bundle config set without development test
|
216
216
|
|
217
217
|
|
218
|
-
After running bundle install --without test, bundler will remember that
|
219
|
-
you excluded the test group in the last installation. The next time you
|
220
|
-
run bundle install, without any --without option, bundler will recall
|
221
|
-
it.
|
222
218
|
|
223
|
-
Also,
|
224
|
-
"bundler/setup"
|
219
|
+
Also, calling Bundler.setup with no parameters, or calling require
|
220
|
+
"bundler/setup" will setup all groups except for the ones you excluded
|
225
221
|
via --without (since they are not available).
|
226
222
|
|
227
|
-
Note
|
228
|
-
in
|
229
|
-
and
|
230
|
-
sions
|
231
|
-
Understanding Bundler
|
223
|
+
Note that on bundle install, bundler downloads and evaluates all gems,
|
224
|
+
in order to create a single canonical list of all of the required gems
|
225
|
+
and their dependencies. This means that you cannot list different ver-
|
226
|
+
sions of the same gems in different groups. For more details, see
|
227
|
+
Understanding Bundler https://bundler.io/rationale.html.
|
232
228
|
|
233
229
|
PLATFORMS
|
234
|
-
If
|
235
|
-
forms,
|
236
|
-
groups,
|
230
|
+
If a gem should only be used in a particular platform or set of plat-
|
231
|
+
forms, you can specify them. Platforms are essentially identical to
|
232
|
+
groups, except that you do not need to use the --without install-time
|
237
233
|
flag to exclude groups of gems for other platforms.
|
238
234
|
|
239
235
|
There are a number of Gemfile platforms:
|
@@ -256,7 +252,7 @@ GEMS
|
|
256
252
|
|
257
253
|
mswin Windows
|
258
254
|
|
259
|
-
You
|
255
|
+
You can restrict further by platform and version for all platforms
|
260
256
|
except for rbx, jruby, truffleruby and mswin.
|
261
257
|
|
262
258
|
To specify a version in addition to a platform, append the version num-
|
@@ -271,14 +267,14 @@ GEMS
|
|
271
267
|
|
272
268
|
The full list of platforms and supported versions includes:
|
273
269
|
|
274
|
-
ruby 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
270
|
+
ruby 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
275
271
|
|
276
|
-
mri 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
272
|
+
mri 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
277
273
|
|
278
|
-
mingw 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
274
|
+
mingw 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
279
275
|
|
280
276
|
x64_mingw
|
281
|
-
2.0, 2.1, 2.2, 2.3, 2.4, 2.5
|
277
|
+
2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
|
282
278
|
|
283
279
|
As with groups, you can specify one or more platforms:
|
284
280
|
|
@@ -290,12 +286,12 @@ GEMS
|
|
290
286
|
|
291
287
|
|
292
288
|
|
293
|
-
All
|
294
|
-
Bundler.setup,
|
289
|
+
All operations involving groups (bundle install bundle-install.1.html,
|
290
|
+
Bundler.setup, Bundler.require) behave exactly the same as if any
|
295
291
|
groups not matching the current platform were explicitly excluded.
|
296
292
|
|
297
293
|
SOURCE
|
298
|
-
You
|
294
|
+
You can select an alternate Rubygems repository for a gem using the
|
299
295
|
':source' option.
|
300
296
|
|
301
297
|
|
@@ -304,22 +300,22 @@ GEMS
|
|
304
300
|
|
305
301
|
|
306
302
|
|
307
|
-
This
|
308
|
-
global
|
303
|
+
This forces the gem to be loaded from this source and ignores any
|
304
|
+
global sources declared at the top level of the file. If the gem does
|
309
305
|
not exist in this source, it will not be installed.
|
310
306
|
|
311
307
|
Bundler will search for child dependencies of this gem by first looking
|
312
308
|
in the source selected for the parent, but if they are not found there,
|
313
|
-
it
|
309
|
+
it will fall back on global sources using the ordering described in
|
314
310
|
SOURCE PRIORITY.
|
315
311
|
|
316
|
-
Selecting
|
312
|
+
Selecting a specific source repository this way also suppresses the
|
317
313
|
ambiguous gem warning described above in GLOBAL SOURCES (#source).
|
318
314
|
|
319
|
-
Using
|
320
|
-
source
|
321
|
-
do
|
322
|
-
sources,
|
315
|
+
Using the :source option for an individual gem will also make that
|
316
|
+
source available as a possible global source for any other gems which
|
317
|
+
do not specify explicit sources. Thus, when adding gems with explicit
|
318
|
+
sources, it is recommended that you also ensure all other gems in the
|
323
319
|
Gemfile are using explicit sources.
|
324
320
|
|
325
321
|
GIT
|
@@ -337,27 +333,27 @@ GEMS
|
|
337
333
|
If using SSH, the user that you use to run bundle install MUST have the
|
338
334
|
appropriate keys available in their $HOME/.ssh.
|
339
335
|
|
340
|
-
NOTE:
|
341
|
-
These
|
342
|
-
can
|
336
|
+
NOTE: http:// and git:// URLs should be avoided if at all possible.
|
337
|
+
These protocols are unauthenticated, so a man-in-the-middle attacker
|
338
|
+
can deliver malicious code and compromise your system. HTTPS and SSH
|
343
339
|
are strongly preferred.
|
344
340
|
|
345
|
-
The
|
341
|
+
The group, platforms, and require options are available and behave
|
346
342
|
exactly the same as they would for a normal gem.
|
347
343
|
|
348
|
-
A
|
349
|
-
directory
|
350
|
-
MUST
|
344
|
+
A git repository SHOULD have at least one file, at the root of the
|
345
|
+
directory containing the gem, with the extension .gemspec. This file
|
346
|
+
MUST contain a valid gem specification, as expected by the gem build
|
351
347
|
command.
|
352
348
|
|
353
|
-
If
|
349
|
+
If a git repository does not have a .gemspec, bundler will attempt to
|
354
350
|
create one, but it will not contain any dependencies, executables, or C
|
355
|
-
extension
|
351
|
+
extension compilation instructions. As a result, it may fail to prop-
|
356
352
|
erly integrate into your application.
|
357
353
|
|
358
|
-
If
|
359
|
-
to,
|
360
|
-
only
|
354
|
+
If a git repository does have a .gemspec for the gem you attached it
|
355
|
+
to, a version specifier, if provided, means that the git repository is
|
356
|
+
only valid if the .gemspec specifies a version matching the version
|
361
357
|
specifier. If not, bundler will print a warning.
|
362
358
|
|
363
359
|
|
@@ -368,34 +364,34 @@ GEMS
|
|
368
364
|
|
369
365
|
|
370
366
|
|
371
|
-
If
|
367
|
+
If a git repository does not have a .gemspec for the gem you attached
|
372
368
|
it to, a version specifier MUST be provided. Bundler will use this ver-
|
373
369
|
sion in the simple .gemspec it creates.
|
374
370
|
|
375
371
|
Git repositories support a number of additional options.
|
376
372
|
|
377
373
|
branch, tag, and ref
|
378
|
-
You
|
379
|
-
is :branch => "master"
|
374
|
+
You MUST only specify at most one of these options. The default
|
375
|
+
is :branch => "master". For example:
|
380
376
|
|
381
|
-
|
377
|
+
gem "rails", :git => "https://github.com/rails/rails.git",
|
378
|
+
:branch => "5-0-stable"
|
382
379
|
|
383
|
-
|
384
|
-
|
380
|
+
gem "rails", :git => "https://github.com/rails/rails.git", :tag
|
381
|
+
=> "v5.0.0"
|
385
382
|
|
386
|
-
git "https://github.com/rails/rails.git",
|
387
|
-
|
388
|
-
git "https://github.com/rails/rails.git", :ref => "4aded" do
|
383
|
+
gem "rails", :git => "https://github.com/rails/rails.git", :ref
|
384
|
+
=> "4aded"
|
389
385
|
|
390
386
|
submodules
|
391
|
-
For
|
387
|
+
For reference, a git submodule
|
392
388
|
https://git-scm.com/book/en/v2/Git-Tools-Submodules lets you
|
393
|
-
have
|
389
|
+
have another git repository within a subfolder of your reposi-
|
394
390
|
tory. Specify :submodules => true to cause bundler to expand any
|
395
391
|
submodules included in the git repository
|
396
392
|
|
397
|
-
If
|
398
|
-
sents
|
393
|
+
If a git repository contains multiple .gemspecs, each .gemspec repre-
|
394
|
+
sents a gem located at the same place in the file system as the .gem-
|
399
395
|
spec.
|
400
396
|
|
401
397
|
|
@@ -410,16 +406,16 @@ GEMS
|
|
410
406
|
|
411
407
|
|
412
408
|
|
413
|
-
To
|
414
|
-
directory
|
409
|
+
To install a gem located in a git repository, bundler changes to the
|
410
|
+
directory containing the gemspec, runs gem build name.gemspec and then
|
415
411
|
installs the resulting gem. The gem build command, which comes standard
|
416
|
-
with
|
412
|
+
with Rubygems, evaluates the .gemspec in the context of the directory
|
417
413
|
in which it is located.
|
418
414
|
|
419
415
|
GIT SOURCE
|
420
|
-
A
|
421
|
-
the
|
422
|
-
argument
|
416
|
+
A custom git source can be defined via the git_source method. Provide
|
417
|
+
the source's name as an argument, and a block which receives a single
|
418
|
+
argument and interpolates it into a string to return the full repo
|
423
419
|
address:
|
424
420
|
|
425
421
|
|
@@ -442,10 +438,10 @@ GEMS
|
|
442
438
|
rently expands to an insecure git:// URL. This allows a man-in-the-mid-
|
443
439
|
dle attacker to compromise your system.
|
444
440
|
|
445
|
-
If
|
446
|
-
lic,
|
447
|
-
and
|
448
|
-
slash.
|
441
|
+
If the git repository you want to use is hosted on GitHub and is pub-
|
442
|
+
lic, you can use the :github shorthand to specify the github username
|
443
|
+
and repository name (without the trailing ".git"), separated by a
|
444
|
+
slash. If both the username and repository name are the same, you can
|
449
445
|
omit one.
|
450
446
|
|
451
447
|
|
@@ -468,7 +464,7 @@ GEMS
|
|
468
464
|
|
469
465
|
GIST
|
470
466
|
If the git repository you want to use is hosted as a Github Gist and is
|
471
|
-
public,
|
467
|
+
public, you can use the :gist shorthand to specify the gist identifier
|
472
468
|
(without the trailing ".git").
|
473
469
|
|
474
470
|
|
@@ -485,14 +481,14 @@ GEMS
|
|
485
481
|
|
486
482
|
|
487
483
|
|
488
|
-
Since
|
484
|
+
Since the gist method is a specialization of git_source, it accepts a
|
489
485
|
:branch named argument.
|
490
486
|
|
491
487
|
BITBUCKET
|
492
|
-
If
|
493
|
-
public,
|
494
|
-
username
|
495
|
-
by
|
488
|
+
If the git repository you want to use is hosted on Bitbucket and is
|
489
|
+
public, you can use the :bitbucket shorthand to specify the bitbucket
|
490
|
+
username and repository name (without the trailing ".git"), separated
|
491
|
+
by a slash. If both the username and repository name are the same, you
|
496
492
|
can omit one.
|
497
493
|
|
498
494
|
|
@@ -510,19 +506,19 @@ GEMS
|
|
510
506
|
|
511
507
|
|
512
508
|
|
513
|
-
Since
|
509
|
+
Since the bitbucket method is a specialization of git_source, it
|
514
510
|
accepts a :branch named argument.
|
515
511
|
|
516
512
|
PATH
|
517
|
-
You
|
513
|
+
You can specify that a gem is located in a particular location on the
|
518
514
|
file system. Relative paths are resolved relative to the directory con-
|
519
515
|
taining the Gemfile.
|
520
516
|
|
521
|
-
Similar
|
522
|
-
that
|
517
|
+
Similar to the semantics of the :git option, the :path option requires
|
518
|
+
that the directory in question either contains a .gemspec for the gem,
|
523
519
|
or that you specify an explicit version that bundler should use.
|
524
520
|
|
525
|
-
Unlike
|
521
|
+
Unlike :git, bundler does not compile C extensions for gems specified
|
526
522
|
as paths.
|
527
523
|
|
528
524
|
|
@@ -532,8 +528,8 @@ GEMS
|
|
532
528
|
|
533
529
|
|
534
530
|
If you would like to use multiple local gems directly from the filesys-
|
535
|
-
tem,
|
536
|
-
files.
|
531
|
+
tem, you can set a global path option to the path containing the gem's
|
532
|
+
files. This will automatically load gemspec files from subdirectories.
|
537
533
|
|
538
534
|
|
539
535
|
|
@@ -601,48 +597,48 @@ INSTALL_IF
|
|
601
597
|
|
602
598
|
|
603
599
|
GEMSPEC
|
604
|
-
The
|
600
|
+
The .gemspec http://guides.rubygems.org/specification-reference/ file
|
605
601
|
is where you provide metadata about your gem to Rubygems. Some required
|
606
|
-
Gemspec
|
607
|
-
gem.
|
602
|
+
Gemspec attributes include the name, description, and homepage of your
|
603
|
+
gem. This is also where you specify the dependencies your gem needs to
|
608
604
|
run.
|
609
605
|
|
610
606
|
If you wish to use Bundler to help install dependencies for a gem while
|
611
|
-
it
|
607
|
+
it is being developed, use the gemspec method to pull in the dependen-
|
612
608
|
cies listed in the .gemspec file.
|
613
609
|
|
614
610
|
The gemspec method adds any runtime dependencies as gem requirements in
|
615
|
-
the
|
616
|
-
requirements
|
611
|
+
the default group. It also adds development dependencies as gem
|
612
|
+
requirements in the development group. Finally, it adds a gem require-
|
617
613
|
ment on your project (:path => '.'). In conjunction with Bundler.setup,
|
618
614
|
this allows you to require project files in your test code as you would
|
619
|
-
if
|
615
|
+
if the project were installed as a gem; you need not manipulate the
|
620
616
|
load path manually or require project files via relative paths.
|
621
617
|
|
622
618
|
The gemspec method supports optional :path, :glob, :name, and :develop-
|
623
619
|
ment_group options, which control where bundler looks for the .gemspec,
|
624
|
-
the
|
625
|
-
spec"),
|
620
|
+
the glob it uses to look for the gemspec (defaults to: "{,,/*}.gem-
|
621
|
+
spec"), what named .gemspec it uses (if more than one is present), and
|
626
622
|
which group development dependencies are included in.
|
627
623
|
|
628
|
-
When
|
629
|
-
tion,
|
630
|
-
even
|
624
|
+
When a gemspec dependency encounters version conflicts during resolu-
|
625
|
+
tion, the local version under development will always be selected --
|
626
|
+
even if there are remote versions that better match other requirements
|
631
627
|
for the gemspec gem.
|
632
628
|
|
633
629
|
SOURCE PRIORITY
|
634
|
-
When
|
630
|
+
When attempting to locate a gem to satisfy a gem requirement, bundler
|
635
631
|
uses the following priority order:
|
636
632
|
|
637
633
|
1. The source explicitly attached to the gem (using :source, :path, or
|
638
634
|
:git)
|
639
635
|
|
640
636
|
2. For implicit gems (dependencies of explicit gems), any source, git,
|
641
|
-
or
|
642
|
-
prioritizing
|
637
|
+
or path repository declared on the parent. This results in bundler
|
638
|
+
prioritizing the ActiveSupport gem from the Rails git repository
|
643
639
|
over ones from rubygems.org
|
644
640
|
|
645
|
-
3. The
|
641
|
+
3. The sources specified via global source lines, searching each
|
646
642
|
source in your Gemfile from last added to first added.
|
647
643
|
|
648
644
|
|
@@ -650,4 +646,4 @@ SOURCE PRIORITY
|
|
650
646
|
|
651
647
|
|
652
648
|
|
653
|
-
|
649
|
+
December 2019 GEMFILE(5)
|