Merge Bundler 2.1.0.pre.3

  Features:
    - Add caller information to some deprecation messages to make them easier to fix [#7361](https://github.com/bundler/bundler/pull/7361)
    - Reconcile `bundle cache` vs `bundle package` everywhere. Now in docs, CLI help and everywhere else `bundle cache` is the preferred version and `bundle package` remains as an alias [#7389](https://github.com/bundler/bundler/pull/7389)
    - Display some basic `bundler` documentation together with ruby's RDoc based documentation [#7394](https://github.com/bundler/bundler/pull/7394)

  Bugfixes:
    - Fix typos deprecation message and upgrading docs [#7374](https://github.com/bundler/bundler/pull/7374)
    - Deprecation warnings about `taint` usage on ruby 2.7 [#7385](https://github.com/bundler/bundler/pull/7385)
    - Fix `--help` flag not correctly delegating to `man` when used with command aliases [#7388](https://github.com/bundler/bundler/pull/7388)
    - `bundle add` should cache newly added gems if an application cache exists [#7393](https://github.com/bundler/bundler/pull/7393)
    - Stop using an insecure folder as a "fallback home" when user home is not defined [#7416](https://github.com/bundler/bundler/pull/7416)
    - Fix `bundler/inline` warning about `Bundler.root` redefinition [#7417](https://github.com/bundler/bundler/pull/7417)

1 files changed, 127 insertions, 0 deletions

diff --git a/spec/bundler/support/rubygems_version_manager.rb b/spec/bundler/support/rubygems_version_manager.rb
new file mode 100644
index 0000000000..31f7cc4b08
--- /dev/null
+++ b/spec/bundler/support/rubygems_version_manager.rb
@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "helpers"
+require_relative "path"
+
+class RubygemsVersionManager
+  include Spec::Helpers
+  include Spec::Path
+
+  def initialize(env_version)
+    @env_version = env_version
+  end
+
+  def switch
+    return if use_system?
+
+    unrequire_rubygems_if_needed
+
+    switch_local_copy_if_needed
+
+    prepare_environment
+  end
+
+private
+
+  def use_system?
+    @env_version.nil?
+  end
+
+  def unrequire_rubygems_if_needed
+    return unless rubygems_unrequire_needed?
+
+    require "rbconfig"
+
+    ruby = File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"])
+    ruby << RbConfig::CONFIG["EXEEXT"]
+
+    cmd = [ruby, $0, *ARGV].compact
+    cmd[1, 0] = "--disable-gems"
+
+    exec(ENV, *cmd)
+  end
+
+  def switch_local_copy_if_needed
+    return unless local_copy_switch_needed?
+
+    Dir.chdir(local_copy_path) do
+      sys_exec!("git remote update")
+      sys_exec!("git checkout #{target_tag_version} --quiet")
+    end
+  end
+
+  def prepare_environment
+    $:.unshift File.expand_path("lib", local_copy_path)
+  end
+
+  def rubygems_unrequire_needed?
+    defined?(Gem) && Gem::VERSION != target_gem_version
+  end
+
+  def local_copy_switch_needed?
+    !env_version_is_path? && target_gem_version != local_copy_version
+  end
+
+  def target_gem_version
+    @target_gem_version ||= resolve_target_gem_version
+  end
+
+  def target_tag_version
+    @target_tag_version ||= resolve_target_tag_version
+  end
+
+  def local_copy_version
+    gemspec_contents = File.read(local_copy_path.join("lib/rubygems.rb"))
+    version_regexp = /VERSION = ["'](.*)["']/
+
+    version_regexp.match(gemspec_contents)[1]
+  end
+
+  def local_copy_path
+    @local_copy_path ||= resolve_local_copy_path
+  end
+
+  def resolve_local_copy_path
+    return expanded_env_version if env_version_is_path?
+
+    rubygems_path = root.join("tmp/rubygems")
+
+    unless rubygems_path.directory?
+      rubygems_path.parent.mkpath
+      sys_exec!("git clone https://github.com/rubygems/rubygems.git #{rubygems_path}")
+    end
+
+    rubygems_path
+  end
+
+  def env_version_is_path?
+    expanded_env_version.directory?
+  end
+
+  def expanded_env_version
+    @expanded_env_version ||= Pathname.new(@env_version).expand_path(root)
+  end
+
+  def resolve_target_tag_version
+    return "v#{@env_version}" if @env_version.match(/^\d/)
+
+    return "master" if @env_version == master_gem_version
+
+    @env_version
+  end
+
+  def resolve_target_gem_version
+    return local_copy_version if env_version_is_path?
+
+    return @env_version[1..-1] if @env_version.match(/^v/)
+
+    return master_gem_version if @env_version == "master"
+
+    @env_version
+  end
+
+  def master_gem_version
+    "3.1.0.pre1"
+  end
+end