Module: Gem::Resolver::Molinillo::SpecificationProvider

Included in:
Gem::Resolver
Defined in:
lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb

Overview

Provides information about specifcations and dependencies to the resolver, allowing the Resolver class to remain generic while still providing power and flexibility.

This module contains the methods that users of Gem::Resolver::Molinillo must to implement, using knowledge of their own model classes.

Instance Method Summary collapse

Instance Method Details

#allow_missing?(dependency) ⇒ Boolean

Returns whether this dependency, which has no possible matching specifications, can safely be ignored.

Parameters:

  • dependency (Object)

Returns:

  • (Boolean)

    whether this dependency can safely be skipped.



96
97
98
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 96

def allow_missing?(dependency)
  false
end

#dependencies_for(specification) ⇒ Array<Object>

Note:

This method should be ‘pure’, i.e. the return value should depend only on the ‘specification` parameter.

Returns the dependencies of ‘specification`.

Parameters:

  • specification (Object)

Returns:

  • (Array<Object>)

    the dependencies that are required by the given ‘specification`.



30
31
32
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 30

def dependencies_for(specification)
  []
end

#name_for(dependency) ⇒ String

Note:

This method should be ‘pure’, i.e. the return value should depend only on the ‘dependency` parameter.

Returns the name for the given ‘dependency`.

Parameters:

  • dependency (Object)

Returns:

  • (String)

    the name for the given ‘dependency`.



53
54
55
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 53

def name_for(dependency)
  dependency.to_s
end

#name_for_explicit_dependency_sourceString

Returns the name of the source of explicit dependencies, i.e. those passed to Resolver#resolve directly.

Returns:

  • (String)

    the name of the source of explicit dependencies, i.e. those passed to Resolver#resolve directly.



59
60
61
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 59

def name_for_explicit_dependency_source
  'user-specified dependency'
end

#name_for_locking_dependency_sourceString

Returns the name of the source of ‘locked’ dependencies, i.e. those passed to Resolver#resolve directly as the ‘base`.

Returns:

  • (String)

    the name of the source of ‘locked’ dependencies, i.e. those passed to Resolver#resolve directly as the ‘base`



65
66
67
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 65

def name_for_locking_dependency_source
  'Lockfile'
end

#requirement_satisfied_by?(requirement, activated, spec) ⇒ Boolean

Determines whether the given ‘requirement` is satisfied by the given `spec`, in the context of the current `activated` dependency graph.

Parameters:

  • requirement (Object)
  • activated (DependencyGraph)

    the current dependency graph in the resolution process.

  • spec (Object)

Returns:

  • (Boolean)

    whether ‘requirement` is satisfied by `spec` in the context of the current `activated` dependency graph.



43
44
45
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 43

def requirement_satisfied_by?(requirement, activated, spec)
  true
end

#search_for(dependency) ⇒ Array<Object>

Note:

This method should be ‘pure’, i.e. the return value should depend only on the ‘dependency` parameter.

Search for the specifications that match the given dependency. The specifications in the returned array will be considered in reverse order, so the latest version ought to be last.

Parameters:

  • dependency (Object)

Returns:

  • (Array<Object>)

    the specifications that satisfy the given ‘dependency`.



19
20
21
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 19

def search_for(dependency)
  []
end

#sort_dependencies(dependencies, activated, conflicts) ⇒ Array<Object>

Sort dependencies so that the ones that are easiest to resolve are first. Easiest to resolve is (usually) defined by:

1) Is this dependency already activated?
2) How relaxed are the requirements?
3) Are there any conflicts for this dependency?
4) How many possibilities are there to satisfy this dependency?

Parameters:

  • dependencies (Array<Object>)
  • activated (DependencyGraph)

    the current dependency graph in the resolution process.

  • conflicts ({String => Array<Conflict>})

Returns:

  • (Array<Object>)

    a sorted copy of ‘dependencies`.



81
82
83
84
85
86
87
88
89
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/specification_provider.rb', line 81

def sort_dependencies(dependencies, activated, conflicts)
  dependencies.sort_by do |dependency|
    name = name_for(dependency)
    [
      activated.vertex_named(name).payload ? 0 : 1,
      conflicts[name] ? 0 : 1,
    ]
  end
end