PHP 8.2.31
Preview: source.rb Size: 4.90 KB
/proc/thread-self/root/opt/alt/ruby21/lib64/ruby/2.1.0/rubygems/source.rb

require 'uri'
require 'fileutils'

##
# A Source knows how to list and fetch gems from a RubyGems marshal index.
#
# There are other Source subclasses for installed gems, local gems, the
# bundler dependency API and so-forth.

class Gem::Source

  include Comparable

  FILES = { # :nodoc:
    :released   => 'specs',
    :latest     => 'latest_specs',
    :prerelease => 'prerelease_specs',
  }

  ##
  # The URI this source will fetch gems from.

  attr_reader :uri

  ##
  # Creates a new Source which will use the index located at +uri+.

  def initialize(uri)
    unless uri.kind_of? URI
      uri = URI.parse(uri.to_s)
    end

    @uri = uri
    @api_uri = nil
  end

  ##
  # Use an SRV record on the host to look up the true endpoint for the index.

  def api_uri # :nodoc:
    require 'rubygems/remote_fetcher'
    @api_uri ||= Gem::RemoteFetcher.fetcher.api_endpoint uri
  end

  ##
  # Sources are ordered by installation preference.

  def <=>(other)
    case other
    when Gem::Source::Installed,
         Gem::Source::Local,
         Gem::Source::Lock,
         Gem::Source::SpecificFile,
         Gem::Source::Git,
         Gem::Source::Vendor then
      -1
    when Gem::Source then
      if !@uri
        return 0 unless other.uri
        return 1
      end

      return -1 if !other.uri

      @uri.to_s <=> other.uri.to_s
    else
      nil
    end
  end

  def == other # :nodoc:
    self.class === other and @uri == other.uri
  end

  alias_method :eql?, :== # :nodoc:

  ##
  # Returns a Set that can fetch specifications from this source.

  def dependency_resolver_set # :nodoc:
    bundler_api_uri = api_uri + './api/v1/dependencies'

    begin
      fetcher = Gem::RemoteFetcher.fetcher
      fetcher.fetch_path bundler_api_uri, nil, true
    rescue Gem::RemoteFetcher::FetchError
      Gem::Resolver::IndexSet.new self
    else
      Gem::Resolver::APISet.new bundler_api_uri
    end
  end

  def hash # :nodoc:
    @uri.hash
  end

  ##
  # Returns the local directory to write +uri+ to.

  def cache_dir(uri)
    # Correct for windows paths
    escaped_path = uri.path.sub(/^\/([a-z]):\//i, '/\\1-/')
    File.join Gem.spec_cache_dir, "#{uri.host}%#{uri.port}", File.dirname(escaped_path)
  end

  ##
  # Returns true when it is possible and safe to update the cache directory.

  def update_cache?
    @update_cache ||=
      begin
        File.stat(Gem.user_home).uid == Process.uid
      rescue Errno::ENOENT
        false
      end
  end

  ##
  # Fetches a specification for the given +name_tuple+.

  def fetch_spec name_tuple
    fetcher = Gem::RemoteFetcher.fetcher

    spec_file_name = name_tuple.spec_name

    uri = api_uri + "#{Gem::MARSHAL_SPEC_DIR}#{spec_file_name}"

    cache_dir = cache_dir uri

    local_spec = File.join cache_dir, spec_file_name

    if File.exist? local_spec then
      spec = Gem.read_binary local_spec
      spec = Marshal.load(spec) rescue nil
      return spec if spec
    end

    uri.path << '.rz'

    spec = fetcher.fetch_path uri
    spec = Gem.inflate spec

    if update_cache? then
      FileUtils.mkdir_p cache_dir

      open local_spec, 'wb' do |io|
        io.write spec
      end
    end

    # TODO: Investigate setting Gem::Specification#loaded_from to a URI
    Marshal.load spec
  end

  ##
  # Loads +type+ kind of specs fetching from +@uri+ if the on-disk cache is
  # out of date.
  #
  # +type+ is one of the following:
  #
  # :released   => Return the list of all released specs
  # :latest     => Return the list of only the highest version of each gem
  # :prerelease => Return the list of all prerelease only specs
  #

  def load_specs(type)
    file       = FILES[type]
    fetcher    = Gem::RemoteFetcher.fetcher
    file_name  = "#{file}.#{Gem.marshal_version}"
    spec_path  = api_uri + "#{file_name}.gz"
    cache_dir  = cache_dir spec_path
    local_file = File.join(cache_dir, file_name)
    retried    = false

    FileUtils.mkdir_p cache_dir if update_cache?

    spec_dump = fetcher.cache_update_path spec_path, local_file, update_cache?

    begin
      Gem::NameTuple.from_list Marshal.load(spec_dump)
    rescue ArgumentError
      if update_cache? && !retried
        FileUtils.rm local_file
        retried = true
        retry
      else
        raise Gem::Exception.new("Invalid spec cache file in #{local_file}")
      end
    end
  end

  ##
  # Downloads +spec+ and writes it to +dir+.  See also
  # Gem::RemoteFetcher#download.

  def download(spec, dir=Dir.pwd)
    fetcher = Gem::RemoteFetcher.fetcher
    fetcher.download spec, api_uri.to_s, dir
  end

  def pretty_print q # :nodoc:
    q.group 2, '[Remote:', ']' do
      q.breakable
      q.text @uri.to_s

      if api = api_uri
        q.breakable
        q.text 'API URI: '
        q.text api.to_s
      end
    end
  end

end

require 'rubygems/source/git'
require 'rubygems/source/installed'
require 'rubygems/source/specific_file'
require 'rubygems/source/local'
require 'rubygems/source/lock'
require 'rubygems/source/vendor'

Directory Contents

Dirs: 10 × Files: 59

Name Size Perms Modified Actions
commands DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
core_ext DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
ext DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
package DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
resolver DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
security DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
source DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
ssl_certs DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
util DIR
- drwxr-xr-x 2024-03-03 22:43:11
Edit Download
3.00 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
5.65 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
13.43 KB lrw-r--r-- 2012-11-30 16:27:52
Edit Download
4.62 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
1.67 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
12.23 KB lrw-r--r-- 2023-07-26 14:19:40
Edit Download
3.64 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
7.77 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
12.64 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
5.53 KB lrw-r--r-- 2013-02-27 23:20:57
Edit Download
1.70 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
3.04 KB lrw-r--r-- 2013-11-21 23:27:30
Edit Download
2.42 KB lrw-r--r-- 2013-11-19 00:34:13
Edit Download
5.87 KB lrw-r--r-- 2013-11-21 23:27:30
Edit Download
431 B lrw-r--r-- 2013-10-16 06:00:39
Edit Download
3.97 KB lrw-r--r-- 2013-09-18 21:29:41
Edit Download
1.96 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
13.03 KB lrw-r--r-- 2013-10-16 00:14:16
Edit Download
21.42 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
4.20 KB lrw-r--r-- 2023-07-26 14:19:40
Edit Download
307 B lrw-r--r-- 2013-07-09 23:21:36
Edit Download
281 B lrw-r--r-- 2012-11-29 06:52:18
Edit Download
5.21 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
3.36 KB lrw-r--r-- 2011-07-27 01:40:07
Edit Download
1.35 KB lrw-r--r-- 2012-11-29 06:52:18
Edit Download
2.23 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
14.25 KB lrw-r--r-- 2023-07-26 14:19:40
Edit Download
3.77 KB lrw-r--r-- 2013-08-26 20:24:51
Edit Download
1.82 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download
6.05 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
269 B lrw-r--r-- 2013-10-20 01:33:19
Edit Download
763 B lrw-r--r-- 2013-07-09 22:34:58
Edit Download
7.75 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
9.46 KB lrw-r--r-- 2015-08-18 12:56:58
Edit Download
7.53 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
6.94 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
6.10 KB lrw-r--r-- 2013-12-08 01:22:39
Edit Download
12.46 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
1.11 KB lrw-r--r-- 2023-07-26 14:19:40
Edit Download
20.96 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
21.69 KB lrw-r--r-- 2013-11-10 17:51:40
Edit Download
4.90 KB lrw-r--r-- 2013-12-08 01:22:39
Edit Download
2.47 KB lrw-r--r-- 2013-11-19 00:34:13
Edit Download
111 B lrw-r--r-- 2013-09-14 08:59:02
Edit Download
93 B lrw-r--r-- 2013-09-14 08:59:02
Edit Download
70.80 KB lrw-r--r-- 2023-07-26 14:19:40
Edit Download
6.40 KB lrw-r--r-- 2013-11-19 00:34:13
Edit Download
3.10 KB lrw-r--r-- 2013-10-18 21:56:18
Edit Download
2.09 KB lrw-r--r-- 2013-12-19 22:09:19
Edit Download
35.62 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
8.37 KB lrw-r--r-- 2013-12-08 01:22:39
Edit Download
1.23 KB lrw-r--r-- 2011-07-27 01:40:07
Edit Download
8.69 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
762 B lrw-r--r-- 2013-10-20 01:33:19
Edit Download
14.40 KB lrw-r--r-- 2013-12-13 00:51:04
Edit Download
2.26 KB lrw-r--r-- 2013-11-25 19:14:49
Edit Download
4.18 KB lrw-r--r-- 2013-11-30 23:27:52
Edit Download
10.78 KB lrw-r--r-- 2014-02-06 02:59:36
Edit Download
1.83 KB lrw-r--r-- 2013-09-14 08:59:02
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).