Class: Gem::AvailableSet (Ruby 2.3.4)

Home Classes Methods

In Files

rubygems/available_set.rb

Parent

Object

Methods

::new
#<<
#add
#all_specs
#each
#each_spec
#empty?
#find_all
#inject_into_list
#match_platform!
#pick_best!
#prefetch
#remove_installed!
#size
#sorted
#source_for
#to_request_set

Included Modules

Enumerable

Class/Module Index

Gem::AvailableSet

frozen_string_literal: true

Constants

Tuple

Attributes

set[R]

Public Class Methods

new()

 
               # File rubygems/available_set.rb, line 10
def initialize
  @set = []
  @sorted = nil
  @remote = true
end

Public Instance Methods

<<(o)

 
               # File rubygems/available_set.rb, line 24
def <<(o)
  case o
  when Gem::AvailableSet
    s = o.set
  when Array
    s = o.map do |sp,so|
      if !sp.kind_of?(Gem::Specification) or !so.kind_of?(Gem::Source)
        raise TypeError, "Array must be in [[spec, source], ...] form"
      end

      Tuple.new(sp,so)
    end
  else
    raise TypeError, "must be a Gem::AvailableSet"
  end

  @set += s
  @sorted = nil

  self
end

add(spec, source)

 
               # File rubygems/available_set.rb, line 18
def add(spec, source)
  @set << Tuple.new(spec, source)
  @sorted = nil
  self
end

all_specs()

 
               # File rubygems/available_set.rb, line 72
def all_specs
  @set.map { |t| t.spec }
end

each()

Yields each Tuple in this AvailableSet

 
               # File rubygems/available_set.rb, line 49
def each
  return enum_for __method__ unless block_given?

  @set.each do |tuple|
    yield tuple
  end
end

each_spec()

Yields the Gem::Specification for each Tuple in this AvailableSet

 
               # File rubygems/available_set.rb, line 60
def each_spec
  return enum_for __method__ unless block_given?

  each do |tuple|
    yield tuple.spec
  end
end

empty?()

 
               # File rubygems/available_set.rb, line 68
def empty?
  @set.empty?
end

find_all(req)

Used by the Resolver, the protocol to use a AvailableSet as a search Set.

 
               # File rubygems/available_set.rb, line 126
def find_all(req)
  dep = req.dependency

  match = @set.find_all do |t|
    dep.match? t.spec
  end

  match.map do |t|
    Gem::Resolver::LocalSpecification.new(self, t.spec, t.source)
  end
end

inject_into_list(dep_list)

 
               # File rubygems/available_set.rb, line 162
def inject_into_list(dep_list)
  @set.each { |t| dep_list.add t.spec }
end

match_platform!()

 
               # File rubygems/available_set.rb, line 76
def match_platform!
  @set.reject! { |t| !Gem::Platform.match(t.spec.platform) }
  @sorted = nil
  self
end

pick_best!()

 
               # File rubygems/available_set.rb, line 141
def pick_best!
  return self if empty?

  @set = [sorted.first]
  @sorted = nil
  self
end

prefetch(reqs)

 
               # File rubygems/available_set.rb, line 138
def prefetch(reqs)
end

remove_installed!(dep)

 
               # File rubygems/available_set.rb, line 149
def remove_installed!(dep)
  @set.reject! do |t|
    # already locally installed
    Gem::Specification.any? do |installed_spec|
      dep.name == installed_spec.name and
        dep.requirement.satisfied_by? installed_spec.version
    end
  end

  @sorted = nil
  self
end

size()

 
               # File rubygems/available_set.rb, line 89
def size
  @set.size
end

sorted()

 
               # File rubygems/available_set.rb, line 82
def sorted
  @sorted ||= @set.sort do |a,b|
    i = b.spec <=> a.spec
    i != 0 ? i : (a.source <=> b.source)
  end
end

source_for(spec)

 
               # File rubygems/available_set.rb, line 93
def source_for(spec)
  f = @set.find { |t| t.spec == spec }
  f.source
end

to_request_set(development = :none)

Converts this AvailableSet into a RequestSet that can be used to install gems.

If development is :none then no development dependencies are installed. Other options are :shallow for only direct development dependencies of the gems in this set or :all for all development dependencies.

 
               # File rubygems/available_set.rb, line 106
def to_request_set development = :none
  request_set = Gem::RequestSet.new
  request_set.development = :all == development

  each_spec do |spec|
    request_set.always_install << spec

    request_set.gem spec.name, spec.version
    request_set.import spec.development_dependencies if
      :shallow == development
  end

  request_set
end