Gem

 
               # File rubygems.rb, line 265
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?

  specs = Gem::Dependency.new(name, requirements).matching_specs(true)

  raise Gem::GemNotFoundException,
        "can't find gem #{name} (#{requirements})" if specs.empty?

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

  unless spec = specs.last
    msg = "can't find gem #{name} (#{requirements}) with executable #{exec_name}"
    raise Gem::GemNotFoundException, msg
  end

  spec.bin_file exec_name
end
            

 
               # File rubygems.rb, line 294
def self.binary_mode
  'rb'
end
            

 
               # File rubygems.rb, line 301
def self.bindir(install_dir=Gem.dir)
  # TODO: move to Gem::Dirs
  return File.join install_dir, 'bin' unless
    install_dir.to_s == Gem.default_dir.to_s
  Gem.default_bindir
end
            

 
               # File rubygems.rb, line 1093
def clear_default_specs
  @path_to_default_spec_map.clear
end
            

 
               # File rubygems.rb, line 313
def self.clear_paths
  @paths         = nil
  @user_home     = nil
  Gem::Specification.reset
  Gem::Security.reset if const_defined? :Security
end
            

 
               # File rubygems.rb, line 323
def self.config_file
  @config_file ||= File.join Gem.user_home, '.gemrc'
end
            

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

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

 
               # File rubygems.rb, line 346
  def self.datadir(gem_name)
# TODO: deprecate and move to Gem::Specification
#       and drop the extra ", gem_name" which is uselessly redundant
    spec = @loaded_specs[gem_name]
    return nil if spec.nil?
    File.join spec.full_gem_path, "data", gem_name
  end
            

 
               # File rubygems/defaults.rb, line 105
def self.default_bindir
  if defined? RUBY_FRAMEWORK_VERSION then # mac framework support
    '/usr/bin'
  else # generic install
    ConfigMap[:bindir]
  end
end
            

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

 
               # File rubygems/defaults.rb, line 29
def self.default_dir
  path = if defined? RUBY_FRAMEWORK_VERSION then
           [
             File.dirname(ConfigMap[:sitedir]),
             'Gems',
             ConfigMap[:ruby_version]
           ]
         elsif ConfigMap[:rubylibprefix] then
           [
            ConfigMap[:rubylibprefix],
            'gems',
            ConfigMap[:ruby_version]
           ]
         else
           [
             ConfigMap[:libdir],
             ruby_engine,
             'gems',
             ConfigMap[:ruby_version]
           ]
         end

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

 
               # File rubygems/defaults.rb, line 91
def self.default_exec_format
  exec_format = ConfigMap[:ruby_install_name].sub('ruby', '%s') rescue '%s'

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

  exec_format
end
            

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

 
               # File rubygems/defaults.rb, line 80
def self.default_path
  if Gem.user_home && File.exist?(Gem.user_home) then
    [user_dir, default_dir]
  else
    [default_dir]
  end
end
            

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

 
               # File rubygems/defaults.rb, line 13
def self.default_sources
  %w[https://rubygems.org/]
end
            

 
               # File rubygems/defaults.rb, line 21
def self.default_spec_cache_dir
  File.join Gem.user_home, '.gem', 'specs'
end
            

 
               # File rubygems.rb, line 357
def self.deflate(data)
  require 'zlib'
  Zlib::Deflate.deflate data
end
            

 
               # File rubygems.rb, line 215
def self.detect_gemdeps
  if path = ENV['RUBYGEMS_GEMDEPS']
    path = path.dup.untaint

    if path == "-"
      here = Dir.pwd.untaint
      start = here

      begin
        while true
          path = GEM_DEP_FILES.find { |f| File.file?(f) }

          if path
            path = File.join here, path
            break
          end

          Dir.chdir ".."

          # If we're at a toplevel, stop.
          return if Dir.pwd == here

          here = Dir.pwd
        end
      ensure
        Dir.chdir start
      end
    end

    path.untaint

    return unless File.file? path

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

    rs.resolve_current.map do |s|
      sp = s.full_spec
      sp.activate
      sp
    end
  end
end
            

 
               # File rubygems.rb, line 379
def self.dir
  # TODO: raise "no"
  paths.home
end
            

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

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

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

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

  files = find_files_from_load_path glob if check_load_path

  files.concat Gem::Specification.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 rubygems.rb, line 484
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 rubygems.rb, line 1072
def find_unresolved_default_spec(path)
  Gem.suffixes.each do |suffix|
    spec = @path_to_default_spec_map["#{path}#{suffix}"]
    return spec if spec
  end
  nil
end
            

 
               # File rubygems.rb, line 207
def self.finish_resolve(request_set=Gem::RequestSet.new)
  request_set.import Gem::Specification.unresolved_deps.values

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

 
               # File rubygems.rb, line 543
def self.gunzip(data)
  # TODO: move to utils
  require 'stringio'
  require 'zlib'
  data = StringIO.new data

  unzipped = Zlib::GzipReader.new(data).read
  unzipped.force_encoding Encoding::BINARY if Object.const_defined? :Encoding
  unzipped
end
            

 
               # File rubygems.rb, line 557
def self.gzip(data)
  # TODO: move to utils
  require 'stringio'
  require 'zlib'
  zipped = StringIO.new
  zipped.set_encoding Encoding::BINARY if Object.const_defined? :Encoding

  Zlib::GzipWriter.wrap zipped do |io| io.write data end

  zipped.string
end
            

 
               # File rubygems.rb, line 597
def self.host
  # TODO: move to utils
  @host ||= Gem::DEFAULT_HOST
end
            

 
               # File rubygems.rb, line 604
def self.host= host
  # TODO: move to utils
  @host = host
end
            

 
               # File rubygems.rb, line 572
def self.inflate(data)
  # TODO: move to utils
  require 'zlib'
  Zlib::Inflate.inflate data
end
            

 
               # File rubygems.rb, line 586
def self.install name, version = Gem::Requirement.default
  require "rubygems/dependency_installer"
  inst = Gem::DependencyInstaller.new
  inst.install name, version
  inst.installed_gems
end
            

 
               # File rubygems.rb, line 840
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 rubygems.rb, line 827
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 rubygems.rb, line 848
def self.latest_version_for name
  spec = latest_spec_for name
  spec and spec.version
end
            

 
               # File rubygems.rb, line 1012
def self.load_env_plugins
  path = "rubygems_plugin"

  files = []
  $LOAD_PATH.each do |load_path|
    globbed = Dir["#{File.expand_path path, load_path}#{Gem.suffix_pattern}"]

    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 rubygems.rb, line 616
def self.load_path_insert_index
  index = $LOAD_PATH.index ConfigMap[:sitelibdir]

  index
end
            

 
               # File rubygems.rb, line 1000
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 rubygems.rb, line 627
def self.load_yaml
  return if @yaml_loaded
  return unless defined?(gem)

  test_syck = ENV['TEST_SYCK']

  unless test_syck
    begin
      gem 'psych', '~> 1.2', '>= 1.2.1'
    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
  end

  require 'yaml'

  # If we're supposed to be using syck, then we may have to force
  # activate it via the YAML::ENGINE API.
  if test_syck and defined?(YAML::ENGINE)
    YAML::ENGINE.yamler = "syck" unless YAML::ENGINE.syck?
  end

  # 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 rubygems.rb, line 676
def self.location_of_caller
  caller[1] =~ /(.*?):(\d+).*?$/
  file = $1
  lineno = $2.to_i

  # TODO: it is ALWAYS joined! STUPID!
  [file, lineno]
end
            

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

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

  yield rs

  finish_resolve rs
end
            

 
               # File rubygems.rb, line 384
def self.path
  # TODO: raise "no"
  paths.path
end
            

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

 
               # File rubygems.rb, line 363
def self.paths
  @paths ||= Gem::PathSupport.new
end
            

 
               # File rubygems.rb, line 368
def self.paths=(env)
  clear_paths
  @paths = Gem::PathSupport.new env
  Gem::Specification.dirs = @paths.path # FIX: home is at end
end
            

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

 
               # File rubygems.rb, line 695
def self.platforms=(platforms)
  @platforms = platforms
end
            

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

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

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

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

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

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

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

 
               # File rubygems.rb, line 786
def self.prefix
  prefix = File.dirname RUBYGEMS_DIR

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

 
               # File rubygems.rb, line 806
def self.read_binary(path)
  File.open path, binary_mode do |f| f.read end
end
            

 
               # File rubygems.rb, line 799
def self.refresh
  Gem::Specification.reset
end
            

 
               # File rubygems.rb, line 1049
def register_default_spec(spec)
  new_format, prefix_pattern = nil

  spec.files.each do |file|
    if new_format == nil
      new_format = spec.require_paths.any? {|path| file.start_with? path}

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

    if new_format
      file = file.sub(prefix_pattern, "")
      next unless $~
    end

    @path_to_default_spec_map[file] = spec
  end
end
            

 
               # File rubygems.rb, line 1084
def remove_unresolved_default_spec(spec)
  spec.files.each do |file|
    @path_to_default_spec_map.delete(file)
  end
end
            

 
               # File rubygems.rb, line 813
def self.ruby
  if @ruby.nil? then
    @ruby = File.join(ConfigMap[:bindir],
                      "#{ConfigMap[:ruby_install_name]}#{ConfigMap[:EXEEXT]}")

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

  @ruby
end
            

 
               # File rubygems/test_case.rb, line 64
def self.ruby= ruby
  @ruby = ruby
end
            

 
               # File rubygems/defaults.rb, line 116
def self.ruby_engine
  if defined? RUBY_ENGINE then
    RUBY_ENGINE
  else
    'ruby'
  end
end
            

 
               # File rubygems.rb, line 856
def self.ruby_version
  return @ruby_version if defined? @ruby_version
  version = RUBY_VERSION.dup

  if defined?(RUBY_PATCHLEVEL) && RUBY_PATCHLEVEL != -1 then
    version << ".#{RUBY_PATCHLEVEL}"
  elsif defined?(RUBY_REVISION) then
    version << ".dev.#{RUBY_REVISION}"
  end

  @ruby_version = Gem::Version.new version
end
            

 
               # File rubygems.rb, line 872
def self.rubygems_version
  return @rubygems_version if defined? @rubygems_version
  @rubygems_version = Gem::Version.new Gem::VERSION
end
            

 
               # File rubygems/test_case.rb, line 48
def self.searcher=(searcher)
  @searcher = searcher
end
            

 
               # File rubygems.rb, line 881
def self.sources
  @sources ||= Gem::SourceList.from(default_sources)
end
            

 
               # File rubygems.rb, line 892
def self.sources= new_sources
  if !new_sources
    @sources = nil
  else
    @sources = Gem::SourceList.from(new_sources)
  end
end
            

 
               # File rubygems.rb, line 389
def self.spec_cache_dir
  paths.spec_cache_dir
end
            

 
               # File rubygems.rb, line 903
def self.suffix_pattern
  @suffix_pattern ||= "{#{suffixes.join(',')}}"
end
            

 
               # File rubygems.rb, line 910
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 rubygems.rb, line 925
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 rubygems.rb, line 175
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 alreaby be activated
  # or if it was ambigious (and thus unresolved) the code in our custom
  # require will try to activate the more specific version.

  spec = Gem::Specification.find_inactive_by_path path

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

  begin
    spec.activate
  rescue Gem::LoadError # this could fail due to gem dep collisions, go lax
    Gem::Specification.find_by_name(spec.name).activate
  end

  return true
end
            

 
               # File rubygems.rb, line 940
def self.ui
  require 'rubygems/user_interaction'

  Gem::DefaultUserInteraction.ui
end
            

 
               # File rubygems.rb, line 950
def self.use_paths(home, *paths)
  paths = nil if paths == [nil]
  paths = paths.first if Array === Array(paths).first
  self.paths = { "GEM_HOME" => home, "GEM_PATH" => paths }
  # TODO: self.paths = home, paths
end
            

 
               # File rubygems/defaults.rb, line 64
def self.user_dir
  parts = [Gem.user_home, '.gem', ruby_engine]
  parts << ConfigMap[:ruby_version] unless ConfigMap[:ruby_version].empty?
  File.join parts
end
            

 
               # File rubygems.rb, line 960
def self.user_home
  @user_home ||= find_home.untaint
end
            

 
               # File rubygems/test_case.rb, line 56
def self.win_platform=(val)
  @@win_platform = val
end
            

 
               # File rubygems.rb, line 967
def self.win_platform?
  if @@win_platform.nil? then
    ruby_platform = RbConfig::CONFIG['host_os']
    @@win_platform = !!WIN_PATTERNS.find { |r| ruby_platform =~ r }
  end

  @@win_platform
end