bundler 1.16.0 → 1.16.1
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 +5 -5
- data/CHANGELOG.md +13 -0
- data/bundler.gemspec +57 -0
- data/lib/bundler/build_metadata.rb +2 -2
- data/lib/bundler/cli/gem.rb +1 -1
- data/lib/bundler/cli/init.rb +1 -5
- data/lib/bundler/cli/update.rb +3 -1
- data/lib/bundler/definition.rb +1 -1
- data/lib/bundler/resolver.rb +4 -1
- data/lib/bundler/source/rubygems.rb +2 -4
- data/lib/bundler/templates/.document +1 -0
- data/lib/bundler/templates/Executable +11 -3
- data/lib/bundler/templates/newgem/{.travis.yml.tt → travis.yml.tt} +0 -0
- data/lib/bundler/version.rb +1 -1
- data/man/bundle-add.1 +1 -1
- data/man/bundle-add.1.txt +11 -11
- data/man/bundle-binstubs.1.txt +19 -19
- data/man/bundle-check.1 +1 -1
- data/man/bundle-check.1.txt +15 -15
- data/man/bundle-clean.1 +1 -1
- data/man/bundle-clean.1.txt +10 -10
- data/man/bundle-config.1 +1 -1
- data/man/bundle-config.1.txt +194 -194
- data/man/bundle-exec.1 +1 -1
- data/man/bundle-exec.1.txt +62 -62
- data/man/bundle-gem.1 +1 -1
- data/man/bundle-gem.1.txt +38 -38
- data/man/bundle-info.1 +1 -1
- data/man/bundle-info.1.txt +8 -8
- data/man/bundle-init.1 +1 -1
- data/man/bundle-init.1.txt +12 -12
- data/man/bundle-inject.1 +1 -1
- data/man/bundle-inject.1.txt +9 -9
- data/man/bundle-install.1 +1 -1
- data/man/bundle-install.1.txt +165 -165
- data/man/bundle-list.1 +1 -1
- data/man/bundle-list.1.txt +8 -8
- data/man/bundle-lock.1 +1 -1
- data/man/bundle-lock.1.txt +46 -46
- data/man/bundle-open.1 +1 -1
- data/man/bundle-open.1.txt +7 -7
- data/man/bundle-outdated.1 +1 -1
- data/man/bundle-outdated.1.txt +33 -33
- data/man/bundle-package.1 +1 -1
- data/man/bundle-package.1.txt +35 -35
- data/man/bundle-platform.1 +1 -1
- data/man/bundle-platform.1.txt +13 -13
- data/man/bundle-pristine.1 +1 -1
- data/man/bundle-pristine.1.txt +19 -19
- data/man/bundle-show.1 +1 -1
- data/man/bundle-show.1.txt +11 -11
- data/man/bundle-update.1 +1 -1
- data/man/bundle-update.1.txt +98 -98
- data/man/bundle-viz.1 +1 -1
- data/man/bundle-viz.1.txt +16 -16
- data/man/bundle.1 +1 -1
- data/man/bundle.1.txt +50 -50
- data/man/gemfile.5 +1 -1
- data/man/gemfile.5.txt +200 -200
- metadata +5 -3
data/man/bundle-exec.1
CHANGED
data/man/bundle-exec.1.txt
CHANGED
@@ -2,53 +2,53 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
2
2
|
|
3
3
|
|
4
4
|
|
5
|
-
|
6
|
-
|
5
|
+
NAME
|
6
|
+
bundle-exec - Execute a command in the context of the bundle
|
7
7
|
|
8
|
-
|
9
|
-
|
8
|
+
SYNOPSIS
|
9
|
+
bundle exec [--keep-file-descriptors] command
|
10
10
|
|
11
|
-
|
11
|
+
DESCRIPTION
|
12
12
|
This command executes the command, making all gems specified in the
|
13
|
-
|
13
|
+
Gemfile(5) available to require in Ruby programs.
|
14
14
|
|
15
|
-
Essentially, if you would normally have run something like
|
16
|
-
|
17
|
-
|
18
|
-
should run
|
15
|
+
Essentially, if you would normally have run something like rspec
|
16
|
+
spec/my_spec.rb, and you want to use the gems specified in the Gem-
|
17
|
+
file(5) and installed via [bundle install(1)][bundle-install], you
|
18
|
+
should run bundle exec rspec spec/my_spec.rb.
|
19
19
|
|
20
|
-
Note that
|
21
|
-
on your shell's
|
20
|
+
Note that bundle exec does not require that an executable is available
|
21
|
+
on your shell's $PATH.
|
22
22
|
|
23
|
-
|
24
|
-
|
23
|
+
OPTIONS
|
24
|
+
--keep-file-descriptors
|
25
25
|
Exec in Ruby 2.0 began discarding non-standard file descriptors.
|
26
26
|
When this flag is passed, exec will revert to the 1.9 behaviour
|
27
27
|
of passing all file descriptors to the new process.
|
28
28
|
|
29
|
-
|
30
|
-
If you use the
|
29
|
+
BUNDLE INSTALL --BINSTUBS
|
30
|
+
If you use the --binstubs flag in [bundle install(1)][bundle-install],
|
31
31
|
Bundler will automatically create a directory (which defaults to
|
32
|
-
|
32
|
+
app_root/bin) containing all of the executables available from gems in
|
33
33
|
the bundle.
|
34
34
|
|
35
|
-
After using
|
36
|
-
|
35
|
+
After using --binstubs, bin/rspec spec/my_spec.rb is identical to bun-
|
36
|
+
dle exec rspec spec/my_spec.rb.
|
37
37
|
|
38
|
-
|
39
|
-
|
38
|
+
ENVIRONMENT MODIFICATIONS
|
39
|
+
bundle exec makes a number of changes to the shell environment, then
|
40
40
|
executes the command you specify in full.
|
41
41
|
|
42
|
-
o make sure that it's still possible to shell out to
|
43
|
-
inside a command invoked by
|
42
|
+
o make sure that it's still possible to shell out to bundle from
|
43
|
+
inside a command invoked by bundle exec (using $BUNDLE_BIN_PATH)
|
44
44
|
|
45
|
-
o put the directory containing executables (like
|
46
|
-
|
45
|
+
o put the directory containing executables (like rails, rspec,
|
46
|
+
rackup) for your bundle on $PATH
|
47
47
|
|
48
48
|
o make sure that if bundler is invoked in the subshell, it uses the
|
49
|
-
same
|
49
|
+
same Gemfile (by setting BUNDLE_GEMFILE)
|
50
50
|
|
51
|
-
o add
|
51
|
+
o add -rbundler/setup to $RUBYOPT, which makes sure that Ruby pro-
|
52
52
|
grams invoked in the subshell can see the gems in the bundle
|
53
53
|
|
54
54
|
|
@@ -57,40 +57,40 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
57
57
|
|
58
58
|
o disallow loading additional gems not in the bundle
|
59
59
|
|
60
|
-
o modify the
|
61
|
-
ments is in the bundle, and to raise a
|
60
|
+
o modify the gem method to be a no-op if a gem matching the require-
|
61
|
+
ments is in the bundle, and to raise a Gem::LoadError if it's not
|
62
62
|
|
63
|
-
o Define
|
63
|
+
o Define Gem.refresh to be a no-op, since the source index is always
|
64
64
|
frozen when using bundler, and to prevent gems from the system
|
65
65
|
leaking into the environment
|
66
66
|
|
67
|
-
o Override
|
67
|
+
o Override Gem.bin_path to use the gems in the bundle, making system
|
68
68
|
executables work
|
69
69
|
|
70
70
|
o Add all gems in the bundle into Gem.loaded_specs
|
71
71
|
|
72
72
|
|
73
73
|
|
74
|
-
Finally,
|
74
|
+
Finally, bundle exec also implicitly modifies Gemfile.lock if the lock-
|
75
75
|
file and the Gemfile do not match. Bundler needs the Gemfile to deter-
|
76
|
-
mine things such as a gem's groups,
|
76
|
+
mine things such as a gem's groups, autorequire, and platforms, etc.,
|
77
77
|
and that information isn't stored in the lockfile. The Gemfile and
|
78
|
-
lockfile must be synced in order to
|
79
|
-
|
78
|
+
lockfile must be synced in order to bundle exec successfully, so bundle
|
79
|
+
exec updates the lockfile beforehand.
|
80
80
|
|
81
|
-
|
82
|
-
By default, when attempting to
|
83
|
-
bang, Bundler will
|
81
|
+
Loading
|
82
|
+
By default, when attempting to bundle exec to a file with a ruby she-
|
83
|
+
bang, Bundler will Kernel.load that file instead of using Kernel.exec.
|
84
84
|
For the vast majority of cases, this is a performance improvement. In a
|
85
85
|
rare few cases, this could cause some subtle side-effects (such as
|
86
|
-
dependence on the exact contents of
|
87
|
-
tion can be disabled by enabling the
|
86
|
+
dependence on the exact contents of $0 or __FILE__) and the optimiza-
|
87
|
+
tion can be disabled by enabling the disable_exec_load setting.
|
88
88
|
|
89
|
-
|
90
|
-
Any Ruby code that opens a subshell (like
|
89
|
+
Shelling out
|
90
|
+
Any Ruby code that opens a subshell (like system, backticks, or %x{})
|
91
91
|
will automatically use the current Bundler environment. If you need to
|
92
92
|
shell out to a Ruby command that is not part of your current bundle,
|
93
|
-
use the
|
93
|
+
use the with_clean_env method with a block. Any subshells created
|
94
94
|
inside the block will be given the environment present before Bundler
|
95
95
|
was activated. For example, Homebrew commands run Ruby, but don't work
|
96
96
|
inside a bundle:
|
@@ -103,10 +103,10 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
103
103
|
|
104
104
|
|
105
105
|
|
106
|
-
Using
|
106
|
+
Using with_clean_env is also necessary if you are shelling out to a
|
107
107
|
different bundle. Any Bundler commands run in a subshell will inherit
|
108
108
|
the current Gemfile, so commands that need to run in the context of a
|
109
|
-
different bundle also need to use
|
109
|
+
different bundle also need to use with_clean_env.
|
110
110
|
|
111
111
|
|
112
112
|
|
@@ -118,7 +118,7 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
118
118
|
|
119
119
|
|
120
120
|
|
121
|
-
Bundler provides convenience helpers that wrap
|
121
|
+
Bundler provides convenience helpers that wrap system and exec, and
|
122
122
|
they can be used like this:
|
123
123
|
|
124
124
|
|
@@ -128,24 +128,24 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
128
128
|
|
129
129
|
|
130
130
|
|
131
|
-
|
131
|
+
RUBYGEMS PLUGINS
|
132
132
|
At present, the Rubygems plugin system requires all files named
|
133
|
-
|
134
|
-
code requires
|
135
|
-
system, like
|
133
|
+
rubygems_plugin.rb on the load path of any installed gem when any Ruby
|
134
|
+
code requires rubygems.rb. This includes executables installed into the
|
135
|
+
system, like rails, rackup, and rspec.
|
136
136
|
|
137
137
|
Since Rubygems plugins can contain arbitrary Ruby code, they commonly
|
138
138
|
end up activating themselves or their dependencies.
|
139
139
|
|
140
|
-
For instance, the
|
141
|
-
that version of gemcutter installed (even if you
|
142
|
-
sion without this problem), Rubygems would activate
|
143
|
-
|
140
|
+
For instance, the gemcutter 0.5 gem depended on json_pure. If you had
|
141
|
+
that version of gemcutter installed (even if you also had a newer ver-
|
142
|
+
sion without this problem), Rubygems would activate gemcutter 0.5 and
|
143
|
+
json_pure <latest>.
|
144
144
|
|
145
|
-
If your Gemfile(5) also contained
|
146
|
-
on
|
147
|
-
the version in your Gemfile(5), or the snapshot version in your
|
148
|
-
|
145
|
+
If your Gemfile(5) also contained json_pure (or a gem with a dependency
|
146
|
+
on json_pure), the latest version on your system might conflict with
|
147
|
+
the version in your Gemfile(5), or the snapshot version in your Gem-
|
148
|
+
file.lock.
|
149
149
|
|
150
150
|
If this happens, bundler will say:
|
151
151
|
|
@@ -158,7 +158,7 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
158
158
|
|
159
159
|
In this situation, you almost certainly want to remove the underlying
|
160
160
|
gem with the problematic gem plugin. In general, the authors of these
|
161
|
-
plugins (in this case, the
|
161
|
+
plugins (in this case, the gemcutter gem) have released newer versions
|
162
162
|
that are more careful in their plugins.
|
163
163
|
|
164
164
|
You can find a list of all the gems containing gem plugins by running
|
@@ -170,9 +170,9 @@ BUNDLE-EXEC(1) BUNDLE-EXEC(1)
|
|
170
170
|
|
171
171
|
|
172
172
|
At the very least, you should remove all but the newest version of each
|
173
|
-
gem plugin, and also remove all gem plugins that you aren't using (
|
174
|
-
|
173
|
+
gem plugin, and also remove all gem plugins that you aren't using (gem
|
174
|
+
uninstall gem_name).
|
175
175
|
|
176
176
|
|
177
177
|
|
178
|
-
|
178
|
+
July 2017 BUNDLE-EXEC(1)
|
data/man/bundle-gem.1
CHANGED
data/man/bundle-gem.1.txt
CHANGED
@@ -2,90 +2,90 @@ BUNDLE-GEM(1) BUNDLE-GEM(1)
|
|
2
2
|
|
3
3
|
|
4
4
|
|
5
|
-
|
6
|
-
|
5
|
+
NAME
|
6
|
+
bundle-gem - Generate a project skeleton for creating a rubygem
|
7
7
|
|
8
|
-
|
9
|
-
|
8
|
+
SYNOPSIS
|
9
|
+
bundle gem GEM_NAME OPTIONS
|
10
10
|
|
11
|
-
|
12
|
-
Generates a directory named
|
11
|
+
DESCRIPTION
|
12
|
+
Generates a directory named GEM_NAME with a Rakefile, GEM_NAME.gemspec,
|
13
13
|
and other supporting files and directories that can be used to develop
|
14
14
|
a rubygem with that name.
|
15
15
|
|
16
|
-
Run
|
16
|
+
Run rake -T in the resulting project for a list of Rake tasks that can
|
17
17
|
be used to test and publish the gem to rubygems.org.
|
18
18
|
|
19
19
|
The generated project skeleton can be customized with OPTIONS, as
|
20
20
|
explained below. Note that these options can also be specified via
|
21
21
|
Bundler's global configuration file using the following names:
|
22
22
|
|
23
|
-
o
|
23
|
+
o gem.coc
|
24
24
|
|
25
|
-
o
|
25
|
+
o gem.mit
|
26
26
|
|
27
|
-
o
|
27
|
+
o gem.test
|
28
28
|
|
29
29
|
|
30
30
|
|
31
|
-
|
32
|
-
|
31
|
+
OPTIONS
|
32
|
+
--exe or -b or --bin
|
33
33
|
Specify that Bundler should create a binary executable (as
|
34
|
-
|
35
|
-
also be added to the
|
34
|
+
exe/GEM_NAME) in the generated rubygem project. This binary will
|
35
|
+
also be added to the GEM_NAME.gemspec manifest. This behavior is
|
36
36
|
disabled by default.
|
37
37
|
|
38
|
-
|
39
|
-
Do not create a binary (overrides
|
38
|
+
--no-exe
|
39
|
+
Do not create a binary (overrides --exe specified in the global
|
40
40
|
config).
|
41
41
|
|
42
|
-
|
42
|
+
--coc Add a CODE_OF_CONDUCT.md file to the root of the generated
|
43
43
|
project. If this option is unspecified, an interactive prompt
|
44
44
|
will be displayed and the answer will be saved in Bundler's
|
45
|
-
global config for future
|
45
|
+
global config for future bundle gem use.
|
46
46
|
|
47
|
-
|
48
|
-
Do not create a
|
47
|
+
--no-coc
|
48
|
+
Do not create a CODE_OF_CONDUCT.md (overrides --coc specified in
|
49
49
|
the global config).
|
50
50
|
|
51
|
-
|
51
|
+
--ext Add boilerplate for C extension code to the generated project.
|
52
52
|
This behavior is disabled by default.
|
53
53
|
|
54
|
-
|
55
|
-
Do not add C extension code (overrides
|
54
|
+
--no-ext
|
55
|
+
Do not add C extension code (overrides --ext specified in the
|
56
56
|
global config).
|
57
57
|
|
58
|
-
|
58
|
+
--mit Add an MIT license to a LICENSE.txt file in the root of the gen-
|
59
59
|
erated project. Your name from the global git config is used for
|
60
60
|
the copyright statement. If this option is unspecified, an
|
61
61
|
interactive prompt will be displayed and the answer will be
|
62
|
-
saved in Bundler's global config for future
|
62
|
+
saved in Bundler's global config for future bundle gem use.
|
63
63
|
|
64
|
-
|
65
|
-
Do not create a
|
64
|
+
--no-mit
|
65
|
+
Do not create a LICENSE.txt (overrides --mit specified in the
|
66
66
|
global config).
|
67
67
|
|
68
|
-
|
68
|
+
-t, --test=minitest, --test=rspec
|
69
69
|
Specify the test framework that Bundler should use when generat-
|
70
|
-
ing the project. Acceptable values are
|
71
|
-
|
70
|
+
ing the project. Acceptable values are minitest and rspec. The
|
71
|
+
GEM_NAME.gemspec will be configured and a skeleton test/spec
|
72
72
|
directory will be created based on this option. If this option
|
73
73
|
is unspecified, an interactive prompt will be displayed and the
|
74
|
-
answer will be saved in Bundler's global config for future
|
75
|
-
|
74
|
+
answer will be saved in Bundler's global config for future bun-
|
75
|
+
dle gem use. If no option is specified, the default testing
|
76
76
|
framework is RSpec.
|
77
77
|
|
78
|
-
|
78
|
+
-e, --edit[=EDITOR]
|
79
79
|
Open the resulting GEM_NAME.gemspec in EDITOR, or the default
|
80
|
-
editor
|
81
|
-
|
80
|
+
editor if not specified. The default is $BUNDLER_EDITOR,
|
81
|
+
$VISUAL, or $EDITOR.
|
82
82
|
|
83
|
-
|
84
|
-
o bundle-config
|
83
|
+
SEE ALSO
|
84
|
+
o bundle-config http://bundler.io/v1.14/bundle_config.html
|
85
85
|
|
86
86
|
|
87
87
|
|
88
88
|
|
89
89
|
|
90
90
|
|
91
|
-
|
91
|
+
December 2017 BUNDLE-GEM(1)
|
data/man/bundle-info.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\-INFO" "1" "
|
4
|
+
.TH "BUNDLE\-INFO" "1" "February 2017" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-info\fR \- Show information for the given gem in your bundle
|
data/man/bundle-info.1.txt
CHANGED
@@ -2,20 +2,20 @@ BUNDLE-INFO(1) BUNDLE-INFO(1)
|
|
2
2
|
|
3
3
|
|
4
4
|
|
5
|
-
|
6
|
-
|
5
|
+
NAME
|
6
|
+
bundle-info - Show information for the given gem in your bundle
|
7
7
|
|
8
|
-
|
9
|
-
|
8
|
+
SYNOPSIS
|
9
|
+
bundle info [GEM] [--path]
|
10
10
|
|
11
|
-
|
11
|
+
DESCRIPTION
|
12
12
|
Print the basic information about the provided GEM such as homepage,
|
13
13
|
version, path and summary.
|
14
14
|
|
15
|
-
|
16
|
-
|
15
|
+
OPTIONS
|
16
|
+
--path Print the path of the given gem
|
17
17
|
|
18
18
|
|
19
19
|
|
20
20
|
|
21
|
-
|
21
|
+
February 2017 BUNDLE-INFO(1)
|
data/man/bundle-init.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\-INIT" "1" "
|
4
|
+
.TH "BUNDLE\-INIT" "1" "February 2017" "" ""
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBbundle\-init\fR \- Generates a Gemfile into the current working directory
|
data/man/bundle-init.1.txt
CHANGED
@@ -2,23 +2,23 @@ BUNDLE-INIT(1) BUNDLE-INIT(1)
|
|
2
2
|
|
3
3
|
|
4
4
|
|
5
|
-
|
6
|
-
|
5
|
+
NAME
|
6
|
+
bundle-init - Generates a Gemfile into the current working directory
|
7
7
|
|
8
|
-
|
9
|
-
|
8
|
+
SYNOPSIS
|
9
|
+
bundle init [--gemspec=FILE]
|
10
10
|
|
11
|
-
|
12
|
-
Init generates a default
|
13
|
-
When adding a
|
11
|
+
DESCRIPTION
|
12
|
+
Init generates a default Gemfile(5) in the current working directory.
|
13
|
+
When adding a Gemfile(5) to a gem with a gemspec, the --gemspec option
|
14
14
|
will automatically add each dependency listed in the gemspec file to
|
15
|
-
the newly created
|
15
|
+
the newly created Gemfile(5).
|
16
16
|
|
17
|
-
|
18
|
-
|
19
|
-
Use the specified .gemspec to create the
|
17
|
+
OPTIONS
|
18
|
+
--gemspec
|
19
|
+
Use the specified .gemspec to create the Gemfile(5)
|
20
20
|
|
21
21
|
|
22
22
|
|
23
23
|
|
24
|
-
|
24
|
+
February 2017 BUNDLE-INIT(1)
|