class Bundler::Source::Rubygems

Constants

API_REQUEST_SIZE

Ask for X gems per API request

Attributes

remotes[RW]

Public Class Methods

from_lock(options) click to toggle source
# File bundler/source/rubygems.rb, line 94
def self.from_lock(options)
  options["remotes"] = Array(options.delete("remote")).reverse
  new(options.merge("from_lockfile" => true))
end
new(options = {}) click to toggle source
# File bundler/source/rubygems.rb, line 15
def initialize(options = {})
  @options = options
  @remotes = []
  @dependency_names = []
  @allow_remote = false
  @allow_cached = false
  @allow_local = options["allow_local"] || false
  @checksum_store = Checksum::Store.new

  Array(options["remotes"]).reverse_each {|r| add_remote(r) }

  @lockfile_remotes = @remotes if options["from_lockfile"]
end

Public Instance Methods

==(other)
Alias for: eql?
add_remote(source) click to toggle source
# File bundler/source/rubygems.rb, line 239
def add_remote(source)
  uri = normalize_uri(source)
  @remotes.unshift(uri) unless @remotes.include?(uri)
end
cache(spec, custom_path = nil) click to toggle source
# File bundler/source/rubygems.rb, line 214
def cache(spec, custom_path = nil)
  cached_path = Bundler.settings[:cache_all_platforms] ? fetch_gem_if_possible(spec) : cached_gem(spec)
  raise GemNotFound, "Missing gem file '#{spec.file_name}'." unless cached_path
  return if File.dirname(cached_path) == Bundler.app_cache.to_s
  Bundler.ui.info "  * #{File.basename(cached_path)}"
  FileUtils.cp(cached_path, Bundler.app_cache(custom_path))
rescue Errno::EACCES => e
  Bundler.ui.debug(e)
  raise InstallError, e.message
end
cached!() click to toggle source
# File bundler/source/rubygems.rb, line 54
def cached!
  return unless File.exist?(cache_path)

  return if @allow_cached

  @specs = nil
  @allow_cached = true
end
cached_built_in_gem(spec, local: false) click to toggle source
# File bundler/source/rubygems.rb, line 225
def cached_built_in_gem(spec, local: false)
  cached_path = cached_gem(spec)
  if cached_path.nil? && !local
    remote_spec = remote_specs.search(spec).first
    if remote_spec
      cached_path = fetch_gem(remote_spec)
      spec.remote = remote_spec.remote
    else
      Bundler.ui.warn "#{spec.full_name} is built in to Ruby, and can't be cached because your Gemfile doesn't have any sources that contain it."
    end
  end
  cached_path
end
caches() click to toggle source
# File bundler/source/rubygems.rb, line 29
def caches
  @caches ||= [cache_path, *Bundler.rubygems.gem_cache]
end
can_lock?(spec) click to toggle source
Calls superclass method Bundler::Source#can_lock?
# File bundler/source/rubygems.rb, line 85
def can_lock?(spec)
  return super unless multiple_remotes?
  include?(spec.source)
end
dependency_api_available?() click to toggle source
# File bundler/source/rubygems.rb, line 306
def dependency_api_available?
  @allow_remote && api_fetchers.any?
end
dependency_names_to_double_check() click to toggle source
# File bundler/source/rubygems.rb, line 291
def dependency_names_to_double_check
  names = []
  remote_specs.each do |spec|
    case spec
    when EndpointSpecification, Gem::Specification, StubSpecification, LazySpecification
      names.concat(spec.runtime_dependencies.map(&:name))
    when RemoteSpecification # from the full index
      return nil
    else
      raise "unhandled spec type (#{spec.inspect})"
    end
  end
  names
end
double_check_for(unmet_dependency_names) click to toggle source
# File bundler/source/rubygems.rb, line 271
def double_check_for(unmet_dependency_names)
  return unless dependency_api_available?

  unmet_dependency_names = unmet_dependency_names.call
  unless unmet_dependency_names.nil?
    if api_fetchers.size <= 1
      # can't do this when there are multiple fetchers because then we might not fetch from _all_
      # of them
      unmet_dependency_names -= remote_specs.spec_names # avoid re-fetching things we've already gotten
    end
    return if unmet_dependency_names.empty?
  end

  Bundler.ui.debug "Double checking for #{unmet_dependency_names || "all specs (due to the size of the request)"} in #{self}"

  fetch_names(api_fetchers, unmet_dependency_names, remote_specs)

  specs.use remote_specs
end
eql?(other) click to toggle source
# File bundler/source/rubygems.rb, line 67
def eql?(other)
  other.is_a?(Rubygems) && other.credless_remotes == credless_remotes
end
Also aliased as: ==
fetchers() click to toggle source
# File bundler/source/rubygems.rb, line 267
def fetchers
  @fetchers ||= remote_fetchers.values.freeze
end
hash() click to toggle source
# File bundler/source/rubygems.rb, line 63
def hash
  @remotes.hash
end
identifier() click to toggle source
# File bundler/source/rubygems.rb, line 123
def identifier
  if remotes.empty?
    "locally installed gems"
  else
    "rubygems repository #{remote_names}"
  end
end
Also aliased as: name, to_gemfile
include?(o) click to toggle source
# File bundler/source/rubygems.rb, line 73
def include?(o)
  o.is_a?(Rubygems) && (o.credless_remotes - credless_remotes).empty?
end
install(spec, options = {}) click to toggle source
# File bundler/source/rubygems.rb, line 150
def install(spec, options = {})
  if (spec.default_gem? && !cached_built_in_gem(spec, local: options[:local])) || (installed?(spec) && !options[:force])
    print_using_message "Using #{version_message(spec, options[:previous_spec])}"
    return nil # no post-install message
  end

  if spec.remote
    # Check for this spec from other sources
    uris = [spec.remote, *remotes_for_spec(spec)].map(&:anonymized_uri).uniq
    Installer.ambiguous_gems << [spec.name, *uris] if uris.length > 1
  end

  path = fetch_gem_if_possible(spec, options[:previous_spec])
  raise GemNotFound, "Could not find #{spec.file_name} for installation" unless path

  return if Bundler.settings[:no_install]

  install_path = rubygems_dir
  bin_path     = Bundler.system_bindir

  require_relative "../rubygems_gem_installer"

  installer = Bundler::RubyGemsGemInstaller.at(
    path,
    security_policy: Bundler.rubygems.security_policies[Bundler.settings["trust-policy"]],
    install_dir: install_path.to_s,
    bin_dir: bin_path.to_s,
    ignore_dependencies: true,
    wrappers: true,
    env_shebang: true,
    build_args: options[:build_args],
    bundler_extension_cache_path: extension_cache_path(spec)
  )

  if spec.remote
    s = begin
      installer.spec
    rescue Gem::Package::FormatError
      Bundler.rm_rf(path)
      raise
    rescue Gem::Security::Exception => e
      raise SecurityError,
       "The gem #{File.basename(path, ".gem")} can't be installed because " \
       "the security policy didn't allow it, with the message: #{e.message}"
    end

    spec.__swap__(s)
  end

  spec.source.checksum_store.register(spec, installer.gem_checksum)

  message = "Installing #{version_message(spec, options[:previous_spec])}"
  message += " with native extensions" if spec.extensions.any?
  Bundler.ui.confirm message

  installed_spec = installer.install

  spec.full_gem_path = installed_spec.full_gem_path
  spec.loaded_from = installed_spec.loaded_from
  spec.base_dir = installed_spec.base_dir

  spec.post_install_message
end
local!() click to toggle source
# File bundler/source/rubygems.rb, line 40
def local!
  return if @allow_local

  @specs = nil
  @allow_local = true
end
local_only!() click to toggle source
# File bundler/source/rubygems.rb, line 33
def local_only!
  @specs = nil
  @allow_local = true
  @allow_cached = false
  @allow_remote = false
end
multiple_remotes?() click to toggle source
# File bundler/source/rubygems.rb, line 77
def multiple_remotes?
  @remotes.size > 1
end
name()
Alias for: identifier
no_remotes?() click to toggle source
# File bundler/source/rubygems.rb, line 81
def no_remotes?
  @remotes.size == 0
end
options() click to toggle source
# File bundler/source/rubygems.rb, line 90
def options
  { "remotes" => @remotes.map(&:to_s) }
end
remote!() click to toggle source
# File bundler/source/rubygems.rb, line 47
def remote!
  return if @allow_remote

  @specs = nil
  @allow_remote = true
end
remote_fetchers() click to toggle source
# File bundler/source/rubygems.rb, line 260
def remote_fetchers
  @remote_fetchers ||= remotes.to_h do |uri|
    remote = Source::Rubygems::Remote.new(uri)
    [remote, Bundler::Fetcher.new(remote)]
  end.freeze
end
spec_names() click to toggle source
# File bundler/source/rubygems.rb, line 244
def spec_names
  if dependency_api_available?
    remote_specs.spec_names
  else
    []
  end
end
specs() click to toggle source
# File bundler/source/rubygems.rb, line 133
def specs
  @specs ||= begin
    # remote_specs usually generates a way larger Index than the other
    # sources, and large_idx.merge! small_idx is way faster than
    # small_idx.merge! large_idx.
    index = @allow_remote ? remote_specs.dup : Index.new
    index.merge!(cached_specs) if @allow_cached
    index.merge!(installed_specs) if @allow_local

    # complete with default specs, only if not already available in the
    # index through remote, cached, or installed specs
    index.use(default_specs) if @allow_local

    index
  end
end
to_gemfile()
Alias for: identifier
to_lock() click to toggle source
# File bundler/source/rubygems.rb, line 99
def to_lock
  out = String.new("GEM\n")
  lockfile_remotes.reverse_each do |remote|
    out << "  remote: #{remote}\n"
  end
  out << "  specs:\n"
end
to_s() click to toggle source
# File bundler/source/rubygems.rb, line 107
def to_s
  if remotes.empty?
    "locally installed gems"
  elsif @allow_remote && @allow_cached && @allow_local
    "rubygems repository #{remote_names}, cached gems or installed locally"
  elsif @allow_remote && @allow_local
    "rubygems repository #{remote_names} or installed locally"
  elsif @allow_remote
    "rubygems repository #{remote_names}"
  elsif @allow_cached && @allow_local
    "cached gems or installed locally"
  else
    "locally installed gems"
  end
end
unmet_deps() click to toggle source
# File bundler/source/rubygems.rb, line 252
def unmet_deps
  if dependency_api_available?
    remote_specs.unmet_dependency_names
  else
    []
  end
end

Protected Instance Methods

api_fetchers() click to toggle source
# File bundler/source/rubygems.rb, line 392
def api_fetchers
  fetchers.select(&:api_fetcher?)
end
cache_path() click to toggle source
# File bundler/source/rubygems.rb, line 456
def cache_path
  Bundler.app_cache
end
cached_gem(spec) click to toggle source
# File bundler/source/rubygems.rb, line 327
def cached_gem(spec)
  global_cache_path = download_cache_path(spec)
  caches << global_cache_path if global_cache_path

  possibilities = caches.map {|p| package_path(p, spec) }
  possibilities.find {|p| File.exist?(p) }
end
cached_specs() click to toggle source
# File bundler/source/rubygems.rb, line 378
def cached_specs
  @cached_specs ||= begin
    idx = Index.new

    Dir["#{cache_path}/*.gem"].each do |gemfile|
      s ||= Bundler.rubygems.spec_from_gem(gemfile)
      s.source = self
      idx << s
    end

    idx
  end
end
credless_remotes() click to toggle source
# File bundler/source/rubygems.rb, line 316
def credless_remotes
  remotes.map(&method(:remove_auth))
end
default_cache_path_for(dir) click to toggle source
# File bundler/source/rubygems.rb, line 452
def default_cache_path_for(dir)
  "#{dir}/cache"
end
default_specs() click to toggle source
# File bundler/source/rubygems.rb, line 369
def default_specs
  @default_specs ||= Index.build do |idx|
    Bundler.rubygems.default_specs.each do |spec|
      spec.source = self
      idx << spec
    end
  end
end
fetch_gem(spec, previous_spec = nil) click to toggle source
# File bundler/source/rubygems.rb, line 429
def fetch_gem(spec, previous_spec = nil)
  spec.fetch_platform

  cache_path = download_cache_path(spec) || default_cache_path_for(rubygems_dir)
  gem_path = package_path(cache_path, spec)
  return gem_path if File.exist?(gem_path)

  SharedHelpers.filesystem_access(cache_path) do |p|
    FileUtils.mkdir_p(p)
  end
  download_gem(spec, cache_path, previous_spec)

  gem_path
end
fetch_gem_if_possible(spec, previous_spec = nil) click to toggle source
# File bundler/source/rubygems.rb, line 421
def fetch_gem_if_possible(spec, previous_spec = nil)
  if spec.remote
    fetch_gem(spec, previous_spec)
  else
    cached_gem(spec)
  end
end
fetch_names(fetchers, dependency_names, index) click to toggle source
# File bundler/source/rubygems.rb, line 408
def fetch_names(fetchers, dependency_names, index)
  fetchers.each do |f|
    if dependency_names
      Bundler.ui.info "Fetching gem metadata from #{URICredentialsFilter.credential_filtered_uri(f.uri)}", Bundler.ui.debug?
      index.use f.specs_with_retry(dependency_names, self)
      Bundler.ui.info "" unless Bundler.ui.debug? # new line now that the dots are over
    else
      Bundler.ui.info "Fetching source index from #{URICredentialsFilter.credential_filtered_uri(f.uri)}"
      index.use f.specs_with_retry(nil, self)
    end
  end
end
installed?(spec) click to toggle source
# File bundler/source/rubygems.rb, line 444
def installed?(spec)
  installed_specs[spec].any? && !spec.deleted_gem?
end
installed_specs() click to toggle source
# File bundler/source/rubygems.rb, line 356
def installed_specs
  @installed_specs ||= Index.build do |idx|
    Bundler.rubygems.installed_specs.reverse_each do |spec|
      spec.source = self
      if Bundler.rubygems.spec_missing_extensions?(spec, false)
        Bundler.ui.debug "Source #{self} is ignoring #{spec} because it is missing extensions"
        next
      end
      idx << spec
    end
  end
end
normalize_uri(uri) click to toggle source
# File bundler/source/rubygems.rb, line 339
def normalize_uri(uri)
  uri = URINormalizer.normalize_suffix(uri.to_s)
  require_relative "../vendored_uri"
  uri = Gem::URI(uri)
  raise ArgumentError, "The source must be an absolute URI. For example:\n" \
    "source 'https://rubygems.org'" if !uri.absolute? || (uri.is_a?(Gem::URI::HTTP) && uri.host.nil?)
  uri
end
package_path(cache_path, spec) click to toggle source
# File bundler/source/rubygems.rb, line 335
def package_path(cache_path, spec)
  "#{cache_path}/#{spec.file_name}"
end
remote_names() click to toggle source
# File bundler/source/rubygems.rb, line 312
def remote_names
  remotes.map(&:to_s).join(", ")
end
remote_specs() click to toggle source
# File bundler/source/rubygems.rb, line 396
def remote_specs
  @remote_specs ||= Index.build do |idx|
    index_fetchers = fetchers - api_fetchers

    if index_fetchers.empty?
      fetch_names(api_fetchers, dependency_names, idx)
    else
      fetch_names(fetchers, nil, idx)
    end
  end
end
remotes_for_spec(spec) click to toggle source
# File bundler/source/rubygems.rb, line 320
def remotes_for_spec(spec)
  specs.search_all(spec.name).inject([]) do |uris, s|
    uris << s.remote if s.remote
    uris
  end
end
remove_auth(remote) click to toggle source
# File bundler/source/rubygems.rb, line 348
def remove_auth(remote)
  if remote.user || remote.password
    remote.dup.tap {|uri| uri.user = uri.password = nil }.to_s
  else
    remote.to_s
  end
end
rubygems_dir() click to toggle source
# File bundler/source/rubygems.rb, line 448
def rubygems_dir
  Bundler.bundle_path
end

Private Instance Methods

download_cache_path(spec) click to toggle source

Returns the global cache path of the calling Rubygems::Source object.

Note that the Source determines the path’s subdirectory. We use this subdirectory in the global cache path so that gems with the same name – and possibly different versions – from different sources are saved to their respective subdirectories and do not override one another.

@param [Gem::Specification] specification

@return [Pathname] The global cache path.

# File bundler/source/rubygems.rb, line 496
def download_cache_path(spec)
  return unless Bundler.feature_flag.global_gem_cache?
  return unless remote = spec.remote
  return unless cache_slug = remote.cache_slug

  Bundler.user_cache.join("gems", cache_slug)
end
download_gem(spec, download_cache_path, previous_spec = nil) click to toggle source

Checks if the requested spec exists in the global cache. If it does, we copy it to the download path, and if it does not, we download it.

@param [Specification] spec

the spec we want to download or retrieve from the cache.

@param [String] download_cache_path

the local directory the .gem will end up in.

@param [Specification] previous_spec

the spec previously locked
# File bundler/source/rubygems.rb, line 478
def download_gem(spec, download_cache_path, previous_spec = nil)
  uri = spec.remote.uri
  Bundler.ui.confirm("Fetching #{version_message(spec, previous_spec)}")
  gem_remote_fetcher = remote_fetchers.fetch(spec.remote).gem_remote_fetcher
  Bundler.rubygems.download_gem(spec, uri, download_cache_path, gem_remote_fetcher)
end
extension_cache_slug(spec) click to toggle source
# File bundler/source/rubygems.rb, line 504
def extension_cache_slug(spec)
  return unless remote = spec.remote
  remote.cache_slug
end
lockfile_remotes() click to toggle source
# File bundler/source/rubygems.rb, line 462
def lockfile_remotes
  @lockfile_remotes || credless_remotes
end