class Bundler::SourceList - bundler: Ruby Standard Library Documentation

# class Bundler::SourceList

### Attributes

git_sources[R]
global_path_source[R]
metadata_source[R]
path_sources[R]
plugin_sources[R]

### Public Class Methods

new() click to toggle source

    # File bundler/source_list.rb, line 15
    def initialize
      @path_sources           = []
      @git_sources            = []
      @plugin_sources         = []
      @global_rubygems_source = nil
      @global_path_source     = nil
      @rubygems_sources       = []
      @metadata_source        = Source::Metadata.new

      @merged_gem_lockfile_sections = false
      @local_mode = true
    end

### Public Instance Methods

add_git_source(options = {}) click to toggle source

    # File bundler/source_list.rb, line 55
    def add_git_source(options = {})
      add_source_to_list(Source::Git.new(options), git_sources).tap do |source|
        warn_on_git_protocol(source)
      end
    end

add_global_rubygems_remote(uri) click to toggle source

    # File bundler/source_list.rb, line 72
    def add_global_rubygems_remote(uri)
      global_rubygems_source.add_remote(uri)
      global_rubygems_source
    end

add_path_source(options = {}) click to toggle source

    # File bundler/source_list.rb, line 45
    def add_path_source(options = {})
      if options["gemspec"]
        add_source_to_list Source::Gemspec.new(options), path_sources
      else
        path_source = add_source_to_list Source::Path.new(options), path_sources
        @global_path_source ||= path_source if options["global"]
        path_source
      end
    end

add_plugin_source(source, options = {}) click to toggle source

    # File bundler/source_list.rb, line 68
    def add_plugin_source(source, options = {})
      add_source_to_list Plugin.source(source).new(options), @plugin_sources
    end

add_rubygems_source(options = {}) click to toggle source

    # File bundler/source_list.rb, line 61
    def add_rubygems_source(options = {})
      new_source = Source::Rubygems.new(options)
      return @global_rubygems_source if @global_rubygems_source == new_source

      add_source_to_list new_source, @rubygems_sources
    end

aggregate_global_source?() click to toggle source

    # File bundler/source_list.rb, line 37
    def aggregate_global_source?
      global_rubygems_source.multiple_remotes?
    end

all_sources() click to toggle source

    # File bundler/source_list.rb, line 97
    def all_sources
      path_sources + git_sources + plugin_sources + rubygems_sources + [metadata_source]
    end

cached!() click to toggle source

    # File bundler/source_list.rb, line 152
    def cached!
      all_sources.each(&:cached!)
    end

default_source() click to toggle source

    # File bundler/source_list.rb, line 81
    def default_source
      global_path_source || global_rubygems_source
    end

expired_sources?(replacement_sources) click to toggle source

Returns true if there are changes

    # File bundler/source_list.rb, line 136
    def expired_sources?(replacement_sources)
      return false if replacement_sources.empty?

      lock_sources = dup_with_replaced_sources(replacement_sources).lock_sources

      different_sources?(lock_sources, replacement_sources)
    end

get(source) click to toggle source

    # File bundler/source_list.rb, line 105
    def get(source)
      source_list_for(source).find {|s| equivalent_source?(source, s) }
    end

global_rubygems_source() click to toggle source

    # File bundler/source_list.rb, line 11
    def global_rubygems_source
      @global_rubygems_source ||= rubygems_aggregate_class.new("allow_local" => true)
    end

implicit_global_source?() click to toggle source

    # File bundler/source_list.rb, line 41
    def implicit_global_source?
      global_rubygems_source.no_remotes?
    end

local!() click to toggle source

    # File bundler/source_list.rb, line 148
    def local!
      all_sources.each(&:local!)
    end

local_mode?() click to toggle source

    # File bundler/source_list.rb, line 77
    def local_mode?
      @local_mode
    end

local_only!() click to toggle source

    # File bundler/source_list.rb, line 144
    def local_only!
      all_sources.each(&:local_only!)
    end

lock_other_sources() click to toggle source

    # File bundler/source_list.rb, line 113
    def lock_other_sources
      (path_sources + git_sources + plugin_sources).sort_by(&:identifier)
    end

lock_rubygems_sources() click to toggle source

    # File bundler/source_list.rb, line 117
    def lock_rubygems_sources
      if merged_gem_lockfile_sections?
        [combine_rubygems_sources]
      else
        rubygems_sources.sort_by(&:identifier)
      end
    end

lock_sources() click to toggle source

    # File bundler/source_list.rb, line 109
    def lock_sources
      lock_other_sources + lock_rubygems_sources
    end

merged_gem_lockfile_sections!(replacement_source) click to toggle source

    # File bundler/source_list.rb, line 32
    def merged_gem_lockfile_sections!(replacement_source)
      @merged_gem_lockfile_sections = true
      @global_rubygems_source = replacement_source
    end

merged_gem_lockfile_sections?() click to toggle source

    # File bundler/source_list.rb, line 28
    def merged_gem_lockfile_sections?
      @merged_gem_lockfile_sections
    end

non_default_explicit_sources() click to toggle source

    # File bundler/source_list.rb, line 101
    def non_default_explicit_sources
      all_sources - [default_source, metadata_source]
    end

non_global_rubygems_sources() click to toggle source

    # File bundler/source_list.rb, line 89
    def non_global_rubygems_sources
      @rubygems_sources
    end

remote!() click to toggle source

    # File bundler/source_list.rb, line 156
    def remote!
      @local_mode = false

      all_sources.each(&:remote!)
    end

replace_sources!(replacement_sources) click to toggle source

Returns true if there are changes

    # File bundler/source_list.rb, line 126
    def replace_sources!(replacement_sources)
      return false if replacement_sources.empty?

      @rubygems_sources, @path_sources, @git_sources, @plugin_sources = map_sources(replacement_sources)
      @global_rubygems_source = global_replacement_source(replacement_sources)

      different_sources?(lock_sources, replacement_sources)
    end

rubygems_remotes() click to toggle source

    # File bundler/source_list.rb, line 93
    def rubygems_remotes
      rubygems_sources.flat_map(&:remotes).uniq
    end

rubygems_sources() click to toggle source

    # File bundler/source_list.rb, line 85
    def rubygems_sources
      non_global_rubygems_sources + [global_rubygems_source]
    end

### Private Instance Methods

add_source_to_list(source, list) click to toggle source

    # File bundler/source_list.rb, line 213
    def add_source_to_list(source, list)
      list.unshift(source).uniq!
      source
    end

combine_rubygems_sources() click to toggle source

    # File bundler/source_list.rb, line 228
    def combine_rubygems_sources
      Source::Rubygems.new("remotes" => rubygems_remotes)
    end

different_sources?(lock_sources, replacement_sources) click to toggle source

    # File bundler/source_list.rb, line 205
    def different_sources?(lock_sources, replacement_sources)
      !equivalent_sources?(lock_sources, replacement_sources)
    end

dup_with_replaced_sources(replacement_sources) click to toggle source

    # File bundler/source_list.rb, line 164
    def dup_with_replaced_sources(replacement_sources)
      new_source_list = dup
      new_source_list.replace_sources!(replacement_sources)
      new_source_list
    end

equivalent_source?(source, other_source) click to toggle source

    # File bundler/source_list.rb, line 247
    def equivalent_source?(source, other_source)
      source == other_source
    end

equivalent_sources?(lock_sources, replacement_sources) click to toggle source

    # File bundler/source_list.rb, line 243
    def equivalent_sources?(lock_sources, replacement_sources)
      lock_sources.sort_by(&:identifier) == replacement_sources.sort_by(&:identifier)
    end

global_replacement_source(replacement_sources) click to toggle source

    # File bundler/source_list.rb, line 188
    def global_replacement_source(replacement_sources)
      replacement_source = replace_rubygems_source(replacement_sources, global_rubygems_source)
      return global_rubygems_source unless replacement_source

      replacement_source.local!
      replacement_source
    end

map_sources(replacement_sources) click to toggle source

    # File bundler/source_list.rb, line 170
    def map_sources(replacement_sources)
      rubygems = @rubygems_sources.map do |source|
        replace_rubygems_source(replacement_sources, source) || source
      end

      git, plugin = [@git_sources, @plugin_sources].map do |sources|
        sources.map do |source|
          replacement_sources.find {|s| s == source } || source
        end
      end

      path = @path_sources.map do |source|
        replacement_sources.find {|s| s == (source.is_a?(Source::Gemspec) ? source.as_path_source : source) } || source
      end

      [rubygems, path, git, plugin]
    end

replace_rubygems_source(replacement_sources, gemfile_source) click to toggle source

    # File bundler/source_list.rb, line 196
    def replace_rubygems_source(replacement_sources, gemfile_source)
      replacement_source = replacement_sources.find {|s| s == gemfile_source }
      return unless replacement_source

      # locked sources never include credentials so always prefer remotes from the gemfile
      replacement_source.remotes = gemfile_source.remotes
      replacement_source
    end

rubygems_aggregate_class() click to toggle source

    # File bundler/source_list.rb, line 209
    def rubygems_aggregate_class
      Source::Rubygems
    end

source_list_for(source) click to toggle source

    # File bundler/source_list.rb, line 218
    def source_list_for(source)
      case source
      when Source::Git          then git_sources
      when Source::Path         then path_sources
      when Source::Rubygems     then rubygems_sources
      when Plugin::API::Source  then plugin_sources
      else raise ArgumentError, "Invalid source: #{source.inspect}"
      end
    end

warn_on_git_protocol(source) click to toggle source

    # File bundler/source_list.rb, line 232
    def warn_on_git_protocol(source)
      return if Bundler.settings["git.allow_insecure"]

      if /^git\:/.match?(source.uri)
        Bundler.ui.warn "The git source `#{source.uri}` uses the `git` protocol, " \
          "which transmits data without encryption. Disable this warning with " \
          "`bundle config set --local git.allow_insecure true`, or switch to the `https` " \
          "protocol to keep your data secure."
      end
    end