module Gem

# File lib/rubygems.rb, line 283
def self.activate_and_load_bin_path(name, exec_name = nil, *requirements)
  spec = find_and_activate_spec_for_exe name, exec_name, requirements

  if spec.name == "bundler"
    # Old versions of Bundler need a workaround to support nested `bundle
    # exec` invocations by overriding `Gem.activate_bin_path`. However,
    # RubyGems now uses this new `Gem.activate_and_load_bin_path` helper in
    # binstubs, which is of course not overridden in Bundler since it didn't
    # exist at the time. So, include the override here to workaround that.
    load ENV["BUNDLE_BIN_PATH"] if ENV["BUNDLE_BIN_PATH"] && spec.version <= Gem::Version.create("2.5.22")

    # Make sure there's no version of Bundler in `$LOAD_PATH` that's different
    # from the version we just activated. If that was the case (it happens
    # when testing Bundler from ruby/ruby), we would load Bundler extensions
    # to RubyGems from the copy in `$LOAD_PATH` but then load the binstub from
    # an installed copy, causing those copies to be mixed and yet more
    # redefinition warnings.
    #
    require_path = $LOAD_PATH.resolve_feature_path("bundler").last.delete_suffix("/bundler.rb")
    Gem.load_bundler_extensions(spec.version) if spec.full_require_paths.include?(require_path)
  end

  load spec.bin_file(exec_name)
end

# File lib/rubygems.rb, line 626
def self.activated_gem_paths
  @activated_gem_paths ||= 0
end

# File lib/rubygems.rb, line 633
def self.add_to_load_path(*paths)
  @activated_gem_paths = activated_gem_paths + paths.size

  # gem directories must come after -I and ENV['RUBYLIB']
  $LOAD_PATH.insert(Gem.load_path_insert_index, *paths)
end

# File lib/rubygems.rb, line 231
def self.bin_path(name, exec_name = nil, *requirements)
  requirements = Gem::Requirement.default if
    requirements.empty?

  find_spec_for_exe(name, exec_name, requirements).bin_file exec_name
end

# File lib/rubygems.rb, line 326
def self.binary_mode
  "rb"
end

# File lib/rubygems.rb, line 333
def self.bindir(install_dir = Gem.dir)
  return File.join install_dir, "bin" unless
    install_dir.to_s == Gem.default_dir.to_s
  Gem.default_bindir
end

# File lib/rubygems/defaults.rb, line 147
def self.cache_home
  @cache_home ||= ENV["XDG_CACHE_HOME"] || File.join(Gem.user_home, ".cache")
end

# File lib/rubygems.rb, line 1326
def clear_default_specs
  @path_to_default_spec_map.clear
end

# File lib/rubygems.rb, line 351
def self.clear_paths
  @paths         = nil
  @user_home     = nil
  Gem::Specification.reset
  Gem::Security.reset if defined?(Gem::Security)
end

# File lib/rubygems/defaults.rb, line 133
def self.config_file
  @config_file ||= find_config_file
end

# File lib/rubygems/defaults.rb, line 114
def self.config_home
  @config_home ||= ENV["XDG_CONFIG_HOME"] || File.join(Gem.user_home, ".config")
end

# File lib/rubygems.rb, line 361
def self.configuration
  @configuration ||= Gem::ConfigFile.new []
end

# File lib/rubygems.rb, line 369
def self.configuration=(config)
  @configuration = config
end

# File lib/rubygems/defaults.rb, line 154
def self.data_home
  @data_home ||= ENV["XDG_DATA_HOME"] || File.join(Gem.user_home, ".local", "share")
end

# File lib/rubygems/defaults.rb, line 204
def self.default_bindir
  RbConfig::CONFIG["bindir"]
end

# File lib/rubygems/defaults.rb, line 228
def self.default_cert_path
  default_cert_path = File.join Gem.user_home, ".gem", "gem-public_cert.pem"

  unless File.exist?(default_cert_path)
    default_cert_path = File.join Gem.data_home, "gem", "gem-public_cert.pem"
  end

  default_cert_path
end

# File lib/rubygems/defaults.rb, line 37
def self.default_dir
  @default_dir ||= File.join(RbConfig::CONFIG["rubylibprefix"], "gems", RbConfig::CONFIG["ruby_version"])
end

# File lib/rubygems/defaults.rb, line 186
def self.default_exec_format
  exec_format = begin
                  RbConfig::CONFIG["ruby_install_name"].sub("ruby", "%s")
                rescue StandardError
                  "%s"
                end

  unless exec_format.include?("%s")
    raise Gem::Exception,
      "[BUG] invalid exec_format #{exec_format.inspect}, no %s"
  end

  exec_format
end

# File lib/rubygems/defaults.rb, line 48
def self.default_ext_dir_for(base_dir)
  nil
end

# File lib/rubygems/defaults.rb, line 215
def self.default_key_path
  default_key_path = File.join Gem.user_home, ".gem", "gem-private_key.pem"

  unless File.exist?(default_key_path)
    default_key_path = File.join Gem.data_home, "gem", "gem-private_key.pem"
  end

  default_key_path
end

# File lib/rubygems/defaults.rb, line 175
def self.default_path
  path = []
  path << user_dir if user_home && File.exist?(user_home)
  path << default_dir
  path << vendor_dir if vendor_dir && File.directory?(vendor_dir)
  path
end

# File lib/rubygems/defaults.rb, line 55
def self.default_rubygems_dirs
  nil # default to standard layout
end

# File lib/rubygems/defaults.rb, line 15
def self.default_sources
  @default_sources ||= %w[https://rubygems.org/]
end

# File lib/rubygems/defaults.rb, line 23
def self.default_spec_cache_dir
  default_spec_cache_dir = File.join Gem.user_home, ".gem", "specs"

  unless File.exist?(default_spec_cache_dir)
    default_spec_cache_dir = File.join Gem.cache_home, "gem", "specs"
  end

  default_spec_cache_dir
end

# File lib/rubygems/defaults.rb, line 62
def self.default_specifications_dir
  @default_specifications_dir ||= File.join(Gem.default_dir, "specifications", "default")
end

# File lib/rubygems.rb, line 376
def self.deflate(data)
  require "zlib"
  Zlib::Deflate.deflate data
end

# File lib/rubygems.rb, line 424
def self.dir
  paths.home
end

# File lib/rubygems.rb, line 761
def self.done_installing(&hook)
  @done_installing_hooks << hook
end

# File lib/rubygems.rb, line 1042
def self.dynamic_library_suffixes
  @dynamic_library_suffixes ||= suffixes - [".rb"]
end

# File lib/rubygems.rb, line 475
def self.ensure_default_gem_subdirectories(dir = Gem.dir, mode = nil)
  ensure_subdirectories(dir, mode, REPOSITORY_DEFAULT_GEM_SUBDIRECTORIES)
end

# File lib/rubygems.rb, line 462
def self.ensure_gem_subdirectories(dir = Gem.dir, mode = nil)
  ensure_subdirectories(dir, mode, REPOSITORY_SUBDIRECTORIES)
end

# File lib/rubygems.rb, line 910
def self.env_requirement(gem_name)
  @env_requirements_by_name ||= {}
  @env_requirements_by_name[gem_name] ||= begin
    req = ENV["GEM_REQUIREMENT_#{gem_name.upcase}"] || ">= 0"
    Gem::Requirement.create(req)
  end
end

# File lib/rubygems/defaults.rb, line 121
def self.find_config_file
  gemrc = File.join Gem.user_home, ".gemrc"
  if File.exist? gemrc
    gemrc
  else
    File.join Gem.config_home, "gem", "gemrc"
  end
end

# File lib/rubygems.rb, line 1311
def find_default_spec(path)
  @path_to_default_spec_map[path]
end

# File lib/rubygems.rb, line 526
def self.find_files(glob, check_load_path = true)
  files = []

  files = find_files_from_load_path glob if check_load_path

  gem_specifications = @gemdeps ? Gem.loaded_specs.values : Gem::Specification.stubs

  files.concat gem_specifications.flat_map {|spec|
    spec.matches_for_glob("#{glob}#{Gem.suffix_pattern}")
  }

  # $LOAD_PATH might contain duplicate entries or reference
  # the spec dirs directly, so we prune.
  files.uniq! if check_load_path

  files
end

# File lib/rubygems.rb, line 563
def self.find_latest_files(glob, check_load_path = true)
  files = []

  files = find_files_from_load_path glob if check_load_path

  files.concat Gem::Specification.latest_specs(true).flat_map {|spec|
    spec.matches_for_glob("#{glob}#{Gem.suffix_pattern}")
  }

  # $LOAD_PATH might contain duplicate entries or reference
  # the spec dirs directly, so we prune.
  files.uniq! if check_load_path

  files
end

# File lib/rubygems.rb, line 1318
def find_unresolved_default_spec(path)
  default_spec = @path_to_default_spec_map[path]
  default_spec if default_spec && loaded_specs[default_spec.name] != default_spec
end

# File lib/rubygems.rb, line 216
def self.finish_resolve(request_set = Gem::RequestSet.new)
  request_set.import Gem::Specification.unresolved_deps.values
  request_set.import Gem.loaded_specs.values.map {|s| Gem::Dependency.new(s.name, s.version) }

  request_set.resolve_current.each do |s|
    s.full_spec.activate
  end
end

# File lib/rubygems.rb, line 1100
def self.freebsd_platform?
  RbConfig::CONFIG["host_os"].to_s.include?("bsd")
end

# File lib/rubygems.rb, line 598
def self.host
  @host ||= Gem::DEFAULT_HOST
end

# File lib/rubygems.rb, line 604
def self.host=(host)
  @host = host
end

# File lib/rubygems.rb, line 587
def self.install(name, version = Gem::Requirement.default, *options)
  require_relative "rubygems/dependency_installer"
  inst = Gem::DependencyInstaller.new(*options)
  inst.install name, version
  inst.installed_gems
end

# File lib/rubygems.rb, line 1086
def self.java_platform?
  RUBY_PLATFORM == "java"
end

# File lib/rubygems.rb, line 935
def self.latest_rubygems_version
  latest_version_for("rubygems-update") ||
    raise("Can't find 'rubygems-update' in any repo. Check `gem source list`.")
end

# File lib/rubygems.rb, line 922
def self.latest_spec_for(name)
  dependency   = Gem::Dependency.new name
  fetcher      = Gem::SpecFetcher.fetcher
  spec_tuples, = fetcher.spec_for_dependency dependency

  spec, = spec_tuples.last

  spec
end

# File lib/rubygems.rb, line 943
def self.latest_version_for(name)
  latest_spec_for(name)&.version
end

# File lib/rubygems.rb, line 670
def self.load_bundler_extensions(version)
  return unless version <= Gem::Version.create("2.6.9")

  previous_platforms = {}

  platform_const_list = ["JAVA", "MSWIN", "MSWIN64", "MINGW", "X64_MINGW_LEGACY", "X64_MINGW", "UNIVERSAL_MINGW", "WINDOWS", "X64_LINUX", "X64_LINUX_MUSL"]

  platform_const_list.each do |platform|
    previous_platforms[platform] = Gem::Platform.const_get(platform)
    Gem::Platform.send(:remove_const, platform)
  end

  require "bundler/rubygems_ext"

  platform_const_list.each do |platform|
    Gem::Platform.send(:remove_const, platform) if Gem::Platform.const_defined?(platform)
    Gem::Platform.const_set(platform, previous_platforms[platform])
  end
end

# File lib/rubygems.rb, line 1135
def self.load_env_plugins
  load_plugin_files find_files_from_load_path("rubygems_plugin")
end

# File lib/rubygems.rb, line 612
def self.load_path_insert_index
  $LOAD_PATH.each_with_index do |path, i|
    return i if path.instance_variable_defined?(:@gem_prelude_index)
  end

  index = $LOAD_PATH.index RbConfig::CONFIG["sitelibdir"]

  index || 0
end

# File lib/rubygems.rb, line 1126
def self.load_plugins
  Gem.path.each do |gem_path|
    load_plugin_files Gem::Util.glob_files_in_dir("*#{Gem.plugin_suffix_pattern}", plugindir(gem_path))
  end
end

# File lib/rubygems.rb, line 658
def self.load_safe_marshal
  return if @safe_marshal_loaded

  require_relative "rubygems/safe_marshal"

  @safe_marshal_loaded = true
end

# File lib/rubygems.rb, line 645
def self.load_yaml
  return if @yaml_loaded

  require "psych"
  require_relative "rubygems/psych_tree"

  require_relative "rubygems/safe_yaml"

  @yaml_loaded = true
end

# File lib/rubygems.rb, line 704
def self.location_of_caller(depth = 1)
  caller[depth] =~ /(.*?):(\d+).*?$/i
  file = $1
  lineno = $2.to_i

  [file, lineno]
end

# File lib/rubygems.rb, line 715
def self.marshal_version
  "#{Marshal::MAJOR_VERSION}.#{Marshal::MINOR_VERSION}"
end

# File lib/rubygems.rb, line 208
def self.needs
  rs = Gem::RequestSet.new

  yield rs

  finish_resolve rs
end

# File lib/rubygems.rb, line 851
def self.open_file(path, flags, &block)
  File.open(path, flags, &block)
end

# File lib/rubygems.rb, line 869
def self.open_file_with_flock(path, &block)
  # read-write mode is used rather than read-only in order to support NFS
  mode = IO::RDWR | IO::APPEND | IO::CREAT | IO::BINARY
  mode |= IO::SHARE_DELETE if IO.const_defined?(:SHARE_DELETE)

  File.open(path, mode) do |io|
    begin
      # Try to get a lock without blocking.
      # If we do, the file is locked.
      # Otherwise, explain why we're waiting and get a lock, but block this time.
      if io.flock(File::LOCK_EX | File::LOCK_NB) != 0
        warn "Waiting for another process to let go of lock: #{path}"
        io.flock(File::LOCK_EX)
      end
      io.puts(Process.pid)
    rescue Errno::ENOSYS, Errno::ENOTSUP
    end
    yield io
  end
end

# File lib/rubygems.rb, line 858
def self.open_file_with_lock(path, &block)
  file_lock = "#{path}.lock"
  open_file_with_flock(file_lock, &block)
ensure
  require "fileutils"
  FileUtils.rm_f file_lock
end

# File lib/rubygems/defaults.rb, line 286
def self.operating_system_defaults
  {}
end

# File lib/rubygems.rb, line 428
def self.path
  paths.path
end

# File lib/rubygems/defaults.rb, line 168
def self.path_separator
  File::PATH_SEPARATOR
end

# File lib/rubygems.rb, line 384
def self.paths
  @paths ||= Gem::PathSupport.new(ENV)
end

# File lib/rubygems.rb, line 394
  def self.paths=(env)
    clear_paths
    target = {}
    env.each_pair do |k,v|
      case k
      when "GEM_HOME", "GEM_PATH", "GEM_SPEC_CACHE"
        case v
        when nil, String
          target[k] = v
        when Array
          unless Gem::Deprecate.skip
            warn <<-EOWARN
Array values in the parameter to `Gem.paths=` are deprecated.
Please use a String or nil.
An Array (#{env.inspect}) was passed in from #{caller[3]}
            EOWARN
          end
          target[k] = v.join File::PATH_SEPARATOR
        end
      else
        target[k] = v
      end
    end
    @paths = Gem::PathSupport.new ENV.to_hash.merge(target)
    Gem::Specification.dirs = @paths.path
  end

# File lib/rubygems/defaults.rb, line 305
def self.platform_defaults
  {}
end

# File lib/rubygems.rb, line 729
def self.platforms
  @platforms ||= []
  if @platforms.empty?
    @platforms = [Gem::Platform::RUBY, Gem::Platform.local]
  end
  @platforms
end

# File lib/rubygems.rb, line 722
def self.platforms=(platforms)
  @platforms = platforms
end

# File lib/rubygems.rb, line 1015
def self.plugin_suffix_pattern
  @plugin_suffix_pattern ||= "_plugin#{suffix_pattern}"
end

# File lib/rubygems.rb, line 1022
def self.plugin_suffix_regexp
  @plugin_suffix_regexp ||= /_plugin#{suffix_regexp}\z/
end

# File lib/rubygems.rb, line 342
def self.plugindir(install_dir = Gem.dir)
  File.join install_dir, "plugins"
end

# File lib/rubygems.rb, line 744
def self.post_build(&hook)
  @post_build_hooks << hook
end

# File lib/rubygems.rb, line 752
def self.post_install(&hook)
  @post_install_hooks << hook
end

# File lib/rubygems.rb, line 769
def self.post_reset(&hook)
  @post_reset_hooks << hook
end

# File lib/rubygems.rb, line 778
def self.post_uninstall(&hook)
  @post_uninstall_hooks << hook
end

# File lib/rubygems.rb, line 787
def self.pre_install(&hook)
  @pre_install_hooks << hook
end

# File lib/rubygems.rb, line 795
def self.pre_reset(&hook)
  @pre_reset_hooks << hook
end

# File lib/rubygems.rb, line 804
def self.pre_uninstall(&hook)
  @pre_uninstall_hooks << hook
end

# File lib/rubygems.rb, line 813
def self.prefix
  prefix = File.dirname RUBYGEMS_DIR

  if prefix != File.expand_path(RbConfig::CONFIG["sitelibdir"]) &&
     prefix != File.expand_path(RbConfig::CONFIG["libdir"]) &&
     File.basename(RUBYGEMS_DIR) == "lib"
    prefix
  end
end

# File lib/rubygems/rdoc.rb, line 13
def self.rdoc_hooks_defined_via_plugin?
  Gem::Version.new(::RDoc::VERSION) >= Gem::Version.new("6.9.0")
end

# File lib/rubygems.rb, line 833
def self.read_binary(path)
  File.binread(path)
end