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 57%w[ only with without ].freeze
-
BOOL_KEYS =
# File 'lib/bundler/settings.rb', line 9%w[ allow_deployment_source_credential_changes 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 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 79{ "BUNDLE_SILENCE_DEPRECATIONS" => false, "BUNDLE_DISABLE_VERSION_CHECK" => true, "BUNDLE_PREFER_PATCH" => false, "BUNDLE_REDIRECT" => 5, "BUNDLE_RETRY" => 3, "BUNDLE_TIMEOUT" => 10, }.freeze
-
NORMALIZE_URI_OPTIONS_PATTERN =
# File 'lib/bundler/settings.rb', line 474/ \A (\w+\.)? # optional prefix key (https?.*?) # URI (\.#{Regexp.union(PER_URI_OPTIONS)})? # optional suffix key \z /ix.freeze
-
NUMBER_KEYS =
# File 'lib/bundler/settings.rb', line 49%w[ jobs redirect retry ssl_verify_mode timeout ].freeze
-
PER_URI_OPTIONS =
# File 'lib/bundler/settings.rb', line 470%w[ fallback_timeout ].freeze
-
STRING_KEYS =
# File 'lib/bundler/settings.rb', line 63%w[ bin cache_path console gem.ci gem.github_username gem.linter gem.rubocop gem.test gemfile path shebang system_bindir trust-policy ].freeze
Class Method Summary
- .new(root = nil) ⇒ Settings constructor
- .key_for(key) private
-
.normalize_uri(uri)
private
TODO: duplicates
Rubygems#normalize_uri
TODO: is this the correct place to validate mirror URIs?
Instance Attribute Summary
- #ignore_config? ⇒ Boolean readonly
Instance Method Summary
- #[](name)
- #all
- #app_cache_path
- #credentials_for(uri)
- #gem_mirrors
- #key_for(key)
- #local_overrides
- #locations(key)
- #mirror_for(uri)
-
#path
for legacy reasons, in
::Bundler
2, we do not respect:disable_shared_gems
. - #pretty_values_for(exposed_key)
- #processor_count
- #set_command_option(key, value)
- #set_command_option_if_given(key, value)
- #set_global(key, value)
- #set_local(key, value)
- #temporary(update)
- #validate!
- #array_to_s(array) private
- #configs private
- #converted_value(value, key) private
- #global_config_file private
- #is_array(key) private
- #is_bool(name) private
- #is_credential(key) private
- #is_num(key) private
- #is_string(name) private
- #is_userinfo(value) private
- #load_config(config_file) private
- #local_config_file private
- #parent_setting_for(name) private
- #printable_value(value, key) private
- #set_key(raw_key, value, hash, file) private
- #specific_gem_for(name) private
- #split_specific_setting_for(name) private
- #to_array(value) private
- #to_bool(value) private
- #value_for(name, config) private
Constructor Details
.new(root = nil) ⇒ Settings
# File 'lib/bundler/settings.rb', line 88
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
Class Method Details
.key_for(key) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 483
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) (private)
TODO: duplicates Rubygems#normalize_uri
TODO: is this the correct place to validate mirror URIs?
# File 'lib/bundler/settings.rb', line 491
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 = Bundler::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 280
def ignore_config? ENV["BUNDLE_IGNORE_CONFIG"] end
Instance Method Details
#[](name)
[ GitHub ]# File 'lib/bundler/settings.rb', line 96
def [](name) key = key_for(name) value = configs.values.map {|config| config[key] }.compact.first converted_value(value, name) end
#all
[ GitHub ]# File 'lib/bundler/settings.rb', line 140
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
#app_cache_path
[ GitHub ]# File 'lib/bundler/settings.rb', line 284
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 367
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 303
def configs { :temporary => @temporary, :local => @local_config, :env => @env_config, :global => @global_config, :default => DEFAULT_CONFIG, } end
#converted_value(value, key) (private)
[ GitHub ]#credentials_for(uri)
[ GitHub ]# File 'lib/bundler/settings.rb', line 165
def credentials_for(uri) self[uri.to_s] || self[uri.host] end
#gem_mirrors
[ GitHub ]#global_config_file (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 431
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 350
def is_array(key) ARRAY_KEYS.include?(key.to_s) end
#is_bool(name) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 329
def is_bool(name) BOOL_KEYS.include?(name.to_s) || BOOL_KEYS.include?(parent_setting_for(name.to_s)) end
#is_credential(key) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 354
def is_credential(key) key == "gem.push_key" end
#is_num(key) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 346
def is_num(key) NUMBER_KEYS.include?(key.to_s) end
#is_string(name) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 333
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) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 358
def is_userinfo(value) value.include?(":") end
#key_for(key)
[ GitHub ]# File 'lib/bundler/settings.rb', line 297
def key_for(key) self.class.key_for(key) end
#load_config(config_file) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 447
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 (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 443
def local_config_file Pathname.new(@root).join("config") if @root end
#local_overrides
[ GitHub ]# File 'lib/bundler/settings.rb', line 148
def local_overrides repos = {} all.each do |k| repos[$'] = self[k] if k =~ /^local\./ end repos end
#locations(key)
[ GitHub ]#mirror_for(uri)
[ GitHub ]# File 'lib/bundler/settings.rb', line 156
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
#parent_setting_for(name) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 317
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
# File 'lib/bundler/settings.rb', line 218
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 185
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 408
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 210
def processor_count require "etc" Etc.nprocessors rescue StandardError 1 end
#set_command_option(key, value)
[ GitHub ]# File 'lib/bundler/settings.rb', line 103
def set_command_option(key, value) if Bundler.feature_flag. 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 112
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 136
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 373
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
#set_local(key, value)
[ GitHub ]# File 'lib/bundler/settings.rb', line 117
def set_local(key, value) local_config_file || raise(GemfileNotFound, "Could not locate Gemfile") set_key(key, value, @local_config, local_config_file) end
#specific_gem_for(name) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 321
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 325
def split_specific_setting_for(name) name.split(".") end
#temporary(update)
[ GitHub ]#to_array(value) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 362
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 337
def to_bool(value) case value when nil, /\A(false|f|no|n|0|)\z/i, false false else true end end
#validate!
[ GitHub ]#value_for(name, config) (private)
[ GitHub ]# File 'lib/bundler/settings.rb', line 313
def value_for(name, config) converted_value(config[key_for(name)], name) end