bundler 1.15.2 → 1.17.3

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 (286) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGELOG.md +302 -0
  3. data/README.md +17 -8
  4. data/bundler.gemspec +25 -9
  5. data/exe/bundle +1 -1
  6. data/exe/bundle_ruby +4 -3
  7. data/lib/bundler/build_metadata.rb +53 -0
  8. data/lib/bundler/capistrano.rb +5 -0
  9. data/lib/bundler/cli/add.rb +15 -6
  10. data/lib/bundler/cli/binstubs.rb +17 -9
  11. data/lib/bundler/cli/cache.rb +5 -4
  12. data/lib/bundler/cli/check.rb +3 -5
  13. data/lib/bundler/cli/clean.rb +5 -6
  14. data/lib/bundler/cli/common.rb +11 -2
  15. data/lib/bundler/cli/config.rb +2 -1
  16. data/lib/bundler/cli/console.rb +2 -1
  17. data/lib/bundler/cli/doctor.rb +48 -1
  18. data/lib/bundler/cli/exec.rb +6 -5
  19. data/lib/bundler/cli/gem.rb +13 -8
  20. data/lib/bundler/cli/info.rb +0 -1
  21. data/lib/bundler/cli/init.rb +18 -6
  22. data/lib/bundler/cli/inject.rb +1 -0
  23. data/lib/bundler/cli/install.rb +64 -61
  24. data/lib/bundler/cli/issue.rb +1 -1
  25. data/lib/bundler/cli/list.rb +58 -0
  26. data/lib/bundler/cli/lock.rb +0 -1
  27. data/lib/bundler/cli/open.rb +2 -2
  28. data/lib/bundler/cli/outdated.rb +20 -9
  29. data/lib/bundler/cli/package.rb +9 -6
  30. data/lib/bundler/cli/platform.rb +1 -0
  31. data/lib/bundler/cli/plugin.rb +1 -0
  32. data/lib/bundler/cli/pristine.rb +20 -6
  33. data/lib/bundler/cli/remove.rb +18 -0
  34. data/lib/bundler/cli/show.rb +0 -1
  35. data/lib/bundler/cli/update.rb +35 -7
  36. data/lib/bundler/cli/viz.rb +1 -0
  37. data/lib/bundler/cli.rb +227 -89
  38. data/lib/bundler/compact_index_client/cache.rb +1 -2
  39. data/lib/bundler/compact_index_client/updater.rb +14 -4
  40. data/lib/bundler/compact_index_client.rb +1 -0
  41. data/lib/bundler/compatibility_guard.rb +14 -0
  42. data/lib/bundler/constants.rb +1 -0
  43. data/lib/bundler/current_ruby.rb +13 -5
  44. data/lib/bundler/definition.rb +192 -139
  45. data/lib/bundler/dep_proxy.rb +3 -1
  46. data/lib/bundler/dependency.rb +9 -9
  47. data/lib/bundler/deployment.rb +1 -1
  48. data/lib/bundler/deprecate.rb +15 -3
  49. data/lib/bundler/dsl.rb +115 -64
  50. data/lib/bundler/endpoint_specification.rb +10 -1
  51. data/lib/bundler/env.rb +90 -29
  52. data/lib/bundler/environment_preserver.rb +27 -6
  53. data/lib/bundler/errors.rb +1 -0
  54. data/lib/bundler/feature_flag.rb +46 -4
  55. data/lib/bundler/fetcher/base.rb +1 -0
  56. data/lib/bundler/fetcher/compact_index.rb +2 -11
  57. data/lib/bundler/fetcher/dependency.rb +2 -1
  58. data/lib/bundler/fetcher/downloader.rb +11 -5
  59. data/lib/bundler/fetcher/index.rb +3 -2
  60. data/lib/bundler/fetcher.rb +18 -11
  61. data/lib/bundler/friendly_errors.rb +6 -1
  62. data/lib/bundler/gem_helper.rb +19 -10
  63. data/lib/bundler/gem_helpers.rb +1 -0
  64. data/lib/bundler/gem_remote_fetcher.rb +1 -0
  65. data/lib/bundler/gem_tasks.rb +1 -0
  66. data/lib/bundler/gem_version_promoter.rb +17 -2
  67. data/lib/bundler/gemdeps.rb +1 -0
  68. data/lib/bundler/graph.rb +1 -0
  69. data/lib/bundler/index.rb +8 -8
  70. data/lib/bundler/injector.rb +192 -30
  71. data/lib/bundler/inline.rb +5 -7
  72. data/lib/bundler/installer/gem_installer.rb +11 -2
  73. data/lib/bundler/installer/parallel_installer.rb +78 -42
  74. data/lib/bundler/installer/standalone.rb +1 -0
  75. data/lib/bundler/installer.rb +138 -53
  76. data/lib/bundler/lazy_specification.rb +3 -2
  77. data/lib/bundler/lockfile_generator.rb +95 -0
  78. data/lib/bundler/lockfile_parser.rb +10 -4
  79. data/lib/bundler/match_platform.rb +1 -0
  80. data/lib/bundler/mirror.rb +8 -5
  81. data/lib/bundler/plugin/api/source.rb +9 -2
  82. data/lib/bundler/plugin/events.rb +61 -0
  83. data/lib/bundler/plugin/index.rb +7 -2
  84. data/lib/bundler/plugin/installer.rb +7 -6
  85. data/lib/bundler/plugin/source_list.rb +7 -8
  86. data/lib/bundler/plugin.rb +13 -5
  87. data/lib/bundler/process_lock.rb +24 -0
  88. data/lib/bundler/psyched_yaml.rb +10 -0
  89. data/lib/bundler/remote_specification.rb +1 -0
  90. data/lib/bundler/resolver/spec_group.rb +106 -0
  91. data/lib/bundler/resolver.rb +158 -195
  92. data/lib/bundler/retry.rb +1 -0
  93. data/lib/bundler/ruby_dsl.rb +1 -0
  94. data/lib/bundler/ruby_version.rb +2 -1
  95. data/lib/bundler/rubygems_ext.rb +5 -4
  96. data/lib/bundler/rubygems_gem_installer.rb +31 -1
  97. data/lib/bundler/rubygems_integration.rb +71 -32
  98. data/lib/bundler/runtime.rb +11 -9
  99. data/lib/bundler/settings/validator.rb +102 -0
  100. data/lib/bundler/settings.rb +200 -77
  101. data/lib/bundler/setup.rb +1 -0
  102. data/lib/bundler/shared_helpers.rb +131 -26
  103. data/lib/bundler/similarity_detector.rb +1 -0
  104. data/lib/bundler/source/gemspec.rb +1 -0
  105. data/lib/bundler/source/git/git_proxy.rb +21 -11
  106. data/lib/bundler/source/git.rb +24 -19
  107. data/lib/bundler/source/metadata.rb +62 -0
  108. data/lib/bundler/source/path/installer.rb +2 -0
  109. data/lib/bundler/source/path.rb +8 -8
  110. data/lib/bundler/source/rubygems/remote.rb +8 -2
  111. data/lib/bundler/source/rubygems.rb +161 -84
  112. data/lib/bundler/source.rb +36 -0
  113. data/lib/bundler/source_list.rb +75 -15
  114. data/lib/bundler/spec_set.rb +10 -5
  115. data/lib/bundler/ssl_certs/certificate_manager.rb +2 -1
  116. data/lib/bundler/stub_specification.rb +1 -0
  117. data/lib/bundler/templates/.document +1 -0
  118. data/lib/bundler/templates/Executable +12 -0
  119. data/lib/bundler/templates/Executable.bundler +105 -0
  120. data/lib/bundler/templates/Gemfile +1 -0
  121. data/lib/bundler/templates/gems.rb +8 -0
  122. data/lib/bundler/templates/newgem/README.md.tt +1 -1
  123. data/lib/bundler/templates/newgem/gitignore.tt +0 -1
  124. data/lib/bundler/templates/newgem/lib/newgem.rb.tt +1 -0
  125. data/lib/bundler/templates/newgem/newgem.gemspec.tt +12 -3
  126. data/lib/bundler/templates/newgem/rspec.tt +1 -0
  127. data/lib/bundler/templates/newgem/spec/newgem_spec.rb.tt +0 -2
  128. data/lib/bundler/templates/newgem/{.travis.yml.tt → travis.yml.tt} +2 -0
  129. data/lib/bundler/ui/rg_proxy.rb +1 -0
  130. data/lib/bundler/ui/shell.rb +17 -4
  131. data/lib/bundler/ui/silent.rb +1 -0
  132. data/lib/bundler/ui.rb +1 -0
  133. data/lib/bundler/uri_credentials_filter.rb +1 -0
  134. data/lib/bundler/vendor/fileutils/lib/fileutils.rb +1638 -0
  135. data/lib/bundler/vendor/molinillo/lib/molinillo/compatibility.rb +26 -0
  136. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/resolution_state.rb +7 -0
  137. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +1 -0
  138. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/action.rb +1 -0
  139. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +1 -0
  140. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +1 -0
  141. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +1 -0
  142. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +1 -0
  143. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/log.rb +1 -0
  144. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/set_payload.rb +1 -0
  145. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +1 -0
  146. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +15 -4
  147. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +3 -2
  148. data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +75 -7
  149. data/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +2 -1
  150. data/lib/bundler/vendor/molinillo/lib/molinillo/modules/specification_provider.rb +1 -0
  151. data/lib/bundler/vendor/molinillo/lib/molinillo/modules/ui.rb +3 -1
  152. data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +491 -148
  153. data/lib/bundler/vendor/molinillo/lib/molinillo/resolver.rb +1 -0
  154. data/lib/bundler/vendor/molinillo/lib/molinillo/state.rb +8 -4
  155. data/lib/bundler/vendor/molinillo/lib/molinillo.rb +2 -0
  156. data/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +1 -1
  157. data/lib/bundler/vendor/thor/lib/thor/actions/create_file.rb +1 -0
  158. data/lib/bundler/vendor/thor/lib/thor/actions/create_link.rb +1 -0
  159. data/lib/bundler/vendor/thor/lib/thor/actions/empty_directory.rb +9 -1
  160. data/lib/bundler/vendor/thor/lib/thor/actions/file_manipulation.rb +45 -8
  161. data/lib/bundler/vendor/thor/lib/thor/actions/inject_into_file.rb +9 -3
  162. data/lib/bundler/vendor/thor/lib/thor/actions.rb +6 -3
  163. data/lib/bundler/vendor/thor/lib/thor/base.rb +27 -4
  164. data/lib/bundler/vendor/thor/lib/thor/command.rb +9 -7
  165. data/lib/bundler/vendor/thor/lib/thor/core_ext/hash_with_indifferent_access.rb +12 -0
  166. data/lib/bundler/vendor/thor/lib/thor/group.rb +1 -1
  167. data/lib/bundler/vendor/thor/lib/thor/line_editor/basic.rb +2 -0
  168. data/lib/bundler/vendor/thor/lib/thor/parser/option.rb +5 -5
  169. data/lib/bundler/vendor/thor/lib/thor/parser/options.rb +6 -5
  170. data/lib/bundler/vendor/thor/lib/thor/runner.rb +6 -4
  171. data/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +10 -9
  172. data/lib/bundler/vendor/thor/lib/thor/version.rb +1 -1
  173. data/lib/bundler/vendor/thor/lib/thor.rb +25 -8
  174. data/lib/bundler/vendored_fileutils.rb +9 -0
  175. data/lib/bundler/vendored_molinillo.rb +1 -0
  176. data/lib/bundler/vendored_persistent.rb +35 -0
  177. data/lib/bundler/vendored_thor.rb +1 -0
  178. data/lib/bundler/version.rb +6 -2
  179. data/lib/bundler/version_ranges.rb +1 -0
  180. data/lib/bundler/vlad.rb +5 -0
  181. data/lib/bundler/worker.rb +1 -0
  182. data/lib/bundler/yaml_serializer.rb +3 -3
  183. data/lib/bundler.rb +86 -52
  184. data/man/bundle-add.1 +18 -3
  185. data/man/bundle-add.1.txt +26 -14
  186. data/man/bundle-add.ronn +13 -2
  187. data/man/bundle-binstubs.1 +11 -1
  188. data/man/bundle-binstubs.1.txt +33 -18
  189. data/man/bundle-binstubs.ronn +15 -1
  190. data/man/bundle-check.1 +4 -4
  191. data/man/bundle-check.1.txt +15 -14
  192. data/man/bundle-check.ronn +3 -3
  193. data/man/bundle-clean.1 +1 -1
  194. data/man/bundle-clean.1.txt +10 -10
  195. data/man/bundle-config.1 +129 -29
  196. data/man/bundle-config.1.txt +285 -174
  197. data/man/bundle-config.ronn +167 -88
  198. data/man/bundle-doctor.1 +44 -0
  199. data/man/bundle-doctor.1.txt +44 -0
  200. data/man/bundle-doctor.ronn +33 -0
  201. data/man/bundle-exec.1 +6 -3
  202. data/man/bundle-exec.1.txt +78 -71
  203. data/man/bundle-exec.ronn +10 -3
  204. data/man/bundle-gem.1 +3 -3
  205. data/man/bundle-gem.1.txt +40 -39
  206. data/man/bundle-gem.ronn +2 -1
  207. data/man/bundle-info.1 +1 -1
  208. data/man/bundle-info.1.txt +8 -8
  209. data/man/bundle-init.1 +9 -4
  210. data/man/bundle-init.1.txt +23 -13
  211. data/man/bundle-init.ronn +15 -4
  212. data/man/bundle-inject.1 +4 -4
  213. data/man/bundle-inject.1.txt +10 -10
  214. data/man/bundle-inject.ronn +3 -3
  215. data/man/bundle-install.1 +31 -28
  216. data/man/bundle-install.1.txt +205 -194
  217. data/man/bundle-install.ronn +44 -35
  218. data/man/bundle-list.1 +50 -0
  219. data/man/bundle-list.1.txt +43 -0
  220. data/man/bundle-list.ronn +33 -0
  221. data/man/bundle-lock.1 +1 -1
  222. data/man/bundle-lock.1.txt +47 -47
  223. data/man/bundle-lock.ronn +1 -1
  224. data/man/bundle-open.1 +1 -1
  225. data/man/bundle-open.1.txt +7 -7
  226. data/man/bundle-outdated.1 +7 -3
  227. data/man/bundle-outdated.1.txt +40 -36
  228. data/man/bundle-outdated.ronn +6 -2
  229. data/man/bundle-package.1 +6 -3
  230. data/man/bundle-package.1.txt +44 -39
  231. data/man/bundle-package.ronn +7 -2
  232. data/man/bundle-platform.1 +1 -1
  233. data/man/bundle-platform.1.txt +13 -13
  234. data/man/bundle-pristine.1 +21 -3
  235. data/man/bundle-pristine.1.txt +33 -10
  236. data/man/bundle-pristine.ronn +24 -3
  237. data/man/bundle-remove.1 +31 -0
  238. data/man/bundle-remove.1.txt +34 -0
  239. data/man/bundle-remove.ronn +23 -0
  240. data/man/bundle-show.1 +3 -3
  241. data/man/bundle-show.1.txt +14 -12
  242. data/man/bundle-show.ronn +3 -2
  243. data/man/bundle-update.1 +13 -9
  244. data/man/bundle-update.1.txt +133 -130
  245. data/man/bundle-update.ronn +21 -17
  246. data/man/bundle-viz.1 +7 -7
  247. data/man/bundle-viz.1.txt +17 -15
  248. data/man/bundle-viz.ronn +6 -6
  249. data/man/bundle.1 +31 -23
  250. data/man/bundle.1.txt +63 -57
  251. data/man/bundle.ronn +35 -29
  252. data/man/gemfile.5 +44 -8
  253. data/man/gemfile.5.ronn +54 -8
  254. data/man/gemfile.5.txt +218 -165
  255. data/man/index.txt +25 -15
  256. metadata +36 -36
  257. data/.codeclimate.yml +0 -25
  258. data/.gitignore +0 -18
  259. data/.rspec +0 -3
  260. data/.rubocop.yml +0 -131
  261. data/.rubocop_todo.yml +0 -418
  262. data/.travis.yml +0 -122
  263. data/CODE_OF_CONDUCT.md +0 -42
  264. data/CONTRIBUTING.md +0 -17
  265. data/Rakefile +0 -338
  266. data/bin/rake +0 -19
  267. data/bin/rspec +0 -15
  268. data/bin/rubocop +0 -17
  269. data/bin/with_rubygems +0 -39
  270. data/doc/README.md +0 -30
  271. data/doc/TROUBLESHOOTING.md +0 -64
  272. data/doc/contributing/BUG_TRIAGE.md +0 -36
  273. data/doc/contributing/COMMUNITY.md +0 -13
  274. data/doc/contributing/GETTING_HELP.md +0 -11
  275. data/doc/contributing/HOW_YOU_CAN_HELP.md +0 -27
  276. data/doc/contributing/ISSUES.md +0 -51
  277. data/doc/contributing/README.md +0 -38
  278. data/doc/development/NEW_FEATURES.md +0 -10
  279. data/doc/development/PULL_REQUESTS.md +0 -40
  280. data/doc/development/README.md +0 -19
  281. data/doc/development/RELEASING.md +0 -9
  282. data/doc/development/SETUP.md +0 -27
  283. data/doc/documentation/README.md +0 -29
  284. data/doc/documentation/VISION.md +0 -26
  285. data/doc/documentation/WRITING.md +0 -54
  286. data/task/release.rake +0 -116
@@ -2,88 +2,101 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
2
2
 
3
3
 
4
4
 
5
- 1mNAME0m
6
- 1mbundle-config 22m- Set bundler configuration options
5
+ NAME
6
+ bundle-config - Set bundler configuration options
7
7
 
8
- 1mSYNOPSIS0m
9
- 1mbundle config 22m[4mname24m [4mvalue24m]]
8
+ SYNOPSIS
9
+ bundle config [name [value]]
10
10
 
11
- 1mDESCRIPTION0m
12
- This command allows you to interact with bundler's configuration sys-
13
- tem. Bundler retrieves its configuration from the local application
14
- (1mapp/.bundle/config22m), environment variables, and the user's home direc-
15
- tory (1m~/.bundle/config22m), in that order of priority.
11
+ DESCRIPTION
12
+ This command allows you to interact with Bundler's configuration sys-
13
+ tem.
16
14
 
17
- Executing 1mbundle config 22mwith no parameters will print a list of all
15
+ Bundler loads configuration settings in this order:
16
+
17
+ 1. Local config (app/.bundle/config)
18
+
19
+ 2. Environmental variables (ENV)
20
+
21
+ 3. Global config (~/.bundle/config)
22
+
23
+ 4. Bundler default config
24
+
25
+
26
+
27
+ Executing bundle config with no parameters will print a list of all
18
28
  bundler configuration for the current bundle, and where that configura-
19
29
  tion was set.
20
30
 
21
- Executing 1mbundle config <name> 22mwill print the value of that configura-
31
+ Executing bundle config <name> will print the value of that configura-
22
32
  tion setting, and where it was set.
23
33
 
24
- Executing 1mbundle config <name> <value> 22mwill set that configuration to
34
+ Executing bundle config <name> <value> will set that configuration to
25
35
  the value specified for all bundles executed as the current user. The
26
- configuration will be stored in 1m~/.bundle/config22m. If 4mname24m already is
27
- set, 4mname24m will be overridden and user will be warned.
36
+ configuration will be stored in ~/.bundle/config. If name already is
37
+ set, name will be overridden and user will be warned.
28
38
 
29
- Executing 1mbundle config --global <name> <value> 22mworks the same as
39
+ Executing bundle config --global <name> <value> works the same as
30
40
  above.
31
41
 
32
- Executing 1mbundle config --local <name> <value> 22mwill set that configura-
42
+ Executing bundle config --local <name> <value> will set that configura-
33
43
  tion to the local application. The configuration will be stored in
34
- 1mapp/.bundle/config22m.
44
+ app/.bundle/config.
35
45
 
36
- Executing 1mbundle config --delete <name> 22mwill delete the configuration
46
+ Executing bundle config --delete <name> will delete the configuration
37
47
  in both local and global sources. Not compatible with --global or
38
48
  --local flag.
39
49
 
40
- Executing bundle with the 1mBUNDLE_IGNORE_CONFIG 22menvironment variable set
50
+ Executing bundle with the BUNDLE_IGNORE_CONFIG environment variable set
41
51
  will cause it to ignore all configuration.
42
52
 
43
- Executing 1mbundle config disable_multisource true 22mupgrades the warning
53
+ Executing bundle config disable_multisource true upgrades the warning
44
54
  about the Gemfile containing multiple primary sources to an error. Exe-
45
- cuting 1mbundle config --delete disable_multisource 22mdowngrades this error
55
+ cuting bundle config --delete disable_multisource downgrades this error
46
56
  to a warning.
47
57
 
48
- 1mREMEMBERING OPTIONS0m
49
- Flags passed to 1mbundle install 22mor the Bundler runtime, such as 1m--path0m
50
- 1mfoo 22mor 1m--without production22m, are not remembered between commands. If
51
- these options must be remembered,they must be set using 1mbundle config0m
52
- (e.g., 1mbundle config path foo22m).
58
+ REMEMBERING OPTIONS
59
+ Flags passed to bundle install or the Bundler runtime, such as --path
60
+ foo or --without production, are not remembered between commands. If
61
+ these options must be remembered,they must be set using bundle config
62
+ (e.g., bundle config path foo).
53
63
 
54
64
  The options that can be configured are:
55
65
 
56
- 1mbin 22mCreates a directory (defaults to 1m~/bin22m) and place any executa-
66
+ bin Creates a directory (defaults to ~/bin) and place any executa-
57
67
  bles from the gem there. These executables run in Bundler's con-
58
68
  text. If used, you might add this directory to your environ-
59
- ment's 1mPATH 22mvariable. For instance, if the 1mrails 22mgem comes with
60
- a 1mrails 22mexecutable, this flag will create a 1mbin/rails 22mexecutable
69
+ ment's PATH variable. For instance, if the rails gem comes with
70
+ a rails executable, this flag will create a bin/rails executable
61
71
  that ensures that all referred dependencies will be resolved
62
72
  using the bundled gems.
63
73
 
64
- 1mdeployment0m
65
- In deployment mode, Bundler will 'roll-out' the bundle for 1mpro-0m
66
- 1mduction 22muse. Please check carefully if you want to have this
67
- option enabled in 1mdevelopment 22mor 1mtest 22menvironments.
74
+ deployment
75
+ In deployment mode, Bundler will 'roll-out' the bundle for pro-
76
+ duction use. Please check carefully if you want to have this
77
+ option enabled in development or test environments.
68
78
 
69
- 1mpath 22mThe location to install the specified gems to. This defaults to
79
+ path The location to install the specified gems to. This defaults to
70
80
  Rubygems' setting. Bundler shares this location with Rubygems,
71
- 1mgem install ... 22mwill have gem installed there, too. Therefore,
72
- gems installed without a 1m--path ... 22msetting will show up by
73
- calling 1mgem list22m. Accordingly, gems installed to other locations
81
+ gem install ... will have gem installed there, too. Therefore,
82
+ gems installed without a --path ... setting will show up by
83
+ calling gem list. Accordingly, gems installed to other locations
74
84
  will not get listed.
75
85
 
76
- 1mwithout0m
86
+ without
77
87
  A space-separated list of groups referencing gems to skip during
78
88
  installation.
79
89
 
80
- 1mBUILD OPTIONS0m
81
- You can use 1mbundle config 22mto give bundler the flags to pass to the gem
90
+ with A space-separated list of groups referencing gems to include
91
+ during installation.
92
+
93
+ BUILD OPTIONS
94
+ You can use bundle config to give Bundler the flags to pass to the gem
82
95
  installer every time bundler tries to install a particular gem.
83
96
 
84
- A very common example, the 1mmysql 22mgem, requires Snow Leopard users to
85
- pass configuration flags to 1mgem install 22mto specify where to find the
86
- 1mmysql_config 22mexecutable.
97
+ A very common example, the mysql gem, requires Snow Leopard users to
98
+ pass configuration flags to gem install to specify where to find the
99
+ mysql_config executable.
87
100
 
88
101
 
89
102
 
@@ -91,7 +104,7 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
91
104
 
92
105
 
93
106
 
94
- Since the specific location of that executable can change from machine
107
+ Since the specific location of that executable can change from machine
95
108
  to machine, you can specify these flags on a per-machine basis.
96
109
 
97
110
 
@@ -100,185 +113,266 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
100
113
 
101
114
 
102
115
 
103
- After running this command, every time bundler needs to install the
104
- 1mmysql 22mgem, it will pass along the flags you specified.
116
+ After running this command, every time bundler needs to install the
117
+ mysql gem, it will pass along the flags you specified.
105
118
 
106
- 1mCONFIGURATION KEYS0m
107
- Configuration keys in bundler have two forms: the canonical form and
119
+ CONFIGURATION KEYS
120
+ Configuration keys in bundler have two forms: the canonical form and
108
121
  the environment variable form.
109
122
 
110
- For instance, passing the 1m--without 22mflag to bundle install(1) 4mbun-0m
111
- 4mdle-install.1.html24m prevents Bundler from installing certain groups
112
- specified in the Gemfile(5). Bundler persists this value in 1mapp/.bun-0m
113
- 1mdle/config 22mso that calls to 1mBundler.setup 22mdo not try to find gems from
114
- the 1mGemfile 22mthat you didn't install. Additionally, subsequent calls to
115
- bundle install(1) 4mbundle-install.1.html24m remember this setting and skip
123
+ For instance, passing the --without flag to bundle install(1) bun-
124
+ dle-install.1.html prevents Bundler from installing certain groups
125
+ specified in the Gemfile(5). Bundler persists this value in app/.bun-
126
+ dle/config so that calls to Bundler.setup do not try to find gems from
127
+ the Gemfile that you didn't install. Additionally, subsequent calls to
128
+ bundle install(1) bundle-install.1.html remember this setting and skip
116
129
  those groups.
117
130
 
118
- The canonical form of this configuration is 1m"without"22m. To convert the
119
- canonical form to the environment variable form, capitalize it, and
120
- prepend 1mBUNDLE_22m. The environment variable form of 1m"without" 22mis 1mBUN-0m
121
- 1mDLE_WITHOUT22m.
131
+ The canonical form of this configuration is "without". To convert the
132
+ canonical form to the environment variable form, capitalize it, and
133
+ prepend BUNDLE_. The environment variable form of "without" is BUN-
134
+ DLE_WITHOUT.
122
135
 
123
- Any periods in the configuration keys must be replaced with two under-
136
+ Any periods in the configuration keys must be replaced with two under-
124
137
  scores when setting it via environment variables. The configuration key
125
- 1mlocal.rack 22mbecomes the environment variable 1mBUNDLE_LOCAL__RACK22m.
138
+ local.rack becomes the environment variable BUNDLE_LOCAL__RACK.
126
139
 
127
- 1mLIST OF AVAILABLE KEYS0m
128
- The following is a list of all configuration keys and their purpose.
129
- You can learn more about their operation in bundle install(1) 4mbun-0m
130
- 4mdle-install.1.html24m.
140
+ LIST OF AVAILABLE KEYS
141
+ The following is a list of all configuration keys and their purpose.
142
+ You can learn more about their operation in bundle install(1) bun-
143
+ dle-install.1.html.
131
144
 
132
- o 1mpath 22m(1mBUNDLE_PATH22m): The location on disk where all gems in your
133
- bundle will be located regardless of 1m$GEM_HOME 22mor 1m$GEM_PATH 22mvalues.
134
- Bundle gems not found in this location will be installed by 1mbundle0m
135
- 1minstall22m. Defaults to 1mGem.dir22m. When --deployment is used, defaults
136
- to vendor/bundle.
145
+ o allow_bundler_dependency_conflicts (BUNDLE_ALLOW_BUNDLER_DEPEN-
146
+ DENCY_CONFLICTS): Allow resolving to specifications that have
147
+ dependencies on bundler that are incompatible with the running
148
+ Bundler version.
137
149
 
138
- o 1mfrozen 22m(1mBUNDLE_FROZEN22m): Disallow changes to the 1mGemfile22m. Defaults
139
- to 1mtrue 22mwhen 1m--deployment 22mis used.
150
+ o allow_deployment_source_credential_changes (BUNDLE_ALLOW_DEPLOY-
151
+ MENT_SOURCE_CREDENTIAL_CHANGES): When in deployment mode, allow
152
+ changing the credentials to a gem's source. Ex:
153
+ https://some.host.com/gems/path/ -> https://user_name:pass-
154
+ word@some.host.com/gems/path
140
155
 
141
- o 1mwithout 22m(1mBUNDLE_WITHOUT22m): A 1m:22m-separated list of groups whose gems
142
- bundler should not install
156
+ o allow_offline_install (BUNDLE_ALLOW_OFFLINE_INSTALL): Allow Bundler
157
+ to use cached data when installing without network access.
143
158
 
144
- o 1mbin 22m(1mBUNDLE_BIN22m): Install executables from gems in the bundle to
145
- the specified directory. Defaults to 1mfalse22m.
159
+ o auto_clean_without_path (BUNDLE_AUTO_CLEAN_WITHOUT_PATH): Automati-
160
+ cally run bundle clean after installing when an explicit path has
161
+ not been set and Bundler is not installing into the system gems.
146
162
 
147
- o 1mgemfile 22m(1mBUNDLE_GEMFILE22m): The name of the file that bundler should
148
- use as the 1mGemfile22m. This location of this file also sets the root
149
- of the project, which is used to resolve relative paths in the 1mGem-0m
150
- 1mfile22m, among other things. By default, bundler will search up from
151
- the current working directory until it finds a 1mGemfile22m.
163
+ o auto_install (BUNDLE_AUTO_INSTALL): Automatically run bundle
164
+ install when gems are missing.
152
165
 
153
- o 1mssl_ca_cert 22m(1mBUNDLE_SSL_CA_CERT22m): Path to a designated CA certifi-
154
- cate file or folder containing multiple certificates for trusted
155
- CAs in PEM format.
166
+ o bin (BUNDLE_BIN): Install executables from gems in the bundle to
167
+ the specified directory. Defaults to false.
156
168
 
157
- o 1mssl_client_cert 22m(1mBUNDLE_SSL_CLIENT_CERT22m): Path to a designated file
158
- containing a X.509 client certificate and key in PEM format.
169
+ o cache_all (BUNDLE_CACHE_ALL): Cache all gems, including path and
170
+ git gems.
159
171
 
160
- o 1mcache_path 22m(1mBUNDLE_CACHE_PATH22m): The directory that bundler will
161
- place cached gems in when running 1mbundle package22m, and that bundler
162
- will look in when installing gems. Defaults to 1mvendor/bundle22m.
172
+ o cache_all_platforms (BUNDLE_CACHE_ALL_PLATFORMS): Cache gems for
173
+ all platforms.
163
174
 
164
- o 1mdisable_multisource 22m(1mBUNDLE_DISABLE_MULTISOURCE22m): When set, Gem-
165
- files containing multiple sources will produce errors instead of
166
- warnings. Use 1mbundle config --delete disable_multisource 22mto unset.
175
+ o cache_path (BUNDLE_CACHE_PATH): The directory that bundler will
176
+ place cached gems in when running bundle package, and that bundler
177
+ will look in when installing gems. Defaults to vendor/bundle.
167
178
 
168
- o 1mignore_messages 22m(1mBUNDLE_IGNORE_MESSAGES22m): When set, no post install
169
- messages will be printed. To silence a single gem, use dot notation
170
- like 1mignore_messages.httparty true22m.
179
+ o clean (BUNDLE_CLEAN): Whether Bundler should run bundle clean auto-
180
+ matically after bundle install.
171
181
 
172
- o 1mretry 22m(1mBUNDLE_RETRY22m): The number of times to retry failed network
173
- requests. Defaults to 1m322m.
182
+ o console (BUNDLE_CONSOLE): The console that bundle console starts.
183
+ Defaults to irb.
174
184
 
175
- o 1mredirect 22m(1mBUNDLE_REDIRECT22m): The number of redirects allowed for
176
- network requests. Defaults to 1m522m.
185
+ o default_install_uses_path (BUNDLE_DEFAULT_INSTALL_USES_PATH):
186
+ Whether a bundle install without an explicit --path argument
187
+ defaults to installing gems in .bundle.
177
188
 
178
- o 1mtimeout 22m(1mBUNDLE_TIMEOUT22m): The seconds allowed before timing out for
179
- network requests. Defaults to 1m1022m.
189
+ o deployment (BUNDLE_DEPLOYMENT): Disallow changes to the Gemfile.
190
+ When the Gemfile is changed and the lockfile has not been updated,
191
+ running Bundler commands will be blocked.
180
192
 
181
- o 1mforce_ruby_platform 22m(1mBUNDLE_FORCE_RUBY_PLATFORM22m): Ignore the cur-
182
- rent machine's platform and install only 1mruby 22mplatform gems. As a
183
- result, gems with native extensions will be compiled from source.
184
-
185
- o 1mspecific_platform 22m(1mBUNDLE_SPECIFIC_PLATFORM22m): Allow bundler to
186
- resolve for the specific running platform and store it in the lock-
187
- file, instead of only using a generic platform. A specific platform
188
- is the exact platform triple reported by 1mGem::Platform.local22m, such
189
- as 1mx86_64-darwin-16 22mor 1muniversal-java-1.822m. On the other hand,
190
- generic platforms are those such as 1mruby22m, 1mmswin22m, or 1mjava22m. In this
191
- example, 1mx86_64-darwin-16 22mwould map to 1mruby 22mand 1muniversal-java-1.80m
192
- to 1mjava22m.
193
-
194
- o 1mdisable_checksum_validation 22m(1mBUNDLE_DISABLE_CHECKSUM_VALIDATION22m):
195
- Allow installing gems even if they do not match the checksum pro-
193
+ o disable_checksum_validation (BUNDLE_DISABLE_CHECKSUM_VALIDATION):
194
+ Allow installing gems even if they do not match the checksum pro-
196
195
  vided by RubyGems.
197
196
 
198
- o 1mdisable_version_check 22m(1mBUNDLE_DISABLE_VERSION_CHECK22m): Stop Bundler
197
+ o disable_exec_load (BUNDLE_DISABLE_EXEC_LOAD): Stop Bundler from
198
+ using load to launch an executable in-process in bundle exec.
199
+
200
+ o disable_local_branch_check (BUNDLE_DISABLE_LOCAL_BRANCH_CHECK):
201
+ Allow Bundler to use a local git override without a branch speci-
202
+ fied in the Gemfile.
203
+
204
+ o disable_multisource (BUNDLE_DISABLE_MULTISOURCE): When set, Gem-
205
+ files containing multiple sources will produce errors instead of
206
+ warnings. Use bundle config --delete disable_multisource to unset.
207
+
208
+ o disable_platform_warnings (BUNDLE_DISABLE_PLATFORM_WARNINGS): Dis-
209
+ able warnings during bundle install when a dependency is unused on
210
+ the current platform.
211
+
212
+ o disable_shared_gems (BUNDLE_DISABLE_SHARED_GEMS): Stop Bundler from
213
+ accessing gems installed to RubyGems' normal location.
214
+
215
+ o disable_version_check (BUNDLE_DISABLE_VERSION_CHECK): Stop Bundler
199
216
  from checking if a newer Bundler version is available on
200
217
  rubygems.org.
201
218
 
202
- o 1mallow_offline_install 22m(1mBUNDLE_ALLOW_OFFLINE_INSTALL22m): Allow Bundler
203
- to use cached data when installing without network access.
219
+ o error_on_stderr (BUNDLE_ERROR_ON_STDERR): Print Bundler errors to
220
+ stderr.
204
221
 
205
- o 1mauto_install 22m(1mBUNDLE_AUTO_INSTALL22m): Automatically run 1mbundle0m
206
- 1minstall 22mwhen gems are missing.
222
+ o force_ruby_platform (BUNDLE_FORCE_RUBY_PLATFORM): Ignore the cur-
223
+ rent machine's platform and install only ruby platform gems. As a
224
+ result, gems with native extensions will be compiled from source.
207
225
 
208
- o 1mcache_all_platforms 22m(1mBUNDLE_CACHE_ALL_PLATFORMS22m): Cache gems for
209
- all platforms.
226
+ o frozen (BUNDLE_FROZEN): Disallow changes to the Gemfile. When the
227
+ Gemfile is changed and the lockfile has not been updated, running
228
+ Bundler commands will be blocked. Defaults to true when --deploy-
229
+ ment is used.
210
230
 
211
- o 1mcache_all 22m(1mBUNDLE_CACHE_ALL22m): Cache all gems, including path and
212
- git gems.
231
+ o gem.push_key (BUNDLE_GEM__PUSH_KEY): Sets the --key parameter for
232
+ gem push when using the rake release command with a private gem-
233
+ stash server.
213
234
 
214
- o 1mclean 22m(1mBUNDLE_CLEAN22m): Whether Bundler should run 1mbundle clean 22mauto-
215
- matically after 1mbundle install22m.
235
+ o gemfile (BUNDLE_GEMFILE): The name of the file that bundler should
236
+ use as the Gemfile. This location of this file also sets the root
237
+ of the project, which is used to resolve relative paths in the Gem-
238
+ file, among other things. By default, bundler will search up from
239
+ the current working directory until it finds a Gemfile.
216
240
 
217
- o 1mconsole 22m(1mBUNDLE_CONSOLE22m): The console that 1mbundle console 22mstarts.
218
- Defaults to 1mirb22m.
241
+ o global_gem_cache (BUNDLE_GLOBAL_GEM_CACHE): Whether Bundler should
242
+ cache all gems globally, rather than locally to the installing Ruby
243
+ installation.
219
244
 
220
- o 1mdisable_exec_load 22m(1mBUNDLE_DISABLE_EXEC_LOAD22m): Stop Bundler from
221
- using 1mload 22mto launch an executable in-process in 1mbundle exec22m.
245
+ o global_path_appends_ruby_scope (BUN-
246
+ DLE_GLOBAL_PATH_APPENDS_RUBY_SCOPE): Whether Bundler should append
247
+ the Ruby scope (e.g. engine and ABI version) to a globally-config-
248
+ ured path.
222
249
 
223
- o 1mdisable_local_branch_check 22m(1mBUNDLE_DISABLE_LOCAL_BRANCH_CHECK22m):
224
- Allow Bundler to use a local git override without a branch speci-
225
- fied in the Gemfile.
250
+ o ignore_messages (BUNDLE_IGNORE_MESSAGES): When set, no post install
251
+ messages will be printed. To silence a single gem, use dot notation
252
+ like ignore_messages.httparty true.
226
253
 
227
- o 1mdisable_shared_gems 22m(1mBUNDLE_DISABLE_SHARED_GEMS22m): Stop Bundler from
228
- accessing gems installed to RubyGems' normal location.
254
+ o init_gems_rb (BUNDLE_INIT_GEMS_RB) Generate a gems.rb instead of a
255
+ Gemfile when running bundle init.
229
256
 
230
- o 1mjobs 22m(1mBUNDLE_JOBS22m): The number of gems Bundler can install in par-
257
+ o jobs (BUNDLE_JOBS): The number of gems Bundler can install in par-
231
258
  allel. Defaults to 1.
232
259
 
233
- o 1mmajor_deprecations 22m(1mBUNDLE_MAJOR_DEPRECATIONS22m): Whether Bundler
260
+ o list_command (BUNDLE_LIST_COMMAND) Enable new list command feature
261
+
262
+ o major_deprecations (BUNDLE_MAJOR_DEPRECATIONS): Whether Bundler
234
263
  should print deprecation warnings for behavior that will be changed
235
264
  in the next major version.
236
265
 
237
- o 1mno_install 22m(1mBUNDLE_NO_INSTALL22m): Whether 1mbundle package 22mshould skip
266
+ o no_install (BUNDLE_NO_INSTALL): Whether bundle package should skip
238
267
  installing gems.
239
268
 
240
- o 1mno_prune 22m(1mBUNDLE_NO_PRUNE22m): Whether Bundler should leave outdated
269
+ o no_prune (BUNDLE_NO_PRUNE): Whether Bundler should leave outdated
241
270
  gems unpruned when caching.
242
271
 
243
- o 1monly_update_to_newer_versions 22m(1mBUNDLE_ONLY_UPDATE_TO_NEWER_VER-0m
244
- 1mSIONS22m): During 1mbundle update22m, only resolve to newer versions of the
272
+ o only_update_to_newer_versions (BUNDLE_ONLY_UPDATE_TO_NEWER_VER-
273
+ SIONS): During bundle update, only resolve to newer versions of the
245
274
  gems in the lockfile.
246
275
 
247
- o 1mplugins 22m(1mBUNDLE_PLUGINS22m): Enable Bundler's experimental plugin sys-
276
+ o path (BUNDLE_PATH): The location on disk where all gems in your
277
+ bundle will be located regardless of $GEM_HOME or $GEM_PATH values.
278
+ Bundle gems not found in this location will be installed by bundle
279
+ install. Defaults to Gem.dir. When --deployment is used, defaults
280
+ to vendor/bundle.
281
+
282
+ o path.system (BUNDLE_PATH__SYSTEM): Whether Bundler will install
283
+ gems into the default system path (Gem.dir).
284
+
285
+ o path_relative_to_cwd (PATH_RELATIVE_TO_CWD) Makes --path relative
286
+ to the CWD instead of the Gemfile.
287
+
288
+ o plugins (BUNDLE_PLUGINS): Enable Bundler's experimental plugin sys-
248
289
  tem.
249
290
 
250
- o 1mshebang 22m(1mBUNDLE_SHEBANG22m): The program name that should be invoked
291
+ o prefer_gems_rb (BUNDLE_PREFER_GEMS_RB) Prefer gems.rb to Gemfile
292
+ when Bundler is searching for a Gemfile.
293
+
294
+ o print_only_version_number (BUNDLE_PRINT_ONLY_VERSION_NUMBER) Print
295
+ only version number from bundler --version.
296
+
297
+ o redirect (BUNDLE_REDIRECT): The number of redirects allowed for
298
+ network requests. Defaults to 5.
299
+
300
+ o retry (BUNDLE_RETRY): The number of times to retry failed network
301
+ requests. Defaults to 3.
302
+
303
+ o setup_makes_kernel_gem_public (BUNDLE_SETUP_MAKES_KERNEL_GEM_PUB-
304
+ LIC): Have Bundler.setup make the Kernel#gem method public, even
305
+ though RubyGems declares it as private.
306
+
307
+ o shebang (BUNDLE_SHEBANG): The program name that should be invoked
251
308
  for generated binstubs. Defaults to the ruby install name used to
252
309
  generate the binstub.
253
310
 
254
- o 1msilence_root_warning 22m(1mBUNDLE_SILENCE_ROOT_WARNING22m): Silence the
311
+ o silence_root_warning (BUNDLE_SILENCE_ROOT_WARNING): Silence the
255
312
  warning Bundler prints when installing gems as root.
256
313
 
257
- o 1mssl_verify_mode 22m(1mBUNDLE_SSL_VERIFY_MODE22m): The SSL verification mode
314
+ o skip_default_git_sources (BUNDLE_SKIP_DEFAULT_GIT_SOURCES): Whether
315
+ Bundler should skip adding default git source shortcuts to the Gem-
316
+ file DSL.
317
+
318
+ o specific_platform (BUNDLE_SPECIFIC_PLATFORM): Allow bundler to
319
+ resolve for the specific running platform and store it in the lock-
320
+ file, instead of only using a generic platform. A specific platform
321
+ is the exact platform triple reported by Gem::Platform.local, such
322
+ as x86_64-darwin-16 or universal-java-1.8. On the other hand,
323
+ generic platforms are those such as ruby, mswin, or java. In this
324
+ example, x86_64-darwin-16 would map to ruby and universal-java-1.8
325
+ to java.
326
+
327
+ o ssl_ca_cert (BUNDLE_SSL_CA_CERT): Path to a designated CA certifi-
328
+ cate file or folder containing multiple certificates for trusted
329
+ CAs in PEM format.
330
+
331
+ o ssl_client_cert (BUNDLE_SSL_CLIENT_CERT): Path to a designated file
332
+ containing a X.509 client certificate and key in PEM format.
333
+
334
+ o ssl_verify_mode (BUNDLE_SSL_VERIFY_MODE): The SSL verification mode
258
335
  Bundler uses when making HTTPS requests. Defaults to verify peer.
259
336
 
260
- o 1msystem_bindir 22m(1mBUNDLE_SYSTEM_BINDIR22m): The location where RubyGems
261
- installs binstubs. Defaults to 1mGem.bindir22m.
337
+ o suppress_install_using_messages (BUNDLE_SUPPRESS_INSTALL_USING_MES-
338
+ SAGES): Avoid printing Using ... messages during installation when
339
+ the version of a gem has not changed.
340
+
341
+ o system_bindir (BUNDLE_SYSTEM_BINDIR): The location where RubyGems
342
+ installs binstubs. Defaults to Gem.bindir.
343
+
344
+ o timeout (BUNDLE_TIMEOUT): The seconds allowed before timing out for
345
+ network requests. Defaults to 10.
346
+
347
+ o unlock_source_unlocks_spec (BUNDLE_UNLOCK_SOURCE_UNLOCKS_SPEC):
348
+ Whether running bundle update --source NAME unlocks a gem with the
349
+ given name. Defaults to true.
350
+
351
+ o update_requires_all_flag (BUNDLE_UPDATE_REQUIRES_ALL_FLAG) Require
352
+ passing --all to bundle update when everything should be updated,
353
+ and disallow passing no options to bundle update.
262
354
 
263
- o 1muser_agent 22m(1mBUNDLE_USER_AGENT22m): The custom user agent fragment
355
+ o user_agent (BUNDLE_USER_AGENT): The custom user agent fragment
264
356
  Bundler includes in API requests.
265
357
 
266
- o 1mgem.push_key 22m(1mBUNDLE_GEM__PUSH_KEY22m): Sets the 1m--key 22mparamter for
267
- 1mgem push 22mwhen using the 1mrake release 22mcommand with a private gem-
268
- stash server.
358
+ o with (BUNDLE_WITH): A :-separated list of groups whose gems bundler
359
+ should install.
360
+
361
+ o without (BUNDLE_WITHOUT): A :-separated list of groups whose gems
362
+ bundler should not install.
269
363
 
270
364
 
271
365
 
272
- In general, you should set these settings per-application by using the
273
- applicable flag to the bundle install(1) 4mbundle-install.1.html24m or bun-
274
- dle package(1) 4mbundle-package.1.html24m command.
366
+ In general, you should set these settings per-application by using the
367
+ applicable flag to the bundle install(1) bundle-install.1.html or bun-
368
+ dle package(1) bundle-package.1.html command.
275
369
 
276
- You can set them globally either via environment variables or 1mbundle0m
277
- 1mconfig22m, whichever is preferable for your setup. If you use both, envi-
370
+ You can set them globally either via environment variables or bundle
371
+ config, whichever is preferable for your setup. If you use both, envi-
278
372
  ronment variables will take preference over global settings.
279
373
 
280
- 1mLOCAL GIT REPOS0m
281
- Bundler also allows you to work against a git repository locally
374
+ LOCAL GIT REPOS
375
+ Bundler also allows you to work against a git repository locally
282
376
  instead of using the remote version. This can be achieved by setting up
283
377
  a local override:
284
378
 
@@ -297,28 +391,29 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
297
391
 
298
392
 
299
393
 
300
- Now instead of checking out the remote git repository, the local over-
301
- ride will be used. Similar to a path source, every time the local git
302
- repository change, changes will be automatically picked up by Bundler.
303
- This means a commit in the local git repo will update the revision in
304
- the 1mGemfile.lock 22mto the local git repo revision. This requires the same
305
- attention as git submodules. Before pushing to the remote, you need to
394
+ Now instead of checking out the remote git repository, the local over-
395
+ ride will be used. Similar to a path source, every time the local git
396
+ repository change, changes will be automatically picked up by Bundler.
397
+ This means a commit in the local git repo will update the revision in
398
+ the Gemfile.lock to the local git repo revision. This requires the same
399
+ attention as git submodules. Before pushing to the remote, you need to
306
400
  ensure the local override was pushed, otherwise you may point to a com-
307
- mit that only exists in your local machine.
401
+ mit that only exists in your local machine. You'll also need to CGI
402
+ escape your usernames and passwords as well.
308
403
 
309
404
  Bundler does many checks to ensure a developer won't work with invalid
310
405
  references. Particularly, we force a developer to specify a branch in
311
- the 1mGemfile 22min order to use this feature. If the branch specified in
312
- the 1mGemfile 22mand the current branch in the local git repository do not
406
+ the Gemfile in order to use this feature. If the branch specified in
407
+ the Gemfile and the current branch in the local git repository do not
313
408
  match, Bundler will abort. This ensures that a developer is always
314
409
  working against the correct branches, and prevents accidental locking
315
410
  to a different branch.
316
411
 
317
- Finally, Bundler also ensures that the current revision in the 1mGem-0m
318
- 1mfile.lock 22mexists in the local git repository. By doing this, Bundler
412
+ Finally, Bundler also ensures that the current revision in the Gem-
413
+ file.lock exists in the local git repository. By doing this, Bundler
319
414
  forces you to fetch the latest changes in the remotes.
320
415
 
321
- 1mMIRRORS OF GEM SOURCES0m
416
+ MIRRORS OF GEM SOURCES
322
417
  Bundler supports overriding gem sources with mirrors. This allows you
323
418
  to configure rubygems.org as the gem source in your Gemfile while still
324
419
  using your mirror to fetch gems.
@@ -359,7 +454,7 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
359
454
  The default fallback timeout is 0.1 seconds, but the setting can cur-
360
455
  rently only accept whole seconds (for example, 1, 15, or 30).
361
456
 
362
- 1mCREDENTIALS FOR GEM SOURCES0m
457
+ CREDENTIALS FOR GEM SOURCES
363
458
  Bundler allows you to configure credentials for any gem source, which
364
459
  allows you to avoid putting secrets into your Gemfile.
365
460
 
@@ -369,8 +464,8 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
369
464
 
370
465
 
371
466
 
372
- For example, to save the credentials of user 1mclaudette 22mfor the gem
373
- source at 1mgems.longerous.com22m, you would run:
467
+ For example, to save the credentials of user claudette for the gem
468
+ source at gems.longerous.com, you would run:
374
469
 
375
470
 
376
471
 
@@ -412,7 +507,23 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
412
507
 
413
508
 
414
509
 
510
+ CONFIGURE BUNDLER DIRECTORIES
511
+ Bundler's home, config, cache and plugin directories are able to be
512
+ configured through environment variables. The default location for
513
+ Bundler's home directory is ~/.bundle, which all directories inherit
514
+ from by default. The following outlines the available environment vari-
515
+ ables and their default values
516
+
517
+
518
+
519
+ BUNDLE_USER_HOME : $HOME/.bundle
520
+ BUNDLE_USER_CACHE : $BUNDLE_USER_HOME/cache
521
+ BUNDLE_USER_CONFIG : $BUNDLE_USER_HOME/config
522
+ BUNDLE_USER_PLUGIN : $BUNDLE_USER_HOME/plugin
523
+
524
+
525
+
415
526
 
416
527
 
417
528
 
418
- July 2017 BUNDLE-CONFIG(1)
529
+ December 2018 BUNDLE-CONFIG(1)