Module: Gem

# File 'lib/rubygems.rb', line 356

def self.configuration=(config)
  @configuration = config
end

# File 'lib/rubygems/defaults.rb', line 153

def self.default_gems_use_full_paths?
  ruby_engine != 'ruby'
end

# File 'lib/rubygems.rb', line 1312

attr_reader :done_installing_hooks

# File 'lib/rubygems.rb', line 1237

attr_reader :gemdeps

# File 'lib/rubygems.rb', line 643

def self.host
  # TODO: move to utils
  @host ||= Gem::DEFAULT_HOST
end

# File 'lib/rubygems.rb', line 650

def self.host=(host)
  # TODO: move to utils
  @host = host
end

# File 'lib/rubygems.rb', line 1231

attr_reader :loaded_specs

# File 'lib/rubygems.rb', line 381

def self.paths
  @paths ||= Gem::PathSupport.new(ENV)
end

# File 'lib/rubygems.rb', line 391

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.rb', line 750

def self.platforms
  @platforms ||= []
  if @platforms.empty?
    @platforms = [Gem::Platform::RUBY, Gem::Platform.local]
  end
  @platforms
end

# File 'lib/rubygems.rb', line 743

def self.platforms=(platforms)
  @platforms = platforms
end

# File 'lib/rubygems.rb', line 1300

attr_reader :post_build_hooks

# File 'lib/rubygems.rb', line 1306

attr_reader :post_install_hooks

# File 'lib/rubygems.rb', line 1317

attr_reader :post_reset_hooks

# File 'lib/rubygems.rb', line 1323

attr_reader :post_uninstall_hooks

# File 'lib/rubygems.rb', line 1328

attr_reader :pre_install_hooks

# File 'lib/rubygems.rb', line 1333

attr_reader :pre_reset_hooks

# File 'lib/rubygems.rb', line 1339

attr_reader :pre_uninstall_hooks

# File 'lib/rubygems.rb', line 896

def self.ruby
  if @ruby.nil?
    @ruby = File.join(RbConfig::CONFIG['bindir'],
                      "#{RbConfig::CONFIG['ruby_install_name']}#{RbConfig::CONFIG['EXEEXT']}")

    @ruby = "\"#{@ruby}\"" if @ruby =~ /\s/
  end

  @ruby
end

# File 'lib/rubygems/test_case.rb', line 87

def self.ruby=(ruby)
  @ruby = ruby
end

# File 'lib/rubygems/test_case.rb', line 71

def self.searcher=(searcher)
  @searcher = searcher
end

# File 'lib/rubygems.rb', line 985

def self.sources
  source_list = configuration.sources || default_sources
  @sources ||= Gem::SourceList.from(source_list)
end

# File 'lib/rubygems.rb', line 997

def self.sources=(new_sources)
  if !new_sources
    @sources = nil
  else
    @sources = Gem::SourceList.from(new_sources)
  end
end

# File 'lib/rubygems/test_case.rb', line 79

def self.win_platform=(val)
  @@win_platform = val
end

# File 'lib/rubygems.rb', line 1073

def self.win_platform?
  if @@win_platform.nil?
    ruby_platform = RbConfig::CONFIG['host_os']
    @@win_platform = !!WIN_PATTERNS.find { |r| ruby_platform =~ r }
  end

  @@win_platform
end

# File 'lib/rubygems.rb', line 253

def self.bin_path(name, exec_name = nil, *requirements)
  # TODO: fails test_self_bin_path_bin_file_gone_in_latest
  # Gem::Specification.find_by_name(name, *requirements).bin_file exec_name

  raise ArgumentError, "you must supply exec_name" unless exec_name

  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 313

def self.binary_mode
  'rb'
end

# File 'lib/rubygems.rb', line 320

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.rb', line 1292

def clear_default_specs
  @path_to_default_spec_map.clear
end

# File 'lib/rubygems.rb', line 331

def self.clear_paths
  @paths         = nil
  @user_home     = nil
  Gem::Specification.reset
  Gem::Security.reset if defined?(Gem::Security)
end

# File 'lib/rubygems.rb', line 341

def self.config_file
  @config_file ||= File.join Gem.user_home, '.gemrc'
end

# File 'lib/rubygems.rb', line 364

def self.datadir(gem_name)
  spec = @loaded_specs[gem_name]
  return nil if spec.nil?
  spec.datadir
end

# File 'lib/rubygems/defaults.rb', line 117

def self.default_bindir
  if defined? RUBY_FRAMEWORK_VERSION  # mac framework support
    '/usr/bin'
  else # generic install
    RbConfig::CONFIG['bindir']
  end
end

# File 'lib/rubygems/defaults.rb', line 146

def self.default_cert_path
  File.join Gem.user_home, ".gem", "gem-public_cert.pem"
end

# File 'lib/rubygems/defaults.rb', line 30

def self.default_dir
  path = if defined? RUBY_FRAMEWORK_VERSION
           [
             File.dirname(RbConfig::CONFIG['sitedir']),
             'Gems',
             RbConfig::CONFIG['ruby_version']
           ]
         elsif RbConfig::CONFIG['rubylibprefix']
           [
             RbConfig::CONFIG['rubylibprefix'],
             'gems',
             RbConfig::CONFIG['ruby_version']
           ]
         else
           [
             RbConfig::CONFIG['libdir'],
             ruby_engine,
             'gems',
             RbConfig::CONFIG['ruby_version']
           ]
         end

  @default_dir ||= File.join(*path)
end

# File 'lib/rubygems/defaults.rb', line 103

def self.default_exec_format
  exec_format = RbConfig::CONFIG['ruby_install_name'].sub('ruby', '%s') rescue '%s'

  unless exec_format =~ /%s/
    raise Gem::Exception,
      "[BUG] invalid exec_format #{exec_format.inspect}, no %s"
  end

  exec_format
end

# File 'lib/rubygems/defaults.rb', line 62

def self.default_ext_dir_for(base_dir)
  nil
end

# File 'lib/rubygems/defaults.rb', line 139

def self.default_key_path
  File.join Gem.user_home, ".gem", "gem-private_key.pem"
end

# File 'lib/rubygems/defaults.rb', line 92

def self.default_path
  path = []
  path << user_dir if user_home && File.exist?(user_home)
  path << default_dir
  path << vendor_dir if vendor_dir and File.directory? vendor_dir
  path
end

# File 'lib/rubygems/defaults.rb', line 69

def self.default_rubygems_dirs
  nil # default to standard layout
end

# File 'lib/rubygems/defaults.rb', line 14

def self.default_sources
  %w[https://rubygems.org/]
end

# File 'lib/rubygems/defaults.rb', line 22

def self.default_spec_cache_dir
  File.join Gem.user_home, '.gem', 'specs'
end

# File 'lib/rubygems.rb', line 373

def self.deflate(data)
  require 'zlib'
  Zlib::Deflate.deflate data
end

# File 'lib/rubygems.rb', line 1217

alias detect_gemdeps use_gemdeps # :nodoc:

# File 'lib/rubygems.rb', line 423

def self.dir
  paths.home
end

# File 'lib/rubygems.rb', line 782

def self.done_installing(&hook)
  @done_installing_hooks << hook
end

# File 'lib/rubygems.rb', line 457

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 444

def self.ensure_gem_subdirectories(dir = Gem.dir, mode = nil)
  ensure_subdirectories(dir, mode, REPOSITORY_SUBDIRECTORIES)
end

# File 'lib/rubygems.rb', line 461

def self.ensure_subdirectories(dir, mode, subdirs) # :nodoc:
  old_umask = File.umask
  File.umask old_umask | 002

  require 'fileutils'

  options = {}

  options[:mode] = mode if mode

  subdirs.each do |name|
    subdir = File.join dir, name
    next if File.exist? subdir
    FileUtils.mkdir_p subdir, options rescue nil
  end
ensure
  File.umask old_umask
end

# File 'lib/rubygems.rb', line 914

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'.freeze
    Gem::Requirement.create(req)
  end
end

# File 'lib/rubygems.rb', line 484

def self.extension_api_version # :nodoc:
  if 'no' == RbConfig::CONFIG['ENABLE_SHARED']
    "#{ruby_api_version}-static"
  else
    ruby_api_version
  end
end

# File 'lib/rubygems.rb', line 504

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.map { |spec|
    spec.matches_for_glob("#{glob}#{Gem.suffix_pattern}")
  }.flatten

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

  return files
end

# File 'lib/rubygems.rb', line 522

def self.find_files_from_load_path(glob) # :nodoc:
  glob_with_suffixes = "#{glob}#{Gem.suffix_pattern}"
  $LOAD_PATH.map { |load_path|
    Gem::Util.glob_files_in_dir(glob_with_suffixes, load_path)
  }.flatten.select { |file| File.file? file.untaint }
end

# File 'lib/rubygems.rb', line 574

def self.find_home
  Dir.home.dup
rescue
  if Gem.win_platform?
    File.expand_path File.join(ENV['HOMEDRIVE'] || ENV['SystemDrive'], '/')
  else
    File.expand_path "/"
  end
end

# File 'lib/rubygems.rb', line 541

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).map { |spec|
    spec.matches_for_glob("#{glob}#{Gem.suffix_pattern}")
  }.flatten

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

  return files
end

# File 'lib/rubygems.rb', line 265

def self.find_spec_for_exe(name, exec_name, requirements)
  dep = Gem::Dependency.new name, requirements

  loaded = Gem.loaded_specs[name]

  return loaded if loaded && dep.matches_spec?(loaded)

  specs = dep.matching_specs(true)

  specs = specs.find_all { |spec|
    spec.executables.include? exec_name
  } if exec_name

  unless spec = specs.first
    msg = "can't find gem #{dep} with executable #{exec_name}"
    if name == "bundler" && bundler_message = Gem::BundlerVersionFinder.missing_version_message
      msg = bundler_message
    end
    raise Gem::GemNotFoundException, msg
  end

  spec
end

# File 'lib/rubygems.rb', line 1275

def find_unresolved_default_spec(path)
  @path_to_default_spec_map[path]
end

# File 'lib/rubygems.rb', line 238

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 591

def self.gunzip(data)
  Gem::Util.gunzip data
end

# File 'lib/rubygems.rb', line 603

def self.gzip(data)
  Gem::Util.gzip data
end

# File 'lib/rubygems.rb', line 615

def self.inflate(data)
  Gem::Util.inflate data
end

# File 'lib/rubygems.rb', line 632

def self.install(name, version = Gem::Requirement.default, *options)
  require "rubygems/dependency_installer"
  inst = Gem::DependencyInstaller.new(*options)
  inst.install name, version
  inst.installed_gems
end

# File 'lib/rubygems/defaults.rb', line 160

def self.install_extension_in_lib # :nodoc:
  true
end

# File 'lib/rubygems.rb', line 939

def self.latest_rubygems_version
  latest_version_for('rubygems-update') or
    raise "Can't find 'rubygems-update' in any repo. Check `gem source list`."
end

# File 'lib/rubygems.rb', line 926

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.first

  spec
end

# File 'lib/rubygems.rb', line 947

def self.latest_version_for(name)
  spec = latest_spec_for name
  spec and spec.version
end

# File 'lib/rubygems.rb', line 1118

def self.load_env_plugins
  path = "rubygems_plugin"

  files = []
  glob = "#{path}#{Gem.suffix_pattern}"
  $LOAD_PATH.each do |load_path|
    globbed = Gem::Util.glob_files_in_dir(glob, load_path)

    globbed.each do |load_path_file|
      files << load_path_file if File.file?(load_path_file.untaint)
    end
  end

  load_plugin_files files
end

# File 'lib/rubygems.rb', line 659

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
end

# File 'lib/rubygems.rb', line 1085

def self.load_plugin_files(plugins) # :nodoc:
  plugins.each do |plugin|

    # Skip older versions of the GemCutter plugin: Its commands are in
    # RubyGems proper now.

    next if plugin =~ /gemcutter-0\.[0-3]/

    begin
      load plugin
    rescue ::Exception => e
      details = "#{plugin.inspect}: #{e.message} (#{e.class})"
      warn "Error loading RubyGems plugin #{details}"
    end
  end
end

# File 'lib/rubygems.rb', line 1106

def self.load_plugins
  # Remove this env var by at least 3.0
  if ENV['RUBYGEMS_LOAD_ALL_PLUGINS']
    load_plugin_files find_files('rubygems_plugin', false)
  else
    load_plugin_files find_latest_files('rubygems_plugin', false)
  end
end

# File 'lib/rubygems.rb', line 674

def self.load_yaml
  return if @yaml_loaded
  return unless defined?(gem)

  begin
    gem 'psych', '>= 2.0.0'
  rescue Gem::LoadError
    # It's OK if the user does not have the psych gem installed.  We will
    # attempt to require the stdlib version
  end

  begin
    # Try requiring the gem version *or* stdlib version of psych.
    require 'psych'
  rescue ::LoadError
    # If we can't load psych, thats fine, go on.
  else
    # If 'yaml' has already been required, then we have to
    # be sure to switch it over to the newly loaded psych.
    if defined?(YAML::ENGINE) && YAML::ENGINE.yamler != "psych"
      YAML::ENGINE.yamler = "psych"
    end

    require 'rubygems/psych_additions'
    require 'rubygems/psych_tree'
  end

  require 'yaml'
  require 'rubygems/safe_yaml'

  # Now that we're sure some kind of yaml library is loaded, pull
  # in our hack to deal with Syck's DefaultKey ugliness.
  require 'rubygems/syck_hack'

  @yaml_loaded = true
end

# File 'lib/rubygems.rb', line 725

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 736

def self.marshal_version
  "#{Marshal::MAJOR_VERSION}.#{Marshal::MINOR_VERSION}"
end

# File 'lib/rubygems.rb', line 230

def self.needs
  rs = Gem::RequestSet.new

  yield rs

  finish_resolve rs
end

# File 'lib/rubygems/defaults.rb', line 193

def self.operating_system_defaults
  {}
end

# File 'lib/rubygems.rb', line 427

def self.path
  paths.path
end

# File 'lib/rubygems/defaults.rb', line 85

def self.path_separator
  File::PATH_SEPARATOR
end

# File 'lib/rubygems/defaults.rb', line 212

def self.platform_defaults
  {}
end

# File 'lib/rubygems.rb', line 765

def self.post_build(&hook)
  @post_build_hooks << hook
end

# File 'lib/rubygems.rb', line 773

def self.post_install(&hook)
  @post_install_hooks << hook
end

# File 'lib/rubygems.rb', line 790

def self.post_reset(&hook)
  @post_reset_hooks << hook
end

# File 'lib/rubygems.rb', line 799

def self.post_uninstall(&hook)
  @post_uninstall_hooks << hook
end

# File 'lib/rubygems.rb', line 808

def self.pre_install(&hook)
  @pre_install_hooks << hook
end

# File 'lib/rubygems.rb', line 816

def self.pre_reset(&hook)
  @pre_reset_hooks << hook
end

# File 'lib/rubygems.rb', line 825

def self.pre_uninstall(&hook)
  @pre_uninstall_hooks << hook
end

# File 'lib/rubygems.rb', line 834

def self.prefix
  prefix = File.dirname RUBYGEMS_DIR

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

# File 'lib/rubygems.rb', line 854

def self.read_binary(path)
  File.open path, 'rb+' do |f|
    f.flock(File::LOCK_EX)
    f.read
  end
rescue *READ_BINARY_ERRORS
  File.open path, 'rb' do |f|
    f.read
  end
rescue Errno::ENOLCK # NFS
  if Thread.main != Thread.current
    raise
  else
    File.open path, 'rb' do |f|
      f.read
    end
  end
end

# File 'lib/rubygems.rb', line 847

def self.refresh
  Gem::Specification.reset
end

# File 'lib/rubygems.rb', line 1251

def register_default_spec(spec)
  new_format = Gem.default_gems_use_full_paths? || spec.require_paths.any? {|path| spec.files.any? {|f| f.start_with? path } }

  if new_format
    prefix_group = spec.require_paths.map {|f| f + "/"}.join("|")
    prefix_pattern = /^(#{prefix_group})/
  end

  suffix_pattern = /#{Regexp.union(Gem.suffixes)}\z/

  spec.files.each do |file|
    if new_format
      file = file.sub(prefix_pattern, "")
      next unless $~
    end

    @path_to_default_spec_map[file] = spec
    @path_to_default_spec_map[file.sub(suffix_pattern, "")] = spec
  end
end

# File 'lib/rubygems.rb', line 1283

def remove_unresolved_default_spec(spec)
  spec.files.each do |file|
    @path_to_default_spec_map.delete(file)
  end
end

# File 'lib/rubygems.rb', line 910

def self.ruby_api_version
  @ruby_api_version ||= RbConfig::CONFIG['ruby_version'].dup
end

# File 'lib/rubygems/defaults.rb', line 128

def self.ruby_engine
  if defined? RUBY_ENGINE
    RUBY_ENGINE
  else
    'ruby'
  end
end

# File 'lib/rubygems.rb', line 955

def self.ruby_version
  return @ruby_version if defined? @ruby_version
  version = RUBY_VERSION.dup

  if defined?(RUBY_PATCHLEVEL) && RUBY_PATCHLEVEL != -1
    version << ".#{RUBY_PATCHLEVEL}"
  elsif defined?(RUBY_DESCRIPTION)
    if RUBY_ENGINE == "ruby"
      desc = RUBY_DESCRIPTION[/\Aruby #{Regexp.quote(RUBY_VERSION)}([^ ]+) /, 1]
    else
      desc = RUBY_DESCRIPTION[/\A#{RUBY_ENGINE} #{Regexp.quote(RUBY_ENGINE_VERSION)} \(#{RUBY_VERSION}([^ ]+)\) /, 1]
    end
    version << ".#{desc}" if desc
  end

  @ruby_version = Gem::Version.new version
end

# File 'lib/rubygems.rb', line 976

def self.rubygems_version
  return @rubygems_version if defined? @rubygems_version
  @rubygems_version = Gem::Version.new Gem::VERSION
end

# File 'lib/rubygems.rb', line 431

def self.spec_cache_dir
  paths.spec_cache_dir
end

# File 'lib/rubygems.rb', line 1008

def self.suffix_pattern
  @suffix_pattern ||= "{#{suffixes.join(',')}}"
end

# File 'lib/rubygems.rb', line 1015

def self.suffixes
  @suffixes ||= ['',
                 '.rb',
                 *%w(DLEXT DLEXT2).map { |key|
                   val = RbConfig::CONFIG[key]
                   next unless val and not val.empty?
                   ".#{val}"
                 }
                ].compact.uniq
end

# File 'lib/rubygems.rb', line 1030

def self.time(msg, width = 0, display = Gem.configuration.verbose)
  now = Time.now

  value = yield

  elapsed = Time.now - now

  ui.say "%2$*1$s: %3$3.3fs" % [-width, msg, elapsed] if display

  value
end

# File 'lib/rubygems.rb', line 205

def self.try_activate(path)
  # finds the _latest_ version... regardless of loaded specs and their deps
  # if another gem had a requirement that would mean we shouldn't
  # activate the latest version, then either it would already be activated
  # or if it was ambiguous (and thus unresolved) the code in our custom
  # require will try to activate the more specific version.

  spec = Gem::Specification.find_by_path path
  return false unless spec
  return true if spec.activated?

  begin
    spec.activate
  rescue Gem::LoadError => e # this could fail due to gem dep collisions, go lax
    spec_by_name = Gem::Specification.find_by_name(spec.name)
    if spec_by_name.nil?
      raise e
    else
      spec_by_name.activate
    end
  end

  return true
end

# File 'lib/rubygems.rb', line 1045

def self.ui
  require 'rubygems/user_interaction'

  Gem::DefaultUserInteraction.ui
end

# File 'lib/rubygems.rb', line 1154

def self.use_gemdeps(path = nil)
  raise_exception = path

  path ||= ENV['RUBYGEMS_GEMDEPS']
  return unless path

  path = path.dup

  if path == "-"
    Gem::Util.traverse_parents Dir.pwd do |directory|
      dep_file = GEM_DEP_FILES.find { |f| File.file?(f) }

      next unless dep_file

      path = File.join directory, dep_file
      break
    end
  end

  path.untaint

  unless File.file? path
    return unless raise_exception

    raise ArgumentError, "Unable to find gem dependencies file at #{path}"
  end

  if USE_BUNDLER_FOR_GEMDEPS

    ENV["BUNDLE_GEMFILE"] ||= File.expand_path(path)
    require 'rubygems/user_interaction'
    Gem::DefaultUserInteraction.use_ui(ui) do
      require "bundler"
      @gemdeps = Bundler.setup
      Bundler.ui = nil
      @gemdeps.requested_specs.map(&:to_spec).sort_by(&:name)
    end

  else

    rs = Gem::RequestSet.new
    @gemdeps = rs.load_gemdeps path

    rs.resolve_current.map do |s|
      s.full_spec.tap(&:activate)
    end

  end
rescue => e
  case e
  when Gem::LoadError, Gem::UnsatisfiableDependencyError, (defined?(Bundler::GemNotFound) ? Bundler::GemNotFound : Gem::LoadError)
    warn e.message
    warn "You may need to `gem install -g` to install missing gems"
    warn ""
  else
    raise
  end
end

# File 'lib/rubygems.rb', line 1055

def self.use_paths(home, *paths)
  paths.flatten!
  paths.compact!
  hash = { "GEM_HOME" => home, "GEM_PATH" => paths.empty? ? home : paths.join(File::PATH_SEPARATOR) }
  hash.delete_if { |_, v| v.nil? }
  self.paths = hash
end

# File 'lib/rubygems/defaults.rb', line 76

def self.user_dir
  parts = [Gem.user_home, '.gem', ruby_engine]
  parts << RbConfig::CONFIG['ruby_version'] unless RbConfig::CONFIG['ruby_version'].empty?
  File.join parts
end

# File 'lib/rubygems.rb', line 1066

def self.user_home
  @user_home ||= find_home.untaint
end

# File 'lib/rubygems/defaults.rb', line 167

def self.vendor_dir # :nodoc:
  if vendor_dir = ENV['GEM_VENDOR']
    return vendor_dir.dup
  end

  return nil unless RbConfig::CONFIG.key? 'vendordir'

  File.join RbConfig::CONFIG['vendordir'], 'gems',
            RbConfig::CONFIG['ruby_version']
end

# File 'lib/rubygems.rb', line 875

def self.write_binary(path, data)
  open(path, 'wb') do |io|
    begin
      io.flock(File::LOCK_EX)
    rescue *WRITE_BINARY_ERRORS
    end
    io.write data
  end
rescue Errno::ENOLCK # NFS
  if Thread.main != Thread.current
    raise
  else
    open(path, 'wb') do |io|
      io.write data
    end
  end
end