class Bundler::Source::Rubygems
Constants
- API_REQUEST_LIMIT
Use the API when installing less than X gems
- API_REQUEST_SIZE
Ask for X gems per API request
Attributes
caches[R]
remotes[R]
Public Class Methods
from_lock(options)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 88 def self.from_lock(options) new(options) end
new(options = {})
click to toggle source
# File lib/bundler/source/rubygems.rb, line 16 def initialize(options = {}) @options = options @remotes = [] @dependency_names = [] @allow_remote = false @allow_cached = false @allow_local = options["allow_local"] || false @caches = [cache_path, *Bundler.rubygems.gem_cache] Array(options["remotes"]).reverse_each {|r| add_remote(r) } end
Public Instance Methods
add_remote(source)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 263 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 lib/bundler/source/rubygems.rb, line 239 def cache(spec, custom_path = nil) cached_path = 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 lib/bundler/source/rubygems.rb, line 49 def cached! return if @allow_cached @specs = nil @allow_local = true @allow_cached = true end
cached_built_in_gem(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 250 def cached_built_in_gem(spec) cached_path = cached_path(spec) if cached_path.nil? remote_spec = remote_specs.search(spec).first if remote_spec cached_path = fetch_gem(remote_spec) 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
can_lock?(spec)
click to toggle source
Calls superclass method
Bundler::Source#can_lock?
# File lib/bundler/source/rubygems.rb, line 79 def can_lock?(spec) return super unless multiple_remotes? include?(spec.source) end
dependency_api_available?()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 325 def dependency_api_available? api_fetchers.any? end
dependency_names_to_double_check()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 310 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 lib/bundler/source/rubygems.rb, line 291 def double_check_for(unmet_dependency_names) return unless @allow_remote 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, specs, false) end
eql?(other)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 61 def eql?(other) other.is_a?(Rubygems) && other.credless_remotes == credless_remotes end
Also aliased as: ==
fetchers()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 284 def fetchers @fetchers ||= remotes.map do |uri| remote = Source::Rubygems::Remote.new(uri) Bundler::Fetcher.new(remote) end end
hash()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 57 def hash @remotes.hash end
identifier()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 116 def identifier if remotes.empty? "locally installed gems" else "rubygems repository #{remote_names}" end end
Also aliased as: name
include?(o)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 67 def include?(o) o.is_a?(Rubygems) && (o.credless_remotes - credless_remotes).empty? end
install(spec, opts = {})
click to toggle source
# File lib/bundler/source/rubygems.rb, line 137 def install(spec, opts = {}) force = opts[:force] ensure_builtin_gems_cached = opts[:ensure_builtin_gems_cached] if ensure_builtin_gems_cached && spec.default_gem? if !cached_path(spec) cached_built_in_gem(spec) unless spec.remote force = true else spec.loaded_from = loaded_from(spec) end end if installed?(spec) && !force print_using_message "Using #{version_message(spec)}" return nil # no post-install message end # Download the gem to get the spec, because some specs that are returned # by rubygems.org are broken and wrong. if spec.remote # Check for this spec from other sources uris = [spec.remote.anonymized_uri] uris += remotes_for_spec(spec).map(&:anonymized_uri) uris.uniq! Installer.ambiguous_gems << [spec.name, *uris] if uris.length > 1 path = fetch_gem(spec) begin s = Bundler.rubygems.spec_from_gem(path, Bundler.settings["trust-policy"]) spec.__swap__(s) rescue Gem::Package::FormatError Bundler.rm_rf(path) raise end end unless Bundler.settings[:no_install] message = "Installing #{version_message(spec)}" message += " with native extensions" if spec.extensions.any? Bundler.ui.confirm message path = cached_gem(spec) raise GemNotFound, "Could not find #{spec.file_name} for installation" unless path if requires_sudo? install_path = Bundler.tmp(spec.full_name) bin_path = install_path.join("bin") else install_path = rubygems_dir bin_path = Bundler.system_bindir end Bundler.mkdir_p bin_path, :no_sudo => true unless spec.executables.empty? || Bundler.rubygems.provides?(">= 2.7.5") require_relative "../rubygems_gem_installer" installed_spec = Bundler::RubyGemsGemInstaller.at( path, :install_dir => install_path.to_s, :bin_dir => bin_path.to_s, :ignore_dependencies => true, :wrappers => true, :env_shebang => true, :build_args => opts[:build_args], :bundler_expected_checksum => spec.respond_to?(:checksum) && spec.checksum, :bundler_extension_cache_path => extension_cache_path(spec) ).install spec.full_gem_path = installed_spec.full_gem_path # SUDO HAX if requires_sudo? Bundler.rubygems.repository_subdirectories.each do |name| src = File.join(install_path, name, "*") dst = File.join(rubygems_dir, name) if name == "extensions" && Dir.glob(src).any? src = File.join(src, "*/*") ext_src = Dir.glob(src).first ext_src.gsub!(src[0..-6], "") dst = File.dirname(File.join(dst, ext_src)) end SharedHelpers.filesystem_access(dst) do |p| Bundler.mkdir_p(p) end Bundler.sudo "cp -R #{src} #{dst}" if Dir[src].any? end spec.executables.each do |exe| SharedHelpers.filesystem_access(Bundler.system_bindir) do |p| Bundler.mkdir_p(p) end Bundler.sudo "cp -R #{install_path}/bin/#{exe} #{Bundler.system_bindir}/" end end installed_spec.loaded_from = loaded_from(spec) end spec.loaded_from = loaded_from(spec) spec.post_install_message ensure Bundler.rm_rf(install_path) if requires_sudo? end
local!()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 35 def local! return if @allow_local @specs = nil @allow_local = true end
local_only!()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 28 def local_only! @specs = nil @allow_local = true @allow_cached = false @allow_remote = false end
multiple_remotes?()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 71 def multiple_remotes? @remotes.size > 1 end
no_remotes?()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 75 def no_remotes? @remotes.size == 0 end
options()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 84 def options { "remotes" => @remotes.map(&:to_s) } end
remote!()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 42 def remote! return if @allow_remote @specs = nil @allow_remote = true end
spec_names()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 268 def spec_names if @allow_remote && dependency_api_available? remote_specs.spec_names else [] end end
specs()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 125 def specs @specs ||= begin # remote_specs usually generates a way larger Index than the other # sources, and large_idx.use small_idx is way faster than # small_idx.use large_idx. idx = @allow_remote ? remote_specs.dup : Index.new idx.use(cached_specs, :override_dupes) if @allow_cached || @allow_remote idx.use(installed_specs, :override_dupes) if @allow_local idx end end
to_lock()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 92 def to_lock out = String.new("GEM\n") remotes.reverse_each do |remote| out << " remote: #{suppress_configured_credentials remote}\n" end out << " specs:\n" end
to_s()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 100 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 lib/bundler/source/rubygems.rb, line 276 def unmet_deps if @allow_remote && dependency_api_available? remote_specs.unmet_dependency_names else [] end end
Protected Instance Methods
api_fetchers()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 425 def api_fetchers fetchers.select {|f| f.use_api && f.fetchers.first.api_fetcher? } end
cache_path()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 508 def cache_path Bundler.app_cache end
cached_gem(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 354 def cached_gem(spec) if spec.default_gem? cached_built_in_gem(spec) else cached_path(spec) end end
cached_path(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 362 def cached_path(spec) global_cache_path = download_cache_path(spec) @caches << global_cache_path if global_cache_path possibilities = @caches.map {|p| "#{p}/#{spec.file_name}" } possibilities.find {|p| File.exist?(p) } end
cached_specs()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 410 def cached_specs @cached_specs ||= begin idx = @allow_local ? installed_specs.dup : Index.new Dir["#{cache_path}/*.gem"].each do |gemfile| next if gemfile =~ /^bundler\-[\d\.]+?\.gem/ s ||= Bundler.rubygems.spec_from_gem(gemfile) s.source = self idx << s end idx end end
credless_remotes()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 335 def credless_remotes if Bundler.settings[:allow_deployment_source_credential_changes] remotes.map(&method(:remove_auth)) else remotes.map(&method(:suppress_configured_credentials)) end end
default_cache_path_for(dir)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 504 def default_cache_path_for(dir) "#{dir}/cache" end
fetch_gem(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 460 def fetch_gem(spec) return false unless spec.remote spec.fetch_platform cache_path = download_cache_path(spec) || default_cache_path_for(rubygems_dir) gem_path = "#{cache_path}/#{spec.file_name}" if requires_sudo? download_path = Bundler.tmp(spec.full_name) download_cache_path = default_cache_path_for(download_path) else download_cache_path = cache_path end SharedHelpers.filesystem_access(download_cache_path) do |p| FileUtils.mkdir_p(p) end download_gem(spec, download_cache_path) if requires_sudo? SharedHelpers.filesystem_access(cache_path) do |p| Bundler.mkdir_p(p) end Bundler.sudo "mv #{download_cache_path}/#{spec.file_name} #{gem_path}" end gem_path ensure Bundler.rm_rf(download_path) if requires_sudo? end
fetch_names(fetchers, dependency_names, index, override_dupes)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 447 def fetch_names(fetchers, dependency_names, index, override_dupes) 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), override_dupes 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), override_dupes end end end
installed?(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 492 def installed?(spec) installed_specs[spec].any? && !spec.deleted_gem? end
installed_specs()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 397 def installed_specs @installed_specs ||= Index.build do |idx| Bundler.rubygems.all_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
loaded_from(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 350 def loaded_from(spec) "#{rubygems_dir}/specifications/#{spec.full_name}.gemspec" end
normalize_uri(uri)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 370 def normalize_uri(uri) uri = uri.to_s uri = "#{uri}/" unless uri =~ %r{/$} require_relative "../vendored_uri" uri = Bundler::URI(uri) raise ArgumentError, "The source must be an absolute URI. For example:\n" \ "source 'https://rubygems.org'" if !uri.absolute? || (uri.is_a?(Bundler::URI::HTTP) && uri.host.nil?) uri end
remote_names()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 331 def remote_names remotes.map(&:to_s).join(", ") end
remote_specs()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 429 def remote_specs @remote_specs ||= Index.build do |idx| index_fetchers = fetchers - api_fetchers # gather lists from non-api sites fetch_names(index_fetchers, nil, idx, false) # because ensuring we have all the gems we need involves downloading # the gemspecs of those gems, if the non-api sites contain more than # about 500 gems, we treat all sites as non-api for speed. allow_api = idx.size < API_REQUEST_LIMIT && dependency_names.size < API_REQUEST_LIMIT Bundler.ui.debug "Need to query more than #{API_REQUEST_LIMIT} gems." \ " Downloading full index instead..." unless allow_api fetch_names(api_fetchers, allow_api && dependency_names, idx, false) end end
remotes_for_spec(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 343 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 lib/bundler/source/rubygems.rb, line 389 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
requires_sudo?()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 496 def requires_sudo? Bundler.requires_sudo? end
rubygems_dir()
click to toggle source
# File lib/bundler/source/rubygems.rb, line 500 def rubygems_dir Bundler.rubygems.gem_dir end
suppress_configured_credentials(remote)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 380 def suppress_configured_credentials(remote) remote_nouser = remove_auth(remote) if remote.userinfo && remote.userinfo == Bundler.settings[remote_nouser] remote_nouser else remote end 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 lib/bundler/source/rubygems.rb, line 540 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)
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.
# File lib/bundler/source/rubygems.rb, line 523 def download_gem(spec, download_cache_path) uri = spec.remote.uri Bundler.ui.confirm("Fetching #{version_message(spec)}") Bundler.rubygems.download_gem(spec, uri, download_cache_path) end
extension_cache_slug(spec)
click to toggle source
# File lib/bundler/source/rubygems.rb, line 548 def extension_cache_slug(spec) return unless remote = spec.remote remote.cache_slug end