bundler 1.9.0 → 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 (328) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGELOG.md +1157 -6
  3. data/README.md +33 -6
  4. data/bundler.gemspec +51 -18
  5. data/exe/bundle +31 -0
  6. data/{bin → exe}/bundle_ruby +10 -6
  7. data/exe/bundler +4 -0
  8. data/lib/bundler.rb +326 -207
  9. data/lib/bundler/build_metadata.rb +53 -0
  10. data/lib/bundler/capistrano.rb +9 -3
  11. data/lib/bundler/cli.rb +522 -141
  12. data/lib/bundler/cli/add.rb +35 -0
  13. data/lib/bundler/cli/binstubs.rb +22 -11
  14. data/lib/bundler/cli/cache.rb +7 -6
  15. data/lib/bundler/cli/check.rb +11 -8
  16. data/lib/bundler/cli/clean.rb +7 -8
  17. data/lib/bundler/cli/common.rb +53 -7
  18. data/lib/bundler/cli/config.rb +84 -49
  19. data/lib/bundler/cli/console.rb +13 -8
  20. data/lib/bundler/cli/doctor.rb +140 -0
  21. data/lib/bundler/cli/exec.rb +77 -16
  22. data/lib/bundler/cli/gem.rb +120 -52
  23. data/lib/bundler/cli/info.rb +50 -0
  24. data/lib/bundler/cli/init.rb +21 -7
  25. data/lib/bundler/cli/inject.rb +37 -10
  26. data/lib/bundler/cli/install.rb +139 -78
  27. data/lib/bundler/cli/issue.rb +40 -0
  28. data/lib/bundler/cli/list.rb +58 -0
  29. data/lib/bundler/cli/lock.rb +63 -0
  30. data/lib/bundler/cli/open.rb +9 -6
  31. data/lib/bundler/cli/outdated.rb +221 -35
  32. data/lib/bundler/cli/package.rb +11 -7
  33. data/lib/bundler/cli/platform.rb +7 -4
  34. data/lib/bundler/cli/plugin.rb +24 -0
  35. data/lib/bundler/cli/pristine.rb +47 -0
  36. data/lib/bundler/cli/remove.rb +18 -0
  37. data/lib/bundler/cli/show.rb +11 -10
  38. data/lib/bundler/cli/update.rb +47 -29
  39. data/lib/bundler/cli/viz.rb +12 -8
  40. data/lib/bundler/compact_index_client.rb +109 -0
  41. data/lib/bundler/compact_index_client/cache.rb +118 -0
  42. data/lib/bundler/compact_index_client/updater.rb +116 -0
  43. data/lib/bundler/compatibility_guard.rb +14 -0
  44. data/lib/bundler/constants.rb +3 -1
  45. data/lib/bundler/current_ruby.rb +47 -137
  46. data/lib/bundler/definition.rb +599 -230
  47. data/lib/bundler/dep_proxy.rb +15 -10
  48. data/lib/bundler/dependency.rb +54 -25
  49. data/lib/bundler/deployment.rb +12 -2
  50. data/lib/bundler/deprecate.rb +33 -4
  51. data/lib/bundler/dsl.rb +383 -99
  52. data/lib/bundler/endpoint_specification.rb +72 -7
  53. data/lib/bundler/env.rb +121 -41
  54. data/lib/bundler/environment_preserver.rb +59 -0
  55. data/lib/bundler/errors.rb +158 -0
  56. data/lib/bundler/feature_flag.rb +74 -0
  57. data/lib/bundler/fetcher.rb +171 -280
  58. data/lib/bundler/fetcher/base.rb +52 -0
  59. data/lib/bundler/fetcher/compact_index.rb +126 -0
  60. data/lib/bundler/fetcher/dependency.rb +82 -0
  61. data/lib/bundler/fetcher/downloader.rb +84 -0
  62. data/lib/bundler/fetcher/index.rb +52 -0
  63. data/lib/bundler/friendly_errors.rb +113 -58
  64. data/lib/bundler/gem_helper.rb +73 -46
  65. data/lib/bundler/gem_helpers.rb +85 -9
  66. data/lib/bundler/gem_remote_fetcher.rb +43 -0
  67. data/lib/bundler/gem_tasks.rb +6 -1
  68. data/lib/bundler/gem_version_promoter.rb +190 -0
  69. data/lib/bundler/gemdeps.rb +29 -0
  70. data/lib/bundler/graph.rb +32 -49
  71. data/lib/bundler/index.rb +79 -67
  72. data/lib/bundler/injector.rb +219 -30
  73. data/lib/bundler/inline.rb +74 -0
  74. data/lib/bundler/installer.rb +191 -206
  75. data/lib/bundler/installer/gem_installer.rb +85 -0
  76. data/lib/bundler/installer/parallel_installer.rb +233 -0
  77. data/lib/bundler/installer/standalone.rb +53 -0
  78. data/lib/bundler/lazy_specification.rb +53 -13
  79. data/lib/bundler/lockfile_generator.rb +95 -0
  80. data/lib/bundler/lockfile_parser.rb +157 -62
  81. data/lib/bundler/match_platform.rb +15 -4
  82. data/lib/bundler/mirror.rb +223 -0
  83. data/lib/bundler/plugin.rb +292 -0
  84. data/lib/bundler/plugin/api.rb +81 -0
  85. data/lib/bundler/plugin/api/source.rb +306 -0
  86. data/lib/bundler/plugin/dsl.rb +53 -0
  87. data/lib/bundler/plugin/events.rb +61 -0
  88. data/lib/bundler/plugin/index.rb +162 -0
  89. data/lib/bundler/plugin/installer.rb +96 -0
  90. data/lib/bundler/plugin/installer/git.rb +38 -0
  91. data/lib/bundler/plugin/installer/rubygems.rb +27 -0
  92. data/lib/bundler/plugin/source_list.rb +27 -0
  93. data/lib/bundler/process_lock.rb +24 -0
  94. data/lib/bundler/psyched_yaml.rb +17 -6
  95. data/lib/bundler/remote_specification.rb +68 -11
  96. data/lib/bundler/resolver.rb +263 -229
  97. data/lib/bundler/resolver/spec_group.rb +106 -0
  98. data/lib/bundler/retry.rb +25 -19
  99. data/lib/bundler/ruby_dsl.rb +9 -2
  100. data/lib/bundler/ruby_version.rb +101 -66
  101. data/lib/bundler/rubygems_ext.rb +77 -37
  102. data/lib/bundler/rubygems_gem_installer.rb +106 -0
  103. data/lib/bundler/rubygems_integration.rb +450 -163
  104. data/lib/bundler/runtime.rb +133 -103
  105. data/lib/bundler/settings.rb +344 -83
  106. data/lib/bundler/settings/validator.rb +102 -0
  107. data/lib/bundler/setup.rb +7 -3
  108. data/lib/bundler/shared_helpers.rb +284 -54
  109. data/lib/bundler/similarity_detector.rb +21 -21
  110. data/lib/bundler/source.rb +68 -15
  111. data/lib/bundler/source/gemspec.rb +18 -0
  112. data/lib/bundler/source/git.rb +90 -55
  113. data/lib/bundler/source/git/git_proxy.rb +135 -35
  114. data/lib/bundler/source/metadata.rb +62 -0
  115. data/lib/bundler/source/path.rb +84 -61
  116. data/lib/bundler/source/path/installer.rb +53 -17
  117. data/lib/bundler/source/rubygems.rb +282 -122
  118. data/lib/bundler/source/rubygems/remote.rb +69 -0
  119. data/lib/bundler/source_list.rb +107 -22
  120. data/lib/bundler/spec_set.rb +83 -45
  121. data/lib/bundler/ssl_certs/certificate_manager.rb +8 -7
  122. data/lib/bundler/ssl_certs/index.rubygems.org/GlobalSignRootCA.pem +21 -0
  123. data/lib/bundler/ssl_certs/{DigiCertHighAssuranceEVRootCA.pem → rubygems.global.ssl.fastly.net/DigiCertHighAssuranceEVRootCA.pem} +0 -0
  124. data/lib/bundler/ssl_certs/{AddTrustExternalCARoot-2048.pem → rubygems.org/AddTrustExternalCARoot.pem} +0 -0
  125. data/lib/bundler/stub_specification.rb +108 -0
  126. data/lib/bundler/templates/.document +1 -0
  127. data/lib/bundler/templates/Executable +19 -6
  128. data/lib/bundler/templates/Executable.bundler +105 -0
  129. data/lib/bundler/templates/Executable.standalone +6 -4
  130. data/lib/bundler/templates/Gemfile +4 -1
  131. data/lib/bundler/templates/gems.rb +8 -0
  132. data/lib/bundler/templates/newgem/CODE_OF_CONDUCT.md.tt +68 -7
  133. data/lib/bundler/templates/newgem/Gemfile.tt +4 -2
  134. data/lib/bundler/templates/newgem/LICENSE.txt.tt +1 -1
  135. data/lib/bundler/templates/newgem/README.md.tt +19 -11
  136. data/lib/bundler/templates/newgem/Rakefile.tt +10 -6
  137. data/lib/bundler/templates/newgem/bin/console.tt +1 -1
  138. data/lib/bundler/templates/newgem/bin/setup.tt +2 -1
  139. data/lib/bundler/templates/newgem/ext/newgem/newgem.c.tt +4 -4
  140. data/lib/bundler/templates/newgem/ext/newgem/newgem.h.tt +3 -3
  141. data/lib/bundler/templates/newgem/gitignore.tt +5 -1
  142. data/lib/bundler/templates/newgem/lib/newgem.rb.tt +7 -6
  143. data/lib/bundler/templates/newgem/lib/newgem/version.rb.tt +4 -4
  144. data/lib/bundler/templates/newgem/newgem.gemspec.tt +31 -15
  145. data/lib/bundler/templates/newgem/rspec.tt +1 -0
  146. data/lib/bundler/templates/newgem/spec/newgem_spec.rb.tt +3 -5
  147. data/lib/bundler/templates/newgem/spec/spec_helper.rb.tt +14 -2
  148. data/lib/bundler/templates/newgem/test/{test_newgem.rb.tt → newgem_test.rb.tt} +2 -2
  149. data/lib/bundler/templates/newgem/test/test_helper.rb.tt +4 -0
  150. data/lib/bundler/templates/newgem/travis.yml.tt +7 -0
  151. data/lib/bundler/ui.rb +5 -3
  152. data/lib/bundler/ui/rg_proxy.rb +5 -7
  153. data/lib/bundler/ui/shell.rb +69 -18
  154. data/lib/bundler/ui/silent.rb +26 -1
  155. data/lib/bundler/uri_credentials_filter.rb +37 -0
  156. data/lib/bundler/vendor/fileutils/lib/fileutils.rb +1638 -0
  157. data/lib/bundler/vendor/molinillo/lib/molinillo.rb +12 -0
  158. data/lib/bundler/vendor/molinillo/lib/molinillo/compatibility.rb +26 -0
  159. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/resolution_state.rb +57 -0
  160. data/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +81 -0
  161. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +223 -0
  162. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/action.rb +36 -0
  163. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +66 -0
  164. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +62 -0
  165. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +63 -0
  166. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +61 -0
  167. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/log.rb +126 -0
  168. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/set_payload.rb +46 -0
  169. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +36 -0
  170. data/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +136 -0
  171. data/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +143 -0
  172. data/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +6 -0
  173. data/lib/bundler/vendor/{Molinillo-0.2.1 → molinillo}/lib/molinillo/modules/specification_provider.rb +11 -0
  174. data/lib/bundler/vendor/{Molinillo-0.2.1 → molinillo}/lib/molinillo/modules/ui.rb +6 -2
  175. data/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +837 -0
  176. data/lib/bundler/vendor/{Molinillo-0.2.1 → molinillo}/lib/molinillo/resolver.rb +6 -3
  177. data/lib/bundler/vendor/molinillo/lib/molinillo/state.rb +58 -0
  178. data/lib/bundler/vendor/{net → net-http-persistent/lib/net}/http/faster.rb +1 -0
  179. data/lib/bundler/vendor/{net → net-http-persistent/lib/net}/http/persistent.rb +27 -24
  180. data/lib/bundler/vendor/{net → net-http-persistent/lib/net}/http/persistent/ssl_reuse.rb +2 -1
  181. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor.rb +47 -22
  182. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions.rb +31 -29
  183. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/create_file.rb +3 -2
  184. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/create_link.rb +3 -2
  185. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/directory.rb +3 -3
  186. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/empty_directory.rb +16 -8
  187. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/file_manipulation.rb +66 -18
  188. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/actions/inject_into_file.rb +18 -16
  189. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/base.rb +67 -44
  190. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/command.rb +13 -11
  191. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/core_ext/hash_with_indifferent_access.rb +21 -1
  192. data/lib/bundler/vendor/thor/lib/thor/core_ext/io_binary_read.rb +12 -0
  193. data/lib/bundler/vendor/thor/lib/thor/core_ext/ordered_hash.rb +129 -0
  194. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/error.rb +3 -3
  195. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/group.rb +14 -14
  196. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/invocation.rb +4 -5
  197. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/line_editor.rb +2 -2
  198. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/line_editor/basic.rb +2 -0
  199. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/line_editor/readline.rb +0 -0
  200. data/lib/bundler/vendor/thor/lib/thor/parser.rb +4 -0
  201. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/parser/argument.rb +4 -7
  202. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/parser/arguments.rb +16 -16
  203. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/parser/option.rb +42 -21
  204. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/parser/options.rb +13 -10
  205. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/rake_compat.rb +1 -1
  206. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/runner.rb +35 -33
  207. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/shell.rb +4 -4
  208. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/shell/basic.rb +49 -33
  209. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/shell/color.rb +2 -2
  210. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/shell/html.rb +5 -5
  211. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/util.rb +8 -7
  212. data/lib/bundler/vendor/{thor-0.19.1 → thor}/lib/thor/version.rb +1 -1
  213. data/lib/bundler/vendored_fileutils.rb +9 -0
  214. data/lib/bundler/vendored_molinillo.rb +4 -5
  215. data/lib/bundler/vendored_persistent.rb +45 -4
  216. data/lib/bundler/vendored_thor.rb +8 -5
  217. data/lib/bundler/version.rb +23 -1
  218. data/lib/bundler/version_ranges.rb +76 -0
  219. data/lib/bundler/vlad.rb +8 -2
  220. data/lib/bundler/worker.rb +39 -6
  221. data/lib/bundler/yaml_serializer.rb +90 -0
  222. data/man/bundle-add.1 +58 -0
  223. data/man/bundle-add.1.txt +52 -0
  224. data/man/bundle-add.ronn +40 -0
  225. data/man/bundle-binstubs.1 +40 -0
  226. data/man/bundle-binstubs.1.txt +48 -0
  227. data/man/bundle-binstubs.ronn +43 -0
  228. data/man/bundle-check.1 +31 -0
  229. data/man/bundle-check.1.txt +33 -0
  230. data/man/bundle-check.ronn +26 -0
  231. data/man/bundle-clean.1 +24 -0
  232. data/man/bundle-clean.1.txt +26 -0
  233. data/man/bundle-clean.ronn +18 -0
  234. data/man/bundle-config.1 +497 -0
  235. data/man/bundle-config.1.txt +529 -0
  236. data/man/bundle-config.ronn +256 -31
  237. data/man/bundle-doctor.1 +44 -0
  238. data/man/bundle-doctor.1.txt +44 -0
  239. data/man/bundle-doctor.ronn +33 -0
  240. data/man/bundle-exec.1 +165 -0
  241. data/man/bundle-exec.1.txt +178 -0
  242. data/man/bundle-exec.ronn +19 -3
  243. data/man/bundle-gem.1 +80 -0
  244. data/man/bundle-gem.1.txt +91 -0
  245. data/man/bundle-gem.ronn +78 -0
  246. data/man/bundle-info.1 +20 -0
  247. data/man/bundle-info.1.txt +21 -0
  248. data/man/bundle-info.ronn +17 -0
  249. data/man/bundle-init.1 +25 -0
  250. data/man/bundle-init.1.txt +34 -0
  251. data/man/bundle-init.ronn +29 -0
  252. data/man/bundle-inject.1 +33 -0
  253. data/man/bundle-inject.1.txt +32 -0
  254. data/man/bundle-inject.ronn +22 -0
  255. data/man/bundle-install.1 +308 -0
  256. data/man/bundle-install.1.txt +396 -0
  257. data/man/bundle-install.ronn +64 -67
  258. data/man/bundle-list.1 +50 -0
  259. data/man/bundle-list.1.txt +43 -0
  260. data/man/bundle-list.ronn +33 -0
  261. data/man/bundle-lock.1 +84 -0
  262. data/man/bundle-lock.1.txt +93 -0
  263. data/man/bundle-lock.ronn +94 -0
  264. data/man/bundle-open.1 +32 -0
  265. data/man/bundle-open.1.txt +29 -0
  266. data/man/bundle-open.ronn +19 -0
  267. data/man/bundle-outdated.1 +155 -0
  268. data/man/bundle-outdated.1.txt +131 -0
  269. data/man/bundle-outdated.ronn +111 -0
  270. data/man/bundle-package.1 +55 -0
  271. data/man/bundle-package.1.txt +79 -0
  272. data/man/bundle-package.ronn +14 -8
  273. data/man/bundle-platform.1 +61 -0
  274. data/man/bundle-platform.1.txt +57 -0
  275. data/man/bundle-platform.ronn +1 -1
  276. data/man/bundle-pristine.1 +34 -0
  277. data/man/bundle-pristine.1.txt +44 -0
  278. data/man/bundle-pristine.ronn +34 -0
  279. data/man/bundle-remove.1 +31 -0
  280. data/man/bundle-remove.1.txt +34 -0
  281. data/man/bundle-remove.ronn +23 -0
  282. data/man/bundle-show.1 +23 -0
  283. data/man/bundle-show.1.txt +27 -0
  284. data/man/bundle-show.ronn +21 -0
  285. data/man/bundle-update.1 +394 -0
  286. data/man/bundle-update.1.txt +391 -0
  287. data/man/bundle-update.ronn +180 -18
  288. data/man/bundle-viz.1 +39 -0
  289. data/man/bundle-viz.1.txt +39 -0
  290. data/man/bundle-viz.ronn +30 -0
  291. data/man/bundle.1 +136 -0
  292. data/man/bundle.1.txt +116 -0
  293. data/man/bundle.ronn +46 -33
  294. data/man/gemfile.5 +689 -0
  295. data/man/gemfile.5.ronn +127 -79
  296. data/man/gemfile.5.txt +653 -0
  297. data/man/index.txt +25 -7
  298. metadata +242 -95
  299. data/.gitignore +0 -16
  300. data/.rspec +0 -3
  301. data/.travis.yml +0 -110
  302. data/CODE_OF_CONDUCT.md +0 -40
  303. data/CONTRIBUTING.md +0 -32
  304. data/DEVELOPMENT.md +0 -119
  305. data/ISSUES.md +0 -96
  306. data/Rakefile +0 -302
  307. data/UPGRADING.md +0 -103
  308. data/bin/bundle +0 -21
  309. data/bin/bundler +0 -21
  310. data/lib/bundler/anonymizable_uri.rb +0 -32
  311. data/lib/bundler/environment.rb +0 -42
  312. data/lib/bundler/gem_installer.rb +0 -9
  313. data/lib/bundler/gem_path_manipulation.rb +0 -8
  314. data/lib/bundler/ssl_certs/AddTrustExternalCARoot.pem +0 -32
  315. data/lib/bundler/ssl_certs/Class3PublicPrimaryCertificationAuthority.pem +0 -14
  316. data/lib/bundler/ssl_certs/EntrustnetSecureServerCertificationAuthority.pem +0 -28
  317. data/lib/bundler/ssl_certs/GeoTrustGlobalCA.pem +0 -20
  318. data/lib/bundler/templates/newgem/.travis.yml.tt +0 -3
  319. data/lib/bundler/templates/newgem/test/minitest_helper.rb.tt +0 -4
  320. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo.rb +0 -5
  321. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo/dependency_graph.rb +0 -266
  322. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo/errors.rb +0 -69
  323. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo/gem_metadata.rb +0 -3
  324. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo/resolution.rb +0 -412
  325. data/lib/bundler/vendor/Molinillo-0.2.1/lib/molinillo/state.rb +0 -43
  326. data/lib/bundler/vendor/thor-0.19.1/lib/thor/core_ext/io_binary_read.rb +0 -10
  327. data/lib/bundler/vendor/thor-0.19.1/lib/thor/core_ext/ordered_hash.rb +0 -98
  328. data/lib/bundler/vendor/thor-0.19.1/lib/thor/parser.rb +0 -4
@@ -0,0 +1,391 @@
1
+ BUNDLE-UPDATE(1) BUNDLE-UPDATE(1)
2
+
3
+
4
+
5
+ NAME
6
+ bundle-update - Update your gems to the latest available versions
7
+
8
+ SYNOPSIS
9
+ bundle update *gems [--all] [--group=NAME] [--source=NAME] [--local]
10
+ [--ruby] [--bundler[=VERSION]] [--full-index] [--jobs=JOBS] [--quiet]
11
+ [--force] [--patch|--minor|--major] [--strict] [--conservative]
12
+
13
+ DESCRIPTION
14
+ Update the gems specified (all gems, if --all flag is used), ignoring
15
+ the previously installed gems specified in the Gemfile.lock. In gen-
16
+ eral, you should use bundle install(1) bundle-install.1.html to install
17
+ the same exact gems and versions across machines.
18
+
19
+ You would use bundle update to explicitly update the version of a gem.
20
+
21
+ OPTIONS
22
+ --all Update all gems specified in Gemfile.
23
+
24
+ --group=<name>, -g=[<name>]
25
+ Only update the gems in the specified group. For instance, you
26
+ can update all gems in the development group with bundle update
27
+ --group development. You can also call bundle update rails
28
+ --group test to update the rails gem and all gems in the test
29
+ group, for example.
30
+
31
+ --source=<name>
32
+ The name of a :git or :path source used in the Gemfile(5). For
33
+ instance, with a :git source of
34
+ http://github.com/rails/rails.git, you would call bundle update
35
+ --source rails
36
+
37
+ --local
38
+ Do not attempt to fetch gems remotely and use the gem cache
39
+ instead.
40
+
41
+ --ruby Update the locked version of Ruby to the current version of
42
+ Ruby.
43
+
44
+ --bundler
45
+ Update the locked version of bundler to the invoked bundler ver-
46
+ sion.
47
+
48
+ --full-index
49
+ Fall back to using the single-file index of all gems.
50
+
51
+ --jobs=[<number>], -j[<number>]
52
+ Specify the number of jobs to run in parallel. The default is 1.
53
+
54
+ --retry=[<number>]
55
+ Retry failed network or git requests for number times.
56
+
57
+ --quiet
58
+ Only output warnings and errors.
59
+
60
+ --force
61
+ Force downloading every gem. --redownload is an alias of this
62
+ option.
63
+
64
+ --patch
65
+ Prefer updating only to next patch version.
66
+
67
+ --minor
68
+ Prefer updating only to next minor version.
69
+
70
+ --major
71
+ Prefer updating to next major version (default).
72
+
73
+ --strict
74
+ Do not allow any gem to be updated past latest --patch | --minor
75
+ | --major.
76
+
77
+ --conservative
78
+ Use bundle install conservative update behavior and do not allow
79
+ shared dependencies to be updated.
80
+
81
+ UPDATING ALL GEMS
82
+ If you run bundle update --all, bundler will ignore any previously
83
+ installed gems and resolve all dependencies again based on the latest
84
+ versions of all gems available in the sources.
85
+
86
+ Consider the following Gemfile(5):
87
+
88
+
89
+
90
+ source "https://rubygems.org"
91
+
92
+ gem "rails", "3.0.0.rc"
93
+ gem "nokogiri"
94
+
95
+
96
+
97
+ When you run bundle install(1) bundle-install.1.html the first time,
98
+ bundler will resolve all of the dependencies, all the way down, and
99
+ install what you need:
100
+
101
+
102
+
103
+ Fetching gem metadata from https://rubygems.org/.........
104
+ Resolving dependencies...
105
+ Installing builder 2.1.2
106
+ Installing abstract 1.0.0
107
+ Installing rack 1.2.8
108
+ Using bundler 1.7.6
109
+ Installing rake 10.4.0
110
+ Installing polyglot 0.3.5
111
+ Installing mime-types 1.25.1
112
+ Installing i18n 0.4.2
113
+ Installing mini_portile 0.6.1
114
+ Installing tzinfo 0.3.42
115
+ Installing rack-mount 0.6.14
116
+ Installing rack-test 0.5.7
117
+ Installing treetop 1.4.15
118
+ Installing thor 0.14.6
119
+ Installing activesupport 3.0.0.rc
120
+ Installing erubis 2.6.6
121
+ Installing activemodel 3.0.0.rc
122
+ Installing arel 0.4.0
123
+ Installing mail 2.2.20
124
+ Installing activeresource 3.0.0.rc
125
+ Installing actionpack 3.0.0.rc
126
+ Installing activerecord 3.0.0.rc
127
+ Installing actionmailer 3.0.0.rc
128
+ Installing railties 3.0.0.rc
129
+ Installing rails 3.0.0.rc
130
+ Installing nokogiri 1.6.5
131
+
132
+ Bundle complete! 2 Gemfile dependencies, 26 gems total.
133
+ Use `bundle show [gemname]` to see where a bundled gem is installed.
134
+
135
+
136
+
137
+ As you can see, even though you have two gems in the Gemfile(5), your
138
+ application needs 26 different gems in order to run. Bundler remembers
139
+ the exact versions it installed in Gemfile.lock. The next time you run
140
+ bundle install(1) bundle-install.1.html, bundler skips the dependency
141
+ resolution and installs the same gems as it installed last time.
142
+
143
+ After checking in the Gemfile.lock into version control and cloning it
144
+ on another machine, running bundle install(1) bundle-install.1.html
145
+ will still install the gems that you installed last time. You don't
146
+ need to worry that a new release of erubis or mail changes the gems you
147
+ use.
148
+
149
+ However, from time to time, you might want to update the gems you are
150
+ using to the newest versions that still match the gems in your Gem-
151
+ file(5).
152
+
153
+ To do this, run bundle update --all, which will ignore the Gem-
154
+ file.lock, and resolve all the dependencies again. Keep in mind that
155
+ this process can result in a significantly different set of the 25
156
+ gems, based on the requirements of new gems that the gem authors
157
+ released since the last time you ran bundle update --all.
158
+
159
+ UPDATING A LIST OF GEMS
160
+ Sometimes, you want to update a single gem in the Gemfile(5), and leave
161
+ the rest of the gems that you specified locked to the versions in the
162
+ Gemfile.lock.
163
+
164
+ For instance, in the scenario above, imagine that nokogiri releases
165
+ version 1.4.4, and you want to update it without updating Rails and all
166
+ of its dependencies. To do this, run bundle update nokogiri.
167
+
168
+ Bundler will update nokogiri and any of its dependencies, but leave
169
+ alone Rails and its dependencies.
170
+
171
+ OVERLAPPING DEPENDENCIES
172
+ Sometimes, multiple gems declared in your Gemfile(5) are satisfied by
173
+ the same second-level dependency. For instance, consider the case of
174
+ thin and rack-perftools-profiler.
175
+
176
+
177
+
178
+ source "https://rubygems.org"
179
+
180
+ gem "thin"
181
+ gem "rack-perftools-profiler"
182
+
183
+
184
+
185
+ The thin gem depends on rack >= 1.0, while rack-perftools-profiler
186
+ depends on rack ~> 1.0. If you run bundle install, you get:
187
+
188
+
189
+
190
+ Fetching source index for https://rubygems.org/
191
+ Installing daemons (1.1.0)
192
+ Installing eventmachine (0.12.10) with native extensions
193
+ Installing open4 (1.0.1)
194
+ Installing perftools.rb (0.4.7) with native extensions
195
+ Installing rack (1.2.1)
196
+ Installing rack-perftools_profiler (0.0.2)
197
+ Installing thin (1.2.7) with native extensions
198
+ Using bundler (1.0.0.rc.3)
199
+
200
+
201
+
202
+ In this case, the two gems have their own set of dependencies, but they
203
+ share rack in common. If you run bundle update thin, bundler will
204
+ update daemons, eventmachine and rack, which are dependencies of thin,
205
+ but not open4 or perftools.rb, which are dependencies of
206
+ rack-perftools_profiler. Note that bundle update thin will update rack
207
+ even though it's also a dependency of rack-perftools_profiler.
208
+
209
+ In short, by default, when you update a gem using bundle update,
210
+ bundler will update all dependencies of that gem, including those that
211
+ are also dependencies of another gem.
212
+
213
+ To prevent updating shared dependencies, prior to version 1.14 the only
214
+ option was the CONSERVATIVE UPDATING behavior in bundle install(1) bun-
215
+ dle-install.1.html:
216
+
217
+ In this scenario, updating the thin version manually in the Gemfile(5),
218
+ and then running bundle install(1) bundle-install.1.html will only
219
+ update daemons and eventmachine, but not rack. For more information,
220
+ see the CONSERVATIVE UPDATING section of bundle install(1) bun-
221
+ dle-install.1.html.
222
+
223
+ Starting with 1.14, specifying the --conservative option will also pre-
224
+ vent shared dependencies from being updated.
225
+
226
+ PATCH LEVEL OPTIONS
227
+ Version 1.14 introduced 4 patch-level options that will influence how
228
+ gem versions are resolved. One of the following options can be used:
229
+ --patch, --minor or --major. --strict can be added to further influence
230
+ resolution.
231
+
232
+ --patch
233
+ Prefer updating only to next patch version.
234
+
235
+ --minor
236
+ Prefer updating only to next minor version.
237
+
238
+ --major
239
+ Prefer updating to next major version (default).
240
+
241
+ --strict
242
+ Do not allow any gem to be updated past latest --patch | --minor
243
+ | --major.
244
+
245
+ When Bundler is resolving what versions to use to satisfy declared
246
+ requirements in the Gemfile or in parent gems, it looks up all avail-
247
+ able versions, filters out any versions that don't satisfy the require-
248
+ ment, and then, by default, sorts them from newest to oldest, consider-
249
+ ing them in that order.
250
+
251
+ Providing one of the patch level options (e.g. --patch) changes the
252
+ sort order of the satisfying versions, causing Bundler to consider the
253
+ latest --patch or --minor version available before other versions. Note
254
+ that versions outside the stated patch level could still be resolved to
255
+ if necessary to find a suitable dependency graph.
256
+
257
+ For example, if gem 'foo' is locked at 1.0.2, with no gem requirement
258
+ defined in the Gemfile, and versions 1.0.3, 1.0.4, 1.1.0, 1.1.1, 2.0.0
259
+ all exist, the default order of preference by default (--major) will be
260
+ "2.0.0, 1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2".
261
+
262
+ If the --patch option is used, the order of preference will change to
263
+ "1.0.4, 1.0.3, 1.0.2, 1.1.1, 1.1.0, 2.0.0".
264
+
265
+ If the --minor option is used, the order of preference will change to
266
+ "1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2, 2.0.0".
267
+
268
+ Combining the --strict option with any of the patch level options will
269
+ remove any versions beyond the scope of the patch level option, to
270
+ ensure that no gem is updated that far.
271
+
272
+ To continue the previous example, if both --patch and --strict options
273
+ are used, the available versions for resolution would be "1.0.4, 1.0.3,
274
+ 1.0.2". If --minor and --strict are used, it would be "1.1.1, 1.1.0,
275
+ 1.0.4, 1.0.3, 1.0.2".
276
+
277
+ Gem requirements as defined in the Gemfile will still be the first
278
+ determining factor for what versions are available. If the gem require-
279
+ ment for foo in the Gemfile is '~> 1.0', that will accomplish the same
280
+ thing as providing the --minor and --strict options.
281
+
282
+ PATCH LEVEL EXAMPLES
283
+ Given the following gem specifications:
284
+
285
+
286
+
287
+ foo 1.4.3, requires: ~> bar 2.0
288
+ foo 1.4.4, requires: ~> bar 2.0
289
+ foo 1.4.5, requires: ~> bar 2.1
290
+ foo 1.5.0, requires: ~> bar 2.1
291
+ foo 1.5.1, requires: ~> bar 3.0
292
+ bar with versions 2.0.3, 2.0.4, 2.1.0, 2.1.1, 3.0.0
293
+
294
+
295
+
296
+ Gemfile:
297
+
298
+
299
+
300
+ gem 'foo'
301
+
302
+
303
+
304
+ Gemfile.lock:
305
+
306
+
307
+
308
+ foo (1.4.3)
309
+ bar (~> 2.0)
310
+ bar (2.0.3)
311
+
312
+
313
+
314
+ Cases:
315
+
316
+
317
+
318
+ # Command Line Result
319
+ ------------------------------------------------------------
320
+ 1 bundle update --patch 'foo 1.4.5', 'bar 2.1.1'
321
+ 2 bundle update --patch foo 'foo 1.4.5', 'bar 2.1.1'
322
+ 3 bundle update --minor 'foo 1.5.1', 'bar 3.0.0'
323
+ 4 bundle update --minor --strict 'foo 1.5.0', 'bar 2.1.1'
324
+ 5 bundle update --patch --strict 'foo 1.4.4', 'bar 2.0.4'
325
+
326
+
327
+
328
+ In case 1, bar is upgraded to 2.1.1, a minor version increase, because
329
+ the dependency from foo 1.4.5 required it.
330
+
331
+ In case 2, only foo is requested to be unlocked, but bar is also
332
+ allowed to move because it's not a declared dependency in the Gemfile.
333
+
334
+ In case 3, bar goes up a whole major release, because a minor increase
335
+ is preferred now for foo, and when it goes to 1.5.1, it requires 3.0.0
336
+ of bar.
337
+
338
+ In case 4, foo is preferred up to a minor version, but 1.5.1 won't work
339
+ because the --strict flag removes bar 3.0.0 from consideration since
340
+ it's a major increment.
341
+
342
+ In case 5, both foo and bar have any minor or major increments removed
343
+ from consideration because of the --strict flag, so the most they can
344
+ move is up to 1.4.4 and 2.0.4.
345
+
346
+ RECOMMENDED WORKFLOW
347
+ In general, when working with an application managed with bundler, you
348
+ should use the following workflow:
349
+
350
+ o After you create your Gemfile(5) for the first time, run
351
+
352
+ $ bundle install
353
+
354
+ o Check the resulting Gemfile.lock into version control
355
+
356
+ $ git add Gemfile.lock
357
+
358
+ o When checking out this repository on another development machine,
359
+ run
360
+
361
+ $ bundle install
362
+
363
+ o When checking out this repository on a deployment machine, run
364
+
365
+ $ bundle install --deployment
366
+
367
+ o After changing the Gemfile(5) to reflect a new or update depen-
368
+ dency, run
369
+
370
+ $ bundle install
371
+
372
+ o Make sure to check the updated Gemfile.lock into version control
373
+
374
+ $ git add Gemfile.lock
375
+
376
+ o If bundle install(1) bundle-install.1.html reports a conflict, man-
377
+ ually update the specific gems that you changed in the Gemfile(5)
378
+
379
+ $ bundle update rails thin
380
+
381
+ o If you want to update all the gems to the latest possible versions
382
+ that still match the gems listed in the Gemfile(5), run
383
+
384
+ $ bundle update --all
385
+
386
+
387
+
388
+
389
+
390
+
391
+ December 2018 BUNDLE-UPDATE(1)
@@ -3,13 +3,25 @@ bundle-update(1) -- Update your gems to the latest available versions
3
3
 
4
4
  ## SYNOPSIS
5
5
 
6
- `bundle update` <*gems> [--group=NAME] [--source=NAME] [--local]
6
+ `bundle update` <*gems> [--all]
7
+ [--group=NAME]
8
+ [--source=NAME]
9
+ [--local]
10
+ [--ruby]
11
+ [--bundler[=VERSION]]
12
+ [--full-index]
13
+ [--jobs=JOBS]
14
+ [--quiet]
15
+ [--force]
16
+ [--patch|--minor|--major]
17
+ [--strict]
18
+ [--conservative]
7
19
 
8
20
  ## DESCRIPTION
9
21
 
10
- Update the gems specified (all gems, if none are specified), ignoring
22
+ Update the gems specified (all gems, if `--all` flag is used), ignoring
11
23
  the previously installed gems specified in the `Gemfile.lock`. In
12
- general, you should use [bundle install(1)][bundle-install] to install the same exact
24
+ general, you should use [bundle install(1)](bundle-install.1.html) to install the same exact
13
25
  gems and versions across machines.
14
26
 
15
27
  You would use `bundle update` to explicitly update the version of a
@@ -17,7 +29,10 @@ gem.
17
29
 
18
30
  ## OPTIONS
19
31
 
20
- * `--group=<name>`:
32
+ * `--all`:
33
+ Update all gems specified in Gemfile.
34
+
35
+ * `--group=<name>`, `-g=[<name>]`:
21
36
  Only update the gems in the specified group. For instance, you can update all gems
22
37
  in the development group with `bundle update --group development`. You can also
23
38
  call `bundle update rails --group test` to update the rails gem and all gems in
@@ -31,9 +46,45 @@ gem.
31
46
  * `--local`:
32
47
  Do not attempt to fetch gems remotely and use the gem cache instead.
33
48
 
49
+ * `--ruby`:
50
+ Update the locked version of Ruby to the current version of Ruby.
51
+
52
+ * `--bundler`:
53
+ Update the locked version of bundler to the invoked bundler version.
54
+
55
+ * `--full-index`:
56
+ Fall back to using the single-file index of all gems.
57
+
58
+ * `--jobs=[<number>]`, `-j[<number>]`:
59
+ Specify the number of jobs to run in parallel. The default is `1`.
60
+
61
+ * `--retry=[<number>]`:
62
+ Retry failed network or git requests for <number> times.
63
+
64
+ * `--quiet`:
65
+ Only output warnings and errors.
66
+
67
+ * `--force`:
68
+ Force downloading every gem. `--redownload` is an alias of this option.
69
+
70
+ * `--patch`:
71
+ Prefer updating only to next patch version.
72
+
73
+ * `--minor`:
74
+ Prefer updating only to next minor version.
75
+
76
+ * `--major`:
77
+ Prefer updating to next major version (default).
78
+
79
+ * `--strict`:
80
+ Do not allow any gem to be updated past latest `--patch` | `--minor` | `--major`.
81
+
82
+ * `--conservative`:
83
+ Use bundle install conservative update behavior and do not allow shared dependencies to be updated.
84
+
34
85
  ## UPDATING ALL GEMS
35
86
 
36
- If you run `bundle update` with no parameters, bundler will ignore
87
+ If you run `bundle update --all`, bundler will ignore
37
88
  any previously installed gems and resolve all dependencies again
38
89
  based on the latest versions of all gems available in the sources.
39
90
 
@@ -44,7 +95,7 @@ Consider the following Gemfile(5):
44
95
  gem "rails", "3.0.0.rc"
45
96
  gem "nokogiri"
46
97
 
47
- When you run [bundle install(1)][bundle-install] the first time, bundler will resolve
98
+ When you run [bundle install(1)](bundle-install.1.html) the first time, bundler will resolve
48
99
  all of the dependencies, all the way down, and install what you need:
49
100
 
50
101
  Fetching gem metadata from https://rubygems.org/.........
@@ -79,23 +130,23 @@ all of the dependencies, all the way down, and install what you need:
79
130
  Bundle complete! 2 Gemfile dependencies, 26 gems total.
80
131
  Use `bundle show [gemname]` to see where a bundled gem is installed.
81
132
 
82
- As you can see, even though you have just two gems in the Gemfile(5), your application
83
- actually needs 26 different gems in order to run. Bundler remembers the exact versions
84
- it installed in `Gemfile.lock`. The next time you run [bundle install(1)][bundle-install], bundler skips
133
+ As you can see, even though you have two gems in the Gemfile(5), your application
134
+ needs 26 different gems in order to run. Bundler remembers the exact versions
135
+ it installed in `Gemfile.lock`. The next time you run [bundle install(1)](bundle-install.1.html), bundler skips
85
136
  the dependency resolution and installs the same gems as it installed last time.
86
137
 
87
138
  After checking in the `Gemfile.lock` into version control and cloning it on another
88
- machine, running [bundle install(1)][bundle-install] will _still_ install the gems that you installed
139
+ machine, running [bundle install(1)](bundle-install.1.html) will _still_ install the gems that you installed
89
140
  last time. You don't need to worry that a new release of `erubis` or `mail` changes
90
141
  the gems you use.
91
142
 
92
143
  However, from time to time, you might want to update the gems you are using to the
93
144
  newest versions that still match the gems in your Gemfile(5).
94
145
 
95
- To do this, run `bundle update`, which will ignore the `Gemfile.lock`, and resolve
146
+ To do this, run `bundle update --all`, which will ignore the `Gemfile.lock`, and resolve
96
147
  all the dependencies again. Keep in mind that this process can result in a significantly
97
148
  different set of the 25 gems, based on the requirements of new gems that the gem
98
- authors released since the last time you ran `bundle update`.
149
+ authors released since the last time you ran `bundle update --all`.
99
150
 
100
151
  ## UPDATING A LIST OF GEMS
101
152
 
@@ -140,13 +191,124 @@ In this case, the two gems have their own set of dependencies, but they share
140
191
  `bundle update thin` will update `rack` even though it's _also_ a dependency of
141
192
  `rack-perftools_profiler`.
142
193
 
143
- `In short`, when you update a gem using `bundle update`, bundler will update all
144
- dependencies of that gem, including those that are also dependencies of another gem.
194
+ In short, by default, when you update a gem using `bundle update`, bundler will
195
+ update all dependencies of that gem, including those that are also dependencies
196
+ of another gem.
197
+
198
+ To prevent updating shared dependencies, prior to version 1.14 the only option
199
+ was the `CONSERVATIVE UPDATING` behavior in [bundle install(1)](bundle-install.1.html):
145
200
 
146
201
  In this scenario, updating the `thin` version manually in the Gemfile(5),
147
- and then running [bundle install(1)][bundle-install] will only update `daemons` and `eventmachine`,
202
+ and then running [bundle install(1)](bundle-install.1.html) will only update `daemons` and `eventmachine`,
148
203
  but not `rack`. For more information, see the `CONSERVATIVE UPDATING` section
149
- of [bundle install(1)][bundle-install].
204
+ of [bundle install(1)](bundle-install.1.html).
205
+
206
+ Starting with 1.14, specifying the `--conservative` option will also prevent shared
207
+ dependencies from being updated.
208
+
209
+ ## PATCH LEVEL OPTIONS
210
+
211
+ Version 1.14 introduced 4 patch-level options that will influence how gem
212
+ versions are resolved. One of the following options can be used: `--patch`,
213
+ `--minor` or `--major`. `--strict` can be added to further influence resolution.
214
+
215
+ * `--patch`:
216
+ Prefer updating only to next patch version.
217
+
218
+ * `--minor`:
219
+ Prefer updating only to next minor version.
220
+
221
+ * `--major`:
222
+ Prefer updating to next major version (default).
223
+
224
+ * `--strict`:
225
+ Do not allow any gem to be updated past latest `--patch` | `--minor` | `--major`.
226
+
227
+ When Bundler is resolving what versions to use to satisfy declared
228
+ requirements in the Gemfile or in parent gems, it looks up all
229
+ available versions, filters out any versions that don't satisfy
230
+ the requirement, and then, by default, sorts them from newest to
231
+ oldest, considering them in that order.
232
+
233
+ Providing one of the patch level options (e.g. `--patch`) changes the
234
+ sort order of the satisfying versions, causing Bundler to consider the
235
+ latest `--patch` or `--minor` version available before other versions.
236
+ Note that versions outside the stated patch level could still be
237
+ resolved to if necessary to find a suitable dependency graph.
238
+
239
+ For example, if gem 'foo' is locked at 1.0.2, with no gem requirement
240
+ defined in the Gemfile, and versions 1.0.3, 1.0.4, 1.1.0, 1.1.1, 2.0.0
241
+ all exist, the default order of preference by default (`--major`) will
242
+ be "2.0.0, 1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2".
243
+
244
+ If the `--patch` option is used, the order of preference will change to
245
+ "1.0.4, 1.0.3, 1.0.2, 1.1.1, 1.1.0, 2.0.0".
246
+
247
+ If the `--minor` option is used, the order of preference will change to
248
+ "1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2, 2.0.0".
249
+
250
+ Combining the `--strict` option with any of the patch level options
251
+ will remove any versions beyond the scope of the patch level option,
252
+ to ensure that no gem is updated that far.
253
+
254
+ To continue the previous example, if both `--patch` and `--strict`
255
+ options are used, the available versions for resolution would be
256
+ "1.0.4, 1.0.3, 1.0.2". If `--minor` and `--strict` are used, it would
257
+ be "1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2".
258
+
259
+ Gem requirements as defined in the Gemfile will still be the first
260
+ determining factor for what versions are available. If the gem
261
+ requirement for `foo` in the Gemfile is '~> 1.0', that will accomplish
262
+ the same thing as providing the `--minor` and `--strict` options.
263
+
264
+ ## PATCH LEVEL EXAMPLES
265
+
266
+ Given the following gem specifications:
267
+
268
+ foo 1.4.3, requires: ~> bar 2.0
269
+ foo 1.4.4, requires: ~> bar 2.0
270
+ foo 1.4.5, requires: ~> bar 2.1
271
+ foo 1.5.0, requires: ~> bar 2.1
272
+ foo 1.5.1, requires: ~> bar 3.0
273
+ bar with versions 2.0.3, 2.0.4, 2.1.0, 2.1.1, 3.0.0
274
+
275
+ Gemfile:
276
+
277
+ gem 'foo'
278
+
279
+ Gemfile.lock:
280
+
281
+ foo (1.4.3)
282
+ bar (~> 2.0)
283
+ bar (2.0.3)
284
+
285
+ Cases:
286
+
287
+ # Command Line Result
288
+ ------------------------------------------------------------
289
+ 1 bundle update --patch 'foo 1.4.5', 'bar 2.1.1'
290
+ 2 bundle update --patch foo 'foo 1.4.5', 'bar 2.1.1'
291
+ 3 bundle update --minor 'foo 1.5.1', 'bar 3.0.0'
292
+ 4 bundle update --minor --strict 'foo 1.5.0', 'bar 2.1.1'
293
+ 5 bundle update --patch --strict 'foo 1.4.4', 'bar 2.0.4'
294
+
295
+ In case 1, bar is upgraded to 2.1.1, a minor version increase, because
296
+ the dependency from foo 1.4.5 required it.
297
+
298
+ In case 2, only foo is requested to be unlocked, but bar is also
299
+ allowed to move because it's not a declared dependency in the Gemfile.
300
+
301
+ In case 3, bar goes up a whole major release, because a minor increase
302
+ is preferred now for foo, and when it goes to 1.5.1, it requires 3.0.0
303
+ of bar.
304
+
305
+ In case 4, foo is preferred up to a minor version, but 1.5.1 won't work
306
+ because the --strict flag removes bar 3.0.0 from consideration since
307
+ it's a major increment.
308
+
309
+ In case 5, both foo and bar have any minor or major increments removed
310
+ from consideration because of the --strict flag, so the most they can
311
+ move is up to 1.4.4 and 2.0.4.
150
312
 
151
313
  ## RECOMMENDED WORKFLOW
152
314
 
@@ -177,7 +339,7 @@ use the following workflow:
177
339
 
178
340
  $ git add Gemfile.lock
179
341
 
180
- * If [bundle install(1)][bundle-install] reports a conflict, manually update the specific
342
+ * If [bundle install(1)](bundle-install.1.html) reports a conflict, manually update the specific
181
343
  gems that you changed in the Gemfile(5)
182
344
 
183
345
  $ bundle update rails thin
@@ -185,4 +347,4 @@ use the following workflow:
185
347
  * If you want to update all the gems to the latest possible versions that
186
348
  still match the gems listed in the Gemfile(5), run
187
349
 
188
- $ bundle update
350
+ $ bundle update --all