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.

Files changed (60) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGELOG.md +13 -0
  3. data/bundler.gemspec +57 -0
  4. data/lib/bundler/build_metadata.rb +2 -2
  5. data/lib/bundler/cli/gem.rb +1 -1
  6. data/lib/bundler/cli/init.rb +1 -5
  7. data/lib/bundler/cli/update.rb +3 -1
  8. data/lib/bundler/definition.rb +1 -1
  9. data/lib/bundler/resolver.rb +4 -1
  10. data/lib/bundler/source/rubygems.rb +2 -4
  11. data/lib/bundler/templates/.document +1 -0
  12. data/lib/bundler/templates/Executable +11 -3
  13. data/lib/bundler/templates/newgem/{.travis.yml.tt → travis.yml.tt} +0 -0
  14. data/lib/bundler/version.rb +1 -1
  15. data/man/bundle-add.1 +1 -1
  16. data/man/bundle-add.1.txt +11 -11
  17. data/man/bundle-binstubs.1.txt +19 -19
  18. data/man/bundle-check.1 +1 -1
  19. data/man/bundle-check.1.txt +15 -15
  20. data/man/bundle-clean.1 +1 -1
  21. data/man/bundle-clean.1.txt +10 -10
  22. data/man/bundle-config.1 +1 -1
  23. data/man/bundle-config.1.txt +194 -194
  24. data/man/bundle-exec.1 +1 -1
  25. data/man/bundle-exec.1.txt +62 -62
  26. data/man/bundle-gem.1 +1 -1
  27. data/man/bundle-gem.1.txt +38 -38
  28. data/man/bundle-info.1 +1 -1
  29. data/man/bundle-info.1.txt +8 -8
  30. data/man/bundle-init.1 +1 -1
  31. data/man/bundle-init.1.txt +12 -12
  32. data/man/bundle-inject.1 +1 -1
  33. data/man/bundle-inject.1.txt +9 -9
  34. data/man/bundle-install.1 +1 -1
  35. data/man/bundle-install.1.txt +165 -165
  36. data/man/bundle-list.1 +1 -1
  37. data/man/bundle-list.1.txt +8 -8
  38. data/man/bundle-lock.1 +1 -1
  39. data/man/bundle-lock.1.txt +46 -46
  40. data/man/bundle-open.1 +1 -1
  41. data/man/bundle-open.1.txt +7 -7
  42. data/man/bundle-outdated.1 +1 -1
  43. data/man/bundle-outdated.1.txt +33 -33
  44. data/man/bundle-package.1 +1 -1
  45. data/man/bundle-package.1.txt +35 -35
  46. data/man/bundle-platform.1 +1 -1
  47. data/man/bundle-platform.1.txt +13 -13
  48. data/man/bundle-pristine.1 +1 -1
  49. data/man/bundle-pristine.1.txt +19 -19
  50. data/man/bundle-show.1 +1 -1
  51. data/man/bundle-show.1.txt +11 -11
  52. data/man/bundle-update.1 +1 -1
  53. data/man/bundle-update.1.txt +98 -98
  54. data/man/bundle-viz.1 +1 -1
  55. data/man/bundle-viz.1.txt +16 -16
  56. data/man/bundle.1 +1 -1
  57. data/man/bundle.1.txt +50 -50
  58. data/man/gemfile.5 +1 -1
  59. data/man/gemfile.5.txt +200 -200
  60. metadata +5 -3
@@ -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" "October 2017" "" ""
4
+ .TH "BUNDLE\-VIZ" "1" "July 2017" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-viz\fR \- Generates a visual dependency graph for your Gemfile
@@ -2,37 +2,37 @@ BUNDLE-VIZ(1) BUNDLE-VIZ(1)
2
2
 
3
3
 
4
4
 
5
- 1mNAME0m
6
- 1mbundle-viz 22m- Generates a visual dependency graph for your Gemfile
5
+ NAME
6
+ bundle-viz - Generates a visual dependency graph for your Gemfile
7
7
 
8
- 1mSYNOPSIS0m
9
- 1mbundle viz 22m[--file=FILE] [--format=FORMAT] [--requirements] [--version]
8
+ SYNOPSIS
9
+ bundle viz [--file=FILE] [--format=FORMAT] [--requirements] [--version]
10
10
  [--without=GROUP GROUP]
11
11
 
12
- 1mDESCRIPTION0m
13
- 1mviz 22mgenerates a PNG file of the current 1mGemfile(5) 22mas a dependency
14
- graph. 1mviz 22mrequires the ruby-graphviz gem (and its dependencies).
12
+ DESCRIPTION
13
+ viz generates a PNG file of the current Gemfile(5) as a dependency
14
+ graph. viz requires the ruby-graphviz gem (and its dependencies).
15
15
 
16
- The associated gems must also be installed via 1mbundle install(1)22m.
16
+ The associated gems must also be installed via bundle install(1).
17
17
 
18
- 1mOPTIONS0m
19
- 1m--file22m, 1m-f0m
20
- The name to use for the generated file. See 1m--format 22moption
18
+ OPTIONS
19
+ --file, -f
20
+ The name to use for the generated file. See --format option
21
21
 
22
- 1m--format22m, 1m-F0m
22
+ --format, -F
23
23
  This is output format option. Supported format is png, jpg, svg,
24
24
  dot ...
25
25
 
26
- 1m--requirements22m, 1m-R0m
26
+ --requirements, -R
27
27
  Set to show the version of each required dependency.
28
28
 
29
- 1m--version22m, 1m-v0m
29
+ --version, -v
30
30
  Set to show each gem version.
31
31
 
32
- 1m--without22m, 1m-W0m
32
+ --without, -W
33
33
  Exclude gems that are part of the specified named group.
34
34
 
35
35
 
36
36
 
37
37
 
38
- October 2017 BUNDLE-VIZ(1)
38
+ July 2017 BUNDLE-VIZ(1)
@@ -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" "October 2017" "" ""
4
+ .TH "BUNDLE" "1" "July 2017" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\fR \- Ruby Dependency Management
@@ -2,112 +2,112 @@ BUNDLE(1) BUNDLE(1)
2
2
 
3
3
 
4
4
 
5
- 1mNAME0m
6
- 1mbundle 22m- Ruby Dependency Management
5
+ NAME
6
+ bundle - Ruby Dependency Management
7
7
 
8
- 1mSYNOPSIS0m
9
- 1mbundle 22mCOMMAND [--no-color] [--verbose] [ARGS]
8
+ SYNOPSIS
9
+ bundle COMMAND [--no-color] [--verbose] [ARGS]
10
10
 
11
- 1mDESCRIPTION0m
12
- Bundler manages an 1mapplication's dependencies 22mthrough its entire life
11
+ DESCRIPTION
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 4mhttp://bundler.io24m for information on getting
16
- started, and Gemfile(5) for more information on the 1mGemfile 22mformat.
15
+ See the bundler website http://bundler.io for information on getting
16
+ started, and Gemfile(5) for more information on the Gemfile format.
17
17
 
18
- 1mOPTIONS0m
19
- 1m--no-color0m
18
+ OPTIONS
19
+ --no-color
20
20
  Print all output without color
21
21
 
22
- 1m--retry22m, 1m-r0m
22
+ --retry, -r
23
23
  Specify the number of times you wish to attempt network commands
24
24
 
25
- 1m--verbose22m, 1m-V0m
25
+ --verbose, -V
26
26
  Print out additional logging information
27
27
 
28
- 1mBUNDLE COMMANDS0m
29
- We divide 1mbundle 22msubcommands into primary commands and utilities.
28
+ BUNDLE COMMANDS
29
+ We divide bundle subcommands into primary commands and utilities.
30
30
 
31
- 1mPRIMARY COMMANDS0m
32
- [1mbundle install(1)22m][bundle-install]
33
- Install the gems specified by the 1mGemfile 22mor 1mGemfile.lock0m
31
+ PRIMARY COMMANDS
32
+ [bundle install(1)][bundle-install]
33
+ Install the gems specified by the Gemfile or Gemfile.lock
34
34
 
35
- [1mbundle update(1)22m][bundle-update]
35
+ [bundle update(1)][bundle-update]
36
36
  Update dependencies to their latest versions
37
37
 
38
- [1mbundle package(1)22m][bundle-package]
39
- Package the .gem files required by your application into the
40
- 1mvendor/cache 22mdirectory
38
+ [bundle package(1)][bundle-package]
39
+ Package the .gem files required by your application into the
40
+ vendor/cache directory
41
41
 
42
- [1mbundle exec(1)22m][bundle-exec]
42
+ [bundle exec(1)][bundle-exec]
43
43
  Execute a script in the context of the current bundle
44
44
 
45
- [1mbundle config(1)22m][bundle-config]
45
+ [bundle config(1)][bundle-config]
46
46
  Specify and read configuration options for bundler
47
47
 
48
- 1mbundle help(1)0m
48
+ bundle help(1)
49
49
  Display detailed help for each subcommand
50
50
 
51
- 1mUTILITIES0m
52
- 1mbundle add(1)0m
53
- Add the named gem to the Gemfile and run 1mbundle install0m
51
+ UTILITIES
52
+ bundle add(1)
53
+ Add the named gem to the Gemfile and run bundle install
54
54
 
55
- 1mbundle binstubs(1)0m
55
+ bundle binstubs(1)
56
56
  Generate binstubs for executables in a gem
57
57
 
58
- 1mbundle check(1)0m
59
- Determine whether the requirements for your application are
58
+ bundle check(1)
59
+ Determine whether the requirements for your application are
60
60
  installed and available to bundler
61
61
 
62
- 1mbundle show(1)0m
62
+ bundle show(1)
63
63
  Show the source location of a particular gem in the bundle
64
64
 
65
- [1mbundle outdated(1)22m][bundle-outdated]
65
+ [bundle outdated(1)][bundle-outdated]
66
66
  Show all of the outdated gems in the current bundle
67
67
 
68
- 1mbundle console(1)0m
68
+ bundle console(1)
69
69
  Start an IRB session in the context of the current bundle
70
70
 
71
- 1mbundle open(1)0m
71
+ bundle open(1)
72
72
  Open an installed gem in the editor
73
73
 
74
- [1mbundle lock(1)22m][bundle-lock]
74
+ [bundle lock(1)][bundle-lock]
75
75
  Generate a lockfile for your dependencies
76
76
 
77
- 1mbundle viz(1)0m
77
+ bundle viz(1)
78
78
  Generate a visual representation of your dependencies
79
79
 
80
- 1mbundle init(1)0m
81
- Generate a simple 1mGemfile22m, placed in the current directory
80
+ bundle init(1)
81
+ Generate a simple Gemfile, placed in the current directory
82
82
 
83
- [1mbundle gem(1)22m][bundle-gem]
83
+ [bundle gem(1)][bundle-gem]
84
84
  Create a simple gem, suitable for development with bundler
85
85
 
86
- [1mbundle platform(1)22m][bundle-platform]
86
+ [bundle platform(1)][bundle-platform]
87
87
  Display platform compatibility information
88
88
 
89
- 1mbundle clean(1)0m
89
+ bundle clean(1)
90
90
  Clean up unused gems in your bundler directory
91
91
 
92
- 1mbundle doctor(1)0m
92
+ bundle doctor(1)
93
93
  Display warnings about common potential problems
94
94
 
95
- 1mPLUGINS0m
96
- When running a command that isn't listed in PRIMARY COMMANDS or UTILI-
97
- TIES, Bundler will try to find an executable on your path named
98
- 1mbundler-<command> 22mand execute it, passing down any extra arguments to
95
+ PLUGINS
96
+ When running a command that isn't listed in PRIMARY COMMANDS or UTILI-
97
+ TIES, Bundler will try to find an executable on your path named
98
+ bundler-<command> and execute it, passing down any extra arguments to
99
99
  it.
100
100
 
101
- 1mOBSOLETE0m
101
+ OBSOLETE
102
102
  These commands are obsolete and should no longer be used
103
103
 
104
- o 1mbundle cache(1)0m
104
+ o bundle cache(1)
105
105
 
106
- o 1mbundle show(1)0m
106
+ o bundle show(1)
107
107
 
108
108
 
109
109
 
110
110
 
111
111
 
112
112
 
113
- October 2017 BUNDLE(1)
113
+ July 2017 BUNDLE(1)
@@ -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" "October 2017" "" ""
4
+ .TH "GEMFILE" "5" "July 2017" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBGemfile\fR \- A format for describing gem dependencies for Ruby programs
@@ -2,24 +2,24 @@ GEMFILE(5) GEMFILE(5)
2
2
 
3
3
 
4
4
 
5
- 1mNAME0m
6
- 1mGemfile 22m- A format for describing gem dependencies for Ruby programs
5
+ NAME
6
+ Gemfile - A format for describing gem dependencies for Ruby programs
7
7
 
8
- 1mSYNOPSIS0m
9
- A 1mGemfile 22mdescribes the gem dependencies required to execute associated
8
+ SYNOPSIS
9
+ A Gemfile describes the gem dependencies required to execute associated
10
10
  Ruby code.
11
11
 
12
- Place the 1mGemfile 22min the root of the directory containing the associ-
13
- ated code. For instance, in a Rails application, place the 1mGemfile 22min
14
- the same directory as the 1mRakefile22m.
12
+ Place the Gemfile in the root of the directory containing the associ-
13
+ ated code. For instance, in a Rails application, place the Gemfile in
14
+ the same directory as the Rakefile.
15
15
 
16
- 1mSYNTAX0m
17
- A 1mGemfile 22mis evaluated as Ruby code, in a context which makes available
16
+ SYNTAX
17
+ A Gemfile is evaluated as Ruby code, in a context which makes available
18
18
  a number of methods used to describe the gem requirements.
19
19
 
20
- 1mGLOBAL SOURCES0m
21
- At the top of the 1mGemfile22m, add a line for the 1mRubygems 22msource that con-
22
- tains the gems listed in the 1mGemfile22m.
20
+ GLOBAL SOURCES
21
+ At the top of the Gemfile, add a line for the Rubygems source that con-
22
+ tains the gems listed in the Gemfile.
23
23
 
24
24
 
25
25
 
@@ -28,18 +28,18 @@ GEMFILE(5) GEMFILE(5)
28
28
 
29
29
 
30
30
  It is possible, but not recommended as of Bundler 1.7, to add multiple
31
- global 1msource 22mlines. Each of these 1msource22ms 1mMUST 22mbe a valid Rubygems
31
+ global source lines. Each of these sources MUST be a valid Rubygems
32
32
  repository.
33
33
 
34
34
  Sources are checked for gems following the heuristics described in
35
- 4mSOURCE24m 4mPRIORITY24m. If a gem is found in more than one global source,
35
+ SOURCE PRIORITY. If a gem is found in more than one global source,
36
36
  Bundler will print a warning after installing the gem indicating which
37
37
  source was used, and listing the other sources where the gem is avail-
38
38
  able. A specific source can be selected for gems that need to use a
39
- non-standard repository, suppressing this warning, by using the 1m:source0m
40
- option or a 1msource 22mblock.
39
+ non-standard repository, suppressing this warning, by using the :source
40
+ option or a source block.
41
41
 
42
- 1mCREDENTIALS0m
42
+ CREDENTIALS
43
43
  Some gem sources require a username and password. Use [bundle con-
44
44
  fig(1)][bundle-config] to set the username and password for any of the
45
45
  sources that need it. The command must be run once on each computer
@@ -62,14 +62,14 @@ GEMFILE(5) GEMFILE(5)
62
62
 
63
63
 
64
64
  Credentials in the source URL will take precedence over credentials set
65
- using 1mconfig22m.
65
+ using config.
66
66
 
67
- 1mRUBY0m
67
+ RUBY
68
68
  If your application requires a specific Ruby version or engine, specify
69
- your requirements using the 1mruby 22mmethod, with the following arguments.
70
- All parameters are 1mOPTIONAL 22munless otherwise specified.
69
+ your requirements using the ruby method, with the following arguments.
70
+ All parameters are OPTIONAL unless otherwise specified.
71
71
 
72
- 1mVERSION (required)0m
72
+ VERSION (required)
73
73
  The version of Ruby that your application requires. If your application
74
74
  requires an alternate Ruby engine, such as JRuby or Rubinius, this
75
75
  should be the Ruby version that the engine is compatible with.
@@ -80,32 +80,32 @@ GEMFILE(5) GEMFILE(5)
80
80
 
81
81
 
82
82
 
83
- 1mENGINE0m
84
- Each application 4mmay24m specify a Ruby engine. If an engine is specified,
85
- an engine version 4mmust24m also be specified.
83
+ ENGINE
84
+ Each application may specify a Ruby engine. If an engine is specified,
85
+ an engine version must also be specified.
86
86
 
87
87
  What exactly is an Engine? - A Ruby engine is an implementation of the
88
88
  Ruby language.
89
89
 
90
90
  o For background: the reference or original implementation of the
91
91
  Ruby programming language is called Matz's Ruby Interpreter
92
- 4mhttps://en.wikipedia.org/wiki/Ruby_MRI24m, or MRI for short. This is
92
+ https://en.wikipedia.org/wiki/Ruby_MRI, or MRI for short. This is
93
93
  named after Ruby creator Yukihiro Matsumoto, also known as Matz.
94
94
  MRI is also known as CRuby, because it is written in C. MRI is the
95
95
  most widely used Ruby engine.
96
96
 
97
- o Other implementations 4mhttps://www.ruby-lang.org/en/about/24m of Ruby
97
+ o Other implementations https://www.ruby-lang.org/en/about/ of Ruby
98
98
  exist. Some of the more well-known implementations include Rubinius
99
- 4mhttps://rubinius.com/24m, and JRuby 4mhttp://jruby.org/24m. Rubinius is an
99
+ https://rubinius.com/, and JRuby http://jruby.org/. Rubinius is an
100
100
  alternative implementation of Ruby written in Ruby. JRuby is an
101
- implementation of Ruby on the JVM, short for Java Virtual Machine.
101
+ implementation of Ruby on the JVM, short for Java Virtual Machine.
102
102
 
103
103
 
104
104
 
105
- 1mENGINE VERSION0m
106
- Each application 4mmay24m specify a Ruby engine version. If an engine ver-
107
- sion is specified, an engine 4mmust24m also be specified. If the engine is
108
- "ruby" the engine version specified 4mmust24m match the Ruby version.
105
+ ENGINE VERSION
106
+ Each application may specify a Ruby engine version. If an engine ver-
107
+ sion is specified, an engine must also be specified. If the engine is
108
+ "ruby" the engine version specified must match the Ruby version.
109
109
 
110
110
 
111
111
 
@@ -113,8 +113,8 @@ GEMFILE(5) GEMFILE(5)
113
113
 
114
114
 
115
115
 
116
- 1mPATCHLEVEL0m
117
- Each application 4mmay24m specify a Ruby patchlevel.
116
+ PATCHLEVEL
117
+ Each application may specify a Ruby patchlevel.
118
118
 
119
119
 
120
120
 
@@ -122,12 +122,12 @@ GEMFILE(5) GEMFILE(5)
122
122
 
123
123
 
124
124
 
125
- 1mGEMS0m
126
- Specify gem requirements using the 1mgem 22mmethod, with the following argu-
127
- ments. All parameters are 1mOPTIONAL 22munless otherwise specified.
125
+ GEMS
126
+ Specify gem requirements using the gem method, with the following argu-
127
+ ments. All parameters are OPTIONAL unless otherwise specified.
128
128
 
129
- 1mNAME (required)0m
130
- For each gem requirement, list a single 4mgem24m line.
129
+ NAME (required)
130
+ For each gem requirement, list a single gem line.
131
131
 
132
132
 
133
133
 
@@ -135,8 +135,8 @@ GEMFILE(5) GEMFILE(5)
135
135
 
136
136
 
137
137
 
138
- 1mVERSION0m
139
- Each 4mgem24m 1mMAY 22mhave one or more version specifiers.
138
+ VERSION
139
+ Each gem MAY have one or more version specifiers.
140
140
 
141
141
 
142
142
 
@@ -145,10 +145,10 @@ GEMFILE(5) GEMFILE(5)
145
145
 
146
146
 
147
147
 
148
- 1mREQUIRE AS0m
149
- Each 4mgem24m 1mMAY 22mspecify files that should be used when autorequiring via
150
- 1mBundler.require22m. You may pass an array with multiple files or 1mtrue 22mif
151
- file you want 1mrequired 22mhas same name as 4mgem24m or 1mfalse 22mto prevent any
148
+ REQUIRE AS
149
+ Each gem MAY specify files that should be used when autorequiring via
150
+ Bundler.require. You may pass an array with multiple files or true if
151
+ file you want required has same name as gem or false to prevent any
152
152
  file from being autorequired.
153
153
 
154
154
 
@@ -159,7 +159,7 @@ GEMFILE(5) GEMFILE(5)
159
159
 
160
160
 
161
161
 
162
- The argument defaults to the name of the gem. For example, these are
162
+ The argument defaults to the name of the gem. For example, these are
163
163
  identical:
164
164
 
165
165
 
@@ -170,9 +170,9 @@ GEMFILE(5) GEMFILE(5)
170
170
 
171
171
 
172
172
 
173
- 1mGROUPS0m
174
- Each 4mgem24m 1mMAY 22mspecify membership in one or more groups. Any 4mgem24m that
175
- does not specify membership in any group is placed in the 1mdefault0m
173
+ GROUPS
174
+ Each gem MAY specify membership in one or more groups. Any gem that
175
+ does not specify membership in any group is placed in the default
176
176
  group.
177
177
 
178
178
 
@@ -182,8 +182,8 @@ GEMFILE(5) GEMFILE(5)
182
182
 
183
183
 
184
184
 
185
- The Bundler runtime allows its two main methods, 1mBundler.setup 22mand
186
- 1mBundler.require22m, to limit their impact to particular groups.
185
+ The Bundler runtime allows its two main methods, Bundler.setup and
186
+ Bundler.require, to limit their impact to particular groups.
187
187
 
188
188
 
189
189
 
@@ -202,9 +202,9 @@ GEMFILE(5) GEMFILE(5)
202
202
 
203
203
 
204
204
 
205
- The Bundler CLI allows you to specify a list of groups whose gems 1mbun-0m
206
- 1mdle install 22mshould not install with the 1m--without 22moption. To specify
207
- multiple groups to ignore, specify a list of groups separated by spa-
205
+ The Bundler CLI allows you to specify a list of groups whose gems bun-
206
+ dle install should not install with the --without option. To specify
207
+ multiple groups to ignore, specify a list of groups separated by spa-
208
208
  ces.
209
209
 
210
210
 
@@ -214,46 +214,46 @@ GEMFILE(5) GEMFILE(5)
214
214
 
215
215
 
216
216
 
217
- After running 1mbundle install --without test22m, bundler will remember that
217
+ After running bundle install --without test, bundler will remember that
218
218
  you excluded the test group in the last installation. The next time you
219
- run 1mbundle install22m, without any 1m--without option22m, bundler will recall
219
+ run bundle install, without any --without option, bundler will recall
220
220
  it.
221
221
 
222
- Also, calling 1mBundler.setup 22mwith no parameters, or calling 1mrequire0m
223
- 1m"bundler/setup" 22mwill setup all groups except for the ones you excluded
224
- via 1m--without 22m(since they are not available).
222
+ Also, calling Bundler.setup with no parameters, or calling require
223
+ "bundler/setup" will setup all groups except for the ones you excluded
224
+ via --without (since they are not available).
225
225
 
226
- Note that on 1mbundle install22m, bundler downloads and evaluates all gems,
227
- in order to create a single canonical list of all of the required gems
228
- and their dependencies. This means that you cannot list different ver-
229
- sions of the same gems in different groups. For more details, see
230
- Understanding Bundler 4mhttp://bundler.io/rationale.html24m.
226
+ Note that on bundle install, bundler downloads and evaluates all gems,
227
+ in order to create a single canonical list of all of the required gems
228
+ and their dependencies. This means that you cannot list different ver-
229
+ sions of the same gems in different groups. For more details, see
230
+ Understanding Bundler http://bundler.io/rationale.html.
231
231
 
232
- 1mPLATFORMS0m
233
- If a gem should only be used in a particular platform or set of plat-
234
- forms, you can specify them. Platforms are essentially identical to
235
- groups, except that you do not need to use the 1m--without 22minstall-time
232
+ PLATFORMS
233
+ If a gem should only be used in a particular platform or set of plat-
234
+ forms, you can specify them. Platforms are essentially identical to
235
+ groups, except that you do not need to use the --without install-time
236
236
  flag to exclude groups of gems for other platforms.
237
237
 
238
- There are a number of 1mGemfile 22mplatforms:
238
+ There are a number of Gemfile platforms:
239
239
 
240
- 1mruby 22mC Ruby (MRI) or Rubinius, but 1mNOT 22mWindows
240
+ ruby C Ruby (MRI) or Rubinius, but NOT Windows
241
241
 
242
- 1mmri 22mSame as 4mruby24m, but not Rubinius
242
+ mri Same as ruby, but not Rubinius
243
243
 
244
- 1mmingw 22mWindows 32 bit 'mingw32' platform (aka RubyInstaller)
244
+ mingw Windows 32 bit 'mingw32' platform (aka RubyInstaller)
245
245
 
246
- 1mx64_mingw0m
246
+ x64_mingw
247
247
  Windows 64 bit 'mingw32' platform (aka RubyInstaller x64)
248
248
 
249
- 1mrbx 22mSame as 4mruby24m, but only Rubinius (not MRI)
249
+ rbx Same as ruby, but only Rubinius (not MRI)
250
250
 
251
- 1mjruby 22mJRuby
251
+ jruby JRuby
252
252
 
253
- 1mmswin 22mWindows
253
+ mswin Windows
254
254
 
255
- You can restrict further by platform and version for all platforms
256
- 4mexcept24m for 1mrbx22m, 1mjruby22m, and 1mmswin22m.
255
+ You can restrict further by platform and version for all platforms
256
+ except for rbx, jruby, and mswin.
257
257
 
258
258
  To specify a version in addition to a platform, append the version num-
259
259
  ber without the delimiter to the platform. For example, to specify that
@@ -267,13 +267,13 @@ GEMFILE(5) GEMFILE(5)
267
267
 
268
268
  The full list of platforms and supported versions includes:
269
269
 
270
- 1mruby 22m1.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
271
271
 
272
- 1mmri 22m1.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
273
273
 
274
- 1mmingw 22m1.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
275
275
 
276
- 1mx64_mingw0m
276
+ x64_mingw
277
277
  2.0, 2.1, 2.2, 2.3, 2.4, 2.5
278
278
 
279
279
  As with groups, you can specify one or more platforms:
@@ -286,12 +286,12 @@ GEMFILE(5) GEMFILE(5)
286
286
 
287
287
 
288
288
 
289
- All operations involving groups (1mbundle install22m, 1mBundler.setup22m,
290
- 1mBundler.require22m) behave exactly the same as if any groups not matching
289
+ All operations involving groups (bundle install, Bundler.setup,
290
+ Bundler.require) behave exactly the same as if any groups not matching
291
291
  the current platform were explicitly excluded.
292
292
 
293
- 1mSOURCE0m
294
- You can select an alternate Rubygems repository for a gem using the
293
+ SOURCE
294
+ You can select an alternate Rubygems repository for a gem using the
295
295
  ':source' option.
296
296
 
297
297
 
@@ -300,54 +300,54 @@ GEMFILE(5) GEMFILE(5)
300
300
 
301
301
 
302
302
 
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
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
305
305
  not exist in this source, it will not be installed.
306
306
 
307
307
  Bundler will search for child dependencies of this gem by first looking
308
308
  in the source selected for the parent, but if they are not found there,
309
- it will fall back on global sources using the ordering described in
310
- 4mSOURCE24m 4mPRIORITY24m.
309
+ it will fall back on global sources using the ordering described in
310
+ SOURCE PRIORITY.
311
311
 
312
- Selecting a specific source repository this way also suppresses the
313
- ambiguous gem warning described above in 4mGLOBAL24m 4mSOURCES24m 4m(#source)24m.
312
+ Selecting a specific source repository this way also suppresses the
313
+ ambiguous gem warning described above in GLOBAL SOURCES (#source).
314
314
 
315
- 1mGIT0m
315
+ GIT
316
316
  If necessary, you can specify that a gem is located at a particular git
317
- repository using the 1m:git 22mparameter. The repository can be accessed via
317
+ repository using the :git parameter. The repository can be accessed via
318
318
  several protocols:
319
319
 
320
- 1mHTTP(S)0m
320
+ HTTP(S)
321
321
  gem "rails", :git => "https://github.com/rails/rails.git"
322
322
 
323
- 1mSSH 22mgem "rails", :git => "git@github.com:rails/rails.git"
323
+ SSH gem "rails", :git => "git@github.com:rails/rails.git"
324
324
 
325
- 1mgit 22mgem "rails", :git => "git://github.com/rails/rails.git"
325
+ git gem "rails", :git => "git://github.com/rails/rails.git"
326
326
 
327
- If using SSH, the user that you use to run 1mbundle install MUST 22mhave the
328
- appropriate keys available in their 1m$HOME/.ssh22m.
327
+ If using SSH, the user that you use to run bundle install MUST have the
328
+ appropriate keys available in their $HOME/.ssh.
329
329
 
330
- 1mNOTE22m: 1mhttp:// 22mand 1mgit:// 22mURLs should be avoided if at all possible.
331
- These protocols are unauthenticated, so a man-in-the-middle attacker
332
- can deliver malicious code and compromise your system. HTTPS and SSH
330
+ NOTE: http:// and git:// URLs should be avoided if at all possible.
331
+ These protocols are unauthenticated, so a man-in-the-middle attacker
332
+ can deliver malicious code and compromise your system. HTTPS and SSH
333
333
  are strongly preferred.
334
334
 
335
- The 1mgroup22m, 1mplatforms22m, and 1mrequire 22moptions are available and behave
335
+ The group, platforms, and require options are available and behave
336
336
  exactly the same as they would for a normal gem.
337
337
 
338
- A git repository 1mSHOULD 22mhave at least one file, at the root of the
339
- directory containing the gem, with the extension 1m.gemspec22m. This file
340
- 1mMUST 22mcontain a valid gem specification, as expected by the 1mgem build0m
338
+ A git repository SHOULD have at least one file, at the root of the
339
+ directory containing the gem, with the extension .gemspec. This file
340
+ MUST contain a valid gem specification, as expected by the gem build
341
341
  command.
342
342
 
343
- If a git repository does not have a 1m.gemspec22m, bundler will attempt to
343
+ If a git repository does not have a .gemspec, bundler will attempt to
344
344
  create one, but it will not contain any dependencies, executables, or C
345
- extension compilation instructions. As a result, it may fail to prop-
345
+ extension compilation instructions. As a result, it may fail to prop-
346
346
  erly integrate into your application.
347
347
 
348
- If a git repository does have a 1m.gemspec 22mfor the gem you attached it
349
- to, a version specifier, if provided, means that the git repository is
350
- only valid if the 1m.gemspec 22mspecifies a version matching the version
348
+ If a git repository does have a .gemspec for the gem you attached it
349
+ to, a version specifier, if provided, means that the git repository is
350
+ only valid if the .gemspec specifies a version matching the version
351
351
  specifier. If not, bundler will print a warning.
352
352
 
353
353
 
@@ -358,35 +358,35 @@ GEMFILE(5) GEMFILE(5)
358
358
 
359
359
 
360
360
 
361
- If a git repository does 1mnot 22mhave a 1m.gemspec 22mfor the gem you attached
362
- it to, a version specifier 1mMUST 22mbe provided. Bundler will use this ver-
363
- sion in the simple 1m.gemspec 22mit creates.
361
+ If a git repository does not have a .gemspec for the gem you attached
362
+ it to, a version specifier MUST be provided. Bundler will use this ver-
363
+ sion in the simple .gemspec it creates.
364
364
 
365
365
  Git repositories support a number of additional options.
366
366
 
367
- 1mbranch22m, 1mtag22m, and 1mref0m
368
- You 1mMUST 22monly specify at most one of these options. The default
369
- is 1m:branch => "master"0m
367
+ branch, tag, and ref
368
+ You MUST only specify at most one of these options. The default
369
+ is :branch => "master"
370
370
 
371
371
  For example:
372
372
 
373
- git "https://github.com/rails/rails.git", :branch => "5-0-sta-
373
+ git "https://github.com/rails/rails.git", :branch => "5-0-sta-
374
374
  ble" do
375
375
 
376
376
  git "https://github.com/rails/rails.git", :tag => "v5.0.0" do
377
377
 
378
378
  git "https://github.com/rails/rails.git", :ref => "4aded" do
379
379
 
380
- 1msubmodules0m
381
- For reference, a git submodule
382
- 4mhttps://git-scm.com/book/en/v2/Git-Tools-Submodules24m lets you
383
- have another git repository within a subfolder of your reposi-
384
- tory. Specify 1m:submodules => true 22mto cause bundler to expand any
380
+ submodules
381
+ For reference, a git submodule
382
+ https://git-scm.com/book/en/v2/Git-Tools-Submodules lets you
383
+ have another git repository within a subfolder of your reposi-
384
+ tory. Specify :submodules => true to cause bundler to expand any
385
385
  submodules included in the git repository
386
386
 
387
- If a git repository contains multiple 1m.gemspecs22m, each 1m.gemspec 22mrepre-
388
- sents a gem located at the same place in the file system as the 1m.gem-0m
389
- 1mspec22m.
387
+ If a git repository contains multiple .gemspecs, each .gemspec repre-
388
+ sents a gem located at the same place in the file system as the .gem-
389
+ spec.
390
390
 
391
391
 
392
392
 
@@ -400,16 +400,16 @@ GEMFILE(5) GEMFILE(5)
400
400
 
401
401
 
402
402
 
403
- To install a gem located in a git repository, bundler changes to the
404
- directory containing the gemspec, runs 1mgem build name.gemspec 22mand then
405
- installs the resulting gem. The 1mgem build 22mcommand, which comes standard
406
- with Rubygems, evaluates the 1m.gemspec 22min the context of the directory
403
+ To install a gem located in a git repository, bundler changes to the
404
+ directory containing the gemspec, runs gem build name.gemspec and then
405
+ installs the resulting gem. The gem build command, which comes standard
406
+ with Rubygems, evaluates the .gemspec in the context of the directory
407
407
  in which it is located.
408
408
 
409
- 1mGIT SOURCE0m
410
- A custom git source can be defined via the 1mgit_source 22mmethod. Provide
411
- the source's name as an argument, and a block which receives a single
412
- argument and interpolates it into a string to return the full repo
409
+ GIT SOURCE
410
+ A custom git source can be defined via the git_source method. Provide
411
+ the source's name as an argument, and a block which receives a single
412
+ argument and interpolates it into a string to return the full repo
413
413
  address:
414
414
 
415
415
 
@@ -427,15 +427,15 @@ GEMFILE(5) GEMFILE(5)
427
427
 
428
428
 
429
429
 
430
- 1mGITHUB0m
431
- 1mNOTE22m: This shorthand should be avoided until Bundler 2.0, since it cur-
432
- rently expands to an insecure 1mgit:// 22mURL. This allows a man-in-the-mid-
430
+ GITHUB
431
+ NOTE: This shorthand should be avoided until Bundler 2.0, since it cur-
432
+ rently expands to an insecure git:// URL. This allows a man-in-the-mid-
433
433
  dle attacker to compromise your system.
434
434
 
435
- If the git repository you want to use is hosted on GitHub and is pub-
436
- lic, you can use the :github shorthand to specify the github username
437
- and repository name (without the trailing ".git"), separated by a
438
- slash. If both the username and repository name are the same, you can
435
+ If the git repository you want to use is hosted on GitHub and is pub-
436
+ lic, you can use the :github shorthand to specify the github username
437
+ and repository name (without the trailing ".git"), separated by a
438
+ slash. If both the username and repository name are the same, you can
439
439
  omit one.
440
440
 
441
441
 
@@ -453,12 +453,12 @@ GEMFILE(5) GEMFILE(5)
453
453
 
454
454
 
455
455
 
456
- Since the 1mgithub 22mmethod is a specialization of 1mgit_source22m, it accepts a
457
- 1m:branch 22mnamed argument.
456
+ Since the github method is a specialization of git_source, it accepts a
457
+ :branch named argument.
458
458
 
459
- 1mGIST0m
459
+ GIST
460
460
  If the git repository you want to use is hosted as a Github Gist and is
461
- public, you can use the :gist shorthand to specify the gist identifier
461
+ public, you can use the :gist shorthand to specify the gist identifier
462
462
  (without the trailing ".git").
463
463
 
464
464
 
@@ -475,14 +475,14 @@ GEMFILE(5) GEMFILE(5)
475
475
 
476
476
 
477
477
 
478
- Since the 1mgist 22mmethod is a specialization of 1mgit_source22m, it accepts a
479
- 1m:branch 22mnamed argument.
478
+ Since the gist method is a specialization of git_source, it accepts a
479
+ :branch named argument.
480
480
 
481
- 1mBITBUCKET0m
482
- If the git repository you want to use is hosted on Bitbucket and is
483
- public, you can use the :bitbucket shorthand to specify the bitbucket
484
- username and repository name (without the trailing ".git"), separated
485
- by a slash. If both the username and repository name are the same, you
481
+ BITBUCKET
482
+ If the git repository you want to use is hosted on Bitbucket and is
483
+ public, you can use the :bitbucket shorthand to specify the bitbucket
484
+ username and repository name (without the trailing ".git"), separated
485
+ by a slash. If both the username and repository name are the same, you
486
486
  can omit one.
487
487
 
488
488
 
@@ -500,19 +500,19 @@ GEMFILE(5) GEMFILE(5)
500
500
 
501
501
 
502
502
 
503
- Since the 1mbitbucket 22mmethod is a specialization of 1mgit_source22m, it
504
- accepts a 1m:branch 22mnamed argument.
503
+ Since the bitbucket method is a specialization of git_source, it
504
+ accepts a :branch named argument.
505
505
 
506
- 1mPATH0m
507
- You can specify that a gem is located in a particular location on the
506
+ PATH
507
+ You can specify that a gem is located in a particular location on the
508
508
  file system. Relative paths are resolved relative to the directory con-
509
- taining the 1mGemfile22m.
509
+ taining the Gemfile.
510
510
 
511
- Similar to the semantics of the 1m:git 22moption, the 1m:path 22moption requires
512
- that the directory in question either contains a 1m.gemspec 22mfor the gem,
511
+ Similar to the semantics of the :git option, the :path option requires
512
+ that the directory in question either contains a .gemspec for the gem,
513
513
  or that you specify an explicit version that bundler should use.
514
514
 
515
- Unlike 1m:git22m, bundler does not compile C extensions for gems specified
515
+ Unlike :git, bundler does not compile C extensions for gems specified
516
516
  as paths.
517
517
 
518
518
 
@@ -522,8 +522,8 @@ GEMFILE(5) GEMFILE(5)
522
522
 
523
523
 
524
524
  If you would like to use multiple local gems directly from the filesys-
525
- tem, you can set a global 1mpath 22moption to the path containing the gem's
526
- files. This will automatically load gemspec files from subdirectories.
525
+ tem, you can set a global path option to the path containing the gem's
526
+ files. This will automatically load gemspec files from subdirectories.
527
527
 
528
528
 
529
529
 
@@ -534,8 +534,8 @@ GEMFILE(5) GEMFILE(5)
534
534
 
535
535
 
536
536
 
537
- 1mBLOCK FORM OF SOURCE, GIT, PATH, GROUP and PLATFORMS0m
538
- The 1m:source22m, 1m:git22m, 1m:path22m, 1m:group22m, and 1m:platforms 22moptions may be applied
537
+ BLOCK FORM OF SOURCE, GIT, PATH, GROUP and PLATFORMS
538
+ The :source, :git, :path, :group, and :platforms options may be applied
539
539
  to a group of gems by using block form.
540
540
 
541
541
 
@@ -563,15 +563,15 @@ GEMFILE(5) GEMFILE(5)
563
563
 
564
564
 
565
565
  In the case of the group block form the :optional option can be given
566
- to prevent a group from being installed unless listed in the 1m--with0m
567
- option given to the 1mbundle install 22mcommand.
566
+ to prevent a group from being installed unless listed in the --with
567
+ option given to the bundle install command.
568
568
 
569
- In the case of the 1mgit 22mblock form, the 1m:ref22m, 1m:branch22m, 1m:tag22m, and 1m:sub-0m
570
- 1mmodules 22moptions may be passed to the 1mgit 22mmethod, and all gems in the
569
+ In the case of the git block form, the :ref, :branch, :tag, and :sub-
570
+ modules options may be passed to the git method, and all gems in the
571
571
  block will inherit those options.
572
572
 
573
- 1mINSTALL_IF0m
574
- The 1minstall_if 22mmethod allows gems to be installed based on a proc or
573
+ INSTALL_IF
574
+ The install_if method allows gems to be installed based on a proc or
575
575
  lambda. This is especially useful for optional gems that can only be
576
576
  used if certain software is installed or some other conditions are met.
577
577
 
@@ -583,54 +583,54 @@ GEMFILE(5) GEMFILE(5)
583
583
 
584
584
 
585
585
 
586
- 1mGEMSPEC0m
587
- The .gemspec 4mhttp://guides.rubygems.org/specification-reference/24m file
586
+ GEMSPEC
587
+ The .gemspec http://guides.rubygems.org/specification-reference/ file
588
588
  is where you provide metadata about your gem to Rubygems. Some required
589
- Gemspec attributes include the name, description, and homepage of your
590
- gem. This is also where you specify the dependencies your gem needs to
589
+ Gemspec attributes include the name, description, and homepage of your
590
+ gem. This is also where you specify the dependencies your gem needs to
591
591
  run.
592
592
 
593
593
  If you wish to use Bundler to help install dependencies for a gem while
594
- it is being developed, use the 1mgemspec 22mmethod to pull in the dependen-
595
- cies listed in the 1m.gemspec 22mfile.
594
+ it is being developed, use the gemspec method to pull in the dependen-
595
+ cies listed in the .gemspec file.
596
596
 
597
- The 1mgemspec 22mmethod adds any runtime dependencies as gem requirements in
598
- the default group. It also adds development dependencies as gem
599
- requirements in the 1mdevelopment 22mgroup. Finally, it adds a gem require-
600
- ment on your project (1m:path => '.'22m). In conjunction with 1mBundler.setup22m,
597
+ The gemspec method adds any runtime dependencies as gem requirements in
598
+ the default group. It also adds development dependencies as gem
599
+ requirements in the development group. Finally, it adds a gem require-
600
+ ment on your project (:path => '.'). In conjunction with Bundler.setup,
601
601
  this allows you to require project files in your test code as you would
602
- if the project were installed as a gem; you need not manipulate the
602
+ if the project were installed as a gem; you need not manipulate the
603
603
  load path manually or require project files via relative paths.
604
604
 
605
- The 1mgemspec 22mmethod supports optional 1m:path22m, 1m:glob22m, 1m:name22m, and 1m:develop-0m
606
- 1mment_group 22moptions, which control where bundler looks for the 1m.gemspec22m,
607
- the glob it uses to look for the gemspec (defaults to: "{,4m,24m/*}.gem-
608
- spec"), what named 1m.gemspec 22mit uses (if more than one is present), and
605
+ The gemspec method supports optional :path, :glob, :name, and :develop-
606
+ ment_group options, which control where bundler looks for the .gemspec,
607
+ the glob it uses to look for the gemspec (defaults to: "{,,/*}.gem-
608
+ spec"), what named .gemspec it uses (if more than one is present), and
609
609
  which group development dependencies are included in.
610
610
 
611
- When a 1mgemspec 22mdependency encounters version conflicts during resolu-
612
- tion, the local version under development will always be selected --
613
- even if there are remote versions that better match other requirements
614
- for the 1mgemspec 22mgem.
611
+ When a gemspec dependency encounters version conflicts during resolu-
612
+ tion, the local version under development will always be selected --
613
+ even if there are remote versions that better match other requirements
614
+ for the gemspec gem.
615
615
 
616
- 1mSOURCE PRIORITY0m
617
- When attempting to locate a gem to satisfy a gem requirement, bundler
616
+ SOURCE PRIORITY
617
+ When attempting to locate a gem to satisfy a gem requirement, bundler
618
618
  uses the following priority order:
619
619
 
620
- 1. The source explicitly attached to the gem (using 1m:source22m, 1m:path22m, or
621
- 1m:git22m)
620
+ 1. The source explicitly attached to the gem (using :source, :path, or
621
+ :git)
622
622
 
623
623
  2. For implicit gems (dependencies of explicit gems), any source, git,
624
- or path repository declared on the parent. This results in bundler
625
- prioritizing the ActiveSupport gem from the Rails git repository
626
- over ones from 1mrubygems.org0m
624
+ or path repository declared on the parent. This results in bundler
625
+ prioritizing the ActiveSupport gem from the Rails git repository
626
+ over ones from rubygems.org
627
627
 
628
- 3. The sources specified via global 1msource 22mlines, searching each
629
- source in your 1mGemfile 22mfrom last added to first added.
628
+ 3. The sources specified via global source lines, searching each
629
+ source in your Gemfile from last added to first added.
630
630
 
631
631
 
632
632
 
633
633
 
634
634
 
635
635
 
636
- October 2017 GEMFILE(5)
636
+ July 2017 GEMFILE(5)