Class: Bundler::Source::Rubygems

### Home Classes Methods

### In Files

- lib/bundler/source/rubygems.rb
- lib/bundler/source/rubygems/remote.rb

### Parent

Bundler::Source

### Namespace

- CLASS Bundler::Source::Rubygems::Remote

### Methods

- ::from_lock
- ::new
- #==
- #add_remote
- #api_fetchers
- #builtin_gem?
- #cache
- #cached!
- #cached_built_in_gem
- #cached_gem
- #cached_path
- #cached_specs
- #can_lock?
- #credless_remotes
- #eql?
- #fetch_gem
- #fetchers
- #hash
- #include?
- #install
- #installed_specs
- #loaded_from
- #name
- #normalize_uri
- #options
- #remote!
- #remote_specs
- #remotes_for_spec
- #replace_remotes
- #specs
- #suppress_configured_credentials
- #to_lock
- #to_s
- #unmet_deps

### Files

- bundle
- bundle-config
- bundle-config.txt
- bundle-exec
- bundle-exec.txt
- bundle-install
- bundle-install.txt
- bundle-package
- bundle-package.txt
- bundle-platform
- bundle-platform.txt
- bundle-update
- bundle-update.txt
- bundle.txt
- gemfile.5.txt
- Executable
- Gemfile

### Class/Module Index

Quicksearch

- Bundler
- Bundler::BundlerError
- Bundler::CLI
- Bundler::CLI::Binstubs
- Bundler::CLI::Cache
- Bundler::CLI::Check
- Bundler::CLI::Clean
- Bundler::CLI::Common
- Bundler::CLI::Config
- Bundler::CLI::Console
- Bundler::CLI::Exec
- Bundler::CLI::Gem
- Bundler::CLI::Init
- Bundler::CLI::Inject
- Bundler::CLI::Install
- Bundler::CLI::Lock
- Bundler::CLI::Open
- Bundler::CLI::Outdated
- Bundler::CLI::Package
- Bundler::CLI::Platform
- Bundler::CLI::Show
- Bundler::CLI::Update
- Bundler::CLI::Viz
- Bundler::CurrentRuby
- Bundler::CyclicDependencyError
- Bundler::Definition
- Bundler::DepProxy
- Bundler::Dependency
- Bundler::Deployment
- Bundler::Deprecate
- Bundler::DeprecatedError
- Bundler::Dsl
- Bundler::Dsl::DSLError
- Bundler::EndpointSpecification
- Bundler::Env
- Bundler::Environment
- Bundler::Fetcher
- Bundler::Fetcher::AuthenticationRequiredError
- Bundler::Fetcher::BadAuthenticationError
- Bundler::Fetcher::Base
- Bundler::Fetcher::CertificateFailureError
- Bundler::Fetcher::Dependency
- Bundler::Fetcher::Downloader
- Bundler::Fetcher::FallbackError
- Bundler::Fetcher::Index
- Bundler::Fetcher::NetworkDownError
- Bundler::Fetcher::SSLError
- Bundler::GemHelper
- Bundler::GemHelpers
- Bundler::GemInstaller
- Bundler::GemNotFound
- Bundler::GemfileError
- Bundler::GemfileLockNotFound
- Bundler::GemfileNotFound
- Bundler::GemspecError
- Bundler::GitError
- Bundler::Graph
- Bundler::Graph::GraphVizClient
- Bundler::HTTPError
- Bundler::Index
- Bundler::Injector
- Bundler::InstallError
- Bundler::InstallHookError
- Bundler::Installer
- Bundler::InvalidOption
- Bundler::LazySpecification
- Bundler::LockfileError
- Bundler::LockfileParser
- Bundler::MarshalError
- Bundler::MatchPlatform
- Bundler::Molinillo
- Bundler::Molinillo::CircularDependencyError
- Bundler::Molinillo::DependencyGraph
- Bundler::Molinillo::DependencyGraph::Vertex
- Bundler::Molinillo::DependencyState
- Bundler::Molinillo::NoSuchDependencyError
- Bundler::Molinillo::PossibilityState
- Bundler::Molinillo::Resolver
- Bundler::Molinillo::Resolver::Resolution
- Bundler::Molinillo::ResolverError
- Bundler::Molinillo::SpecificationProvider
- Bundler::Molinillo::UI
- Bundler::Molinillo::VersionConflict
- Bundler::PathError
- Bundler::ProductionError
- Bundler::RemoteSpecification
- Bundler::Resolver
- Bundler::Resolver::Molinillo
- Bundler::Resolver::Molinillo::VersionConflict
- Bundler::Resolver::SpecGroup
- Bundler::Retry
- Bundler::RubyDsl
- Bundler::RubyVersion
- Bundler::RubyVersionMismatch
- Bundler::RubygemsIntegration
- Bundler::RubygemsIntegration::AlmostModern
- Bundler::RubygemsIntegration::Ancient
- Bundler::RubygemsIntegration::Future
- Bundler::RubygemsIntegration::Gem
- Bundler::RubygemsIntegration::Legacy
- Bundler::RubygemsIntegration::Legacy::Gem::SourceIndex
- Bundler::RubygemsIntegration::Modern
- Bundler::RubygemsIntegration::MoreFuture
- Bundler::RubygemsIntegration::MoreModern
- Bundler::RubygemsIntegration::Transitional
- Bundler::Runtime
- Bundler::SecurityError
- Bundler::Settings
- Bundler::SharedHelpers
- Bundler::SimilarityDetector
- Bundler::Source
- Bundler::Source::Git
- Bundler::Source::Git::GitCommandError
- Bundler::Source::Git::GitNotAllowedError
- Bundler::Source::Git::GitNotInstalledError
- Bundler::Source::Git::GitProxy
- Bundler::Source::Path
- Bundler::Source::Path::Installer
- Bundler::Source::Rubygems
- Bundler::Source::Rubygems::Remote
- Bundler::SourceList
- Bundler::SpecSet
- Bundler::StubSpecification
- Bundler::SystemRubyVersion
- Bundler::Thor
- Bundler::Thor::Actions
- Bundler::Thor::Actions::ClassMethods
- Bundler::Thor::AmbiguousCommandError
- Bundler::Thor::Base
- Bundler::Thor::Base::ClassMethods
- Bundler::Thor::Command
- Bundler::Thor::DynamicCommand
- Bundler::Thor::Error
- Bundler::Thor::Group
- Bundler::Thor::HiddenCommand
- Bundler::Thor::Invocation
- Bundler::Thor::Invocation::ClassMethods
- Bundler::Thor::InvocationError
- Bundler::Thor::LineEditor
- Bundler::Thor::LineEditor::Basic
- Bundler::Thor::LineEditor::Readline
- Bundler::Thor::LineEditor::Readline::PathCompletion
- Bundler::Thor::MalformattedArgumentError
- Bundler::Thor::RakeCompat
- Bundler::Thor::RequiredArgumentMissingError
- Bundler::Thor::Shell
- Bundler::Thor::Shell::Basic
- Bundler::Thor::Shell::Color
- Bundler::Thor::Shell::HTML
- Bundler::Thor::UndefinedCommandError
- Bundler::Thor::UnknownArgumentError
- Bundler::Thor::Util
- Bundler::UI
- Bundler::UI::RGProxy
- Bundler::UI::Shell
- Bundler::UI::Silent
- Bundler::VersionConflict
- Bundler::Worker
- Bundler::Worker::WrappedException
- Gem
- Gem::Dependency
- Gem::Platform
- Gem::Requirement
- Gem::Specification
- Net
- Net::HTTP
- Net::HTTP::Persistent
- Net::HTTP::Persistent::Error
- Net::HTTP::Persistent::SSLReuse
- ParallelInstaller
- ParallelInstaller::SpecInstallation
- Object

No matching classes.

# 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 58
    def self.from_lock(options)
      new(options)
    end

new(options = {}) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 17
    def initialize(options = {})
      @options = options
      @remotes = []
      @dependency_names = []
      @allow_remote = false
      @allow_cached = false
      @caches = [Bundler.app_cache, *Bundler.rubygems.gem_cache]

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

### Public Instance Methods

==(o) click to toggle source
Alias for: eql?
add_remote(source) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 190
    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 166
    def cache(spec, custom_path = nil)
      if builtin_gem?(spec)
        cached_path = cached_built_in_gem(spec)
      else
        cached_path = cached_gem(spec)
      end
      raise GemNotFound, "Missing gem file '#{spec.full_name}.gem'." 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 32
    def cached!
      @allow_cached = true
    end

cached_built_in_gem(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 181
    def cached_built_in_gem(spec)
      cached_path = cached_path(spec)
      if cached_path.nil?
        remote_spec = remote_specs.search(spec).first
        cached_path = fetch_gem(remote_spec)
      end
      cached_path
    end

can_lock?(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 50
    def can_lock?(spec)
      spec.source.is_a?(Rubygems)
    end

eql?(o) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 40
    def eql?(o)
      o.is_a?(Rubygems) && o.credless_remotes == credless_remotes
    end

Also aliased as: ==
fetchers() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 212
    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 36
    def hash
      @remotes.hash
    end

include?(o) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 46
    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 88
    def install(spec, opts = {})
      force = opts[:force]
      ensure_builtin_gems_cached = opts[:ensure_builtin_gems_cached]

      if ensure_builtin_gems_cached && builtin_gem?(spec)
        if !cached_path(spec)
          cached_built_in_gem(spec) unless spec.remote
          force = true
        else
          spec.loaded_from = loaded_from(spec)
        end
      end

      return ["Using #{version_message(spec)}", nil] if installed_specs[spec].any? && !force

      # 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 { |remote| remote.anonymized_uri }
        uris.uniq!
        Installer.ambiguous_gems << [spec.name, *uris] if uris.length > 1

        s = Bundler.rubygems.spec_from_gem(fetch_gem(spec), Bundler.settings["trust-policy"])
        spec.__swap__(s)
      end

      unless Bundler.settings[:no_install]
        path = cached_gem(spec)
        if Bundler.requires_sudo?
          install_path = Bundler.tmp(spec.full_name)
          bin_path     = install_path.join("bin")
        else
          install_path = Bundler.rubygems.gem_dir
          bin_path     = Bundler.system_bindir
        end

        installed_spec = nil
        Bundler.rubygems.preserve_paths do
          installed_spec = Bundler::GemInstaller.new(path,
            :install_dir         => install_path.to_s,
            :bin_dir             => bin_path.to_s,
            :ignore_dependencies => true,
            :wrappers            => true,
            :env_shebang         => true
          ).install
        end

        # SUDO HAX
        if Bundler.requires_sudo?
          Bundler.rubygems.repository_subdirectories.each do |name|
            src = File.join(install_path, name, "*")
            dst = File.join(Bundler.rubygems.gem_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
            Bundler.mkdir_p dst
            Bundler.sudo "cp -R #{src} #{dst}" if Dir[src].any?
          end

          spec.executables.each do |exe|
            Bundler.mkdir_p Bundler.system_bindir
            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)
      ["Installing #{version_message(spec)}", spec.post_install_message]
    ensure
      Bundler.rm_rf(install_path) if Bundler.requires_sudo?
    end

name() click to toggle source
Alias for: to_s
options() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 54
    def options
      { "remotes" => @remotes.map { |r| r.to_s } }
    end

remote!() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 28
    def remote!
      @allow_remote = true
    end

replace_remotes(other_remotes) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 195
    def replace_remotes(other_remotes)
      return false if other_remotes == @remotes

      @remotes = []
      other_remotes.reverse_each do |r|
        add_remote r.to_s
      end
    end

specs() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 76
    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)
        idx
      end
    end

to_lock() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 62
    def to_lock
      out = "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 70
    def to_s
      remote_names = self.remotes.map { |r| r.to_s }.join(', ')
      "rubygems repository #{remote_names}"
    end

Also aliased as: name
unmet_deps() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 204
    def unmet_deps
      if @allow_remote && api_fetchers.any?
        remote_specs.unmet_dependency_names
      else
        []
      end
    end

### Protected Instance Methods

api_fetchers() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 312
    def api_fetchers
      fetchers.select(&:use_api)
    end

builtin_gem?(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 401
    def builtin_gem?(spec)
      # Ruby 2.1, where all included gems have this summary
      return true if spec.summary =~ /is bundled with Ruby/

      # Ruby 2.0, where gemspecs are stored in specifications/default/
      spec.loaded_from && spec.loaded_from.include?("specifications/default/")
    end

cached_gem(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 236
    def cached_gem(spec)
      cached_gem = cached_path(spec)
      unless cached_gem
        raise Bundler::GemNotFound, "Could not find #{spec.file_name} for installation"
      end
      cached_gem
    end

cached_path(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 244
    def cached_path(spec)
      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 296
    def cached_specs
      @cached_specs ||= begin
        idx = installed_specs.dup

        path = Bundler.app_cache
        Dir["#{path}/*.gem"].each do |gemfile|
          next if gemfile =~ /^bundler\-[\d\.]+?\.gem/
          s ||= Bundler.rubygems.spec_from_gem(gemfile)
          s.source = self
          idx << s
        end
      end

      idx
    end

credless_remotes() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 221
    def credless_remotes
      remotes.map(&method(:suppress_configured_credentials))
    end

fetch_gem(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 380
    def fetch_gem(spec)
      return false unless spec.remote
      uri = spec.remote.uri
      spec.fetch_platform

      download_path = Bundler.requires_sudo? ? Bundler.tmp(spec.full_name) : Bundler.rubygems.gem_dir
      gem_path = "#{Bundler.rubygems.gem_dir}/cache/#{spec.full_name}.gem"

      FileUtils.mkdir_p("#{download_path}/cache")
      Bundler.rubygems.download_gem(spec, uri, download_path)

      if Bundler.requires_sudo?
        Bundler.mkdir_p "#{Bundler.rubygems.gem_dir}/cache"
        Bundler.sudo "mv #{download_path}/cache/#{spec.full_name}.gem #{gem_path}"
      end

      gem_path
    ensure
      Bundler.rm_rf(download_path) if Bundler.requires_sudo?
    end

installed_specs() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 266
    def installed_specs
      @installed_specs ||= begin
        idx = Index.new
        have_bundler = false
        Bundler.rubygems.all_specs.reverse.each do |spec|
          next if spec.name == 'bundler' && spec.version.to_s != VERSION
          have_bundler = true if spec.name == 'bundler'
          spec.source = self
          idx << spec
        end

        # Always have bundler locally
        unless have_bundler
         # We're running bundler directly from the source
         # so, let's create a fake gemspec for it (it's a path)
         # gemspec
         bundler = Gem::Specification.new do |s|
           s.name     = 'bundler'
           s.version  = VERSION
           s.platform = Gem::Platform::RUBY
           s.source   = self
           s.authors  = ["bundler team"]
           s.loaded_from = File.expand_path("..", __FILE__)
         end
         idx << bundler
        end
        idx
      end
    end

loaded_from(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 232
    def loaded_from(spec)
      "#{Bundler.rubygems.gem_dir}/specifications/#{spec.full_name}.gemspec"
    end

normalize_uri(uri) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 249
    def normalize_uri(uri)
      uri = uri.to_s
      uri = "#{uri}/" unless uri =~ %/$'
      uri = URI(uri)
      raise ArgumentError, "The source must be an absolute URI" unless uri.absolute?
      uri
    end

remote_specs() click to toggle source

    # File lib/bundler/source/rubygems.rb, line 316
    def remote_specs
      @remote_specs ||= Index.build do |idx|
        index_fetchers = fetchers - api_fetchers

        # gather lists from non-api sites
        index_fetchers.each do |f|
          Bundler.ui.info "Fetching source index from #{f.uri}"
          idx.use f.specs(nil, self)
        end

        # 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 100 gems, we just 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

        if allow_api
          api_fetchers.each do |f|
            Bundler.ui.info "Fetching gem metadata from #{f.uri}", Bundler.ui.debug?
            idx.use f.specs(dependency_names, self)
            Bundler.ui.info "" if !Bundler.ui.debug? # new line now that the dots are over
          end

          # Suppose the gem Foo depends on the gem Bar.  Foo exists in Source A.  Bar has some versions that exist in both
          # sources A and B.  At this point, the API request will have found all the versions of Bar in source A,
          # but will not have found any versions of Bar from source B, which is a problem if the requested version
          # of Foo specifically depends on a version of Bar that is only found in source B. This ensures that for
          # each spec we found, we add all possible versions from all sources to the index.
          begin
            idxcount = idx.size
            api_fetchers.each do |f|
              Bundler.ui.info "Fetching version metadata from #{f.uri}", Bundler.ui.debug?
              idx.use f.specs(idx.dependency_names, self), true
              Bundler.ui.info "" if !Bundler.ui.debug? # new line now that the dots are over
            end
          end until idxcount == idx.size

          if api_fetchers.any?
            # 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.
            unmet = idx.unmet_dependency_names

            # if there are any cross-site gems we missed, get them now
            api_fetchers.each do |f|
              Bundler.ui.info "Fetching dependency metadata from #{f.uri}", Bundler.ui.debug?
              idx.use f.specs(unmet, self)
              Bundler.ui.info "" if !Bundler.ui.debug? # new line now that the dots are over
            end if unmet.any?
          else
            allow_api = false
          end
        end

        unless allow_api
          api_fetchers.each do |f|
            Bundler.ui.info "Fetching source index from #{f.uri}"
            idx.use f.specs(nil, self)
          end
        end
      end
    end

remotes_for_spec(spec) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 225
    def remotes_for_spec(spec)
      specs.search_all(spec.name).inject([]) do |uris, s|
        uris << s.remote if s.remote
        uris
      end
    end

suppress_configured_credentials(remote) click to toggle source

    # File lib/bundler/source/rubygems.rb, line 257
    def suppress_configured_credentials(remote)
      remote_nouser = remote.dup.tap { |uri| uri.user = uri.password = nil }.to_s
      if remote.userinfo && remote.userinfo == Bundler.settings[remote_nouser]
        remote_nouser
      else
        remote
      end
    end

[Validate]

Generated with the Darkfish Rdoc Generator 2.