PHP 8.2.31
Preview: dependency_installer.rb Size: 9.91 KB
/proc/thread-self/root/opt/alt/ruby33/share/rubygems/rubygems/dependency_installer.rb

# frozen_string_literal: true

require_relative "../rubygems"
require_relative "dependency_list"
require_relative "package"
require_relative "installer"
require_relative "spec_fetcher"
require_relative "user_interaction"
require_relative "available_set"
require_relative "deprecate"

##
# Installs a gem along with all its dependencies from local and remote gems.

class Gem::DependencyInstaller
  include Gem::UserInteraction
  extend Gem::Deprecate

  DEFAULT_OPTIONS = { # :nodoc:
    env_shebang: false,
    document: %w[ri],
    domain: :both, # HACK: dup
    force: false,
    format_executable: false, # HACK: dup
    ignore_dependencies: false,
    prerelease: false,
    security_policy: nil, # HACK: NoSecurity requires OpenSSL. AlmostNo? Low?
    wrappers: true,
    build_args: nil,
    build_docs_in_background: false,
    install_as_default: false,
  }.freeze

  ##
  # Documentation types.  For use by the Gem.done_installing hook

  attr_reader :document

  ##
  # Errors from SpecFetcher while searching for remote specifications

  attr_reader :errors

  ##
  # List of gems installed by #install in alphabetic order

  attr_reader :installed_gems

  ##
  # Creates a new installer instance.
  #
  # Options are:
  # :cache_dir:: Alternate repository path to store .gem files in.
  # :domain:: :local, :remote, or :both.  :local only searches gems in the
  #           current directory.  :remote searches only gems in Gem::sources.
  #           :both searches both.
  # :env_shebang:: See Gem::Installer::new.
  # :force:: See Gem::Installer#install.
  # :format_executable:: See Gem::Installer#initialize.
  # :ignore_dependencies:: Don't install any dependencies.
  # :install_dir:: See Gem::Installer#install.
  # :prerelease:: Allow prerelease versions.  See #install.
  # :security_policy:: See Gem::Installer::new and Gem::Security.
  # :user_install:: See Gem::Installer.new
  # :wrappers:: See Gem::Installer::new
  # :build_args:: See Gem::Installer::new

  def initialize(options = {})
    @only_install_dir = !options[:install_dir].nil?
    @install_dir = options[:install_dir] || Gem.dir
    @build_root = options[:build_root]

    options = DEFAULT_OPTIONS.merge options

    @bin_dir             = options[:bin_dir]
    @dev_shallow         = options[:dev_shallow]
    @development         = options[:development]
    @document            = options[:document]
    @domain              = options[:domain]
    @env_shebang         = options[:env_shebang]
    @force               = options[:force]
    @format_executable   = options[:format_executable]
    @ignore_dependencies = options[:ignore_dependencies]
    @prerelease          = options[:prerelease]
    @security_policy     = options[:security_policy]
    @user_install        = options[:user_install]
    @wrappers            = options[:wrappers]
    @build_args          = options[:build_args]
    @build_docs_in_background = options[:build_docs_in_background]
    @install_as_default = options[:install_as_default]
    @dir_mode = options[:dir_mode]
    @data_mode = options[:data_mode]
    @prog_mode = options[:prog_mode]

    # Indicates that we should not try to update any deps unless
    # we absolutely must.
    @minimal_deps = options[:minimal_deps]

    @available      = nil
    @installed_gems = []
    @toplevel_specs = nil

    @cache_dir = options[:cache_dir] || @install_dir

    @errors = []
  end

  ##
  # Indicated, based on the requested domain, if local
  # gems should be considered.

  def consider_local?
    @domain == :both || @domain == :local
  end

  ##
  # Indicated, based on the requested domain, if remote
  # gems should be considered.

  def consider_remote?
    @domain == :both || @domain == :remote
  end

  ##
  # Returns a list of pairs of gemspecs and source_uris that match
  # Gem::Dependency +dep+ from both local (Dir.pwd) and remote (Gem.sources)
  # sources.  Gems are sorted with newer gems preferred over older gems, and
  # local gems preferred over remote gems.

  def find_gems_with_sources(dep, best_only=false) # :nodoc:
    set = Gem::AvailableSet.new

    if consider_local?
      sl = Gem::Source::Local.new

      if spec = sl.find_gem(dep.name)
        if dep.matches_spec? spec
          set.add spec, sl
        end
      end
    end

    if consider_remote?
      begin
        # This is pulled from #spec_for_dependency to allow
        # us to filter tuples before fetching specs.
        tuples, errors = Gem::SpecFetcher.fetcher.search_for_dependency dep

        if best_only && !tuples.empty?
          tuples.sort! do |a,b|
            if b[0].version == a[0].version
              if b[0].platform != Gem::Platform::RUBY
                1
              else
                -1
              end
            else
              b[0].version <=> a[0].version
            end
          end
          tuples = [tuples.first]
        end

        specs = []
        tuples.each do |tup, source|
          spec = source.fetch_spec(tup)
        rescue Gem::RemoteFetcher::FetchError => e
          errors << Gem::SourceFetchProblem.new(source, e)
        else
          specs << [spec, source]
        end

        if @errors
          @errors += errors
        else
          @errors = errors
        end

        set << specs
      rescue Gem::RemoteFetcher::FetchError => e
        # FIX if there is a problem talking to the network, we either need to always tell
        # the user (no really_verbose) or fail hard, not silently tell them that we just
        # couldn't find their requested gem.
        verbose do
          "Error fetching remote data:\t\t#{e.message}\n" \
            "Falling back to local-only install"
        end
        @domain = :local
      end
    end

    set
  end
  rubygems_deprecate :find_gems_with_sources

  def in_background(what) # :nodoc:
    fork_happened = false
    if @build_docs_in_background && Process.respond_to?(:fork)
      begin
        Process.fork do
          yield
        end
        fork_happened = true
        say "#{what} in a background process."
      rescue NotImplementedError
      end
    end
    yield unless fork_happened
  end

  ##
  # Installs the gem +dep_or_name+ and all its dependencies.  Returns an Array
  # of installed gem specifications.
  #
  # If the +:prerelease+ option is set and there is a prerelease for
  # +dep_or_name+ the prerelease version will be installed.
  #
  # Unless explicitly specified as a prerelease dependency, prerelease gems
  # that +dep_or_name+ depend on will not be installed.
  #
  # If c-1.a depends on b-1 and a-1.a and there is a gem b-1.a available then
  # c-1.a, b-1 and a-1.a will be installed.  b-1.a will need to be installed
  # separately.

  def install(dep_or_name, version = Gem::Requirement.default)
    request_set = resolve_dependencies dep_or_name, version

    @installed_gems = []

    options = {
      bin_dir: @bin_dir,
      build_args: @build_args,
      document: @document,
      env_shebang: @env_shebang,
      force: @force,
      format_executable: @format_executable,
      ignore_dependencies: @ignore_dependencies,
      prerelease: @prerelease,
      security_policy: @security_policy,
      user_install: @user_install,
      wrappers: @wrappers,
      build_root: @build_root,
      install_as_default: @install_as_default,
      dir_mode: @dir_mode,
      data_mode: @data_mode,
      prog_mode: @prog_mode,
    }
    options[:install_dir] = @install_dir if @only_install_dir

    request_set.install options do |_, installer|
      @installed_gems << installer.spec if installer
    end

    @installed_gems.sort!

    # Since this is currently only called for docs, we can be lazy and just say
    # it's documentation. Ideally the hook adder could decide whether to be in
    # the background or not, and what to call it.
    in_background "Installing documentation" do
      Gem.done_installing_hooks.each do |hook|
        hook.call self, @installed_gems
      end
    end unless Gem.done_installing_hooks.empty?

    @installed_gems
  end

  def install_development_deps # :nodoc:
    if @development && @dev_shallow
      :shallow
    elsif @development
      :all
    else
      :none
    end
  end

  def resolve_dependencies(dep_or_name, version) # :nodoc:
    request_set = Gem::RequestSet.new
    request_set.development         = @development
    request_set.development_shallow = @dev_shallow
    request_set.soft_missing = @force
    request_set.prerelease = @prerelease

    installer_set = Gem::Resolver::InstallerSet.new @domain
    installer_set.ignore_installed = (@minimal_deps == false) || @only_install_dir
    installer_set.force = @force

    if consider_local?
      if dep_or_name =~ /\.gem$/ && File.file?(dep_or_name)
        src = Gem::Source::SpecificFile.new dep_or_name
        installer_set.add_local dep_or_name, src.spec, src
        version = src.spec.version if version == Gem::Requirement.default
      elsif dep_or_name =~ /\.gem$/ # rubocop:disable Performance/RegexpMatch
        Dir[dep_or_name].each do |name|
          src = Gem::Source::SpecificFile.new name
          installer_set.add_local dep_or_name, src.spec, src
        rescue Gem::Package::FormatError
        end
        # else This is a dependency. InstallerSet handles this case
      end
    end

    dependency =
      if spec = installer_set.local?(dep_or_name)
        installer_set.remote = nil if spec.dependencies.none?
        Gem::Dependency.new spec.name, version
      elsif String === dep_or_name
        Gem::Dependency.new dep_or_name, version
      else
        dep_or_name
      end

    dependency.prerelease = @prerelease

    request_set.import [dependency]

    installer_set.add_always_install dependency

    request_set.always_install = installer_set.always_install
    request_set.remote = installer_set.consider_remote?

    if @ignore_dependencies
      installer_set.ignore_dependencies = true
      request_set.ignore_dependencies   = true
      request_set.soft_missing          = true
    end

    request_set.resolve installer_set

    @errors.concat request_set.errors

    request_set
  end
end

Directory Contents

Dirs: 15 × Files: 71

Name Size Perms Modified Actions
commands DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
core_ext DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
defaults DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
ext DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
package DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
request DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
resolver DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
security DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
source DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
ssl_certs DIR
- drwxr-xr-x 2026-04-07 13:52:12
Edit Download
util DIR
- drwxr-xr-x 2026-04-30 07:09:22
Edit Download
vendor DIR
- drwxr-xr-x 2026-04-07 13:52:11
Edit Download
3.00 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
8.17 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.96 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
3.71 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
15.97 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.64 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1022 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
15.79 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
7.35 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
8.45 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
9.91 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.55 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.04 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
3.13 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
4.53 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
7.33 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
498 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
11.17 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
394 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.89 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
27.68 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
771 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
349 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
323 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
6.39 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
3.61 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.38 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
125 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
18.83 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
3.79 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.77 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
8.35 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
795 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
8.50 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
232 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
9.38 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
8.70 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
11.29 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
7.00 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
9.44 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.96 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.92 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.04 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
21.69 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.06 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
66 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.78 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.42 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
69.10 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
15.59 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
5.21 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
6.16 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
4.96 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.06 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
10.94 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
411 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
1.85 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.38 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
784 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
13.10 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.46 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
3.63 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
81 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
233 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
79 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
111 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
228 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
73 B lrw-r--r-- 2026-04-07 13:52:24
Edit Download
12.98 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.17 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download
2.42 KB lrw-r--r-- 2026-04-07 13:52:24
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).