rubygems-update 3.1.4 → 3.2.14

Sign up to get free protection for your applications and to get access to all the features.
Files changed (576) hide show
  1. checksums.yaml +4 -4
  2. data/{History.txt → CHANGELOG.md} +791 -492
  3. data/CODE_OF_CONDUCT.md +55 -19
  4. data/CONTRIBUTING.md +24 -10
  5. data/Manifest.txt +77 -104
  6. data/POLICIES.md +6 -12
  7. data/README.md +1 -1
  8. data/Rakefile +75 -101
  9. data/bin/update_rubygems +1 -1
  10. data/bundler/CHANGELOG.md +1717 -1426
  11. data/bundler/README.md +6 -8
  12. data/bundler/UPGRADING.md +18 -32
  13. data/bundler/bundler.gemspec +4 -4
  14. data/bundler/exe/bundle +3 -0
  15. data/bundler/lib/bundler.rb +33 -9
  16. data/bundler/lib/bundler/build_metadata.rb +4 -12
  17. data/bundler/lib/bundler/cli.rb +56 -21
  18. data/bundler/lib/bundler/cli/add.rb +1 -1
  19. data/bundler/lib/bundler/cli/binstubs.rb +6 -2
  20. data/bundler/lib/bundler/cli/cache.rb +2 -7
  21. data/bundler/lib/bundler/cli/clean.rb +1 -1
  22. data/bundler/lib/bundler/cli/common.rb +14 -0
  23. data/bundler/lib/bundler/cli/console.rb +1 -1
  24. data/bundler/lib/bundler/cli/doctor.rb +1 -1
  25. data/bundler/lib/bundler/cli/exec.rb +4 -4
  26. data/bundler/lib/bundler/cli/fund.rb +36 -0
  27. data/bundler/lib/bundler/cli/gem.rb +121 -28
  28. data/bundler/lib/bundler/cli/info.rb +15 -4
  29. data/bundler/lib/bundler/cli/init.rb +2 -2
  30. data/bundler/lib/bundler/cli/inject.rb +1 -1
  31. data/bundler/lib/bundler/cli/install.rb +13 -11
  32. data/bundler/lib/bundler/cli/issue.rb +2 -2
  33. data/bundler/lib/bundler/cli/list.rb +12 -10
  34. data/bundler/lib/bundler/cli/outdated.rb +87 -66
  35. data/bundler/lib/bundler/cli/plugin.rb +10 -0
  36. data/bundler/lib/bundler/cli/pristine.rb +5 -0
  37. data/bundler/lib/bundler/cli/show.rb +1 -1
  38. data/bundler/lib/bundler/cli/update.rb +3 -1
  39. data/bundler/lib/bundler/compact_index_client.rb +1 -1
  40. data/bundler/lib/bundler/compact_index_client/cache.rb +6 -14
  41. data/bundler/lib/bundler/compact_index_client/gem_parser.rb +28 -0
  42. data/bundler/lib/bundler/compact_index_client/updater.rb +6 -14
  43. data/bundler/lib/bundler/definition.rb +115 -123
  44. data/bundler/lib/bundler/dep_proxy.rb +16 -9
  45. data/bundler/lib/bundler/dependency.rb +3 -10
  46. data/bundler/lib/bundler/dsl.rb +40 -33
  47. data/bundler/lib/bundler/endpoint_specification.rb +1 -1
  48. data/bundler/lib/bundler/env.rb +1 -1
  49. data/bundler/lib/bundler/environment_preserver.rb +26 -2
  50. data/bundler/lib/bundler/errors.rb +1 -0
  51. data/bundler/lib/bundler/feature_flag.rb +0 -4
  52. data/bundler/lib/bundler/fetcher.rb +4 -4
  53. data/bundler/lib/bundler/fetcher/base.rb +1 -1
  54. data/bundler/lib/bundler/fetcher/compact_index.rb +1 -1
  55. data/bundler/lib/bundler/fetcher/downloader.rb +1 -1
  56. data/bundler/lib/bundler/fetcher/index.rb +3 -4
  57. data/bundler/lib/bundler/friendly_errors.rb +22 -13
  58. data/bundler/lib/bundler/gem_helper.rb +35 -18
  59. data/bundler/lib/bundler/gem_helpers.rb +36 -25
  60. data/bundler/lib/bundler/gem_version_promoter.rb +4 -4
  61. data/bundler/lib/bundler/graph.rb +1 -1
  62. data/bundler/lib/bundler/index.rb +12 -7
  63. data/bundler/lib/bundler/injector.rb +22 -4
  64. data/bundler/lib/bundler/inline.rb +2 -1
  65. data/bundler/lib/bundler/installer.rb +37 -49
  66. data/bundler/lib/bundler/installer/gem_installer.rb +3 -3
  67. data/bundler/lib/bundler/installer/parallel_installer.rb +16 -18
  68. data/bundler/lib/bundler/installer/standalone.rb +17 -2
  69. data/bundler/lib/bundler/lazy_specification.rb +40 -25
  70. data/bundler/lib/bundler/lockfile_generator.rb +1 -1
  71. data/bundler/lib/bundler/lockfile_parser.rb +4 -14
  72. data/bundler/lib/bundler/man/.document +1 -0
  73. data/bundler/{man → lib/bundler/man}/bundle-add.1 +1 -1
  74. data/bundler/{man/bundle-add.ronn → lib/bundler/man/bundle-add.1.ronn} +0 -0
  75. data/bundler/{man → lib/bundler/man}/bundle-binstubs.1 +5 -3
  76. data/bundler/{man/bundle-binstubs.ronn → lib/bundler/man/bundle-binstubs.1.ronn} +2 -4
  77. data/bundler/{man → lib/bundler/man}/bundle-cache.1 +1 -1
  78. data/bundler/{man/bundle-cache.ronn → lib/bundler/man/bundle-cache.1.ronn} +0 -0
  79. data/bundler/{man → lib/bundler/man}/bundle-check.1 +1 -1
  80. data/bundler/{man/bundle-check.ronn → lib/bundler/man/bundle-check.1.ronn} +0 -0
  81. data/bundler/{man → lib/bundler/man}/bundle-clean.1 +1 -1
  82. data/bundler/{man/bundle-clean.ronn → lib/bundler/man/bundle-clean.1.ronn} +0 -0
  83. data/bundler/{man → lib/bundler/man}/bundle-config.1 +22 -31
  84. data/bundler/{man/bundle-config.ronn → lib/bundler/man/bundle-config.1.ronn} +30 -40
  85. data/bundler/{man → lib/bundler/man}/bundle-doctor.1 +1 -1
  86. data/bundler/{man/bundle-doctor.ronn → lib/bundler/man/bundle-doctor.1.ronn} +0 -0
  87. data/bundler/{man → lib/bundler/man}/bundle-exec.1 +1 -1
  88. data/bundler/{man/bundle-exec.ronn → lib/bundler/man/bundle-exec.1.ronn} +0 -0
  89. data/bundler/{man → lib/bundler/man}/bundle-gem.1 +25 -3
  90. data/bundler/{man/bundle-gem.ronn → lib/bundler/man/bundle-gem.1.ronn} +30 -7
  91. data/bundler/{man → lib/bundler/man}/bundle-info.1 +1 -1
  92. data/bundler/{man/bundle-info.ronn → lib/bundler/man/bundle-info.1.ronn} +0 -0
  93. data/bundler/{man → lib/bundler/man}/bundle-init.1 +1 -1
  94. data/bundler/{man/bundle-init.ronn → lib/bundler/man/bundle-init.1.ronn} +0 -0
  95. data/bundler/{man → lib/bundler/man}/bundle-inject.1 +1 -1
  96. data/bundler/{man/bundle-inject.ronn → lib/bundler/man/bundle-inject.1.ronn} +0 -0
  97. data/bundler/{man → lib/bundler/man}/bundle-install.1 +30 -3
  98. data/bundler/{man/bundle-install.ronn → lib/bundler/man/bundle-install.1.ronn} +25 -3
  99. data/bundler/{man → lib/bundler/man}/bundle-list.1 +7 -7
  100. data/bundler/{man/bundle-list.ronn → lib/bundler/man/bundle-list.1.ronn} +6 -6
  101. data/bundler/{man → lib/bundler/man}/bundle-lock.1 +1 -1
  102. data/bundler/{man/bundle-lock.ronn → lib/bundler/man/bundle-lock.1.ronn} +0 -0
  103. data/bundler/{man → lib/bundler/man}/bundle-open.1 +1 -1
  104. data/bundler/{man/bundle-open.ronn → lib/bundler/man/bundle-open.1.ronn} +0 -0
  105. data/bundler/{man → lib/bundler/man}/bundle-outdated.1 +1 -1
  106. data/bundler/{man/bundle-outdated.ronn → lib/bundler/man/bundle-outdated.1.ronn} +0 -0
  107. data/bundler/{man → lib/bundler/man}/bundle-platform.1 +1 -1
  108. data/bundler/{man/bundle-platform.ronn → lib/bundler/man/bundle-platform.1.ronn} +0 -0
  109. data/bundler/{man → lib/bundler/man}/bundle-pristine.1 +1 -1
  110. data/bundler/{man/bundle-pristine.ronn → lib/bundler/man/bundle-pristine.1.ronn} +0 -0
  111. data/bundler/{man → lib/bundler/man}/bundle-remove.1 +1 -1
  112. data/bundler/{man/bundle-remove.ronn → lib/bundler/man/bundle-remove.1.ronn} +0 -0
  113. data/bundler/{man → lib/bundler/man}/bundle-show.1 +1 -1
  114. data/bundler/{man/bundle-show.ronn → lib/bundler/man/bundle-show.1.ronn} +0 -0
  115. data/bundler/{man → lib/bundler/man}/bundle-update.1 +1 -1
  116. data/bundler/{man/bundle-update.ronn → lib/bundler/man/bundle-update.1.ronn} +0 -0
  117. data/bundler/{man → lib/bundler/man}/bundle-viz.1 +1 -1
  118. data/bundler/{man/bundle-viz.ronn → lib/bundler/man/bundle-viz.1.ronn} +0 -0
  119. data/bundler/{man → lib/bundler/man}/bundle.1 +1 -1
  120. data/bundler/{man/bundle.ronn → lib/bundler/man/bundle.1.ronn} +0 -0
  121. data/bundler/{man → lib/bundler/man}/gemfile.5 +4 -4
  122. data/bundler/{man → lib/bundler/man}/gemfile.5.ronn +4 -4
  123. data/bundler/{man → lib/bundler/man}/index.txt +0 -0
  124. data/bundler/lib/bundler/mirror.rb +2 -2
  125. data/bundler/lib/bundler/plugin.rb +31 -5
  126. data/bundler/lib/bundler/plugin/api/source.rb +8 -1
  127. data/bundler/lib/bundler/plugin/dsl.rb +1 -1
  128. data/bundler/lib/bundler/plugin/index.rb +10 -1
  129. data/bundler/lib/bundler/plugin/installer.rb +9 -11
  130. data/bundler/lib/bundler/plugin/installer/rubygems.rb +1 -1
  131. data/bundler/lib/bundler/plugin/source_list.rb +5 -1
  132. data/bundler/lib/bundler/psyched_yaml.rb +0 -15
  133. data/bundler/lib/bundler/remote_specification.rb +5 -2
  134. data/bundler/lib/bundler/resolver.rb +133 -77
  135. data/bundler/lib/bundler/resolver/spec_group.rb +75 -48
  136. data/bundler/lib/bundler/retry.rb +1 -1
  137. data/bundler/lib/bundler/ruby_version.rb +1 -1
  138. data/bundler/lib/bundler/rubygems_ext.rb +69 -9
  139. data/bundler/lib/bundler/rubygems_gem_installer.rb +50 -9
  140. data/bundler/lib/bundler/rubygems_integration.rb +25 -60
  141. data/bundler/lib/bundler/runtime.rb +4 -14
  142. data/bundler/lib/bundler/settings.rb +50 -47
  143. data/bundler/lib/bundler/shared_helpers.rb +3 -3
  144. data/bundler/lib/bundler/similarity_detector.rb +1 -1
  145. data/bundler/lib/bundler/source.rb +7 -1
  146. data/bundler/lib/bundler/source/git.rb +24 -22
  147. data/bundler/lib/bundler/source/git/git_proxy.rb +82 -80
  148. data/bundler/lib/bundler/source/metadata.rb +0 -4
  149. data/bundler/lib/bundler/source/path.rb +7 -3
  150. data/bundler/lib/bundler/source/path/installer.rb +10 -10
  151. data/bundler/lib/bundler/source/rubygems.rb +43 -22
  152. data/bundler/lib/bundler/source/rubygems/remote.rb +1 -1
  153. data/bundler/lib/bundler/source_list.rb +30 -25
  154. data/bundler/lib/bundler/spec_set.rb +14 -13
  155. data/bundler/lib/bundler/stub_specification.rb +25 -7
  156. data/bundler/lib/bundler/templates/newgem/CHANGELOG.md.tt +5 -0
  157. data/bundler/lib/bundler/templates/newgem/CODE_OF_CONDUCT.md.tt +57 -47
  158. data/bundler/lib/bundler/templates/newgem/Gemfile.tt +9 -1
  159. data/bundler/lib/bundler/templates/newgem/README.md.tt +6 -5
  160. data/bundler/lib/bundler/templates/newgem/Rakefile.tt +19 -5
  161. data/bundler/lib/bundler/templates/newgem/bin/console.tt +1 -0
  162. data/bundler/lib/bundler/templates/newgem/circleci/config.yml.tt +13 -0
  163. data/bundler/lib/bundler/templates/newgem/ext/newgem/extconf.rb.tt +2 -0
  164. data/bundler/lib/bundler/templates/newgem/github/workflows/main.yml.tt +18 -0
  165. data/bundler/lib/bundler/templates/newgem/gitlab-ci.yml.tt +9 -0
  166. data/bundler/lib/bundler/templates/newgem/lib/newgem.rb.tt +4 -2
  167. data/bundler/lib/bundler/templates/newgem/lib/newgem/version.rb.tt +2 -0
  168. data/bundler/lib/bundler/templates/newgem/newgem.gemspec.tt +15 -7
  169. data/bundler/lib/bundler/templates/newgem/rubocop.yml.tt +13 -0
  170. data/bundler/lib/bundler/templates/newgem/spec/newgem_spec.rb.tt +2 -0
  171. data/bundler/lib/bundler/templates/newgem/spec/spec_helper.rb.tt +2 -1
  172. data/bundler/lib/bundler/templates/newgem/test/{newgem_test.rb.tt → minitest/newgem_test.rb.tt} +2 -0
  173. data/bundler/lib/bundler/templates/newgem/test/{test_helper.rb.tt → minitest/test_helper.rb.tt} +2 -0
  174. data/bundler/lib/bundler/templates/newgem/test/test-unit/newgem_test.rb.tt +15 -0
  175. data/bundler/lib/bundler/templates/newgem/test/test-unit/test_helper.rb.tt +6 -0
  176. data/bundler/lib/bundler/ui/shell.rb +5 -5
  177. data/bundler/lib/bundler/uri_credentials_filter.rb +3 -1
  178. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo.rb +0 -1
  179. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/delegates/specification_provider.rb +7 -0
  180. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph.rb +34 -2
  181. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/tag.rb +2 -2
  182. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/dependency_graph/vertex.rb +11 -5
  183. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/errors.rb +3 -3
  184. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/gem_metadata.rb +1 -1
  185. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/modules/specification_provider.rb +11 -0
  186. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/resolution.rb +49 -47
  187. data/bundler/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +82 -189
  188. data/bundler/lib/bundler/vendor/thor/lib/thor.rb +5 -13
  189. data/bundler/lib/bundler/vendor/thor/lib/thor/actions.rb +1 -1
  190. data/bundler/lib/bundler/vendor/thor/lib/thor/actions/create_link.rb +2 -1
  191. data/bundler/lib/bundler/vendor/thor/lib/thor/actions/file_manipulation.rb +4 -2
  192. data/bundler/lib/bundler/vendor/thor/lib/thor/base.rb +9 -0
  193. data/bundler/lib/bundler/vendor/thor/lib/thor/error.rb +1 -1
  194. data/bundler/lib/bundler/vendor/thor/lib/thor/parser/arguments.rb +5 -1
  195. data/bundler/lib/bundler/vendor/thor/lib/thor/parser/options.rb +9 -8
  196. data/bundler/lib/bundler/vendor/thor/lib/thor/shell/basic.rb +5 -2
  197. data/bundler/lib/bundler/vendor/thor/lib/thor/shell/color.rb +5 -1
  198. data/bundler/lib/bundler/vendor/thor/lib/thor/version.rb +1 -1
  199. data/bundler/lib/bundler/vendor/tmpdir/lib/tmpdir.rb +154 -0
  200. data/bundler/lib/bundler/vendored_persistent.rb +0 -7
  201. data/bundler/lib/bundler/vendored_tmpdir.rb +4 -0
  202. data/bundler/lib/bundler/version.rb +1 -1
  203. data/bundler/lib/bundler/worker.rb +1 -1
  204. data/bundler/lib/bundler/yaml_serializer.rb +1 -1
  205. data/lib/rubygems.rb +84 -160
  206. data/lib/rubygems/available_set.rb +4 -6
  207. data/lib/rubygems/basic_specification.rb +11 -9
  208. data/lib/rubygems/bundler_version_finder.rb +14 -9
  209. data/lib/rubygems/command.rb +17 -16
  210. data/lib/rubygems/command_manager.rb +5 -6
  211. data/lib/rubygems/commands/build_command.rb +40 -20
  212. data/lib/rubygems/commands/cert_command.rb +2 -10
  213. data/lib/rubygems/commands/check_command.rb +0 -2
  214. data/lib/rubygems/commands/cleanup_command.rb +11 -7
  215. data/lib/rubygems/commands/contents_command.rb +4 -6
  216. data/lib/rubygems/commands/dependency_command.rb +6 -8
  217. data/lib/rubygems/commands/environment_command.rb +1 -3
  218. data/lib/rubygems/commands/fetch_command.rb +2 -4
  219. data/lib/rubygems/commands/generate_index_command.rb +0 -2
  220. data/lib/rubygems/commands/help_command.rb +3 -3
  221. data/lib/rubygems/commands/info_command.rb +8 -5
  222. data/lib/rubygems/commands/install_command.rb +3 -5
  223. data/lib/rubygems/commands/list_command.rb +8 -7
  224. data/lib/rubygems/commands/lock_command.rb +1 -3
  225. data/lib/rubygems/commands/mirror_command.rb +0 -2
  226. data/lib/rubygems/commands/open_command.rb +0 -4
  227. data/lib/rubygems/commands/outdated_command.rb +0 -2
  228. data/lib/rubygems/commands/owner_command.rb +9 -4
  229. data/lib/rubygems/commands/pristine_command.rb +11 -5
  230. data/lib/rubygems/commands/push_command.rb +10 -47
  231. data/lib/rubygems/commands/query_command.rb +14 -344
  232. data/lib/rubygems/commands/rdoc_command.rb +0 -2
  233. data/lib/rubygems/commands/search_command.rb +7 -7
  234. data/lib/rubygems/commands/server_command.rb +3 -1
  235. data/lib/rubygems/commands/setup_command.rb +101 -74
  236. data/lib/rubygems/commands/signin_command.rb +0 -2
  237. data/lib/rubygems/commands/signout_command.rb +0 -2
  238. data/lib/rubygems/commands/sources_command.rb +6 -4
  239. data/lib/rubygems/commands/specification_command.rb +8 -4
  240. data/lib/rubygems/commands/stale_command.rb +1 -3
  241. data/lib/rubygems/commands/uninstall_command.rb +1 -3
  242. data/lib/rubygems/commands/unpack_command.rb +1 -3
  243. data/lib/rubygems/commands/update_command.rb +59 -14
  244. data/lib/rubygems/commands/which_command.rb +0 -2
  245. data/lib/rubygems/commands/yank_command.rb +4 -7
  246. data/lib/rubygems/config_file.rb +20 -4
  247. data/lib/rubygems/core_ext/kernel_require.rb +29 -36
  248. data/lib/rubygems/core_ext/kernel_warn.rb +12 -13
  249. data/lib/rubygems/core_ext/tcpsocket_init.rb +52 -0
  250. data/lib/rubygems/defaults.rb +101 -7
  251. data/lib/rubygems/dependency.rb +8 -9
  252. data/lib/rubygems/dependency_installer.rb +6 -78
  253. data/lib/rubygems/dependency_list.rb +7 -9
  254. data/lib/rubygems/deprecate.rb +46 -1
  255. data/lib/rubygems/doctor.rb +4 -4
  256. data/lib/rubygems/errors.rb +3 -14
  257. data/lib/rubygems/exceptions.rb +2 -33
  258. data/lib/rubygems/ext.rb +6 -6
  259. data/lib/rubygems/ext/build_error.rb +2 -0
  260. data/lib/rubygems/ext/builder.rb +19 -39
  261. data/lib/rubygems/ext/cmake_builder.rb +6 -9
  262. data/lib/rubygems/ext/configure_builder.rb +5 -8
  263. data/lib/rubygems/ext/ext_conf_builder.rb +21 -19
  264. data/lib/rubygems/ext/rake_builder.rb +4 -6
  265. data/lib/rubygems/gem_runner.rb +3 -10
  266. data/lib/rubygems/gemcutter_utilities.rb +102 -21
  267. data/lib/rubygems/indexer.rb +1 -22
  268. data/lib/rubygems/install_update_options.rb +7 -7
  269. data/lib/rubygems/installer.rb +59 -80
  270. data/lib/rubygems/installer_test_case.rb +25 -11
  271. data/lib/rubygems/installer_uninstaller_utils.rb +29 -0
  272. data/lib/rubygems/local_remote_options.rb +1 -1
  273. data/lib/rubygems/mock_gem_ui.rb +0 -6
  274. data/lib/rubygems/name_tuple.rb +3 -7
  275. data/lib/rubygems/openssl.rb +7 -0
  276. data/lib/rubygems/package.rb +14 -25
  277. data/lib/rubygems/package/digest_io.rb +0 -2
  278. data/lib/rubygems/package/file_source.rb +0 -2
  279. data/lib/rubygems/package/io_source.rb +0 -2
  280. data/lib/rubygems/package/old.rb +1 -3
  281. data/lib/rubygems/package/tar_header.rb +4 -6
  282. data/lib/rubygems/package/tar_reader.rb +0 -3
  283. data/lib/rubygems/package/tar_reader/entry.rb +0 -3
  284. data/lib/rubygems/package/tar_test_case.rb +2 -4
  285. data/lib/rubygems/package/tar_writer.rb +2 -12
  286. data/lib/rubygems/package_task.rb +1 -7
  287. data/lib/rubygems/path_support.rb +1 -3
  288. data/lib/rubygems/platform.rb +21 -16
  289. data/lib/rubygems/psych_tree.rb +0 -2
  290. data/lib/rubygems/query_utils.rb +353 -0
  291. data/lib/rubygems/rdoc.rb +0 -12
  292. data/lib/rubygems/remote_fetcher.rb +18 -37
  293. data/lib/rubygems/request.rb +4 -11
  294. data/lib/rubygems/request/connection_pools.rb +1 -5
  295. data/lib/rubygems/request/http_pool.rb +0 -2
  296. data/lib/rubygems/request/https_pool.rb +0 -2
  297. data/lib/rubygems/request_set.rb +7 -20
  298. data/lib/rubygems/request_set/gem_dependency_api.rb +5 -7
  299. data/lib/rubygems/request_set/lockfile.rb +8 -12
  300. data/lib/rubygems/request_set/lockfile/parser.rb +0 -2
  301. data/lib/rubygems/request_set/lockfile/tokenizer.rb +1 -3
  302. data/lib/rubygems/requirement.rb +21 -22
  303. data/lib/rubygems/resolver.rb +14 -12
  304. data/lib/rubygems/resolver/activation_request.rb +9 -3
  305. data/lib/rubygems/resolver/api_set.rb +30 -23
  306. data/lib/rubygems/resolver/api_set/gem_parser.rb +20 -0
  307. data/lib/rubygems/resolver/api_specification.rb +23 -9
  308. data/lib/rubygems/resolver/best_set.rb +2 -4
  309. data/lib/rubygems/resolver/composed_set.rb +3 -5
  310. data/lib/rubygems/resolver/conflict.rb +2 -4
  311. data/lib/rubygems/resolver/current_set.rb +0 -2
  312. data/lib/rubygems/resolver/dependency_request.rb +1 -3
  313. data/lib/rubygems/resolver/git_set.rb +0 -2
  314. data/lib/rubygems/resolver/git_specification.rb +0 -2
  315. data/lib/rubygems/resolver/index_set.rb +1 -3
  316. data/lib/rubygems/resolver/index_specification.rb +32 -2
  317. data/lib/rubygems/resolver/installed_specification.rb +0 -2
  318. data/lib/rubygems/resolver/installer_set.rb +60 -13
  319. data/lib/rubygems/resolver/local_specification.rb +0 -2
  320. data/lib/rubygems/resolver/lock_set.rb +2 -4
  321. data/lib/rubygems/resolver/lock_specification.rb +0 -2
  322. data/lib/rubygems/resolver/molinillo/lib/molinillo.rb +6 -5
  323. data/lib/rubygems/resolver/molinillo/lib/molinillo/delegates/resolution_state.rb +7 -0
  324. data/lib/rubygems/resolver/molinillo/lib/molinillo/delegates/specification_provider.rb +8 -0
  325. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph.rb +39 -6
  326. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/action.rb +1 -0
  327. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/add_edge_no_circular.rb +2 -1
  328. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/add_vertex.rb +2 -1
  329. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/delete_edge.rb +2 -1
  330. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/detach_vertex_named.rb +2 -1
  331. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/log.rb +7 -6
  332. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/set_payload.rb +2 -1
  333. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/tag.rb +4 -3
  334. data/lib/rubygems/resolver/molinillo/lib/molinillo/dependency_graph/vertex.rb +51 -12
  335. data/lib/rubygems/resolver/molinillo/lib/molinillo/errors.rb +76 -8
  336. data/lib/rubygems/resolver/molinillo/lib/molinillo/gem_metadata.rb +2 -1
  337. data/lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb +12 -0
  338. data/lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb +3 -1
  339. data/lib/rubygems/resolver/molinillo/lib/molinillo/resolution.rb +510 -165
  340. data/lib/rubygems/resolver/molinillo/lib/molinillo/resolver.rb +3 -2
  341. data/lib/rubygems/resolver/molinillo/lib/molinillo/state.rb +8 -4
  342. data/lib/rubygems/resolver/requirement_list.rb +0 -2
  343. data/lib/rubygems/resolver/set.rb +0 -2
  344. data/lib/rubygems/resolver/source_set.rb +0 -2
  345. data/lib/rubygems/resolver/spec_specification.rb +14 -2
  346. data/lib/rubygems/resolver/specification.rb +13 -3
  347. data/lib/rubygems/resolver/stats.rb +0 -2
  348. data/lib/rubygems/resolver/vendor_set.rb +0 -2
  349. data/lib/rubygems/resolver/vendor_specification.rb +0 -2
  350. data/lib/rubygems/s3_uri_signer.rb +2 -8
  351. data/lib/rubygems/safe_yaml.rb +4 -4
  352. data/lib/rubygems/security.rb +27 -34
  353. data/lib/rubygems/security/policy.rb +4 -8
  354. data/lib/rubygems/security/signer.rb +5 -7
  355. data/lib/rubygems/security/trust_dir.rb +1 -3
  356. data/lib/rubygems/server.rb +15 -12
  357. data/lib/rubygems/source.rb +23 -12
  358. data/lib/rubygems/source/git.rb +7 -8
  359. data/lib/rubygems/source/installed.rb +0 -2
  360. data/lib/rubygems/source/local.rb +2 -4
  361. data/lib/rubygems/source/lock.rb +0 -2
  362. data/lib/rubygems/source/specific_file.rb +0 -2
  363. data/lib/rubygems/source/vendor.rb +0 -2
  364. data/lib/rubygems/source_list.rb +4 -7
  365. data/lib/rubygems/spec_fetcher.rb +19 -18
  366. data/lib/rubygems/specification.rb +120 -131
  367. data/lib/rubygems/specification_policy.rb +79 -29
  368. data/lib/rubygems/ssl_certs/{index.rubygems.org → rubygems.org}/GlobalSignRootCA.pem +0 -0
  369. data/lib/rubygems/ssl_certs/rubygems.org/GlobalSignRootCA_R3.pem +21 -0
  370. data/lib/rubygems/stub_specification.rb +1 -5
  371. data/lib/rubygems/syck_hack.rb +0 -2
  372. data/lib/rubygems/test_case.rb +98 -129
  373. data/lib/rubygems/test_utilities.rb +12 -19
  374. data/lib/rubygems/uninstaller.rb +35 -16
  375. data/lib/rubygems/uri_formatter.rb +2 -3
  376. data/lib/rubygems/uri_parser.rb +0 -2
  377. data/lib/rubygems/user_interaction.rb +1 -26
  378. data/lib/rubygems/util.rb +8 -2
  379. data/lib/rubygems/util/licenses.rb +4 -6
  380. data/lib/rubygems/util/list.rb +0 -2
  381. data/lib/rubygems/validator.rb +1 -3
  382. data/lib/rubygems/version.rb +4 -6
  383. data/lib/rubygems/version_option.rb +6 -0
  384. data/rubygems-update.gemspec +3 -3
  385. data/setup.rb +2 -7
  386. data/test/rubygems/data/null-required-ruby-version.gemspec.rz +0 -0
  387. data/test/rubygems/data/null-required-rubygems-version.gemspec.rz +0 -0
  388. data/test/rubygems/plugin/load/rubygems_plugin.rb +0 -2
  389. data/test/rubygems/rubygems/commands/crash_command.rb +0 -2
  390. data/test/rubygems/rubygems_plugin.rb +0 -2
  391. data/test/rubygems/specifications/bar-0.0.2.gemspec +0 -2
  392. data/test/rubygems/specifications/rubyforge-0.0.1.gemspec +0 -2
  393. data/test/rubygems/test_bundled_ca.rb +42 -45
  394. data/test/rubygems/test_config.rb +0 -2
  395. data/test/rubygems/test_deprecate.rb +40 -7
  396. data/test/rubygems/test_gem.rb +167 -87
  397. data/test/rubygems/test_gem_available_set.rb +3 -5
  398. data/test/rubygems/test_gem_bundler_version_finder.rb +19 -3
  399. data/test/rubygems/test_gem_command.rb +24 -7
  400. data/test/rubygems/test_gem_command_manager.rb +36 -5
  401. data/test/rubygems/test_gem_commands_build_command.rb +233 -15
  402. data/test/rubygems/test_gem_commands_cert_command.rb +4 -6
  403. data/test/rubygems/test_gem_commands_check_command.rb +0 -2
  404. data/test/rubygems/test_gem_commands_cleanup_command.rb +14 -5
  405. data/test/rubygems/test_gem_commands_contents_command.rb +50 -19
  406. data/test/rubygems/test_gem_commands_dependency_command.rb +0 -2
  407. data/test/rubygems/test_gem_commands_environment_command.rb +21 -23
  408. data/test/rubygems/test_gem_commands_fetch_command.rb +0 -2
  409. data/test/rubygems/test_gem_commands_generate_index_command.rb +1 -7
  410. data/test/rubygems/test_gem_commands_help_command.rb +15 -4
  411. data/test/rubygems/test_gem_commands_info_command.rb +6 -8
  412. data/test/rubygems/test_gem_commands_install_command.rb +163 -34
  413. data/test/rubygems/test_gem_commands_list_command.rb +0 -2
  414. data/test/rubygems/test_gem_commands_lock_command.rb +0 -2
  415. data/test/rubygems/test_gem_commands_mirror.rb +1 -3
  416. data/test/rubygems/test_gem_commands_open_command.rb +4 -6
  417. data/test/rubygems/test_gem_commands_outdated_command.rb +17 -1
  418. data/test/rubygems/test_gem_commands_owner_command.rb +59 -5
  419. data/test/rubygems/test_gem_commands_pristine_command.rb +43 -12
  420. data/test/rubygems/test_gem_commands_push_command.rb +77 -9
  421. data/test/rubygems/test_gem_commands_query_command.rb +12 -12
  422. data/test/rubygems/test_gem_commands_search_command.rb +0 -2
  423. data/test/rubygems/test_gem_commands_server_command.rb +0 -2
  424. data/test/rubygems/test_gem_commands_setup_command.rb +160 -135
  425. data/test/rubygems/test_gem_commands_signin_command.rb +33 -9
  426. data/test/rubygems/test_gem_commands_signout_command.rb +0 -7
  427. data/test/rubygems/test_gem_commands_sources_command.rb +60 -2
  428. data/test/rubygems/test_gem_commands_specification_command.rb +46 -20
  429. data/test/rubygems/test_gem_commands_stale_command.rb +0 -2
  430. data/test/rubygems/test_gem_commands_uninstall_command.rb +1 -3
  431. data/test/rubygems/test_gem_commands_unpack_command.rb +0 -2
  432. data/test/rubygems/test_gem_commands_update_command.rb +116 -7
  433. data/test/rubygems/test_gem_commands_which_command.rb +3 -5
  434. data/test/rubygems/test_gem_commands_yank_command.rb +44 -8
  435. data/test/rubygems/test_gem_config_file.rb +17 -12
  436. data/test/rubygems/test_gem_dependency.rb +0 -2
  437. data/test/rubygems/test_gem_dependency_installer.rb +133 -247
  438. data/test/rubygems/test_gem_dependency_list.rb +10 -12
  439. data/test/rubygems/test_gem_dependency_resolution_error.rb +1 -3
  440. data/test/rubygems/test_gem_doctor.rb +28 -2
  441. data/test/rubygems/test_gem_ext_builder.rb +50 -47
  442. data/test/rubygems/test_gem_ext_cmake_builder.rb +16 -25
  443. data/test/rubygems/test_gem_ext_configure_builder.rb +6 -22
  444. data/test/rubygems/test_gem_ext_ext_conf_builder.rb +9 -29
  445. data/test/rubygems/test_gem_ext_rake_builder.rb +39 -24
  446. data/test/rubygems/test_gem_gem_runner.rb +44 -1
  447. data/test/rubygems/test_gem_gemcutter_utilities.rb +8 -5
  448. data/test/rubygems/test_gem_impossible_dependencies_error.rb +0 -2
  449. data/test/rubygems/test_gem_indexer.rb +9 -15
  450. data/test/rubygems/test_gem_install_update_options.rb +14 -4
  451. data/test/rubygems/test_gem_installer.rb +260 -115
  452. data/test/rubygems/test_gem_local_remote_options.rb +0 -2
  453. data/test/rubygems/test_gem_name_tuple.rb +0 -2
  454. data/test/rubygems/test_gem_package.rb +38 -31
  455. data/test/rubygems/test_gem_package_old.rb +4 -6
  456. data/test/rubygems/test_gem_package_tar_header.rb +18 -1
  457. data/test/rubygems/test_gem_package_tar_reader.rb +0 -2
  458. data/test/rubygems/test_gem_package_tar_reader_entry.rb +0 -2
  459. data/test/rubygems/test_gem_package_tar_writer.rb +4 -6
  460. data/test/rubygems/test_gem_package_task.rb +46 -13
  461. data/test/rubygems/test_gem_path_support.rb +0 -2
  462. data/test/rubygems/test_gem_platform.rb +71 -6
  463. data/test/rubygems/test_gem_rdoc.rb +0 -2
  464. data/test/rubygems/test_gem_remote_fetcher.rb +213 -212
  465. data/test/rubygems/test_gem_request.rb +13 -17
  466. data/test/rubygems/test_gem_request_connection_pools.rb +0 -4
  467. data/test/rubygems/test_gem_request_set.rb +20 -22
  468. data/test/rubygems/test_gem_request_set_gem_dependency_api.rb +3 -5
  469. data/test/rubygems/test_gem_request_set_lockfile.rb +4 -6
  470. data/test/rubygems/test_gem_request_set_lockfile_parser.rb +9 -11
  471. data/test/rubygems/test_gem_request_set_lockfile_tokenizer.rb +118 -120
  472. data/test/rubygems/test_gem_requirement.rb +43 -3
  473. data/test/rubygems/test_gem_resolver.rb +6 -8
  474. data/test/rubygems/test_gem_resolver_activation_request.rb +0 -2
  475. data/test/rubygems/test_gem_resolver_api_set.rb +60 -59
  476. data/test/rubygems/test_gem_resolver_api_specification.rb +3 -5
  477. data/test/rubygems/test_gem_resolver_best_set.rb +27 -6
  478. data/test/rubygems/test_gem_resolver_composed_set.rb +0 -2
  479. data/test/rubygems/test_gem_resolver_conflict.rb +1 -3
  480. data/test/rubygems/test_gem_resolver_dependency_request.rb +0 -2
  481. data/test/rubygems/test_gem_resolver_git_set.rb +0 -2
  482. data/test/rubygems/test_gem_resolver_git_specification.rb +0 -2
  483. data/test/rubygems/test_gem_resolver_index_set.rb +2 -4
  484. data/test/rubygems/test_gem_resolver_index_specification.rb +0 -2
  485. data/test/rubygems/test_gem_resolver_installed_specification.rb +0 -2
  486. data/test/rubygems/test_gem_resolver_installer_set.rb +7 -9
  487. data/test/rubygems/test_gem_resolver_local_specification.rb +0 -2
  488. data/test/rubygems/test_gem_resolver_lock_set.rb +3 -5
  489. data/test/rubygems/test_gem_resolver_lock_specification.rb +0 -2
  490. data/test/rubygems/test_gem_resolver_requirement_list.rb +0 -2
  491. data/test/rubygems/test_gem_resolver_specification.rb +0 -4
  492. data/test/rubygems/test_gem_resolver_vendor_set.rb +1 -3
  493. data/test/rubygems/test_gem_resolver_vendor_specification.rb +0 -2
  494. data/test/rubygems/test_gem_security.rb +22 -24
  495. data/test/rubygems/test_gem_security_policy.rb +7 -12
  496. data/test/rubygems/test_gem_security_signer.rb +10 -12
  497. data/test/rubygems/test_gem_security_trust_dir.rb +4 -6
  498. data/test/rubygems/test_gem_server.rb +10 -14
  499. data/test/rubygems/test_gem_silent_ui.rb +0 -2
  500. data/test/rubygems/test_gem_source.rb +19 -18
  501. data/test/rubygems/test_gem_source_fetch_problem.rb +0 -2
  502. data/test/rubygems/test_gem_source_git.rb +12 -13
  503. data/test/rubygems/test_gem_source_installed.rb +7 -9
  504. data/test/rubygems/test_gem_source_list.rb +1 -2
  505. data/test/rubygems/test_gem_source_local.rb +8 -10
  506. data/test/rubygems/test_gem_source_lock.rb +10 -12
  507. data/test/rubygems/test_gem_source_specific_file.rb +7 -9
  508. data/test/rubygems/test_gem_source_subpath_problem.rb +49 -0
  509. data/test/rubygems/test_gem_source_vendor.rb +7 -9
  510. data/test/rubygems/test_gem_spec_fetcher.rb +11 -4
  511. data/test/rubygems/test_gem_specification.rb +171 -139
  512. data/test/rubygems/test_gem_stream_ui.rb +3 -3
  513. data/test/rubygems/test_gem_stub_specification.rb +4 -6
  514. data/test/rubygems/test_gem_text.rb +1 -3
  515. data/test/rubygems/test_gem_uninstaller.rb +134 -12
  516. data/test/rubygems/test_gem_unsatisfiable_dependency_error.rb +0 -2
  517. data/test/rubygems/test_gem_uri_formatter.rb +0 -2
  518. data/test/rubygems/test_gem_util.rb +11 -11
  519. data/test/rubygems/test_gem_validator.rb +1 -3
  520. data/test/rubygems/test_gem_version.rb +1 -3
  521. data/test/rubygems/test_gem_version_option.rb +1 -3
  522. data/test/rubygems/test_kernel.rb +25 -10
  523. data/test/rubygems/test_project_sanity.rb +7 -2
  524. data/test/rubygems/test_remote_fetch_error.rb +0 -2
  525. data/test/rubygems/test_require.rb +291 -56
  526. data/test/test_changelog_generator.rb +17 -0
  527. metadata +84 -136
  528. data/.bundle/config +0 -2
  529. data/.rubocop.yml +0 -91
  530. data/Gemfile +0 -8
  531. data/Gemfile.lock +0 -43
  532. data/bundler/CODE_OF_CONDUCT.md +0 -136
  533. data/bundler/lib/bundler/vendor/molinillo/lib/molinillo/compatibility.rb +0 -26
  534. data/bundler/man/bundle-add.1.txt +0 -58
  535. data/bundler/man/bundle-binstubs.1.txt +0 -48
  536. data/bundler/man/bundle-cache.1.txt +0 -78
  537. data/bundler/man/bundle-check.1.txt +0 -33
  538. data/bundler/man/bundle-clean.1.txt +0 -26
  539. data/bundler/man/bundle-config.1.txt +0 -528
  540. data/bundler/man/bundle-doctor.1.txt +0 -44
  541. data/bundler/man/bundle-exec.1.txt +0 -178
  542. data/bundler/man/bundle-gem.1.txt +0 -91
  543. data/bundler/man/bundle-info.1.txt +0 -21
  544. data/bundler/man/bundle-init.1.txt +0 -34
  545. data/bundler/man/bundle-inject.1.txt +0 -32
  546. data/bundler/man/bundle-install.1.txt +0 -401
  547. data/bundler/man/bundle-list.1.txt +0 -43
  548. data/bundler/man/bundle-lock.1.txt +0 -93
  549. data/bundler/man/bundle-open.1.txt +0 -29
  550. data/bundler/man/bundle-outdated.1.txt +0 -131
  551. data/bundler/man/bundle-platform.1.txt +0 -57
  552. data/bundler/man/bundle-pristine.1.txt +0 -44
  553. data/bundler/man/bundle-remove.1.txt +0 -34
  554. data/bundler/man/bundle-show.1.txt +0 -27
  555. data/bundler/man/bundle-update.1.txt +0 -390
  556. data/bundler/man/bundle-viz.1.txt +0 -39
  557. data/bundler/man/bundle.1.txt +0 -116
  558. data/bundler/man/gemfile.5.txt +0 -649
  559. data/lib/rubygems/source_local.rb +0 -7
  560. data/lib/rubygems/source_specific_file.rb +0 -6
  561. data/lib/rubygems/ssl_certs/rubygems.global.ssl.fastly.net/DigiCertHighAssuranceEVRootCA.pem +0 -23
  562. data/lib/rubygems/ssl_certs/rubygems.org/AddTrustExternalCARoot.pem +0 -25
  563. data/lib/ubygems.rb +0 -14
  564. data/tmp/.keep +0 -0
  565. data/util/CL2notes +0 -55
  566. data/util/bisect +0 -10
  567. data/util/ci.sh +0 -62
  568. data/util/cops/deprecations.rb +0 -52
  569. data/util/create_certs.rb +0 -171
  570. data/util/create_certs.sh +0 -27
  571. data/util/create_encrypted_key.rb +0 -16
  572. data/util/generate_spdx_license_list.rb +0 -63
  573. data/util/patch_with_prs.rb +0 -77
  574. data/util/rubocop +0 -8
  575. data/util/update_bundled_ca_certificates.rb +0 -139
  576. data/util/update_changelog.rb +0 -64
@@ -1,649 +0,0 @@
1
- GEMFILE(5) GEMFILE(5)
2
-
3
-
4
-
5
- NAME
6
- Gemfile - A format for describing gem dependencies for Ruby programs
7
-
8
- SYNOPSIS
9
- A Gemfile describes the gem dependencies required to execute associated
10
- Ruby code.
11
-
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
-
16
- SYNTAX
17
- A Gemfile is evaluated as Ruby code, in a context which makes available
18
- a number of methods used to describe the gem requirements.
19
-
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
-
24
-
25
-
26
- source "https://rubygems.org"
27
-
28
-
29
-
30
- It is possible, but not recommended as of Bundler 1.7, to add multiple
31
- global source lines. Each of these sources MUST be a valid Rubygems
32
- repository.
33
-
34
- Sources are checked for gems following the heuristics described in
35
- SOURCE PRIORITY. If a gem is found in more than one global source,
36
- Bundler will print a warning after installing the gem indicating which
37
- source was used, and listing the other sources where the gem is avail-
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 :source
40
- option or a source block.
41
-
42
- CREDENTIALS
43
- Some gem sources require a username and password. Use bundle config(1)
44
- bundle-config.1.html to set the username and password for any of the
45
- sources that need it. The command must be run once on each computer
46
- that will install the Gemfile, but this keeps the credentials from
47
- being stored in plain text in version control.
48
-
49
-
50
-
51
- bundle config gems.example.com user:password
52
-
53
-
54
-
55
- For some sources, like a company Gemfury account, it may be easier to
56
- include the credentials in the Gemfile as part of the source URL.
57
-
58
-
59
-
60
- source "https://user:password@gems.example.com"
61
-
62
-
63
-
64
- Credentials in the source URL will take precedence over credentials set
65
- using config.
66
-
67
- RUBY
68
- If your application requires a specific Ruby version or engine, specify
69
- your requirements using the ruby method, with the following arguments.
70
- All parameters are OPTIONAL unless otherwise specified.
71
-
72
- VERSION (required)
73
- The version of Ruby that your application requires. If your application
74
- requires an alternate Ruby engine, such as JRuby, Rubinius or Truf-
75
- fleRuby, this should be the Ruby version that the engine is compatible
76
- with.
77
-
78
-
79
-
80
- ruby "1.9.3"
81
-
82
-
83
-
84
- ENGINE
85
- Each application may specify a Ruby engine. If an engine is specified,
86
- an engine version must also be specified.
87
-
88
- What exactly is an Engine? - A Ruby engine is an implementation of the
89
- Ruby language.
90
-
91
- o For background: the reference or original implementation of the
92
- Ruby programming language is called Matz's Ruby Interpreter
93
- https://en.wikipedia.org/wiki/Ruby_MRI, or MRI for short. This is
94
- named after Ruby creator Yukihiro Matsumoto, also known as Matz.
95
- MRI is also known as CRuby, because it is written in C. MRI is the
96
- most widely used Ruby engine.
97
-
98
- o Other implementations https://www.ruby-lang.org/en/about/ of Ruby
99
- exist. Some of the more well-known implementations include Rubinius
100
- https://rubinius.com/, and JRuby http://jruby.org/. Rubinius is an
101
- alternative implementation of Ruby written in Ruby. JRuby is an
102
- implementation of Ruby on the JVM, short for Java Virtual Machine.
103
-
104
-
105
-
106
- ENGINE VERSION
107
- Each application may specify a Ruby engine version. If an engine ver-
108
- sion is specified, an engine must also be specified. If the engine is
109
- "ruby" the engine version specified must match the Ruby version.
110
-
111
-
112
-
113
- ruby "1.8.7", :engine => "jruby", :engine_version => "1.6.7"
114
-
115
-
116
-
117
- PATCHLEVEL
118
- Each application may specify a Ruby patchlevel.
119
-
120
-
121
-
122
- ruby "2.0.0", :patchlevel => "247"
123
-
124
-
125
-
126
- GEMS
127
- Specify gem requirements using the gem method, with the following argu-
128
- ments. All parameters are OPTIONAL unless otherwise specified.
129
-
130
- NAME (required)
131
- For each gem requirement, list a single gem line.
132
-
133
-
134
-
135
- gem "nokogiri"
136
-
137
-
138
-
139
- VERSION
140
- Each gem MAY have one or more version specifiers.
141
-
142
-
143
-
144
- gem "nokogiri", ">= 1.4.2"
145
- gem "RedCloth", ">= 4.1.0", "< 4.2.0"
146
-
147
-
148
-
149
- REQUIRE AS
150
- Each gem MAY specify files that should be used when autorequiring via
151
- Bundler.require. You may pass an array with multiple files or true if
152
- file you want required has same name as gem or false to prevent any
153
- file from being autorequired.
154
-
155
-
156
-
157
- gem "redis", :require => ["redis/connection/hiredis", "redis"]
158
- gem "webmock", :require => false
159
- gem "byebug", :require => true
160
-
161
-
162
-
163
- The argument defaults to the name of the gem. For example, these are
164
- identical:
165
-
166
-
167
-
168
- gem "nokogiri"
169
- gem "nokogiri", :require => "nokogiri"
170
- gem "nokogiri", :require => true
171
-
172
-
173
-
174
- GROUPS
175
- Each gem MAY specify membership in one or more groups. Any gem that
176
- does not specify membership in any group is placed in the default
177
- group.
178
-
179
-
180
-
181
- gem "rspec", :group => :test
182
- gem "wirble", :groups => [:development, :test]
183
-
184
-
185
-
186
- The Bundler runtime allows its two main methods, Bundler.setup and
187
- Bundler.require, to limit their impact to particular groups.
188
-
189
-
190
-
191
- # setup adds gems to Ruby's load path
192
- Bundler.setup # defaults to all groups
193
- require "bundler/setup" # same as Bundler.setup
194
- Bundler.setup(:default) # only set up the _default_ group
195
- Bundler.setup(:test) # only set up the _test_ group (but `not` _default_)
196
- Bundler.setup(:default, :test) # set up the _default_ and _test_ groups, but no others
197
-
198
- # require requires all of the gems in the specified groups
199
- Bundler.require # defaults to the _default_ group
200
- Bundler.require(:default) # identical
201
- Bundler.require(:default, :test) # requires the _default_ and _test_ groups
202
- Bundler.require(:test) # requires the _test_ group
203
-
204
-
205
-
206
- The Bundler CLI allows you to specify a list of groups whose gems bun-
207
- dle install should not install with the without configuration.
208
-
209
- To specify multiple groups to ignore, specify a list of groups sepa-
210
- rated by spaces.
211
-
212
-
213
-
214
- bundle config set without test
215
- bundle config set without development test
216
-
217
-
218
-
219
- Also, calling Bundler.setup with no parameters, or calling require
220
- "bundler/setup" will setup all groups except for the ones you excluded
221
- via --without (since they are not available).
222
-
223
- Note that on bundle install, bundler downloads and evaluates all gems,
224
- in order to create a single canonical list of all of the required gems
225
- and their dependencies. This means that you cannot list different ver-
226
- sions of the same gems in different groups. For more details, see
227
- Understanding Bundler https://bundler.io/rationale.html.
228
-
229
- PLATFORMS
230
- If a gem should only be used in a particular platform or set of plat-
231
- forms, you can specify them. Platforms are essentially identical to
232
- groups, except that you do not need to use the --without install-time
233
- flag to exclude groups of gems for other platforms.
234
-
235
- There are a number of Gemfile platforms:
236
-
237
- ruby C Ruby (MRI), Rubinius or TruffleRuby, but NOT Windows
238
-
239
- mri Same as ruby, but only C Ruby (MRI)
240
-
241
- mingw Windows 32 bit 'mingw32' platform (aka RubyInstaller)
242
-
243
- x64_mingw
244
- Windows 64 bit 'mingw32' platform (aka RubyInstaller x64)
245
-
246
- rbx Rubinius
247
-
248
- jruby JRuby
249
-
250
- truffleruby
251
- TruffleRuby
252
-
253
- mswin Windows
254
-
255
- You can restrict further by platform and version for all platforms
256
- except for rbx, jruby, truffleruby and mswin.
257
-
258
- To specify a version in addition to a platform, append the version num-
259
- ber without the delimiter to the platform. For example, to specify that
260
- a gem should only be used on platforms with Ruby 2.3, use:
261
-
262
-
263
-
264
- ruby_23
265
-
266
-
267
-
268
- The full list of platforms and supported versions includes:
269
-
270
- ruby 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
271
-
272
- mri 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
273
-
274
- mingw 1.8, 1.9, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
275
-
276
- x64_mingw
277
- 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
278
-
279
- As with groups, you can specify one or more platforms:
280
-
281
-
282
-
283
- gem "weakling", :platforms => :jruby
284
- gem "ruby-debug", :platforms => :mri_18
285
- gem "nokogiri", :platforms => [:mri_18, :jruby]
286
-
287
-
288
-
289
- All operations involving groups (bundle install bundle-install.1.html,
290
- Bundler.setup, Bundler.require) behave exactly the same as if any
291
- groups not matching the current platform were explicitly excluded.
292
-
293
- SOURCE
294
- You can select an alternate Rubygems repository for a gem using the
295
- ':source' option.
296
-
297
-
298
-
299
- gem "some_internal_gem", :source => "https://gems.example.com"
300
-
301
-
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
305
- not exist in this source, it will not be installed.
306
-
307
- Bundler will search for child dependencies of this gem by first looking
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
- SOURCE PRIORITY.
311
-
312
- Selecting a specific source repository this way also suppresses the
313
- ambiguous gem warning described above in GLOBAL SOURCES (#source).
314
-
315
- Using the :source option for an individual gem will also make that
316
- source available as a possible global source for any other gems which
317
- do not specify explicit sources. Thus, when adding gems with explicit
318
- sources, it is recommended that you also ensure all other gems in the
319
- Gemfile are using explicit sources.
320
-
321
- GIT
322
- If necessary, you can specify that a gem is located at a particular git
323
- repository using the :git parameter. The repository can be accessed via
324
- several protocols:
325
-
326
- HTTP(S)
327
- gem "rails", :git => "https://github.com/rails/rails.git"
328
-
329
- SSH gem "rails", :git => "git@github.com:rails/rails.git"
330
-
331
- git gem "rails", :git => "git://github.com/rails/rails.git"
332
-
333
- If using SSH, the user that you use to run bundle install MUST have the
334
- appropriate keys available in their $HOME/.ssh.
335
-
336
- NOTE: http:// and git:// URLs should be avoided if at all possible.
337
- These protocols are unauthenticated, so a man-in-the-middle attacker
338
- can deliver malicious code and compromise your system. HTTPS and SSH
339
- are strongly preferred.
340
-
341
- The group, platforms, and require options are available and behave
342
- exactly the same as they would for a normal gem.
343
-
344
- A git repository SHOULD have at least one file, at the root of the
345
- directory containing the gem, with the extension .gemspec. This file
346
- MUST contain a valid gem specification, as expected by the gem build
347
- command.
348
-
349
- If a git repository does not have a .gemspec, bundler will attempt to
350
- create one, but it will not contain any dependencies, executables, or C
351
- extension compilation instructions. As a result, it may fail to prop-
352
- erly integrate into your application.
353
-
354
- If a git repository does have a .gemspec for the gem you attached it
355
- to, a version specifier, if provided, means that the git repository is
356
- only valid if the .gemspec specifies a version matching the version
357
- specifier. If not, bundler will print a warning.
358
-
359
-
360
-
361
- gem "rails", "2.3.8", :git => "https://github.com/rails/rails.git"
362
- # bundle install will fail, because the .gemspec in the rails
363
- # repository's master branch specifies version 3.0.0
364
-
365
-
366
-
367
- If a git repository does not have a .gemspec for the gem you attached
368
- it to, a version specifier MUST be provided. Bundler will use this ver-
369
- sion in the simple .gemspec it creates.
370
-
371
- Git repositories support a number of additional options.
372
-
373
- branch, tag, and ref
374
- You MUST only specify at most one of these options. The default
375
- is :branch => "master". For example:
376
-
377
- gem "rails", :git => "https://github.com/rails/rails.git",
378
- :branch => "5-0-stable"
379
-
380
- gem "rails", :git => "https://github.com/rails/rails.git", :tag
381
- => "v5.0.0"
382
-
383
- gem "rails", :git => "https://github.com/rails/rails.git", :ref
384
- => "4aded"
385
-
386
- submodules
387
- For reference, a git submodule
388
- https://git-scm.com/book/en/v2/Git-Tools-Submodules lets you
389
- have another git repository within a subfolder of your reposi-
390
- tory. Specify :submodules => true to cause bundler to expand any
391
- submodules included in the git repository
392
-
393
- If a git repository contains multiple .gemspecs, each .gemspec repre-
394
- sents a gem located at the same place in the file system as the .gem-
395
- spec.
396
-
397
-
398
-
399
- |~rails [git root]
400
- | |-rails.gemspec [rails gem located here]
401
- |~actionpack
402
- | |-actionpack.gemspec [actionpack gem located here]
403
- |~activesupport
404
- | |-activesupport.gemspec [activesupport gem located here]
405
- |...
406
-
407
-
408
-
409
- To install a gem located in a git repository, bundler changes to the
410
- directory containing the gemspec, runs gem build name.gemspec and then
411
- installs the resulting gem. The gem build command, which comes standard
412
- with Rubygems, evaluates the .gemspec in the context of the directory
413
- in which it is located.
414
-
415
- GIT SOURCE
416
- A custom git source can be defined via the git_source method. Provide
417
- the source's name as an argument, and a block which receives a single
418
- argument and interpolates it into a string to return the full repo
419
- address:
420
-
421
-
422
-
423
- git_source(:stash){ |repo_name| "https://stash.corp.acme.pl/#{repo_name}.git" }
424
- gem 'rails', :stash => 'forks/rails'
425
-
426
-
427
-
428
- In addition, if you wish to choose a specific branch:
429
-
430
-
431
-
432
- gem "rails", :stash => "forks/rails", :branch => "branch_name"
433
-
434
-
435
-
436
- GITHUB
437
- NOTE: This shorthand should be avoided until Bundler 2.0, since it cur-
438
- rently expands to an insecure git:// URL. This allows a man-in-the-mid-
439
- dle attacker to compromise your system.
440
-
441
- If the git repository you want to use is hosted on GitHub and is pub-
442
- lic, you can use the :github shorthand to specify the github username
443
- and repository name (without the trailing ".git"), separated by a
444
- slash. If both the username and repository name are the same, you can
445
- omit one.
446
-
447
-
448
-
449
- gem "rails", :github => "rails/rails"
450
- gem "rails", :github => "rails"
451
-
452
-
453
-
454
- Are both equivalent to
455
-
456
-
457
-
458
- gem "rails", :git => "git://github.com/rails/rails.git"
459
-
460
-
461
-
462
- Since the github method is a specialization of git_source, it accepts a
463
- :branch named argument.
464
-
465
- GIST
466
- If the git repository you want to use is hosted as a Github Gist and is
467
- public, you can use the :gist shorthand to specify the gist identifier
468
- (without the trailing ".git").
469
-
470
-
471
-
472
- gem "the_hatch", :gist => "4815162342"
473
-
474
-
475
-
476
- Is equivalent to:
477
-
478
-
479
-
480
- gem "the_hatch", :git => "https://gist.github.com/4815162342.git"
481
-
482
-
483
-
484
- Since the gist method is a specialization of git_source, it accepts a
485
- :branch named argument.
486
-
487
- BITBUCKET
488
- If the git repository you want to use is hosted on Bitbucket and is
489
- public, you can use the :bitbucket shorthand to specify the bitbucket
490
- username and repository name (without the trailing ".git"), separated
491
- by a slash. If both the username and repository name are the same, you
492
- can omit one.
493
-
494
-
495
-
496
- gem "rails", :bitbucket => "rails/rails"
497
- gem "rails", :bitbucket => "rails"
498
-
499
-
500
-
501
- Are both equivalent to
502
-
503
-
504
-
505
- gem "rails", :git => "https://rails@bitbucket.org/rails/rails.git"
506
-
507
-
508
-
509
- Since the bitbucket method is a specialization of git_source, it
510
- accepts a :branch named argument.
511
-
512
- PATH
513
- You can specify that a gem is located in a particular location on the
514
- file system. Relative paths are resolved relative to the directory con-
515
- taining the Gemfile.
516
-
517
- Similar to the semantics of the :git option, the :path option requires
518
- that the directory in question either contains a .gemspec for the gem,
519
- or that you specify an explicit version that bundler should use.
520
-
521
- Unlike :git, bundler does not compile C extensions for gems specified
522
- as paths.
523
-
524
-
525
-
526
- gem "rails", :path => "vendor/rails"
527
-
528
-
529
-
530
- If you would like to use multiple local gems directly from the filesys-
531
- tem, you can set a global path option to the path containing the gem's
532
- files. This will automatically load gemspec files from subdirectories.
533
-
534
-
535
-
536
- path 'components' do
537
- gem 'admin_ui'
538
- gem 'public_ui'
539
- end
540
-
541
-
542
-
543
- BLOCK FORM OF SOURCE, GIT, PATH, GROUP and PLATFORMS
544
- The :source, :git, :path, :group, and :platforms options may be applied
545
- to a group of gems by using block form.
546
-
547
-
548
-
549
- source "https://gems.example.com" do
550
- gem "some_internal_gem"
551
- gem "another_internal_gem"
552
- end
553
-
554
- git "https://github.com/rails/rails.git" do
555
- gem "activesupport"
556
- gem "actionpack"
557
- end
558
-
559
- platforms :ruby do
560
- gem "ruby-debug"
561
- gem "sqlite3"
562
- end
563
-
564
- group :development, :optional => true do
565
- gem "wirble"
566
- gem "faker"
567
- end
568
-
569
-
570
-
571
- In the case of the group block form the :optional option can be given
572
- to prevent a group from being installed unless listed in the --with
573
- option given to the bundle install command.
574
-
575
- In the case of the git block form, the :ref, :branch, :tag, and :sub-
576
- modules options may be passed to the git method, and all gems in the
577
- block will inherit those options.
578
-
579
- The presence of a source block in a Gemfile also makes that source
580
- available as a possible global source for any other gems which do not
581
- specify explicit sources. Thus, when defining source blocks, it is rec-
582
- ommended that you also ensure all other gems in the Gemfile are using
583
- explicit sources, either via source blocks or :source directives on
584
- individual gems.
585
-
586
- INSTALL_IF
587
- The install_if method allows gems to be installed based on a proc or
588
- lambda. This is especially useful for optional gems that can only be
589
- used if certain software is installed or some other conditions are met.
590
-
591
-
592
-
593
- install_if -> { RUBY_PLATFORM =~ /darwin/ } do
594
- gem "pasteboard"
595
- end
596
-
597
-
598
-
599
- GEMSPEC
600
- The .gemspec http://guides.rubygems.org/specification-reference/ file
601
- is where you provide metadata about your gem to Rubygems. Some required
602
- Gemspec attributes include the name, description, and homepage of your
603
- gem. This is also where you specify the dependencies your gem needs to
604
- run.
605
-
606
- If you wish to use Bundler to help install dependencies for a gem while
607
- it is being developed, use the gemspec method to pull in the dependen-
608
- cies listed in the .gemspec file.
609
-
610
- The gemspec method adds any runtime dependencies as gem requirements in
611
- the default group. It also adds development dependencies as gem
612
- requirements in the development group. Finally, it adds a gem require-
613
- ment on your project (:path => '.'). In conjunction with Bundler.setup,
614
- this allows you to require project files in your test code as you would
615
- if the project were installed as a gem; you need not manipulate the
616
- load path manually or require project files via relative paths.
617
-
618
- The gemspec method supports optional :path, :glob, :name, and :develop-
619
- ment_group options, which control where bundler looks for the .gemspec,
620
- the glob it uses to look for the gemspec (defaults to: "{,,/*}.gem-
621
- spec"), what named .gemspec it uses (if more than one is present), and
622
- which group development dependencies are included in.
623
-
624
- When a gemspec dependency encounters version conflicts during resolu-
625
- tion, the local version under development will always be selected --
626
- even if there are remote versions that better match other requirements
627
- for the gemspec gem.
628
-
629
- SOURCE PRIORITY
630
- When attempting to locate a gem to satisfy a gem requirement, bundler
631
- uses the following priority order:
632
-
633
- 1. The source explicitly attached to the gem (using :source, :path, or
634
- :git)
635
-
636
- 2. For implicit gems (dependencies of explicit gems), any source, git,
637
- or path repository declared on the parent. This results in bundler
638
- prioritizing the ActiveSupport gem from the Rails git repository
639
- over ones from rubygems.org
640
-
641
- 3. The sources specified via global source lines, searching each
642
- source in your Gemfile from last added to first added.
643
-
644
-
645
-
646
-
647
-
648
-
649
- January 2020 GEMFILE(5)