A RequestSet groups a request to activate a set of dependencies.

nokogiri = Gem::Dependency.new 'nokogiri', '~> 1.6'
pg = Gem::Dependency.new 'pg', '~> 0.14'

set = Gem::RequestSet.new nokogiri, pg

requests = set.resolve

p requests.map { |r| r.full_name }
#=> ["nokogiri-1.6.0", "mini_portile-0.5.1", "pg-0.17.0"]
Namespace
Methods
G
I
L
N
R
S
Included Modules
Constants
GemDepedencyAPI = self
 

TODO: remove this typo name at RubyGems 3.0
Attributes
[R] always_install

Array of gems to install even if already installed
[R] dependencies
[RW] development
[RW] ignore_dependencies

When true, dependency resolution is not performed, only the requested gems are installed.
[RW] remote

When false no remote sets are used for resolving gems.
[RW] soft_missing

Treat missing dependencies as silent errors
Class Public methods
new(*deps)

Creates a RequestSet for a list of Gem::Dependency objects, deps. You can then resolve and install the resolved list of dependencies.

nokogiri = Gem::Dependency.new 'nokogiri', '~> 1.6'
pg = Gem::Dependency.new 'pg', '~> 0.14'

set = Gem::RequestSet.new nokogiri, pg

Source: show 

# File lib/rubygems/request_set.rb, line 70
def initialize *deps
  @dependencies = deps

  @always_install      = []
  @dependency_names    = {}
  @development         = false
  @git_set             = nil
  @ignore_dependencies = false
  @install_dir         = Gem.dir
  @remote              = true
  @requests            = []
  @sets                = []
  @soft_missing        = false
  @sorted              = nil
  @specs               = nil
  @vendor_set          = nil

  yield self if block_given?
end
Instance Public methods
gem(name, *reqs)

Declare that a gem of name name with reqs requirements is needed.

Source: show 

# File lib/rubygems/request_set.rb, line 93
def gem name, *reqs
  if dep = @dependency_names[name] then
    dep.requirement.concat reqs
  else
    dep = Gem::Dependency.new name, reqs
    @dependency_names[name] = dep
    @dependencies << dep
  end
end
import(deps)

Add deps Gem::Dependency objects to the set.

Source: show 

# File lib/rubygems/request_set.rb, line 106
def import deps
  @dependencies.concat deps
end
install(options, &block)

Installs gems for this RequestSet using the Gem::Installer options.

If a block is given an activation request and installer are yielded. The installer will be nil if a gem matching the request was already installed.

Source: show 

# File lib/rubygems/request_set.rb, line 117
def install options, &block # :yields: request, installer
  if dir = options[:install_dir]
    return install_into dir, false, options, &block
  end

  cache_dir = options[:cache_dir] || Gem.dir

  specs = []

  sorted_requests.each do |req|
    if req.installed? then
      req.spec.spec.build_extensions

      if @always_install.none? { |spec| spec == req.spec.spec } then
        yield req, nil if block_given?
        next
      end
    end

    path = req.download cache_dir

    inst = Gem::Installer.new path, options

    yield req, inst if block_given?

    specs << inst.install
  end

  specs
end
install_from_gemdeps(options, &block)

Installs from the gem dependencies files in the :gemdeps option in options, yielding to the block as in install.

If :without_groups is given in the options, those groups in the gem dependencies file are not used. See Gem::Installer for other options.

Source: show 

# File lib/rubygems/request_set.rb, line 155
def install_from_gemdeps options, &block
  gemdeps = options[:gemdeps]

  @install_dir = options[:install_dir] || Gem.dir
  @remote      = options[:domain] != :local

  load_gemdeps gemdeps, options[:without_groups]

  resolve

  if options[:explain]
    puts "Gems to install:"

    specs.map { |s| s.full_name }.sort.each do |s|
      puts "  #{s}"
    end

    if Gem.configuration.really_verbose
      @resolver.stats.display
    end
  else
    installed = install options, &block

    lockfile = Gem::RequestSet::Lockfile.new self, gemdeps
    lockfile.write

    installed
  end
end
install_into(dir, force = true, options = {})

Source: show 

# File lib/rubygems/request_set.rb, line 185
def install_into dir, force = true, options = {}
  gem_home, ENV['GEM_HOME'] = ENV['GEM_HOME'], dir

  existing = force ? [] : specs_in(dir)
  existing.delete_if { |s| @always_install.include? s }

  dir = File.expand_path dir

  installed = []

  options[:install_dir] = dir
  options[:only_install_dir] = true

  sorted_requests.each do |request|
    spec = request.spec

    if existing.find { |s| s.full_name == spec.full_name } then
      yield request, nil if block_given?
      next
    end

    spec.install options do |installer|
      yield request, installer if block_given?
    end

    installed << request
  end

  installed
ensure
  ENV['GEM_HOME'] = gem_home
end
load_gemdeps(path, without_groups = [])

Load a dependency management file.

Source: show 

# File lib/rubygems/request_set.rb, line 221
def load_gemdeps path, without_groups = []
  @git_set    = Gem::Resolver::GitSet.new
  @vendor_set = Gem::Resolver::VendorSet.new

  @git_set.root_dir = @install_dir

  lockfile = Gem::RequestSet::Lockfile.new self, path
  lockfile.parse

  gf = Gem::RequestSet::GemDependencyAPI.new self, path
  gf.without_groups = without_groups if without_groups
  gf.load
end
resolve(set = Gem::Resolver::BestSet.new)

Resolve the requested dependencies and return an Array of Specification objects to be activated.

Source: show 

# File lib/rubygems/request_set.rb, line 239
def resolve set = Gem::Resolver::BestSet.new
  @sets << set
  @sets << @git_set
  @sets << @vendor_set

  set = Gem::Resolver.compose_sets(*@sets)
  set.remote = @remote

  resolver = Gem::Resolver.new @dependencies, set
  resolver.development         = @development
  resolver.ignore_dependencies = @ignore_dependencies
  resolver.soft_missing        = @soft_missing

  @resolver = resolver

  @requests = resolver.resolve
end
resolve_current()

Resolve the requested dependencies against the gems available via Gem.path and return an Array of Specification objects to be activated.

Source: show 

# File lib/rubygems/request_set.rb, line 261
def resolve_current
  resolve Gem::Resolver::CurrentSet.new
end
sorted_requests()

Source: show 

# File lib/rubygems/request_set.rb, line 265
def sorted_requests
  @sorted ||= strongly_connected_components.flatten
end
specs()

Source: show 

# File lib/rubygems/request_set.rb, line 269
def specs
  @specs ||= @requests.map { |r| r.full_spec }
end
specs_in(dir)

Source: show 

# File lib/rubygems/request_set.rb, line 273
def specs_in dir
  Dir["#{dir}/specifications/*.gemspec"].map do |g|
    Gem::Specification.load g
  end
end