Class: Gem::Resolver
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Classes:
APISet ,
APISpecification ,
ActivationRequest ,
BestSet ,
ComposedSet ,
Conflict ,
CurrentSet ,
DependencyRequest ,
GitSet ,
GitSpecification ,
IndexSet ,
IndexSpecification ,
InstalledSpecification ,
InstallerSet ,
LocalSpecification ,
LockSet ,
LockSpecification ,
RequirementList ,
Set ,
SourceSet ,
SpecSpecification ,
Specification ,
Stats ,
VendorSet ,
VendorSpecification | |
Super Chains via Extension / Inclusion / Inheritance | |
Instance Chain:
|
|
Inherits: | Object |
Defined in: | lib/rubygems/resolver.rb |
Overview
Given a set of Dependency
objects as needed
and a way to query the set of available specs via set
, calculates a set of ActivationRequest
objects which indicate all the specs that should be activated to meet the all the requirements.
Constant Summary
-
DEBUG_RESOLVER =
If the
DEBUG_RESOLVER
environment variable is set then debugging mode is enabled for the resolver. This will display information about the state of the resolver while a set of dependencies is being resolved.!ENV['DEBUG_RESOLVER'].nil?
-
SINGLE_POSSIBILITY_CONSTRAINT_PENALTY =
private
# File 'lib/rubygems/resolver.rb', line 2941_000_000
Class Method Summary
-
.compose_sets(*sets)
Combines
sets
into aComposedSet
that allows specification lookup in a uniform manner. -
.for_current_gems(needed)
Creates a
Resolver
that queries only against the already installed gems for theneeded
dependencies. -
.new(needed, set = nil) ⇒ Resolver
constructor
Create Resolver object which will resolve the tree starting with
needed
Dependency
objects.
Instance Attribute Summary
- #debug? ⇒ Boolean readonly
-
#development
rw
Set
to true if all development dependencies should be considered. -
#development_shallow
rw
Set
to true if immediate development dependencies should be considered. -
#ignore_dependencies
rw
When true, no dependencies are looked up for requested gems.
-
#missing
readonly
List
of dependencies that could not be found in the configured sources. -
#skip_gems
rw
Hash of gems to skip resolution.
-
#soft_missing
rw
When a missing dependency, don’t stop.
- #stats readonly
Resolver::Molinillo::UI
- Included
#debug? | Whether or not debug messages should be printed. |
Instance Method Summary
- #allow_missing?(dependency) ⇒ Boolean
- #dependencies_for(specification)
- #name_for(dependency)
- #output
- #requirement_satisfied_by?(requirement, activated, spec) ⇒ Boolean
-
#resolve
Proceed with resolution! Returns an array of
ActivationRequest
objects. - #search_for(dependency)
- #sort_dependencies(dependencies, activated, conflicts)
-
#amount_constrained(dependency)
private
returns an integer in (-infty, 0] a number closer to 0 means the dependency is less constraining.
-
#activation_request(dep, possible)
Internal use only
Creates an
ActivationRequest
for the givendep
and the lastpossible
specification. - #explain(stage, *data) Internal use only
- #explain_list(stage) Internal use only
-
#find_possible(dependency)
Internal use only
Extracts the specifications that may be able to fulfill
dependency
and returns those that match the local platform and all those that match. - #requests(s, act, reqs = []) Internal use only
-
#select_local_platforms(specs)
Internal use only
Returns the gems in
specs
that match the local platform.
Resolver::Molinillo::SpecificationProvider
- Included
#allow_missing? | Returns whether this dependency, which has no possible matching specifications, can safely be ignored. |
#dependencies_equal? | Determines whether two arrays of dependencies are equal, and thus can be grouped. |
#dependencies_for | Returns the dependencies of |
#name_for | Returns the name for the given |
#name_for_explicit_dependency_source, #name_for_locking_dependency_source, | |
#requirement_satisfied_by? | Determines whether the given |
#search_for | Search for the specifications that match the given dependency. |
#sort_dependencies | Sort dependencies so that the ones that are easiest to resolve are first. |
Resolver::Molinillo::UI
- Included
#after_resolution | Called after resolution ends (either successfully or with an error). |
#before_resolution | Called before resolution begins. |
#debug | Conveys debug information to the user. |
#indicate_progress | Called roughly every |
#output | The |
#progress_rate | How often progress should be conveyed to the user via |
Constructor Details
.new(needed, set = nil) ⇒ Resolver
Create Resolver object which will resolve the tree starting with needed
Dependency
objects.
set
is an object that provides where to look for specifications to satisfy the Dependencies. This defaults to Resolver::IndexSet
, which will query rubygems.org.
# File 'lib/rubygems/resolver.rb', line 101
def initialize(needed, set = nil) @set = set || Gem::Resolver::IndexSet.new @needed = needed @development = false @development_shallow = false @ignore_dependencies = false @missing = [] @skip_gems = {} @soft_missing = false @stats = Gem::Resolver::Stats.new end
Class Method Details
.compose_sets(*sets)
Combines sets
into a Resolver::ComposedSet
that allows specification lookup in a uniform manner. If one of the sets
is itself a Resolver::ComposedSet
its sets are flattened into the result Resolver::ComposedSet
.
# File 'lib/rubygems/resolver.rb', line 61
def self.compose_sets(*sets) sets.compact! sets = sets.map do |set| case set when Gem::Resolver::BestSet then set when Gem::Resolver::ComposedSet then set.sets else set end end.flatten case sets.length when 0 then raise ArgumentError, 'one set in the composition must be non-nil' when 1 then sets.first else Gem::Resolver::ComposedSet.new(*sets) end end
.for_current_gems(needed)
Creates a Resolver
that queries only against the already installed gems for the needed
dependencies.
# File 'lib/rubygems/resolver.rb', line 89
def self.for_current_gems(needed) new needed, Gem::Resolver::CurrentSet.new end
Instance Attribute Details
#debug? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/rubygems/resolver.rb', line 179
def debug? DEBUG_RESOLVER end
#development (rw)
Resolver::Set
to true if all development dependencies should be considered.
# File 'lib/rubygems/resolver.rb', line 25
attr_accessor :development
#development_shallow (rw)
Resolver::Set
to true if immediate development dependencies should be considered.
# File 'lib/rubygems/resolver.rb', line 30
attr_accessor :development_shallow
#ignore_dependencies (rw)
When true, no dependencies are looked up for requested gems.
# File 'lib/rubygems/resolver.rb', line 35
attr_accessor :ignore_dependencies
#missing (readonly)
List
of dependencies that could not be found in the configured sources.
# File 'lib/rubygems/resolver.rb', line 40
attr_reader :missing
#skip_gems (rw)
Hash of gems to skip resolution. Keyed by gem name, with arrays of gem specifications as values.
# File 'lib/rubygems/resolver.rb', line 48
attr_accessor :skip_gems
#soft_missing (rw)
When a missing dependency, don’t stop. Just go on and record what was missing.
# File 'lib/rubygems/resolver.rb', line 54
attr_accessor :soft_missing
#stats (readonly)
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 42
attr_reader :stats
Instance Method Details
#activation_request(dep, possible)
Creates an Resolver::ActivationRequest
for the given dep
and the last possible
specification.
Returns the Resolver::Specification
and the Resolver::ActivationRequest
# File 'lib/rubygems/resolver.rb', line 138
def activation_request(dep, possible) # :nodoc: spec = possible.pop explain :activate, [spec.full_name, possible.size] explain :possible, possible activation_request = Gem::Resolver::ActivationRequest.new spec, dep, possible return spec, activation_request end
#allow_missing?(dependency) ⇒ Boolean
# File 'lib/rubygems/resolver.rb', line 276
def allow_missing?(dependency) @missing << dependency @soft_missing end
#amount_constrained(dependency) (private)
returns an integer in (-infty, 0] a number closer to 0 means the dependency is less constraining
dependencies w/ 0 or 1 possibilities (ignoring version requirements) are given very negative values, so they always sort first, before dependencies that are unconstrained
# File 'lib/rubygems/resolver.rb', line 303
def amount_constrained(dependency) @amount_constrained ||= {} @amount_constrained[dependency.name] ||= begin name_dependency = Gem::Dependency.new(dependency.name) dependency_request_for_name = Gem::Resolver::DependencyRequest.new(name_dependency, dependency.requester) all = @set.find_all(dependency_request_for_name).size if all <= 1 all - SINGLE_POSSIBILITY_CONSTRAINT_PENALTY else search = search_for(dependency).size search - all end end end
#dependencies_for(specification)
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 257
def dependencies_for(specification) return [] if @ignore_dependencies spec = specification.spec requests(spec, specification) end
#explain(stage, *data)
# File 'lib/rubygems/resolver.rb', line 114
def explain(stage, *data) # :nodoc: return unless DEBUG_RESOLVER d = data.map {|x| x.pretty_inspect }.join(", ") $stderr.printf "%10s %s\n", stage.to_s.upcase, d end
#explain_list(stage)
# File 'lib/rubygems/resolver.rb', line 121
def explain_list(stage) # :nodoc: return unless DEBUG_RESOLVER data = yield $stderr.printf "%10s (%d entries)\n", stage.to_s.upcase, data.size unless data.empty? require 'pp' PP.pp data, $stderr end end
#find_possible(dependency)
Extracts the specifications that may be able to fulfill dependency
and returns those that match the local platform and all those that match.
# File 'lib/rubygems/resolver.rb', line 202
def find_possible(dependency) # :nodoc: all = @set.find_all dependency if (skip_dep_gems = skip_gems[dependency.name]) && !skip_dep_gems.empty? matching = all.select do |api_spec| skip_dep_gems.any? {|s| api_spec.version == s.version } end all = matching unless matching.empty? end matching_platform = select_local_platforms all return matching_platform, all end
#name_for(dependency)
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 272
def name_for(dependency) dependency.name end
#output
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 175
def output @output ||= debug? ? $stdout : File.open(IO::NULL, 'w') end
#requests(s, act, reqs = [])
# File 'lib/rubygems/resolver.rb', line 150
def requests(s, act, reqs=[]) # :nodoc: return reqs if @ignore_dependencies s.fetch_development_dependencies if @development s.dependencies.reverse_each do |d| next if d.type == :development and not @development next if d.type == :development and @development_shallow and act.development? next if d.type == :development and @development_shallow and act.parent reqs << Gem::Resolver::DependencyRequest.new(d, act) @stats.requirement! end @set.prefetch reqs @stats.record_requirements reqs reqs end
#requirement_satisfied_by?(requirement, activated, spec) ⇒ Boolean
# File 'lib/rubygems/resolver.rb', line 263
def requirement_satisfied_by?(requirement, activated, spec) matches_spec = requirement.matches_spec? spec return matches_spec if @soft_missing matches_spec && spec.spec.required_ruby_version.satisfied_by?(Gem.ruby_version) && spec.spec.required_rubygems_version.satisfied_by?(Gem.rubygems_version) end
#resolve
Proceed with resolution! Returns an array of Resolver::ActivationRequest
objects.
# File 'lib/rubygems/resolver.rb', line 188
def resolve locking_dg = Molinillo::DependencyGraph.new Molinillo::Resolver.new(self, self).resolve(@needed.map {|d| DependencyRequest.new d, nil }, locking_dg).tsort.map(&:payload).compact rescue Molinillo::VersionConflict => e conflict = e.conflicts.values.first raise Gem::DependencyResolutionError, Conflict.new(conflict.requirement_trees.first.first, conflict.existing, conflict.requirement) ensure @output.close if defined?(@output) and !debug? end
#search_for(dependency)
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 227
def search_for(dependency) possibles, all = find_possible(dependency) if !@soft_missing && possibles.empty? @missing << dependency exc = Gem::UnsatisfiableDependencyError.new dependency, all exc.errors = @set.errors raise exc end groups = Hash.new {|hash, key| hash[key] = [] } # create groups & sources in the same loop sources = possibles.map do |spec| source = spec.source groups[source] << spec source end.uniq.reverse activation_requests = [] sources.each do |source| groups[source]. sort_by {|spec| [spec.version, Gem::Platform.local =~ spec.platform ? 1 : 0] }. map {|spec| ActivationRequest.new spec, dependency }. each {|activation_request| activation_requests << activation_request } end activation_requests end
#select_local_platforms(specs)
Returns the gems in specs
that match the local platform.
# File 'lib/rubygems/resolver.rb', line 221
def select_local_platforms(specs) # :nodoc: specs.select do |spec| Gem::Platform.installable? spec end end
#sort_dependencies(dependencies, activated, conflicts)
[ GitHub ]# File 'lib/rubygems/resolver.rb', line 281
def sort_dependencies(dependencies, activated, conflicts) dependencies.sort_by.with_index do |dependency, i| name = name_for(dependency) [ activated.vertex_named(name).payload ? 0 : 1, amount_constrained(dependency), conflicts[name] ? 0 : 1, activated.vertex_named(name).payload ? 0 : search_for(dependency).count, i, # for stable sort ] end end