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 489 def self.key_for(key) key = normalize_uri(key).to_s if key.is_a?(String) && key.start_with?("http", "mirror.http") 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 497 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 280 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 290 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 286 def ignore_config? ENV["BUNDLE_IGNORE_CONFIG"] end
key_for(key)
click to toggle source
# File bundler/settings.rb, line 303 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 = "vendor/bundle" if value_for("deployment", settings) && path.nil? 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 294 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 373 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 309 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 400 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 437 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 356 def is_array(key) ARRAY_KEYS.include?(key.to_s) end
is_bool(name)
click to toggle source
# File bundler/settings.rb, line 335 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 360 def is_credential(key) key == "gem.push_key" end
is_num(key)
click to toggle source
# File bundler/settings.rb, line 352 def is_num(key) NUMBER_KEYS.include?(key.to_s) end
is_string(name)
click to toggle source
# File bundler/settings.rb, line 339 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 364 def is_userinfo(value) value.include?(":") end
load_config(config_file)
click to toggle source
# File bundler/settings.rb, line 453 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 449 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 323 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 414 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 379 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 327 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 331 def split_specific_setting_for(name) name.split(".") end
to_array(value)
click to toggle source
# File bundler/settings.rb, line 368 def to_array(value) return [] unless value value.tr(" ", ":").split(":").map(&:to_sym) end
to_bool(value)
click to toggle source
# File bundler/settings.rb, line 343 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 319 def value_for(name, config) converted_value(config[key_for(name)], name) end