class Gem::DependencyList

Gem::DependencyList 用于以正确的顺序安装和卸载 gem，以避免冲突。

属性

允许启用/禁用开发依赖项的使用

公共类方法

源代码

# File lib/rubygems/dependency_list.rb, line 34
def self.from_specs
  list = new
  list.add(*Gem::Specification.to_a)
  list
end

从当前规范创建 DependencyList。

new (development = false)

源代码

# File lib/rubygems/dependency_list.rb, line 44
def initialize(development = false)
  @specs = []

  @development = development
end

创建一个新的 DependencyList。如果 development 为 true，则会包含开发依赖项。

公共实例方法

add (*gemspecs)

源代码

# File lib/rubygems/dependency_list.rb, line 53
def add(*gemspecs)
  @specs.concat gemspecs
end

将 gemspecs 添加到依赖项列表中。

clear ()

源代码

# File lib/rubygems/dependency_list.rb, line 57
def clear
  @specs.clear
end

dependency_order ()

源代码

# File lib/rubygems/dependency_list.rb, line 76
def dependency_order
  sorted = strongly_connected_components.flatten

  result = []
  seen = {}

  sorted.each do |spec|
    if index = seen[spec.name]
      if result[index].version < spec.version
        result[index] = spec
      end
    else
      seen[spec.name] = result.length
      result << spec
    end
  end

  result.reverse
end

返回依赖项列表中 gem 规范的列表，并按顺序排序，以便列表中没有 gem 规范依赖于列表前面位置的 gem 规范。

当从一组已安装的 gem 中删除 gem 时，这很有用。通过按返回的顺序删除它们，您不会遇到太多依赖问题。

如果存在循环依赖（呸！），那么 gem 将按顺序返回，直到只剩下循环依赖项以及它们引用的任何内容。然后将返回任意的 gem 规范，直到循环依赖被打破，之后 gem 将再次按依赖顺序返回。

each (&block)

源代码

# File lib/rubygems/dependency_list.rb, line 99
def each(&block)
  dependency_order.each(&block)
end

迭代 dependency_order

find_name (full_name)

源代码

# File lib/rubygems/dependency_list.rb, line 103
def find_name(full_name)
  @specs.find {|spec| spec.full_name == full_name }
end

ok? ()

源代码

# File lib/rubygems/dependency_list.rb, line 114
def ok?
  why_not_ok?(:quick).empty?
end

列表中的所有依赖项都满足了吗？

ok_to_remove? (full_name, check_dev=true)

源代码

# File lib/rubygems/dependency_list.rb, line 143
def ok_to_remove?(full_name, check_dev=true)
  gem_to_remove = find_name full_name

  # If the state is inconsistent, at least don't crash
  return true unless gem_to_remove

  siblings = @specs.find_all do |s|
    s.name == gem_to_remove.name &&
      s.full_name != gem_to_remove.full_name
  end

  deps = []

  @specs.each do |spec|
    check = check_dev ? spec.dependencies : spec.runtime_dependencies

    check.each do |dep|
      deps << dep if gem_to_remove.satisfies_requirement?(dep)
    end
  end

  deps.all? do |dep|
    siblings.any? do |s|
      s.satisfies_requirement? dep
    end
  end
end

从依赖项列表中删除 gem 规范是否安全？

如果删除 gem 规范会导致当前满足的依赖项中断，则删除 gem 规范是不安全的。

remove_by_name (full_name)

源代码

# File lib/rubygems/dependency_list.rb, line 186
def remove_by_name(full_name)
  @specs.delete_if {|spec| spec.full_name == full_name }
end

从依赖项列表中删除与 full_name 匹配的 gem 规范

remove_specs_unsatisfied_by (dependencies)

源代码

# File lib/rubygems/dependency_list.rb, line 176
def remove_specs_unsatisfied_by(dependencies)
  specs.reject! do |spec|
    dep = dependencies[spec.name]
    dep && !dep.requirement.satisfied_by?(spec.version)
  end
end

删除 DependencyList 中与 dependencies（gem 名称到依赖项数组的哈希）中的项匹配但不满足其要求的任何内容。

spec_predecessors ()

源代码

# File lib/rubygems/dependency_list.rb, line 194
def spec_predecessors
  result = Hash.new {|h,k| h[k] = [] }

  specs = @specs.sort.reverse

  specs.each do |spec|
    specs.each do |other|
      next if spec == other

      other.dependencies.each do |dep|
        if spec.satisfies_requirement? dep
          result[spec] << other
        end
      end
    end
  end

  result
end

返回前置依赖项的哈希表。result[spec] 是一个 Array，其中包含具有由指定 gem 规范满足的依赖项的 gem 规范。

tsort_each_child (node) { |spec| ... }

源代码

# File lib/rubygems/dependency_list.rb, line 218
def tsort_each_child(node)
  specs = @specs.sort.reverse

  dependencies = node.runtime_dependencies
  dependencies.push(*node.development_dependencies) if @development

  dependencies.each do |dep|
    specs.each do |spec|
      if spec.satisfies_requirement? dep
        yield spec
        break
      end
    end
  end
end

tsort_each_node (&block)

源代码

# File lib/rubygems/dependency_list.rb, line 214
def tsort_each_node(&block)
  @specs.each(&block)
end

why_not_ok? (quick = false)

源代码

# File lib/rubygems/dependency_list.rb, line 118
def why_not_ok?(quick = false)
  unsatisfied = Hash.new {|h,k| h[k] = [] }
  each do |spec|
    spec.runtime_dependencies.each do |dep|
      inst = Gem::Specification.any? do |installed_spec|
        dep.name == installed_spec.name &&
          dep.requirement.satisfied_by?(installed_spec.version)
      end

      unless inst || @specs.find {|s| s.satisfies_requirement? dep }
        unsatisfied[spec.name] << dep
        return unsatisfied if quick
      end
    end
  end

  unsatisfied
end

私有实例方法

active_count (specs, ignored)

源代码

# File lib/rubygems/dependency_list.rb, line 240
def active_count(specs, ignored)
  specs.count {|spec| ignored[spec.full_name].nil? }
end

计算列表 specs 中不在 ignored 中的 gem 规范的数量。