class Gem::Resolver::APISet

全局 rubygems 池，可通过 rubygems.org API 访问。返回 APISpecification 实例。

属性

source [R]

用于获取 gem 的 Gem::Source

uri [R]

用于获取 gem 的相应位置。

Public Class Methods

new (dep_uri = "https://index.rubygems.org/info/")

Source

# File lib/rubygems/resolver/api_set.rb, line 30
def initialize(dep_uri = "https://index.rubygems.org/info/")
  super()

  dep_uri = Gem::URI dep_uri unless Gem::URI === dep_uri

  @dep_uri = dep_uri
  @uri     = dep_uri + ".."

  @data   = Hash.new {|h,k| h[k] = [] }
  @source = Gem::Source.new @uri

  @to_fetch = []
end

创建一个新的 APISet，它将使用 RubyGems API URL dep_uri 从 uri 检索 gem。该 API 在 guides.rubygems.org/rubygems-org-api 中有所描述。

调用超类方法 BasicObject::new

Public Instance Methods

find_all (req)

Source

# File lib/rubygems/resolver/api_set.rb, line 48
def find_all(req)
  res = []

  return res unless @remote

  if @to_fetch.include?(req.name)
    prefetch_now
  end

  versions(req.name).each do |ver|
    if req.dependency.match? req.name, ver[:number], @prerelease
      res << Gem::Resolver::APISpecification.new(self, ver)
    end
  end

  res
end

返回与 DependencyRequest req 匹配的 APISpecification 对象数组。

prefetch (reqs)

Source

# File lib/rubygems/resolver/api_set.rb, line 70
def prefetch(reqs)
  return unless @remote
  names = reqs.map {|r| r.dependency.name }
  needed = names - @data.keys - @to_fetch

  @to_fetch += needed
end

由解析器运行的提示，允许 Set 为 DependencyRequests reqs 获取数据。

私有实例方法

lines (str)

Source

# File lib/rubygems/resolver/api_set.rb, line 129
def lines(str)
  lines = str.split("\n")
  header = lines.index("---")
  header ? lines[header + 1..-1] : lines
end

parse_gem (string)

Source

# File lib/rubygems/resolver/api_set.rb, line 135
def parse_gem(string)
  @gem_parser ||= GemParser.new
  @gem_parser.parse(string)
end