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 bundler/source/rubygems.rb, line 89 def self.from_lock(options) new(options) end
new(options = {})
click to toggle source
# File bundler/source/rubygems.rb, line 17 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 bundler/source/rubygems.rb, line 232 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 208 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 50 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 bundler/source/rubygems.rb, line 219 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 bundler/source/rubygems.rb, line 80 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 294 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 279 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 260 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 bundler/source/rubygems.rb, line 62 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 253 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 bundler/source/rubygems.rb, line 58 def hash @remotes.hash end
identifier()
click to toggle source
# File bundler/source/rubygems.rb, line 117 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 bundler/source/rubygems.rb, line 68 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 138 def install(spec, options = {}) force = options[:force] ensure_builtin_gems_cached = options[:ensure_builtin_gems_cached] if ensure_builtin_gems_cached && spec.default_gem? && !cached_path(spec) cached_built_in_gem(spec) unless spec.remote force = true end if installed?(spec) && !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_expected_checksum => spec.respond_to?(:checksum) && spec.checksum, :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 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.post_install_message end
local!()
click to toggle source
# File bundler/source/rubygems.rb, line 36 def local! return if @allow_local @specs = nil @allow_local = true end
local_only!()
click to toggle source
# File bundler/source/rubygems.rb, line 29 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 72 def multiple_remotes? @remotes.size > 1 end
no_remotes?()
click to toggle source
# File bundler/source/rubygems.rb, line 76 def no_remotes? @remotes.size == 0 end
options()
click to toggle source
# File bundler/source/rubygems.rb, line 85 def options { "remotes" => @remotes.map(&:to_s) } end
remote!()
click to toggle source
# File bundler/source/rubygems.rb, line 43 def remote! return if @allow_remote @specs = nil @allow_remote = true end
spec_names()
click to toggle source
# File bundler/source/rubygems.rb, line 237 def spec_names if @allow_remote && dependency_api_available? remote_specs.spec_names else [] end end
specs()
click to toggle source
# File 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
to_lock()
click to toggle source
# File 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()
click to toggle source
# File 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()
click to toggle source
# File bundler/source/rubygems.rb, line 245 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 bundler/source/rubygems.rb, line 393 def api_fetchers fetchers.select {|f| f.use_api && f.fetchers.first.api_fetcher? } end
cache_path()
click to toggle source
# File bundler/source/rubygems.rb, line 463 def cache_path Bundler.app_cache end
cached_gem(spec)
click to toggle source
# File bundler/source/rubygems.rb, line 319 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 bundler/source/rubygems.rb, line 327 def cached_path(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 = @allow_local ? installed_specs.dup : Index.new Dir["#{cache_path}/*.gem"].each do |gemfile| next if /^bundler\-[\d\.]+?\.gem/.match?(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 304 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 bundler/source/rubygems.rb, line 459 def default_cache_path_for(dir) "#{dir}/cache" end
fetch_gem(spec, previous_spec = nil)
click to toggle source
# File bundler/source/rubygems.rb, line 436 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 428 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, override_dupes)
click to toggle source
# File bundler/source/rubygems.rb, line 415 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 bundler/source/rubygems.rb, line 451 def installed?(spec) installed_specs[spec].any? && !spec.deleted_gem? end
installed_specs()
click to toggle source
# File bundler/source/rubygems.rb, line 365 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
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 = 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
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 300 def remote_names remotes.map(&:to_s).join(", ") end
remote_specs()
click to toggle source
# File bundler/source/rubygems.rb, line 397 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 bundler/source/rubygems.rb, line 312 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 357 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 455 def rubygems_dir Bundler.bundle_path end
suppress_configured_credentials(remote)
click to toggle source
# File bundler/source/rubygems.rb, line 348 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