PHP 8.2.31
Preview: spec_fetcher.rb Size: 7.68 KB
//proc/thread-self/root/opt/alt/ruby34/share/rubygems/rubygems/spec_fetcher.rb

# frozen_string_literal: true

require_relative "remote_fetcher"
require_relative "user_interaction"
require_relative "errors"
require_relative "text"
require_relative "name_tuple"

##
# SpecFetcher handles metadata updates from remote gem repositories.

class Gem::SpecFetcher
  include Gem::UserInteraction
  include Gem::Text

  ##
  # Cache of latest specs

  attr_reader :latest_specs # :nodoc:

  ##
  # Sources for this SpecFetcher

  attr_reader :sources # :nodoc:

  ##
  # Cache of all released specs

  attr_reader :specs # :nodoc:

  ##
  # Cache of prerelease specs

  attr_reader :prerelease_specs # :nodoc:

  @fetcher = nil

  ##
  # Default fetcher instance.  Use this instead of ::new to reduce object
  # allocation.

  def self.fetcher
    @fetcher ||= new
  end

  def self.fetcher=(fetcher) # :nodoc:
    @fetcher = fetcher
  end

  ##
  # Creates a new SpecFetcher.  Ordinarily you want to use the default fetcher
  # from Gem::SpecFetcher::fetcher which uses the Gem.sources.
  #
  # If you need to retrieve specifications from a different +source+, you can
  # send it as an argument.

  def initialize(sources = nil)
    @sources = sources || Gem.sources

    @update_cache =
      begin
        File.stat(Gem.user_home).uid == Process.uid
      rescue Errno::EACCES, Errno::ENOENT
        false
      end

    @specs = {}
    @latest_specs = {}
    @prerelease_specs = {}

    @caches = {
      latest: @latest_specs,
      prerelease: @prerelease_specs,
      released: @specs,
    }

    @fetcher = Gem::RemoteFetcher.fetcher
  end

  ##
  #
  # Find and fetch gem name tuples that match +dependency+.
  #
  # If +matching_platform+ is false, gems for all platforms are returned.

  def search_for_dependency(dependency, matching_platform=true)
    found = {}

    rejected_specs = {}

    list, errors = available_specs(dependency.identity)

    list.each do |source, specs|
      if dependency.name.is_a?(String) && specs.respond_to?(:bsearch)
        start_index = (0...specs.length).bsearch {|i| specs[i].name >= dependency.name }
        end_index   = (0...specs.length).bsearch {|i| specs[i].name > dependency.name }
        specs = specs[start_index...end_index] if start_index && end_index
      end

      found[source] = specs.select do |tup|
        if dependency.match?(tup)
          if matching_platform && !Gem::Platform.match_gem?(tup.platform, tup.name)
            pm = (
              rejected_specs[dependency] ||= \
                Gem::PlatformMismatch.new(tup.name, tup.version))
            pm.add_platform tup.platform
            false
          else
            true
          end
        end
      end
    end

    errors += rejected_specs.values

    tuples = []

    found.each do |source, specs|
      specs.each do |s|
        tuples << [s, source]
      end
    end

    tuples = tuples.sort_by {|x| x[0].version }

    [tuples, errors]
  end

  ##
  # Return all gem name tuples who's names match +obj+

  def detect(type=:complete)
    tuples = []

    list, _ = available_specs(type)
    list.each do |source, specs|
      specs.each do |tup|
        if yield(tup)
          tuples << [tup, source]
        end
      end
    end

    tuples
  end

  ##
  # Find and fetch specs that match +dependency+.
  #
  # If +matching_platform+ is false, gems for all platforms are returned.

  def spec_for_dependency(dependency, matching_platform=true)
    tuples, errors = search_for_dependency(dependency, matching_platform)

    specs = []
    tuples.each do |tup, source|
      spec = source.fetch_spec(tup)
    rescue Gem::RemoteFetcher::FetchError => e
      errors << Gem::SourceFetchProblem.new(source, e)
    else
      specs << [spec, source]
    end

    [specs, errors]
  end

  ##
  # Suggests gems based on the supplied +gem_name+. Returns an array of
  # alternative gem names.

  def suggest_gems_from_name(gem_name, type = :latest, num_results = 5)
    gem_name = gem_name.downcase.tr("_-", "")

    # All results for 3-character-or-shorter (minus hyphens/underscores) gem
    # names get rejected, so we just return an empty array immediately instead.
    return [] if gem_name.length <= 3

    max   = gem_name.size / 2
    names = available_specs(type).first.values.flatten(1)

    min_length = gem_name.length - max
    max_length = gem_name.length + max

    gem_name_with_postfix = "#{gem_name}ruby"
    gem_name_with_prefix = "ruby#{gem_name}"

    matches = names.filter_map do |n|
      len = n.name.length
      # If the gem doesn't support the current platform, bail early.
      next unless n.match_platform?

      # If the length is min_length or shorter, we've done `max` deletions.
      # This would be rejected later, so we skip it for performance.
      next if len <= min_length

      # The candidate name, normalized the same as gem_name.
      normalized_name = n.name.downcase
      normalized_name.tr!("_-", "")

      # If the gem is "{NAME}-ruby" and "ruby-{NAME}", we want to return it.
      # But we already removed hyphens, so we check "{NAME}ruby" and "ruby{NAME}".
      next [n.name, 0] if normalized_name == gem_name_with_postfix
      next [n.name, 0] if normalized_name == gem_name_with_prefix

      # If the length is max_length or longer, we've done `max` insertions.
      # This would be rejected later, so we skip it for performance.
      next if len >= max_length

      # If we found an exact match (after stripping underscores and hyphens),
      # that's our most likely candidate.
      # Return it immediately, and skip the rest of the loop.
      return [n.name] if normalized_name == gem_name

      distance = levenshtein_distance gem_name, normalized_name

      # Skip current candidate, if the edit distance is greater than allowed.
      next if distance >= max

      # If all else fails, return the name and the calculated distance.
      [n.name, distance]
    end

    matches = if matches.empty? && type != :prerelease
      suggest_gems_from_name gem_name, :prerelease
    else
      matches.uniq.sort_by {|_name, dist| dist }
    end

    matches.map {|name, _dist| name }.uniq.first(num_results)
  end

  ##
  # Returns a list of gems available for each source in Gem::sources.
  #
  # +type+ can be one of 3 values:
  # :released   => Return the list of all released specs
  # :complete   => Return the list of all specs
  # :latest     => Return the list of only the highest version of each gem
  # :prerelease => Return the list of all prerelease only specs
  #

  def available_specs(type)
    errors = []
    list = {}

    @sources.each_source do |source|
      names = case type
              when :latest
                tuples_for source, :latest
              when :released
                tuples_for source, :released
              when :complete
                names =
                  tuples_for(source, :prerelease, true) +
                  tuples_for(source, :released)

                names.sort
              when :abs_latest
                names =
                  tuples_for(source, :prerelease, true) +
                  tuples_for(source, :latest)

                names.sort
              when :prerelease
                tuples_for(source, :prerelease)
              else
                raise Gem::Exception, "Unknown type - :#{type}"
      end
    rescue Gem::RemoteFetcher::FetchError => e
      errors << Gem::SourceFetchProblem.new(source, e)
    else
      list[source] = names
    end

    [list, errors]
  end

  ##
  # Retrieves NameTuples from +source+ of the given +type+ (:prerelease,
  # etc.).  If +gracefully_ignore+ is true, errors are ignored.

  def tuples_for(source, type, gracefully_ignore=false) # :nodoc:
    @caches[type][source.uri] ||=
      source.load_specs(type).sort_by(&:name)
  rescue Gem::RemoteFetcher::FetchError
    raise unless gracefully_ignore
    []
  end
end

Directory Contents

Dirs: 15 × Files: 71

Name Size Perms Modified Actions
commands DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
core_ext DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
defaults DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
ext DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
package DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
request DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
resolver DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
security DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
source DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
ssl_certs DIR
- drwxr-xr-x 2026-04-20 12:16:07
Edit Download
util DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
vendor DIR
- drwxr-xr-x 2026-04-20 12:16:04
Edit Download
3.00 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
8.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.96 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.71 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
15.80 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.64 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1022 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
16.31 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.38 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.45 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
9.91 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.55 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.04 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
4.53 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
7.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
498 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
11.29 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
394 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.14 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
27.74 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
771 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
349 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
323 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
6.56 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.59 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
2.38 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
125 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
18.83 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
3.79 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
1.77 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.41 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
855 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.50 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
660 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
9.38 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
8.70 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
11.29 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.13 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
9.43 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.96 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.92 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.04 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
21.69 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.06 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.78 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.42 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
69.03 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
15.59 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
5.21 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.68 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
4.96 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
1.24 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.06 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
10.92 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
411 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.85 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.38 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
784 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
13.10 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.46 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
3.63 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
81 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
233 B lrw-r--r-- 2026-04-20 12:16:24
Edit Download
79 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
87 B lrw-r--r-- 2026-04-20 12:16:24
Edit Download
228 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
73 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
13.35 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.17 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
2.42 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download

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