class Bundler::PubGrub::VersionSolver

Attributes

logger[R]
solution[R]
source[R]

Public Class Methods

new(source:, root: Package.root, logger: Bundler::PubGrub.logger) click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 12
def initialize(source:, root: Package.root, logger: Bundler::PubGrub.logger)
  @logger = logger

  @source = source

  # { package => [incompatibility, ...]}
  @incompatibilities = Hash.new do |h, k|
    h[k] = []
  end

  @seen_incompatibilities = {}

  @solution = PartialSolution.new

  add_incompatibility Incompatibility.new([
    Term.new(VersionConstraint.any(root), false)
  ], cause: :root)

  propagate(root)
end

Public Instance Methods

result()
Alias for: solve
solve() click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 57
def solve
  work until solved?

  solution.decisions
end
Also aliased as: result
solved?() click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 33
def solved?
  solution.unsatisfied.empty?
end
work() click to toggle source

Returns true if there is more work to be done, false otherwise

# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 38
def work
  return false if solved?

  next_package = choose_package_version
  propagate(next_package)

  if solved?
    logger.info { "Solution found after #{solution.attempted_solutions} attempts:" }
    solution.decisions.each do |package, version|
      next if Package.root?(package)
      logger.info { "* #{package} #{version}" }
    end

    false
  else
    true
  end
end

Private Instance Methods

add_incompatibility(incompatibility) click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 240
def add_incompatibility(incompatibility)
  logger.debug { "fact: #{incompatibility}" }
  incompatibility.terms.each do |term|
    package = term.package
    @incompatibilities[package] << incompatibility
  end
end
choose_package_version() click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 119
def choose_package_version
  if solution.unsatisfied.empty?
    logger.info "No packages unsatisfied. Solving complete!"
    return nil
  end

  package = next_package_to_try
  unsatisfied_term = solution.unsatisfied.find { |t| t.package == package }
  version = source.versions_for(package, unsatisfied_term.constraint.range).first
  logger.debug { "attempting #{package} #{version}" }

  if version.nil?
    add_incompatibility source.no_versions_incompatibility_for(package, unsatisfied_term)
    return package
  end

  conflict = false

  source.incompatibilities_for(package, version).each do |incompatibility|
    if @seen_incompatibilities.include?(incompatibility)
      logger.debug { "knew: #{incompatibility}" }
      next
    end
    @seen_incompatibilities[incompatibility] = true

    add_incompatibility incompatibility

    conflict ||= incompatibility.terms.all? do |term|
      term.package == package || solution.satisfies?(term)
    end
  end

  unless conflict
    logger.info { "selected #{package} #{version}" }

    solution.decide(package, version)
  else
    logger.info { "conflict: #{conflict.inspect}" }
  end

  package
end
next_package_to_try() click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 108
def next_package_to_try
  solution.unsatisfied.min_by do |term|
    package = term.package
    range = term.constraint.range
    matching_versions = source.versions_for(package, range)
    higher_versions = source.versions_for(package, range.upper_invert)

    [matching_versions.count <= 1 ? 0 : 1, higher_versions.count]
  end.package
end
propagate(initial_package) click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 67
def propagate(initial_package)
  changed = [initial_package]
  while package = changed.shift
    @incompatibilities[package].reverse_each do |incompatibility|
      result = propagate_incompatibility(incompatibility)
      if result == :conflict
        root_cause = resolve_conflict(incompatibility)
        changed.clear
        changed << propagate_incompatibility(root_cause)
      elsif result # should be a Package
        changed << result
      end
    end
    changed.uniq!
  end
end
propagate_incompatibility(incompatibility) click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 84
def propagate_incompatibility(incompatibility)
  unsatisfied = nil
  incompatibility.terms.each do |term|
    relation = solution.relation(term)
    if relation == :disjoint
      return nil
    elsif relation == :overlap
      # If more than one term is inconclusive, we can't deduce anything
      return nil if unsatisfied
      unsatisfied = term
    end
  end

  if !unsatisfied
    return :conflict
  end

  logger.debug { "derived: #{unsatisfied.invert}" }

  solution.derive(unsatisfied.invert, incompatibility)

  unsatisfied.package
end
resolve_conflict(incompatibility) click to toggle source
# File bundler/vendor/pub_grub/lib/pub_grub/version_solver.rb, line 162
def resolve_conflict(incompatibility)
  logger.info { "conflict: #{incompatibility}" }

  new_incompatibility = nil

  while !incompatibility.failure?
    most_recent_term = nil
    most_recent_satisfier = nil
    difference = nil

    previous_level = 1

    incompatibility.terms.each do |term|
      satisfier = solution.satisfier(term)

      if most_recent_satisfier.nil?
        most_recent_term = term
        most_recent_satisfier = satisfier
      elsif most_recent_satisfier.index < satisfier.index
        previous_level = [previous_level, most_recent_satisfier.decision_level].max
        most_recent_term = term
        most_recent_satisfier = satisfier
        difference = nil
      else
        previous_level = [previous_level, satisfier.decision_level].max
      end

      if most_recent_term == term
        difference = most_recent_satisfier.term.difference(most_recent_term)
        if difference.empty?
          difference = nil
        else
          difference_satisfier = solution.satisfier(difference.inverse)
          previous_level = [previous_level, difference_satisfier.decision_level].max
        end
      end
    end

    if previous_level < most_recent_satisfier.decision_level ||
        most_recent_satisfier.decision?

      logger.info { "backtracking to #{previous_level}" }
      solution.backtrack(previous_level)

      if new_incompatibility
        add_incompatibility(new_incompatibility)
      end

      return incompatibility
    end

    new_terms = []
    new_terms += incompatibility.terms - [most_recent_term]
    new_terms += most_recent_satisfier.cause.terms.reject { |term|
      term.package == most_recent_satisfier.term.package
    }
    if difference
      new_terms << difference.invert
    end

    new_incompatibility = Incompatibility.new(new_terms, cause: Incompatibility::ConflictCause.new(incompatibility, most_recent_satisfier.cause))

    if incompatibility.to_s == new_incompatibility.to_s
      logger.info { "!! failed to resolve conflicts, this shouldn't have happened" }
      break
    end

    incompatibility = new_incompatibility

    partially = difference ? " partially" : ""
    logger.info { "! #{most_recent_term} is#{partially} satisfied by #{most_recent_satisfier.term}" }
    logger.info { "! which is caused by #{most_recent_satisfier.cause}" }
    logger.info { "! thus #{incompatibility}" }
  end

  raise SolveFailure.new(incompatibility)
end