Class: Gem::Resolver::Conflict

Inherits:
Object
  • Object
show all
Defined in:
lib/rubygems/resolver/conflict.rb

Overview

Used internally to indicate that a dependency conflicted with a spec that would be activated.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(dependency, activated, failed_dep = dependency) ⇒ Conflict

Creates a new resolver conflict when dependency is in conflict with an already activated specification.



24
25
26
27
28
 
# File 'lib/rubygems/resolver/conflict.rb', line 24

def initialize(dependency, activated, failed_dep=dependency)
  @dependency = dependency
  @activated = activated
  @failed_dep = failed_dep
end

Instance Attribute Details

#activated ⇒ Object (readonly)

The specification that was activated prior to the conflict



11
12
13
 
# File 'lib/rubygems/resolver/conflict.rb', line 11

def activated
  @activated
end

#dependency ⇒ Object (readonly)

The dependency that is in conflict with the activated gem.



16
17
18
 
# File 'lib/rubygems/resolver/conflict.rb', line 16

def dependency
  @dependency
end

#failed_dep ⇒ Object (readonly)

:nodoc:



18
19
20
 
# File 'lib/rubygems/resolver/conflict.rb', line 18

def failed_dep
  @failed_dep
end

Instance Method Details

#==(other) ⇒ Object

:nodoc:



30
31
32
33
34
35
 
# File 'lib/rubygems/resolver/conflict.rb', line 30

def ==(other) # :nodoc:
  self.class === other &&
    @dependency == other.dependency &&
    @activated  == other.activated  &&
    @failed_dep == other.failed_dep
end

#conflicting_dependencies ⇒ Object

Return the 2 dependency objects that conflicted



47
48
49
 
# File 'lib/rubygems/resolver/conflict.rb', line 47

def conflicting_dependencies
  [@failed_dep.dependency, @activated.request.dependency]
end

#explain ⇒ Object

A string explanation of the conflict.



40
41
42
 
# File 'lib/rubygems/resolver/conflict.rb', line 40

def explain
  "<Conflict wanted: #{@failed_dep}, had: #{activated.spec.full_name}>"
end

#explanation ⇒ Object

Explanation of the conflict used by exceptions to print useful messages



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
 
# File 'lib/rubygems/resolver/conflict.rb', line 54

def explanation
  activated   = @activated.spec.full_name
  dependency  = @failed_dep.dependency
  requirement = dependency.requirement
  alternates  = dependency.matching_specs.map {|spec| spec.full_name }

  unless alternates.empty?
    matching = <<-MATCHING.chomp

Gems matching %s:
  %s
    MATCHING

    matching = matching % [
      dependency,
      alternates.join(", "),
    ]
  end

  explanation = <<-EXPLANATION
Activated %s
which does not match conflicting dependency (%s)

Conflicting dependency chains:
  %s

versus:
  %s
%s
  EXPLANATION

  explanation % [
    activated, requirement,
    request_path(@activated).reverse.join(", depends on\n    "),
    request_path(@failed_dep).reverse.join(", depends on\n    "),
    matching
  ]
end

#for_spec?(spec) ⇒ Boolean

Returns true if the conflicting dependency’s name matches spec.

Returns:

  • (Boolean) 


96
97
98
 
# File 'lib/rubygems/resolver/conflict.rb', line 96

def for_spec?(spec)
  @dependency.name == spec.name
end

#pretty_print(q) ⇒ Object

:nodoc:



100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
 
# File 'lib/rubygems/resolver/conflict.rb', line 100

def pretty_print(q) # :nodoc:
  q.group 2, "[Dependency conflict: ", "]" do
    q.breakable

    q.text "activated "
    q.pp @activated

    q.breakable
    q.text " dependency "
    q.pp @dependency

    q.breakable
    if @dependency == @failed_dep
      q.text " failed"
    else
      q.text " failed dependency "
      q.pp @failed_dep
    end
  end
end

#request_path(current) ⇒ Object

Path of activations from the current list.



124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/rubygems/resolver/conflict.rb', line 124

def request_path(current)
  path = []

  while current do
    case current
    when Gem::Resolver::ActivationRequest then
      path <<
        "#{current.request.dependency}, #{current.spec.version} activated"

      current = current.parent
    when Gem::Resolver::DependencyRequest then
      path << "#{current.dependency}"

      current = current.requester
    else
      raise Gem::Exception, "[BUG] unknown request class #{current.class}"
    end
  end

  path = ["user request (gem command or Gemfile)"] if path.empty?

  path
end

#requester ⇒ Object

Return the Specification that listed the dependency



151
152
153
 
# File 'lib/rubygems/resolver/conflict.rb', line 151

def requester
  @failed_dep.requester
end