Class: Bundler::Settings

Inherits:
Object
  • Object
show all
Defined in:
lib/bundler/mirror.rb,
lib/bundler/settings.rb,
lib/bundler/settings/validator.rb

Defined Under Namespace

Classes: Mirror, MirrorConfig, Mirrors, Path, TCPSocketProbe, Validator

Constant Summary collapse

BOOL_KEYS =
%w[
  allow_bundler_dependency_conflicts
  allow_deployment_source_credential_changes
  allow_offline_install
  auto_clean_without_path
  auto_install
  auto_config_jobs
  cache_all
  cache_all_platforms
  default_install_uses_path
  deployment
  deployment_means_frozen
  disable_checksum_validation
  disable_exec_load
  disable_local_branch_check
  disable_multisource
  disable_shared_gems
  disable_version_check
  force_ruby_platform
  forget_cli_options
  frozen
  gem.coc
  gem.mit
  global_gem_cache
  ignore_messages
  init_gems_rb
  no_install
  no_prune
  only_update_to_newer_versions
  path_relative_to_cwd
  path.system
  plugins
  prefer_patch
  print_only_version_number
  setup_makes_kernel_gem_public
  silence_deprecations
  silence_root_warning
  skip_default_git_sources
  specific_platform
  suppress_install_using_messages
  unlock_source_unlocks_spec
  update_requires_all_flag
  use_gem_version_promoter_for_major_updates
].freeze
NUMBER_KEYS =
%w[
  jobs
  redirect
  retry
  ssl_verify_mode
  timeout
].freeze
ARRAY_KEYS =
%w[
  with
  without
].freeze
DEFAULT_CONFIG =
{
  :silence_deprecations => false,
  :disable_version_check => true,
  :prefer_patch => false,
  :redirect => 5,
  :retry => 3,
  :timeout => 10,
}.freeze

Instance Method Summary collapse

Constructor Details

#initialize(root = nil) ⇒ Settings

Returns a new instance of Settings.


76
77
78
79
80
81
# File 'lib/bundler/settings.rb', line 76

def initialize(root = nil)
  @root            = root
  @local_config    = load_config(local_config_file)
  @global_config   = load_config(global_config_file)
  @temporary       = {}
end

Instance Method Details

#[](name) ⇒ Object


83
84
85
86
87
88
89
90
91
92
93
94
# File 'lib/bundler/settings.rb', line 83

def [](name)
  key = key_for(name)
  value = @temporary.fetch(key) do
          @local_config.fetch(key) do
          ENV.fetch(key) do
          @global_config.fetch(key) do
          DEFAULT_CONFIG.fetch(name) do
            nil
          end end end end end

  converted_value(value, name)
end

#allObject


133
134
135
136
137
138
139
140
141
# File 'lib/bundler/settings.rb', line 133

def all
  env_keys = ENV.keys.grep(/\ABUNDLE_.+/)

  keys = @temporary.keys | @global_config.keys | @local_config.keys | env_keys

  keys.map do |key|
    key.sub(/^BUNDLE_/, "").gsub(/__/, ".").downcase
  end
end

#allow_sudo?Boolean

Returns:

  • (Boolean)

266
267
268
269
270
# File 'lib/bundler/settings.rb', line 266

def allow_sudo?
  key = key_for(:path)
  path_configured = @temporary.key?(key) || @local_config.key?(key)
  !path_configured
end

#app_cache_pathObject


276
277
278
# File 'lib/bundler/settings.rb', line 276

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

#credentials_for(uri) ⇒ Object


160
161
162
# File 'lib/bundler/settings.rb', line 160

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

#gem_mirrorsObject


164
165
166
167
168
169
# File 'lib/bundler/settings.rb', line 164

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?Boolean

Returns:

  • (Boolean)

272
273
274
# File 'lib/bundler/settings.rb', line 272

def ignore_config?
  ENV["BUNDLE_IGNORE_CONFIG"]
end

#key_for(key) ⇒ Object


289
290
291
292
293
# File 'lib/bundler/settings.rb', line 289

def key_for(key)
  key = Settings.normalize_uri(key).to_s if key.is_a?(String) && /https?:/ =~ key
  key = key.to_s.gsub(".", "__").upcase
  "BUNDLE_#{key}"
end

#local_overridesObject


143
144
145
146
147
148
149
# File 'lib/bundler/settings.rb', line 143

def local_overrides
  repos = {}
  all.each do |k|
    repos[$'] = self[k] if k =~ /^local\./
  end
  repos
end

#locations(key) ⇒ Object


171
172
173
174
175
176
177
178
179
180
# File 'lib/bundler/settings.rb', line 171

def locations(key)
  key = key_for(key)
  locations = {}
  locations[:temporary] = @temporary[key] if @temporary.key?(key)
  locations[:local]  = @local_config[key] if @local_config.key?(key)
  locations[:env]    = ENV[key] if ENV[key]
  locations[:global] = @global_config[key] if @global_config.key?(key)
  locations[:default] = DEFAULT_CONFIG[key] if DEFAULT_CONFIG.key?(key)
  locations
end

#mirror_for(uri) ⇒ Object


151
152
153
154
155
156
157
158
# File 'lib/bundler/settings.rb', line 151

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

#pathObject

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


208
209
210
211
212
213
214
215
216
217
# File 'lib/bundler/settings.rb', line 208

def path
  key  = key_for(:path)
  path = ENV[key] || @global_config[key]
  if path && !@temporary.key?(key) && !@local_config.key?(key)
    return Path.new(path, false, false)
  end

  system_path = self["path.system"] || (self[:disable_shared_gems] == false)
  Path.new(self[:path], system_path, Bundler.feature_flag.default_install_uses_path?)
end

#pretty_values_for(exposed_key) ⇒ Object


182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
# File 'lib/bundler/settings.rb', line 182

def pretty_values_for(exposed_key)
  key = key_for(exposed_key)

  locations = []

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

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

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

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

  return ["You have not configured a value for `#{exposed_key}`"] if locations.empty?
  locations
end

#set_command_option(key, value) ⇒ Object


96
97
98
99
100
101
102
103
# File 'lib/bundler/settings.rb', line 96

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) ⇒ Object


105
106
107
108
# File 'lib/bundler/settings.rb', line 105

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

#set_global(key, value) ⇒ Object


129
130
131
# File 'lib/bundler/settings.rb', line 129

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

#set_local(key, value) ⇒ Object


110
111
112
113
114
# File 'lib/bundler/settings.rb', line 110

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) ⇒ Object


116
117
118
119
120
121
122
123
124
125
126
127
# File 'lib/bundler/settings.rb', line 116

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!Object


280
281
282
283
284
285
286
287
# File 'lib/bundler/settings.rb', line 280

def validate!
  all.each do |raw_key|
    [@local_config, ENV, @global_config].each do |settings|
      value = converted_value(settings[key_for(raw_key)], raw_key)
      Validator.validate!(raw_key, value, settings.to_hash.dup)
    end
  end
end