123456789_123456789_123456789_123456789_123456789_

Class: Bundler::SourceList

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
Inherits: Object
Defined in: lib/bundler/source_list.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.newSourceList

[ GitHub ]

  
# File 'lib/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

  @local_mode = true
end

Instance Attribute Details

#aggregate_global_source?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 27

def aggregate_global_source?
  global_rubygems_source.multiple_remotes?
end

#git_sources (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 5

attr_reader :path_sources,
  :git_sources,
  :plugin_sources,
  :global_path_source,
  :

#global_path_source (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 5

attr_reader :path_sources,
  :git_sources,
  :plugin_sources,
  :global_path_source,
  :

#implicit_global_source?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 31

def implicit_global_source?
  global_rubygems_source.no_remotes?
end

#local_mode?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 80

def local_mode?
  @local_mode
end

#metadata_source (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 5

attr_reader :path_sources,
  :git_sources,
  :plugin_sources,
  :global_path_source,
  :

#path_sources (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 5

attr_reader :path_sources,
  :git_sources,
  :plugin_sources,
  :global_path_source,
  :

#plugin_sources (readonly)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 5

attr_reader :path_sources,
  :git_sources,
  :plugin_sources,
  :global_path_source,
  :

Instance Method Details

#add_git_source(options = {})

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 45

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, cooldown: nil)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 68

def add_global_rubygems_remote(uri, cooldown: nil)
  unless cooldown.nil?
    new_source = source_class.new("remotes" => uri, "cooldown" => cooldown)
    [global_rubygems_source, *@rubygems_sources].find do |existing_source|
      warn_on_cooldown_conflict(new_source, existing_source)
    end
  end

  global_rubygems_source.add_remote(uri, cooldown: cooldown)
  global_rubygems_source
end

#add_path_source(options = {})

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 35

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 = {})

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 64

def add_plugin_source(source, options = {})
  add_source_to_list Plugin.source(source).new(options), @plugin_sources
end

#add_rubygems_source(options = {})

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 51

def add_rubygems_source(options = {})
  new_source = Source::Rubygems.new(options)
  if @global_rubygems_source == new_source
    warn_on_cooldown_conflict(new_source, @global_rubygems_source)
    return @global_rubygems_source
  end

  existing_source = @rubygems_sources.find {|s| s == new_source }
  warn_on_cooldown_conflict(new_source, existing_source) if existing_source

  add_source_to_list new_source, @rubygems_sources
end

#add_source_to_list(source, list) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 223

def add_source_to_list(source, list)
  list.unshift(source).uniq!
  source
end

#all_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 96

def all_sources
  path_sources + git_sources + plugin_sources + rubygems_sources + []
end

#cached!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 142

def cached!
  all_sources.each(&:cached!)
end

#clear_cache

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 152

def clear_cache
  rubygems_sources.each(&:clear_cache)
end

#default_source

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 84

def default_source
  global_path_source || global_rubygems_source
end

#equivalent_sources?(lock_sources, replacement_sources) ⇒ Boolean (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 265

def equivalent_sources?(lock_sources, replacement_sources)
  lock_sources.sort_by(&:identifier) == replacement_sources.sort_by(&:identifier)
end

#get(source)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 104

def get(source)
  source_list_for(source).find {|s| s.include?(source) }
end

#global_replacement_source(replacement_sources) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 180

def global_replacement_source(replacement_sources)
  replace_rubygems_source(replacement_sources, global_rubygems_source, &:local!)
end

#global_rubygems_source

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 11

def global_rubygems_source
  @global_rubygems_source ||= source_class.new("allow_local" => true)
end

#local!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 138

def local!
  all_sources.each(&:local!)
end

#local_only!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 134

def local_only!
  all_sources.each(&:local_only!)
end

#lock_other_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 112

def lock_other_sources
  (path_sources + git_sources + plugin_sources).sort_by(&:identifier)
end

#lock_rubygems_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 116

def lock_rubygems_sources
  rubygems_sources.sort_by(&:identifier)
end

#lock_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 108

def lock_sources
  lock_other_sources + lock_rubygems_sources
end

#map_sources(replacement_sources) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 162

def map_sources(replacement_sources)
  rubygems = @rubygems_sources.map do |source|
    replace_rubygems_source(replacement_sources, source)
  end

  git, plugin = [@git_sources, @plugin_sources].map do |sources|
    sources.map do |source|
      replace_source(replacement_sources, source)
    end
  end

  path = @path_sources.map do |source|
    replace_path_source(replacement_sources, source)
  end

  [rubygems, path, git, plugin]
end

#non_default_explicit_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 100

def non_default_explicit_sources
  all_sources - [default_source, ]
end

#non_global_rubygems_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 92

def non_global_rubygems_sources
  @rubygems_sources
end

#prefer_local!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 130

def prefer_local!
  all_sources.each(&:prefer_local!)
end

#release_resolution_memory!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 156

def release_resolution_memory!
  rubygems_sources.each(&:release_resolution_memory!)
end

#remote!

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 146

def remote!
  @local_mode = false

  all_sources.each(&:remote!)
end

#replace_path_source(replacement_sources, gemfile_source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 208

def replace_path_source(replacement_sources, gemfile_source)
  replace_source(replacement_sources, gemfile_source) do |replacement_source|
    if gemfile_source.is_a?(Source::Gemspec)
      gemfile_source.checksum_store = replacement_source.checksum_store
      gemfile_source
    else
      replacement_source
    end
  end
end

#replace_rubygems_source(replacement_sources, gemfile_source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 184

def replace_rubygems_source(replacement_sources, gemfile_source)
  replace_source(replacement_sources, gemfile_source) do |replacement_source|
    # locked sources never include credentials so always prefer remotes from the gemfile
    replacement_source.remotes = gemfile_source.remotes

    # cooldowns are only ever declared in the Gemfile, so carry them over
    # along with the remotes they apply to
    replacement_source.remote_cooldowns = gemfile_source.remote_cooldowns

    yield replacement_source if block_given?

    replacement_source
  end
end

#replace_source(replacement_sources, gemfile_source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 199

def replace_source(replacement_sources, gemfile_source)
  replacement_source = replacement_sources.find {|s| s == gemfile_source }
  return gemfile_source unless replacement_source

  replacement_source = yield(replacement_source) if block_given?

  replacement_source
end

#replace_sources!(replacement_sources)

Returns true if there are changes

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 121

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)

  !equivalent_sources?(lock_sources, replacement_sources)
end

#rubygems_sources

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 88

def rubygems_sources
  non_global_rubygems_sources + [global_rubygems_source]
end

#source_class (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 219

def source_class
  Source::Rubygems
end

#source_list_for(source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 228

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_cooldown_conflict(new_source, existing_source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 238

def warn_on_cooldown_conflict(new_source, existing_source)
  new_source.remote_cooldowns.any? do |uri, cooldown|
    next false unless existing_source.remotes.include?(uri)

    existing_cooldown = existing_source.cooldown_for(uri)
    next false if existing_cooldown == cooldown

    previous = existing_cooldown ? "`cooldown: #{existing_cooldown}`" : "no cooldown"
    Bundler.ui.warn "The source #{uri} is declared more than once with different cooldown " \
      "values (`cooldown: #{cooldown}` here, #{previous} previously). All declarations of " \
      "the same source URL share a single cooldown, so only one of these values will apply " \
      "to all gems from this source."
    true
  end
end

#warn_on_git_protocol(source) (private)

[ GitHub ]

  
# File 'lib/bundler/source_list.rb', line 254

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