class Gem::SpecFetcher
SpecFetcher handles metadata updates from remote gem repositories.
Public Class Methods
# File lib/rubygems/spec_fetcher.rb, line 32 def self.fetcher @fetcher ||= new end
# File lib/rubygems/spec_fetcher.rb, line 40 def initialize @dir = File.join Gem.user_home, '.gem', 'specs' @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
Public Instance Methods
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
# File lib/rubygems/spec_fetcher.rb, line 191 def available_specs(type) errors = [] list = {} Gem.sources.each_source do |source| begin names = case type when :latest tuples_for source, :latest when :released tuples_for source, :released when :complete tuples_for(source, :prerelease, true) + tuples_for(source, :released) 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 end [list, errors] end
Return all gem name tuples who's names match obj
# File lib/rubygems/spec_fetcher.rb, line 117 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 gem name tuples that match
dependency
.
If matching_platform
is false, gems for all platforms are
returned.
# File lib/rubygems/spec_fetcher.rb, line 68 def search_for_dependency(dependency, matching_platform=true) found = {} rejected_specs = {} if dependency.prerelease? type = :complete elsif dependency.latest_version? type = :latest else type = :released end list, errors = available_specs(type) list.each do |source, specs| found[source] = specs.select do |tup| if dependency.match?(tup) if matching_platform and !Gem::Platform.match(tup.platform) 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] } return [tuples, errors] end
Find and fetch specs that match
dependency
.
If matching_platform
is false, gems for all platforms are
returned.
# File lib/rubygems/spec_fetcher.rb, line 138 def spec_for_dependency(dependency, matching_platform=true) tuples, errors = search_for_dependency(dependency, matching_platform) specs = [] tuples.each do |tup, source| begin spec = source.fetch_spec(tup) rescue Gem::RemoteFetcher::FetchError => e errors << Gem::SourceFetchProblem.new(source, e) else specs << [spec, source] end end return [specs, errors] end
Suggests gems based on the supplied gem_name
. Returns an array
of alternative gem names.
# File lib/rubygems/spec_fetcher.rb, line 159 def suggest_gems_from_name gem_name gem_name = gem_name.downcase.tr('_-', '') max = gem_name.size / 2 names = available_specs(:complete).first.values.flatten(1) matches = names.map { |n| next unless n.match_platform? distance = levenshtein_distance gem_name, n.name.downcase.tr('_-', '') next if distance >= max return [n.name] if distance == 0 [n.name, distance] }.compact matches = matches.uniq.sort_by { |name, dist| dist } matches.first(5).map { |name, dist| name } end
# File lib/rubygems/spec_fetcher.rb, line 220 def tuples_for(source, type, gracefully_ignore=false) cache = @caches[type] if gracefully_ignore begin cache[source.uri] ||= source.load_specs(type) rescue Gem::RemoteFetcher::FetchError [] end else cache[source.uri] ||= source.load_specs(type) end end