Class: Bundler::Source::Rubygems
Relationships & Source Files | |
Namespace Children | |
Classes:
| |
Extension / Inclusion / Inheritance Descendants | |
Subclasses:
|
|
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
::Bundler::Source
|
|
Instance Chain:
self,
::Bundler::Source
|
|
Inherits: |
Bundler::Source
|
Defined in: | lib/bundler/source/rubygems.rb, lib/bundler/source/rubygems/remote.rb |
Constant Summary
-
API_REQUEST_LIMIT =
Use the API when installing less than X gems
500
-
API_REQUEST_SIZE =
Ask for X gems per API request
50
Class Method Summary
- .from_lock(options)
- .new(options = {}) ⇒ Rubygems constructor
Instance Attribute Summary
- #caches readonly
- #dependency_api_available? ⇒ Boolean readonly
- #multiple_remotes? ⇒ Boolean readonly
- #no_remotes? ⇒ Boolean readonly
- #remotes readonly
- #requires_sudo? ⇒ Boolean readonly protected
::Bundler::Source
- Inherited
Instance Method Summary
-
#==(other)
Alias for #eql?.
- #add_remote(source)
- #cache(spec, custom_path = nil)
- #cached!
- #cached_built_in_gem(spec)
- #can_lock?(spec) ⇒ Boolean
- #dependency_names_to_double_check
- #double_check_for(unmet_dependency_names)
- #eql?(other) ⇒ Boolean (also: #==)
- #fetchers
- #hash
- #identifier (also: #name)
- #include?(o) ⇒ Boolean
- #install(spec, opts = {})
- #local!
- #local_only!
-
#name
Alias for #identifier.
- #options
- #remote!
- #spec_names
- #specs
- #to_lock
- #to_s
- #unmet_deps
- #api_fetchers protected
- #cache_path protected
- #cached_gem(spec) protected
- #cached_path(spec) protected
- #cached_specs protected
- #credless_remotes protected
- #default_cache_path_for(dir) protected
- #fetch_gem(spec) protected
- #fetch_names(fetchers, dependency_names, index, override_dupes) protected
- #installed?(spec) ⇒ Boolean protected
- #installed_specs protected
- #loaded_from(spec) protected
- #normalize_uri(uri) protected
- #remote_names protected
- #remote_specs protected
- #remotes_for_spec(spec) protected
- #remove_auth(remote) protected
- #rubygems_dir protected
- #suppress_configured_credentials(remote) protected
-
#download_cache_path(spec) ⇒ Pathname
private
Returns the global cache path of the calling
Rubygems::Source
object. -
#download_gem(spec, download_cache_path)
private
Checks if the requested spec exists in the global cache.
- #extension_cache_slug(spec) private
::Bundler::Source
- Inherited
#add_dependency_names, #cached!, #can_lock?, #dependency_names_to_double_check, | |
#double_check_for | it’s possible that gems from one source depend on gems from some other source, so now we download gemspecs and iterate over those dependencies, looking for gems we don’t have info on yet. |
#extension_cache_path, #identifier, #include?, #inspect, #local!, #local_only!, #remote!, #spec_names, #unmet_deps, #version_message, #earlier_version?, #extension_cache_slug, #print_using_message, #version_color |
Constructor Details
.new(options = {}) ⇒ Rubygems
# File 'lib/bundler/source/rubygems.rb', line 17
def initialize( = {}) @options = @remotes = [] @dependency_names = [] @allow_remote = false @allow_cached = false @allow_local = ["allow_local"] || false @caches = [cache_path, *Bundler.rubygems.gem_cache] Array( ["remotes"]).reverse_each {|r| add_remote(r) } end
Class Method Details
.from_lock(options)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 89
def self.from_lock( ) new( ) end
Instance Attribute Details
#caches (readonly)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 15
attr_reader :remotes, :caches
#dependency_api_available? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/bundler/source/rubygems.rb', line 326
def dependency_api_available? api_fetchers.any? end
#multiple_remotes? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/bundler/source/rubygems.rb', line 72
def multiple_remotes? @remotes.size > 1 end
#no_remotes? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/bundler/source/rubygems.rb', line 76
def no_remotes? @remotes.size == 0 end
#remotes (readonly)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 15
attr_reader :remotes, :caches
#requires_sudo? ⇒ Boolean
(readonly, protected)
[ GitHub ]
# File 'lib/bundler/source/rubygems.rb', line 497
def requires_sudo? Bundler.requires_sudo? end
Instance Method Details
#==(other)
Alias for #eql?.
# File 'lib/bundler/source/rubygems.rb', line 66
alias_method :==, :eql?
#add_remote(source)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 264
def add_remote(source) uri = normalize_uri(source) @remotes.unshift(uri) unless @remotes.include?(uri) end
#api_fetchers (protected)
[ GitHub ]#cache(spec, custom_path = nil)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 240
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. end
#cache_path (protected)
[ GitHub ]#cached!
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 50
def cached! return if @allow_cached @specs = nil @allow_local = true @allow_cached = true end
#cached_built_in_gem(spec)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 251
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
#cached_gem(spec) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 355
def cached_gem(spec) if spec.default_gem? cached_built_in_gem(spec) else cached_path(spec) end end
#cached_path(spec) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 363
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 (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 411
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
#can_lock?(spec) ⇒ Boolean
# File 'lib/bundler/source/rubygems.rb', line 80
def can_lock?(spec) return super unless multiple_remotes? include?(spec.source) end
#credless_remotes (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 336
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) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 505
def default_cache_path_for(dir) "#{dir}/cache" end
#dependency_names_to_double_check
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 311
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)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 292
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
#download_cache_path(spec) ⇒ Pathname
(private)
Returns the global cache path of the calling Rubygems::Source
object.
Note that the ::Bundler::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.
# File 'lib/bundler/source/rubygems.rb', line 541
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) (private)
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.
# File 'lib/bundler/source/rubygems.rb', line 524
def download_gem(spec, download_cache_path) uri = spec.remote.uri Bundler.ui.confirm("Fetching #{ (spec)}") Bundler.rubygems.download_gem(spec, uri, download_cache_path) end
#eql?(other) ⇒ Boolean
Also known as: #==
# File 'lib/bundler/source/rubygems.rb', line 62
def eql?(other) other.is_a?(Rubygems) && other.credless_remotes == credless_remotes end
#extension_cache_slug(spec) (private)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 549
def extension_cache_slug(spec) return unless remote = spec.remote remote.cache_slug end
#fetch_gem(spec) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 461
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) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 448
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
#fetchers
[ GitHub ]#hash
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 58
def hash @remotes.hash end
#identifier Also known as: #name
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 117
def identifier if remotes.empty? "locally installed gems" else "rubygems repository #{remote_names}" end end
#include?(o) ⇒ Boolean
# File 'lib/bundler/source/rubygems.rb', line 68
def include?(o) o.is_a?(Rubygems) && (o.credless_remotes - credless_remotes).empty? end
#install(spec, opts = {})
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 138
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 "Using #{ (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] = "Installing #{ (spec)}" += " with native extensions" if spec.extensions.any? Bundler.ui.confirm 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. ensure Bundler.rm_rf(install_path) if requires_sudo? end
#installed?(spec) ⇒ Boolean
(protected)
# File 'lib/bundler/source/rubygems.rb', line 493
def installed?(spec) installed_specs[spec].any? && !spec.deleted_gem? end
#installed_specs (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 398
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) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 351
def loaded_from(spec) "#{rubygems_dir}/specifications/#{spec.full_name}.gemspec" end
#local!
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 36
def local! return if @allow_local @specs = nil @allow_local = true end
#local_only!
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 29
def local_only! @specs = nil @allow_local = true @allow_cached = false @allow_remote = false end
#name
Alias for #identifier.
# File 'lib/bundler/source/rubygems.rb', line 124
alias_method :name, :identifier
#normalize_uri(uri) (protected)
# File 'lib/bundler/source/rubygems.rb', line 371
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
#options
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 85
def { "remotes" => @remotes.map(&:to_s) } end
#remote!
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 43
def remote! return if @allow_remote @specs = nil @allow_remote = true end
#remote_names (protected)
[ GitHub ]#remote_specs (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 430
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) (protected)
[ GitHub ]#remove_auth(remote) (protected)
[ GitHub ]#rubygems_dir (protected)
[ GitHub ]#spec_names
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 269
def spec_names if @allow_remote && dependency_api_available? remote_specs.spec_names else [] end end
#specs
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 126
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
#suppress_configured_credentials(remote) (protected)
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 381
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
#to_lock
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 93
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
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 101
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
[ GitHub ]# File 'lib/bundler/source/rubygems.rb', line 277
def unmet_deps if @allow_remote && dependency_api_available? remote_specs.unmet_dependency_names else [] end end