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.



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

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

Instance Attribute Details

#activatedObject (readonly)

The specification that was activated prior to the conflict



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

def activated
  @activated
end

#dependencyObject (readonly)

The dependency that is in conflict with the activated gem.



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

def dependency
  @dependency
end

#failed_depObject (readonly)

:nodoc:



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

def failed_dep
  @failed_dep
end

Instance Method Details

#==(other) ⇒ Object

:nodoc:



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

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

#conflicting_dependenciesObject

Return the 2 dependency objects that conflicted



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

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

#explainObject

A string explanation of the conflict.



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

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

#explanationObject

Explanation of the conflict used by exceptions to print useful messages



53
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
# File 'lib/rubygems/resolver/conflict.rb', line 53

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)


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

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

#pretty_print(q) ⇒ Object

:nodoc:



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

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.



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

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

#requesterObject

Return the Specification that listed the dependency



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

def requester
  @failed_dep.requester
end