class Bundler::Settings

Constants

ARRAY_KEYS
BOOL_KEYS
DEFAULT_CONFIG
NORMALIZE_URI_OPTIONS_PATTERN
NUMBER_KEYS
PER_URI_OPTIONS
Path
STRING_KEYS

Public Class Methods

new(root = nil) click to toggle source
# File bundler/settings.rb, line 89
def initialize(root = nil)
  @root            = root
  @local_config    = load_config(local_config_file)
  @env_config      = ENV.to_h.select {|key, _value| key =~ /\ABUNDLE_.+/ }
  @global_config   = load_config(global_config_file)
  @temporary       = {}
end

Private Class Methods

key_for(key) click to toggle source
# File bundler/settings.rb, line 488
def self.key_for(key)
  key = normalize_uri(key).to_s if key.is_a?(String) && /https?:/ =~ key
  key = key.to_s.gsub(".", "__").gsub("-", "___").upcase
  "BUNDLE_#{key}"
end
normalize_uri(uri) click to toggle source

TODO: duplicates Rubygems#normalize_uri TODO: is this the correct place to validate mirror URIs?

# File bundler/settings.rb, line 496
def self.normalize_uri(uri)
  uri = uri.to_s
  if uri =~ NORMALIZE_URI_OPTIONS_PATTERN
    prefix = $1
    uri = $2
    suffix = $3
  end
  uri = "#{uri}/" unless uri.end_with?("/")
  require_relative "vendored_uri"
  uri = Bundler::URI(uri)
  unless uri.absolute?
    raise ArgumentError, format("Gem sources must be absolute. You provided '%s'.", uri)
  end
  "#{prefix}#{uri}#{suffix}"
end

Public Instance Methods

[](name) click to toggle source
# File bundler/settings.rb, line 97
def [](name)
  key = key_for(name)
  value = configs.values.map {|config| config[key] }.compact.first

  converted_value(value, name)
end
all() click to toggle source
# File bundler/settings.rb, line 141
def all
  keys = @temporary.keys | @global_config.keys | @local_config.keys | @env_config.keys

  keys.map do |key|
    key.sub(/^BUNDLE_/, "").gsub(/___/, "-").gsub(/__/, ".").downcase
  end.sort
end
allow_sudo?() click to toggle source
# File bundler/settings.rb, line 279
def allow_sudo?
  key = key_for(:path)
  path_configured = @temporary.key?(key) || @local_config.key?(key)
  !path_configured
end
app_cache_path() click to toggle source
# File bundler/settings.rb, line 289
def app_cache_path
  @app_cache_path ||= self[:cache_path] || "vendor/cache"
end
credentials_for(uri) click to toggle source
# File bundler/settings.rb, line 166
def credentials_for(uri)
  self[uri.to_s] || self[uri.host]
end
gem_mirrors() click to toggle source
# File bundler/settings.rb, line 170
def gem_mirrors
  all.inject(Mirrors.new) do |mirrors, k|
    mirrors.parse(k, self[k]) if k.start_with?("mirror.")
    mirrors
  end
end
ignore_config?() click to toggle source
# File bundler/settings.rb, line 285
def ignore_config?
  ENV["BUNDLE_IGNORE_CONFIG"]
end
key_for(key) click to toggle source
# File bundler/settings.rb, line 302
def key_for(key)
  self.class.key_for(key)
end
local_overrides() click to toggle source
# File bundler/settings.rb, line 149
def local_overrides
  repos = {}
  all.each do |k|
    repos[$'] = self[k] if k =~ /^local\./
  end
  repos
end
locations(key) click to toggle source
# File bundler/settings.rb, line 177
def locations(key)
  key = key_for(key)
  configs.keys.inject({}) do |partial_locations, level|
    value_on_level = configs[level][key]
    partial_locations[level] = value_on_level unless value_on_level.nil?
    partial_locations
  end
end
mirror_for(uri) click to toggle source
# File bundler/settings.rb, line 157
def mirror_for(uri)
  if uri.is_a?(String)
    require_relative "vendored_uri"
    uri = Bundler::URI(uri)
  end

  gem_mirrors.for(uri.to_s).uri
end
path() click to toggle source

for legacy reasons, in Bundler 2, we do not respect :disable_shared_gems

# File bundler/settings.rb, line 219
def path
  configs.each do |_level, settings|
    path = value_for("path", settings)
    path_system = value_for("path.system", settings)
    disabled_shared_gems = value_for("disable_shared_gems", settings)
    next if path.nil? && path_system.nil? && disabled_shared_gems.nil?
    system_path = path_system || (disabled_shared_gems == false)
    return Path.new(path, system_path)
  end

  Path.new(nil, false)
end
pretty_values_for(exposed_key) click to toggle source
# File bundler/settings.rb, line 186
def pretty_values_for(exposed_key)
  key = key_for(exposed_key)

  locations = []

  if value = @temporary[key]
    locations << "Set for the current command: #{printable_value(value, exposed_key).inspect}"
  end

  if value = @local_config[key]
    locations << "Set for your local app (#{local_config_file}): #{printable_value(value, exposed_key).inspect}"
  end

  if value = @env_config[key]
    locations << "Set via #{key}: #{printable_value(value, exposed_key).inspect}"
  end

  if value = @global_config[key]
    locations << "Set for the current user (#{global_config_file}): #{printable_value(value, exposed_key).inspect}"
  end

  return ["You have not configured a value for `#{exposed_key}`"] if locations.empty?
  locations
end
processor_count() click to toggle source
# File bundler/settings.rb, line 211
def processor_count
  require "etc"
  Etc.nprocessors
rescue StandardError
  1
end
set_command_option(key, value) click to toggle source
# File bundler/settings.rb, line 104
def set_command_option(key, value)
  if Bundler.feature_flag.forget_cli_options?
    temporary(key => value)
    value
  else
    set_local(key, value)
  end
end
set_command_option_if_given(key, value) click to toggle source
# File bundler/settings.rb, line 113
def set_command_option_if_given(key, value)
  return if value.nil?
  set_command_option(key, value)
end
set_global(key, value) click to toggle source
# File bundler/settings.rb, line 137
def set_global(key, value)
  set_key(key, value, @global_config, global_config_file)
end
set_local(key, value) click to toggle source
# File bundler/settings.rb, line 118
def set_local(key, value)
  local_config_file || raise(GemfileNotFound, "Could not locate Gemfile")

  set_key(key, value, @local_config, local_config_file)
end
temporary(update) { || ... } click to toggle source
# File bundler/settings.rb, line 124
def temporary(update)
  existing = Hash[update.map {|k, _| [k, @temporary[key_for(k)]] }]
  update.each do |k, v|
    set_key(k, v, @temporary, nil)
  end
  return unless block_given?
  begin
    yield
  ensure
    existing.each {|k, v| set_key(k, v, @temporary, nil) }
  end
end
validate!() click to toggle source
# File bundler/settings.rb, line 293
def validate!
  all.each do |raw_key|
    [@local_config, @env_config, @global_config].each do |settings|
      value = value_for(raw_key, settings)
      Validator.validate!(raw_key, value, settings.dup)
    end
  end
end

Private Instance Methods

array_to_s(array) click to toggle source
# File bundler/settings.rb, line 372
def array_to_s(array)
  array = Array(array)
  return nil if array.empty?
  array.join(":").tr(" ", ":")
end
configs() click to toggle source
# File bundler/settings.rb, line 308
def configs
  {
    :temporary => @temporary,
    :local => @local_config,
    :env => @env_config,
    :global => @global_config,
    :default => DEFAULT_CONFIG,
  }
end
converted_value(value, key) click to toggle source
# File bundler/settings.rb, line 399
def converted_value(value, key)
  if is_array(key)
    to_array(value)
  elsif value.nil?
    nil
  elsif is_bool(key) || value == "false"
    to_bool(value)
  elsif is_num(key)
    value.to_i
  else
    value.to_s
  end
end
global_config_file() click to toggle source
# File bundler/settings.rb, line 436
def global_config_file
  if ENV["BUNDLE_CONFIG"] && !ENV["BUNDLE_CONFIG"].empty?
    Pathname.new(ENV["BUNDLE_CONFIG"])
  elsif ENV["BUNDLE_USER_CONFIG"] && !ENV["BUNDLE_USER_CONFIG"].empty?
    Pathname.new(ENV["BUNDLE_USER_CONFIG"])
  elsif ENV["BUNDLE_USER_HOME"] && !ENV["BUNDLE_USER_HOME"].empty?
    Pathname.new(ENV["BUNDLE_USER_HOME"]).join("config")
  elsif Bundler.rubygems.user_home && !Bundler.rubygems.user_home.empty?
    Pathname.new(Bundler.rubygems.user_home).join(".bundle/config")
  end
end
is_array(key) click to toggle source
# File bundler/settings.rb, line 355
def is_array(key)
  ARRAY_KEYS.include?(key.to_s)
end
is_bool(name) click to toggle source
# File bundler/settings.rb, line 334
def is_bool(name)
  BOOL_KEYS.include?(name.to_s) || BOOL_KEYS.include?(parent_setting_for(name.to_s))
end
is_credential(key) click to toggle source
# File bundler/settings.rb, line 359
def is_credential(key)
  key == "gem.push_key"
end
is_num(key) click to toggle source
# File bundler/settings.rb, line 351
def is_num(key)
  NUMBER_KEYS.include?(key.to_s)
end
is_string(name) click to toggle source
# File bundler/settings.rb, line 338
def is_string(name)
  STRING_KEYS.include?(name.to_s) || name.to_s.start_with?("local.") || name.to_s.start_with?("mirror.") || name.to_s.start_with?("build.")
end
is_userinfo(value) click to toggle source
# File bundler/settings.rb, line 363
def is_userinfo(value)
  value.include?(":")
end
load_config(config_file) click to toggle source
# File bundler/settings.rb, line 452
def load_config(config_file)
  return {} if !config_file || ignore_config?
  SharedHelpers.filesystem_access(config_file, :read) do |file|
    valid_file = file.exist? && !file.size.zero?
    return {} unless valid_file
    require_relative "yaml_serializer"
    YAMLSerializer.load(file.read).inject({}) do |config, (k, v)|
      new_k = k

      if k.include?("-")
        Bundler.ui.warn "Your #{file} config includes `#{k}`, which contains the dash character (`-`).\n" \
          "This is deprecated, because configuration through `ENV` should be possible, but `ENV` keys cannot include dashes.\n" \
          "Please edit #{file} and replace any dashes in configuration keys with a triple underscore (`___`)."

        new_k = k.gsub("-", "___")
      end

      config[new_k] = v
      config
    end
  end
end
local_config_file() click to toggle source
# File bundler/settings.rb, line 448
def local_config_file
  Pathname.new(@root).join("config") if @root
end
parent_setting_for(name) click to toggle source
# File bundler/settings.rb, line 322
def parent_setting_for(name)
  split_specific_setting_for(name)[0]
end
printable_value(value, key) click to toggle source
# File bundler/settings.rb, line 413
def printable_value(value, key)
  converted = converted_value(value, key)
  return converted unless converted.is_a?(String)

  if is_string(key)
    converted
  elsif is_credential(key)
    "[REDACTED]"
  elsif is_userinfo(converted)
    username, pass = converted.split(":", 2)

    if pass == "x-oauth-basic"
      username = "[REDACTED]"
    else
      pass = "[REDACTED]"
    end

    [username, pass].join(":")
  else
    converted
  end
end
set_key(raw_key, value, hash, file) click to toggle source
# File bundler/settings.rb, line 378
def set_key(raw_key, value, hash, file)
  raw_key = raw_key.to_s
  value = array_to_s(value) if is_array(raw_key)

  key = key_for(raw_key)

  return if hash[key] == value

  hash[key] = value
  hash.delete(key) if value.nil?

  Validator.validate!(raw_key, converted_value(value, raw_key), hash)

  return unless file
  SharedHelpers.filesystem_access(file) do |p|
    FileUtils.mkdir_p(p.dirname)
    require_relative "yaml_serializer"
    p.open("w") {|f| f.write(YAMLSerializer.dump(hash)) }
  end
end
specific_gem_for(name) click to toggle source
# File bundler/settings.rb, line 326
def specific_gem_for(name)
  split_specific_setting_for(name)[1]
end
split_specific_setting_for(name) click to toggle source
# File bundler/settings.rb, line 330
def split_specific_setting_for(name)
  name.split(".")
end
to_array(value) click to toggle source
# File bundler/settings.rb, line 367
def to_array(value)
  return [] unless value
  value.split(":").map(&:to_sym)
end
to_bool(value) click to toggle source
# File bundler/settings.rb, line 342
def to_bool(value)
  case value
  when nil, /\A(false|f|no|n|0|)\z/i, false
    false
  else
    true
  end
end
value_for(name, config) click to toggle source
# File bundler/settings.rb, line 318
def value_for(name, config)
  converted_value(config[key_for(name)], name)
end