Class: Gem::Resolver::InstallerSet

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

Overview

A set of gems for installation sourced from remote sources and local .gem files

Instance Attribute Summary collapse

Attributes inherited from Set

#prerelease, #remote

Instance Method Summary collapse

Methods inherited from Set

#remote?

Constructor Details

#initialize(domain) ⇒ InstallerSet

Creates a new InstallerSet that will look for gems in domain.


31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/rubygems/resolver/installer_set.rb', line 31

def initialize(domain)
  super()

  @domain = domain
  @remote = consider_remote?

  @f = Gem::SpecFetcher.fetcher

  @always_install      = []
  @ignore_dependencies = false
  @ignore_installed    = false
  @local               = {}
  @local_source        = Gem::Source::Local.new
  @remote_set          = Gem::Resolver::BestSet.new
  @specs               = {}
end

Instance Attribute Details

#always_installObject (readonly)

List of Gem::Specification objects that must always be installed.


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

def always_install
  @always_install
end

#ignore_dependenciesObject

Only install gems in the always_install list


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

def ignore_dependencies
  @ignore_dependencies
end

#ignore_installedObject

Do not look in the installed set when finding specifications. This is used by the –install-dir option to `gem install`


21
22
23
# File 'lib/rubygems/resolver/installer_set.rb', line 21

def ignore_installed
  @ignore_installed
end

#remote_setObject (readonly)

The remote_set looks up remote gems for installation.


26
27
28
# File 'lib/rubygems/resolver/installer_set.rb', line 26

def remote_set
  @remote_set
end

Instance Method Details

#add_always_install(dependency) ⇒ Object

Looks up the latest specification for dependency and adds it to the always_install list.


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

def add_always_install(dependency)
  request = Gem::Resolver::DependencyRequest.new dependency, nil

  found = find_all request

  found.delete_if do |s|
    s.version.prerelease? and not s.local?
  end unless dependency.prerelease?

  found = found.select do |s|
    Gem::Source::SpecificFile === s.source or
      Gem::Platform::RUBY == s.platform or
      Gem::Platform.local === s.platform
  end

  if found.empty?
    exc = Gem::UnsatisfiableDependencyError.new request
    exc.errors = errors

    raise exc
  end

  newest = found.max_by do |s|
    [s.version, s.platform == Gem::Platform::RUBY ? -1 : 1]
  end

  @always_install << newest.spec
end

#add_local(dep_name, spec, source) ⇒ Object

Adds a local gem requested using dep_name with the given spec that can be loaded and installed using the source.


85
86
87
# File 'lib/rubygems/resolver/installer_set.rb', line 85

def add_local(dep_name, spec, source)
  @local[dep_name] = [spec, source]
end

#consider_local?Boolean

Should local gems should be considered?

Returns:

  • (Boolean)

92
93
94
# File 'lib/rubygems/resolver/installer_set.rb', line 92

def consider_local? # :nodoc:
  @domain == :both or @domain == :local
end

#consider_remote?Boolean

Should remote gems should be considered?

Returns:

  • (Boolean)

99
100
101
# File 'lib/rubygems/resolver/installer_set.rb', line 99

def consider_remote? # :nodoc:
  @domain == :both or @domain == :remote
end

#errorsObject

Errors encountered while resolving gems


106
107
108
# File 'lib/rubygems/resolver/installer_set.rb', line 106

def errors
  @errors + @remote_set.errors
end

#find_all(req) ⇒ Object

Returns an array of IndexSpecification objects matching DependencyRequest req.


114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
# File 'lib/rubygems/resolver/installer_set.rb', line 114

def find_all(req)
  res = []

  dep = req.dependency

  return res if @ignore_dependencies and
            @always_install.none? {|spec| dep.match? spec }

  name = dep.name

  dep.matching_specs.each do |gemspec|
    next if @always_install.any? {|spec| spec.name == gemspec.name }

    res << Gem::Resolver::InstalledSpecification.new(self, gemspec)
  end unless @ignore_installed

  if consider_local?
    matching_local = @local.values.select do |spec, _|
      req.match? spec
    end.map do |spec, source|
      Gem::Resolver::LocalSpecification.new self, spec, source
    end

    res.concat matching_local

    begin
      if local_spec = @local_source.find_gem(name, dep.requirement)
        res << Gem::Resolver::IndexSpecification.new(
          self, local_spec.name, local_spec.version,
          @local_source, local_spec.platform)
      end
    rescue Gem::Package::FormatError
      # ignore
    end
  end

  res.delete_if do |spec|
    spec.version.prerelease? and not dep.prerelease?
  end

  res.concat @remote_set.find_all req if consider_remote?

  res
end

#inspectObject

:nodoc:


169
170
171
172
173
174
175
# File 'lib/rubygems/resolver/installer_set.rb', line 169

def inspect # :nodoc:
  always_install = @always_install.map {|s| s.full_name }

  '#<%s domain: %s specs: %p always install: %p>' % [
    self.class, @domain, @specs.keys, always_install
  ]
end

#load_spec(name, ver, platform, source) ⇒ Object

Called from IndexSpecification to get a true Specification object.


181
182
183
184
185
186
187
188
189
# File 'lib/rubygems/resolver/installer_set.rb', line 181

def load_spec(name, ver, platform, source) # :nodoc:
  key = "#{name}-#{ver}-#{platform}"

  @specs.fetch key do
    tuple = Gem::NameTuple.new name, ver, platform

    @specs[key] = source.fetch_spec tuple
  end
end

#local?(dep_name) ⇒ Boolean

Has a local gem for dep_name been added to this set?

Returns:

  • (Boolean)

194
195
196
197
198
# File 'lib/rubygems/resolver/installer_set.rb', line 194

def local?(dep_name) # :nodoc:
  spec, _ = @local[dep_name]

  spec
end

#prefetch(reqs) ⇒ Object


159
160
161
# File 'lib/rubygems/resolver/installer_set.rb', line 159

def prefetch(reqs)
  @remote_set.prefetch(reqs) if consider_remote?
end

#prerelease=(allow_prerelease) ⇒ Object


163
164
165
166
167
# File 'lib/rubygems/resolver/installer_set.rb', line 163

def prerelease=(allow_prerelease)
  super

  @remote_set.prerelease = allow_prerelease
end

#pretty_print(q) ⇒ Object

:nodoc:


200
201
202
203
204
205
206
207
208
209
210
211
212
213
# File 'lib/rubygems/resolver/installer_set.rb', line 200

def pretty_print(q) # :nodoc:
  q.group 2, '[InstallerSet', ']' do
    q.breakable
    q.text "domain: #{@domain}"

    q.breakable
    q.text 'specs: '
    q.pp @specs.keys

    q.breakable
    q.text 'always install: '
    q.pp @always_install
  end
end

#remote=(remote) ⇒ Object

:nodoc:


215
216
217
218
219
220
221
222
223
224
# File 'lib/rubygems/resolver/installer_set.rb', line 215

def remote=(remote) # :nodoc:
  case @domain
  when :local then
    @domain = :both if remote
  when :remote then
    @domain = nil unless remote
  when :both then
    @domain = :local unless remote
  end
end