123456789_123456789_123456789_123456789_123456789_

Class: Bundler::Settings

Relationships & Source Files
Namespace Children
Classes:
Inherits: Object
Defined in: lib/bundler/mirror.rb,
lib/bundler/settings.rb,
lib/bundler/settings/validator.rb

Constant Summary

  • ARRAY_KEYS =
    # File 'lib/bundler/settings.rb', line 71
    %w[
      only
      with
      without
    ].freeze
  • BOOL_KEYS =
    # File 'lib/bundler/settings.rb', line 9
    %w[
      allow_offline_install
      auto_clean_without_path
      auto_install
      cache_all
      cache_all_platforms
      clean
      default_install_uses_path
      deployment
      disable_checksum_validation
      disable_exec_load
      disable_local_branch_check
      disable_local_revision_check
      disable_shared_gems
      disable_version_check
      force_ruby_platform
      forget_cli_options
      frozen
      gem.changelog
      gem.coc
      gem.mit
      git.allow_insecure
      global_gem_cache
      ignore_messages
      init_gems_rb
      inline
      lockfile_checksums
      no_install
      no_prune
      path_relative_to_cwd
      path.system
      plugins
      prefer_patch
      print_only_version_number
      setup_makes_kernel_gem_public
      silence_deprecations
      silence_root_warning
      update_requires_all_flag
    ].freeze
  • DEFAULT_CONFIG =
    # File 'lib/bundler/settings.rb', line 94
    {
      "BUNDLE_SILENCE_DEPRECATIONS" => false,
      "BUNDLE_DISABLE_VERSION_CHECK" => true,
      "BUNDLE_PREFER_PATCH" => false,
      "BUNDLE_REDIRECT" => 5,
      "BUNDLE_RETRY" => 3,
      "BUNDLE_TIMEOUT" => 10,
      "BUNDLE_VERSION" => "lockfile",
    }.freeze
  • FALLBACK_TIMEOUT_URI_OPTION =
    # File 'lib/bundler/settings.rb', line 531
    "fallback_timeout"
  • NORMALIZE_URI_OPTIONS_PATTERN =
    # File 'lib/bundler/settings.rb', line 533
    /
      \A
      (\w+\.)? # optional prefix key
      (https?.*?) # URI
      (\.#{FALLBACK_TIMEOUT_URI_OPTION})? # optional suffix key
      \z
    /ix
  • NUMBER_KEYS =
    # File 'lib/bundler/settings.rb', line 63
    %w[
      jobs
      redirect
      retry
      ssl_verify_mode
      timeout
    ].freeze
  • REMEMBERED_KEYS =
    # File 'lib/bundler/settings.rb', line 49
    %w[
      bin
      cache_all
      clean
      deployment
      frozen
      no_prune
      path
      shebang
      path.system
      without
      with
    ].freeze
  • STRING_KEYS =
    # File 'lib/bundler/settings.rb', line 77
    %w[
      bin
      cache_path
      console
      gem.ci
      gem.github_username
      gem.linter
      gem.rubocop
      gem.test
      gemfile
      path
      shebang
      system_bindir
      trust-policy
      version
    ].freeze

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(root = nil) ⇒ Settings

[ GitHub ]

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

def initialize(root = nil)
  @root            = root
  @local_config    = load_config(local_config_file)
  @local_root      = root || Pathname.new(".bundle").expand_path

  @env_config      = ENV.to_h
  @env_config.select! {|key, _value| key.start_with?("BUNDLE_") }
  @env_config.delete("BUNDLE_")

  @global_config   = load_config(global_config_file)
  @temporary       = {}

  @key_cache = {}
end

Class Method Details

.key_for(key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 542

def self.key_for(key)
  key = key_to_s(key)
  key = normalize_uri(key) if key.start_with?("http", "mirror.http")
  key = key.gsub(".", "__")
  key.gsub!("-", "___")
  key.upcase!

  key.gsub(/\A([ #]*)/, '\1BUNDLE_')
end

.key_to_s(key) (private)

See additional method definition at line 572.

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 585

def self.key_to_s(key)
  case key
  when String
    key
  when Symbol
    key.name
  when Gem::URI::HTTP
    key.to_s
  else
    raise ArgumentError, "Invalid key: #{key.inspect}"
  end
end

.normalize_uri(uri) (private)

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

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 554

def self.normalize_uri(uri)
  uri = uri.to_s
  if uri =~ NORMALIZE_URI_OPTIONS_PATTERN
    prefix = $1
    uri = $2
    suffix = $3
  end
  uri = URINormalizer.normalize_suffix(uri)
  require_relative "vendored_uri"
  uri = Gem::URI(uri)
  unless uri.absolute?
    raise ArgumentError, format("Gem sources must be absolute. You provided '%s'.", uri)
  end
  "#{prefix}#{uri}#{suffix}"
end

Instance Attribute Details

#ignore_config?Boolean (readonly)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 314

def ignore_config?
  ENV["BUNDLE_IGNORE_CONFIG"]
end

Instance Method Details

#[](name)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 119

def [](name)
  key = key_for(name)

  value = nil
  configs.each do |_, config|
    value = config[key]
    next if value.nil?
    break
  end

  converted_value(value, name)
end

#all

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 169

def all
  keys = @temporary.keys.union(@global_config.keys, @local_config.keys, @env_config.keys)

  keys.map! do |key|
    key = key.delete_prefix("BUNDLE_")
    key.gsub!("___", "-")
    key.gsub!("__", ".")
    key.downcase!
    key
  end.sort!
  keys
end

#app_cache_path

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 318

def app_cache_path
  @app_cache_path ||= self[:cache_path] || "vendor/cache"
end

#array_to_s(array) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 409

def array_to_s(array)
  array = Array(array)
  return nil if array.empty?
  array.join(":").tr(" ", ":")
end

#configs (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 337

def configs
  @configs ||= {
    temporary: @temporary,
    local: @local_config,
    env: @env_config,
    global: @global_config,
    default: DEFAULT_CONFIG,
  }
end

#converted_value(value, key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 439

def converted_value(value, key)
  key = self.class.key_to_s(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

#credentials_for(uri)

[ GitHub ]

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

def credentials_for(uri)
  self[uri.to_s] || self[uri.host]
end

#gem_mirrors

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 203

def gem_mirrors
  all.inject(Mirrors.new) do |mirrors, k|
    mirrors.parse(k, self[k]) if k.start_with?("mirror.")
    mirrors
  end
end

#global_config_file (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 478

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) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 388

def is_array(key)
  ARRAY_KEYS.include?(self.class.key_to_s(key))
end

#is_bool(name) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 363

def is_bool(name)
  name = self.class.key_to_s(name)
  BOOL_KEYS.include?(name) || BOOL_KEYS.include?(parent_setting_for(name))
end

#is_credential(key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 396

def is_credential(key)
  key == "gem.push_key"
end

#is_num(key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 384

def is_num(key)
  NUMBER_KEYS.include?(self.class.key_to_s(key))
end

#is_remembered(key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 392

def is_remembered(key)
  REMEMBERED_KEYS.include?(self.class.key_to_s(key))
end

#is_string(name) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 368

def is_string(name)
  name = self.class.key_to_s(name)
  STRING_KEYS.include?(name) || name.start_with?("local.") || name.start_with?("mirror.") || name.start_with?("build.")
end

#is_userinfo(value) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 400

def is_userinfo(value)
  value.include?(":")
end

#key_for(key)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 331

def key_for(key)
  @key_cache[key] ||= self.class.key_for(key)
end

#load_config(config_file) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 494

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
    serializer_class.load(file.read).inject({}) do |config, (k, v)|
      k = k.dup
      k << "/" if /https?:/i.match?(k) && !k.end_with?("/", "__#{FALLBACK_TIMEOUT_URI_OPTION.upcase}")
      k.gsub!(".", "__")

      unless k.start_with?("#")
        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 (`___`)."

          # string hash keys are frozen
          k = k.gsub("-", "___")
        end

        config[k] = v
      end

      config
    end
  end
end

#local_config_file (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 490

def local_config_file
  Pathname.new(@root).join("config") if @root
end

#local_overrides

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 182

def local_overrides
  repos = {}
  all.each do |k|
    repos[k.delete_prefix("local.")] = self[k] if k.start_with?("local.")
  end
  repos
end

#locations(key)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 210

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)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 190

def mirror_for(uri)
  if uri.is_a?(String)
    require_relative "vendored_uri"
    uri = Gem::URI(uri)
  end

  gem_mirrors.for(uri.to_s).uri
end

#parent_setting_for(name) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 351

def parent_setting_for(name)
  split_specific_setting_for(name)[0]
end

#path

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

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 252

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 = "vendor/bundle" if self[:deployment]

  Path.new(path, false)
end

#pretty_values_for(exposed_key)

[ GitHub ]

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

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

#printable_value(value, key) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 455

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

#processor_count

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 244

def processor_count
  require "etc"
  Etc.nprocessors
rescue StandardError
  1
end

#serializer_class (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 522

def serializer_class
  require "rubygems/yaml_serializer"
  Gem::YAMLSerializer
rescue LoadError
  # TODO: Remove this when RubyGems 3.4 is EOL
  require_relative "yaml_serializer"
  YAMLSerializer
end

#set_command_option(key, value)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 132

def set_command_option(key, value)
  if !is_remembered(key) || Bundler.feature_flag.forget_cli_options?
    temporary(key => value)
    value
  else
    set_local(key, value)
  end
end

#set_command_option_if_given(key, value)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 141

def set_command_option_if_given(key, value)
  return if value.nil?
  set_command_option(key, value)
end

#set_global(key, value)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 165

def set_global(key, value)
  set_key(key, value, @global_config, global_config_file)
end

#set_key(raw_key, value, hash, file) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 415

def set_key(raw_key, value, hash, file)
  raw_key = self.class.key_to_s(raw_key)
  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.dirname, :create) do |p|
    FileUtils.mkdir_p(p)
  end

  SharedHelpers.filesystem_access(file) do |p|
    p.open("w") {|f| f.write(serializer_class.dump(hash)) }
  end
end

#set_local(key, value)

[ GitHub ]

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

def set_local(key, value)
  local_config_file = @local_root.join("config")

  set_key(key, value, @local_config, local_config_file)
end

#specific_gem_for(name) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 355

def specific_gem_for(name)
  split_specific_setting_for(name)[1]
end

#split_specific_setting_for(name) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 359

def split_specific_setting_for(name)
  name.split(".")
end

#temporary(update)

[ GitHub ]

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

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

#to_array(value) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 404

def to_array(value)
  return [] unless value
  value.tr(" ", ":").split(":").map(&:to_sym)
end

#to_bool(value) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 373

def to_bool(value)
  case value
  when String
    value.match?(/\A(false|f|no|n|0|)\z/i) ? false : true
  when nil, false
    false
  else
    true
  end
end

#validate!

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 322

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

#value_for(name, config) (private)

[ GitHub ]

  
# File 'lib/bundler/settings.rb', line 347

def value_for(name, config)
  converted_value(config[key_for(name)], name)
end