File: C:/Ruby27-x64/share/doc/ruby/html/Bundler/Settings.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>class Bundler::Settings - RDoc Documentation</title>
<script type="text/javascript">
var rdoc_rel_prefix = "../";
var index_rel_prefix = "../";
</script>
<script src="../js/navigation.js" defer></script>
<script src="../js/search.js" defer></script>
<script src="../js/search_index.js" defer></script>
<script src="../js/searcher.js" defer></script>
<script src="../js/darkfish.js" defer></script>
<link href="../css/fonts.css" rel="stylesheet">
<link href="../css/rdoc.css" rel="stylesheet">
<body id="top" role="document" class="class">
<nav role="navigation">
<div id="project-navigation">
<div id="home-section" role="region" title="Quick navigation" class="nav-section">
<h2>
<a href="../index.html" rel="home">Home</a>
</h2>
<div id="table-of-contents-navigation">
<a href="../table_of_contents.html#pages">Pages</a>
<a href="../table_of_contents.html#classes">Classes</a>
<a href="../table_of_contents.html#methods">Methods</a>
</div>
</div>
<div id="search-section" role="search" class="project-section initially-hidden">
<form action="#" method="get" accept-charset="utf-8">
<div id="search-field-wrapper">
<input id="search-field" role="combobox" aria-label="Search"
aria-autocomplete="list" aria-controls="search-results"
type="text" name="search" placeholder="Search" spellcheck="false"
title="Type to search, Up and Down to navigate, Enter to load">
</div>
<ul id="search-results" aria-label="Search Results"
aria-busy="false" aria-expanded="false"
aria-atomic="false" class="initially-hidden"></ul>
</form>
</div>
</div>
<div id="class-metadata">
<div id="parent-class-section" class="nav-section">
<h3>Parent</h3>
<p class="link"><a href="../Object.html">Object</a>
</div>
<!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
<h3>Methods</h3>
<ul class="link-list" role="directory">
<li ><a href="#method-c-new">::new</a>
<li ><a href="#method-c-normalize_uri">::normalize_uri</a>
<li ><a href="#method-i-5B-5D">#[]</a>
<li ><a href="#method-i-all">#all</a>
<li ><a href="#method-i-allow_sudo-3F">#allow_sudo?</a>
<li ><a href="#method-i-app_cache_path">#app_cache_path</a>
<li ><a href="#method-i-array_to_s">#array_to_s</a>
<li ><a href="#method-i-converted_value">#converted_value</a>
<li ><a href="#method-i-credentials_for">#credentials_for</a>
<li ><a href="#method-i-gem_mirrors">#gem_mirrors</a>
<li ><a href="#method-i-global_config_file">#global_config_file</a>
<li ><a href="#method-i-ignore_config-3F">#ignore_config?</a>
<li ><a href="#method-i-is_array">#is_array</a>
<li ><a href="#method-i-is_bool">#is_bool</a>
<li ><a href="#method-i-is_num">#is_num</a>
<li ><a href="#method-i-key_for">#key_for</a>
<li ><a href="#method-i-load_config">#load_config</a>
<li ><a href="#method-i-local_config_file">#local_config_file</a>
<li ><a href="#method-i-local_overrides">#local_overrides</a>
<li ><a href="#method-i-locations">#locations</a>
<li ><a href="#method-i-mirror_for">#mirror_for</a>
<li ><a href="#method-i-parent_setting_for">#parent_setting_for</a>
<li ><a href="#method-i-path">#path</a>
<li ><a href="#method-i-pretty_values_for">#pretty_values_for</a>
<li ><a href="#method-i-set_command_option">#set_command_option</a>
<li ><a href="#method-i-set_command_option_if_given">#set_command_option_if_given</a>
<li ><a href="#method-i-set_global">#set_global</a>
<li ><a href="#method-i-set_key">#set_key</a>
<li ><a href="#method-i-set_local">#set_local</a>
<li ><a href="#method-i-specific_gem_for">#specific_gem_for</a>
<li ><a href="#method-i-split_specific_setting_for">#split_specific_setting_for</a>
<li ><a href="#method-i-temporary">#temporary</a>
<li ><a href="#method-i-to_array">#to_array</a>
<li ><a href="#method-i-to_bool">#to_bool</a>
<li ><a href="#method-i-validate-21">#validate!</a>
</ul>
</div>
</div>
</nav>
<main role="main" aria-labelledby="class-Bundler::Settings">
<h1 id="class-Bundler::Settings" class="class">
class Bundler::Settings
</h1>
<section class="description">
</section>
<section id="5Buntitled-5D" class="documentation-section">
<section class="constants-list">
<header>
<h3>Constants</h3>
</header>
<dl>
<dt id="ARRAY_KEYS">ARRAY_KEYS
<dd>
<dt id="BOOL_KEYS">BOOL_KEYS
<dd>
<dt id="DEFAULT_CONFIG">DEFAULT_CONFIG
<dd>
<dt id="NORMALIZE_URI_OPTIONS_PATTERN">NORMALIZE_URI_OPTIONS_PATTERN
<dd>
<dt id="NUMBER_KEYS">NUMBER_KEYS
<dd>
<dt id="PER_URI_OPTIONS">PER_URI_OPTIONS
<dd>
<dt id="Path">Path
<dd>
</dl>
</section>
<section id="public-class-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Class Methods</h3>
</header>
<div id="method-c-new" class="method-detail ">
<div class="method-heading">
<span class="method-name">new</span><span
class="method-args">(root = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="new-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 77</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-identifier">root</span> = <span class="ruby-keyword">nil</span>)
<span class="ruby-ivar">@root</span> = <span class="ruby-identifier">root</span>
<span class="ruby-ivar">@local_config</span> = <span class="ruby-identifier">load_config</span>(<span class="ruby-identifier">local_config_file</span>)
<span class="ruby-ivar">@global_config</span> = <span class="ruby-identifier">load_config</span>(<span class="ruby-identifier">global_config_file</span>)
<span class="ruby-ivar">@temporary</span> = {}
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="private-class-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Private Class Methods</h3>
</header>
<div id="method-c-normalize_uri" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_uri</span><span
class="method-args">(uri)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>TODO: duplicates Rubygems#normalize_uri TODO: is this the correct place to validate mirror URIs?</p>
<div class="method-source-code" id="normalize_uri-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 418</span>
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">normalize_uri</span>(<span class="ruby-identifier">uri</span>)
<span class="ruby-identifier">uri</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">NORMALIZE_URI_OPTIONS_PATTERN</span>
<span class="ruby-identifier">prefix</span> = <span class="ruby-node">$1</span>
<span class="ruby-identifier">uri</span> = <span class="ruby-node">$2</span>
<span class="ruby-identifier">suffix</span> = <span class="ruby-node">$3</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">uri</span> = <span class="ruby-node">"#{uri}/"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">end_with?</span>(<span class="ruby-string">"/"</span>)
<span class="ruby-identifier">require_relative</span> <span class="ruby-string">"vendored_uri"</span>
<span class="ruby-identifier">uri</span> = <span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>(<span class="ruby-identifier">uri</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">absolute?</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-identifier">format</span>(<span class="ruby-string">"Gem sources must be absolute. You provided '%s'."</span>, <span class="ruby-identifier">uri</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-node">"#{prefix}#{uri}#{suffix}"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="public-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Instance Methods</h3>
</header>
<div id="method-i-5B-5D" class="method-detail ">
<div class="method-heading">
<span class="method-name">[]</span><span
class="method-args">(name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="5B-5D-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 84</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">[]</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">value</span> = <span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">key</span>) <span class="ruby-keyword">do</span>
<span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">key</span>) <span class="ruby-keyword">do</span>
<span class="ruby-constant">ENV</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">key</span>) <span class="ruby-keyword">do</span>
<span class="ruby-ivar">@global_config</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">key</span>) <span class="ruby-keyword">do</span>
<span class="ruby-constant">DEFAULT_CONFIG</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">name</span>) <span class="ruby-keyword">do</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span> <span class="ruby-keyword">end</span> <span class="ruby-keyword">end</span> <span class="ruby-keyword">end</span> <span class="ruby-keyword">end</span>
<span class="ruby-identifier">converted_value</span>(<span class="ruby-identifier">value</span>, <span class="ruby-identifier">name</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-all" class="method-detail ">
<div class="method-heading">
<span class="method-name">all</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="all-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 134</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">all</span>
<span class="ruby-identifier">env_keys</span> = <span class="ruby-constant">ENV</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">grep</span>(<span class="ruby-regexp">/\ABUNDLE_.+/</span>)
<span class="ruby-identifier">keys</span> = <span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">|</span> <span class="ruby-ivar">@global_config</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">|</span> <span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">env_keys</span>
<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">key</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-regexp">/^BUNDLE_/</span>, <span class="ruby-string">""</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/__/</span>, <span class="ruby-string">"."</span>).<span class="ruby-identifier">downcase</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-allow_sudo-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">allow_sudo?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="allow_sudo-3F-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 267</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">allow_sudo?</span>
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-value">:path</span>)
<span class="ruby-identifier">path_configured</span> = <span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>) <span class="ruby-operator">||</span> <span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-operator">!</span><span class="ruby-identifier">path_configured</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-app_cache_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">app_cache_path</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="app_cache_path-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 277</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">app_cache_path</span>
<span class="ruby-ivar">@app_cache_path</span> <span class="ruby-operator">||=</span> <span class="ruby-keyword">self</span>[<span class="ruby-value">:cache_path</span>] <span class="ruby-operator">||</span> <span class="ruby-string">"vendor/cache"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-credentials_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">credentials_for</span><span
class="method-args">(uri)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="credentials_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 161</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">credentials_for</span>(<span class="ruby-identifier">uri</span>)
<span class="ruby-keyword">self</span>[<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword">self</span>[<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">host</span>]
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-gem_mirrors" class="method-detail ">
<div class="method-heading">
<span class="method-name">gem_mirrors</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="gem_mirrors-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 165</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">gem_mirrors</span>
<span class="ruby-identifier">all</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-constant">Mirrors</span>.<span class="ruby-identifier">new</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">mirrors</span>, <span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">mirrors</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">k</span>, <span class="ruby-keyword">self</span>[<span class="ruby-identifier">k</span>]) <span class="ruby-keyword">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">start_with?</span>(<span class="ruby-string">"mirror."</span>)
<span class="ruby-identifier">mirrors</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-ignore_config-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">ignore_config?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="ignore_config-3F-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 273</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">ignore_config?</span>
<span class="ruby-constant">ENV</span>[<span class="ruby-string">"BUNDLE_IGNORE_CONFIG"</span>]
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-key_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">key_for</span><span
class="method-args">(key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="key_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 290</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">key_for</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-constant">Settings</span>.<span class="ruby-identifier">normalize_uri</span>(<span class="ruby-identifier">key</span>).<span class="ruby-identifier">to_s</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>) <span class="ruby-operator">&&</span> <span class="ruby-regexp">/https?:/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">key</span>
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-string">"."</span>, <span class="ruby-string">"__"</span>).<span class="ruby-identifier">upcase</span>
<span class="ruby-node">"BUNDLE_#{key}"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-local_overrides" class="method-detail ">
<div class="method-heading">
<span class="method-name">local_overrides</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="local_overrides-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 144</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">local_overrides</span>
<span class="ruby-identifier">repos</span> = {}
<span class="ruby-identifier">all</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">repos</span>[<span class="ruby-node">$'</span>] = <span class="ruby-keyword">self</span>[<span class="ruby-identifier">k</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^local\./</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">repos</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-locations" class="method-detail ">
<div class="method-heading">
<span class="method-name">locations</span><span
class="method-args">(key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="locations-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 172</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">locations</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span> = {}
<span class="ruby-identifier">locations</span>[<span class="ruby-value">:temporary</span>] = <span class="ruby-ivar">@temporary</span>[<span class="ruby-identifier">key</span>] <span class="ruby-keyword">if</span> <span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span>[<span class="ruby-value">:local</span>] = <span class="ruby-ivar">@local_config</span>[<span class="ruby-identifier">key</span>] <span class="ruby-keyword">if</span> <span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span>[<span class="ruby-value">:env</span>] = <span class="ruby-constant">ENV</span>[<span class="ruby-identifier">key</span>] <span class="ruby-keyword">if</span> <span class="ruby-constant">ENV</span>[<span class="ruby-identifier">key</span>]
<span class="ruby-identifier">locations</span>[<span class="ruby-value">:global</span>] = <span class="ruby-ivar">@global_config</span>[<span class="ruby-identifier">key</span>] <span class="ruby-keyword">if</span> <span class="ruby-ivar">@global_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span>[<span class="ruby-value">:default</span>] = <span class="ruby-constant">DEFAULT_CONFIG</span>[<span class="ruby-identifier">key</span>] <span class="ruby-keyword">if</span> <span class="ruby-constant">DEFAULT_CONFIG</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-mirror_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">mirror_for</span><span
class="method-args">(uri)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="mirror_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 152</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">mirror_for</span>(<span class="ruby-identifier">uri</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
<span class="ruby-identifier">require_relative</span> <span class="ruby-string">"vendored_uri"</span>
<span class="ruby-identifier">uri</span> = <span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>(<span class="ruby-identifier">uri</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">gem_mirrors</span>.<span class="ruby-identifier">for</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">uri</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-path" class="method-detail ">
<div class="method-heading">
<span class="method-name">path</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>for legacy reasons, in <a href="../Bundler.html"><code>Bundler</code></a> 2, we do not respect :disable_shared_gems</p>
<div class="method-source-code" id="path-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 209</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">path</span>
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-value">:path</span>)
<span class="ruby-identifier">path</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-identifier">key</span>] <span class="ruby-operator">||</span> <span class="ruby-ivar">@global_config</span>[<span class="ruby-identifier">key</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">path</span> <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>) <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-keyword">return</span> <span class="ruby-constant">Path</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">path</span>, <span class="ruby-keyword">false</span>, <span class="ruby-keyword">false</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">system_path</span> = <span class="ruby-keyword">self</span>[<span class="ruby-string">"path.system"</span>] <span class="ruby-operator">||</span> (<span class="ruby-keyword">self</span>[<span class="ruby-value">:disable_shared_gems</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">false</span>)
<span class="ruby-constant">Path</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>[<span class="ruby-value">:path</span>], <span class="ruby-identifier">system_path</span>, <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">default_install_uses_path?</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-pretty_values_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">pretty_values_for</span><span
class="method-args">(exposed_key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="pretty_values_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 183</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">pretty_values_for</span>(<span class="ruby-identifier">exposed_key</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">exposed_key</span>)
<span class="ruby-identifier">locations</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@temporary</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"Set for the current command: #{converted_value(@temporary[key], exposed_key).inspect}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@local_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"Set for your local app (#{local_config_file}): #{converted_value(@local_config[key], exposed_key).inspect}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-identifier">key</span>]
<span class="ruby-identifier">locations</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"Set via #{key}: #{converted_value(value, exposed_key).inspect}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@global_config</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">locations</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"Set for the current user (#{global_config_file}): #{converted_value(@global_config[key], exposed_key).inspect}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> [<span class="ruby-node">"You have not configured a value for `#{exposed_key}`"</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">locations</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">locations</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_command_option" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_command_option</span><span
class="method-args">(key, value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_command_option-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 97</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_command_option</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-keyword">if</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">forget_cli_options?</span>
<span class="ruby-identifier">temporary</span>(<span class="ruby-identifier">key</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">value</span>)
<span class="ruby-identifier">value</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">set_local</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_command_option_if_given" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_command_option_if_given</span><span
class="method-args">(key, value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_command_option_if_given-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 106</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_command_option_if_given</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">nil?</span>
<span class="ruby-identifier">set_command_option</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_global" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_global</span><span
class="method-args">(key, value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_global-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 130</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_global</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-identifier">set_key</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>, <span class="ruby-ivar">@global_config</span>, <span class="ruby-identifier">global_config_file</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_local" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_local</span><span
class="method-args">(key, value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_local-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 111</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_local</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>)
<span class="ruby-identifier">local_config_file</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">raise</span>(<span class="ruby-constant">GemfileNotFound</span>, <span class="ruby-string">"Could not locate Gemfile"</span>)
<span class="ruby-identifier">set_key</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span>, <span class="ruby-ivar">@local_config</span>, <span class="ruby-identifier">local_config_file</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-temporary" class="method-detail ">
<div class="method-heading">
<span class="method-name">temporary</span><span
class="method-args">(update) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="temporary-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 117</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">temporary</span>(<span class="ruby-identifier">update</span>)
<span class="ruby-identifier">existing</span> = <span class="ruby-constant">Hash</span>[<span class="ruby-identifier">update</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">_</span><span class="ruby-operator">|</span> [<span class="ruby-identifier">k</span>, <span class="ruby-ivar">@temporary</span>[<span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">k</span>)]] }]
<span class="ruby-identifier">update</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">set_key</span>(<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>, <span class="ruby-ivar">@temporary</span>, <span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-identifier">existing</span>.<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">set_key</span>(<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>, <span class="ruby-ivar">@temporary</span>, <span class="ruby-keyword">nil</span>) }
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-validate-21" class="method-detail ">
<div class="method-heading">
<span class="method-name">validate!</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="validate-21-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 281</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">validate!</span>
<span class="ruby-identifier">all</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">raw_key</span><span class="ruby-operator">|</span>
[<span class="ruby-ivar">@local_config</span>, <span class="ruby-constant">ENV</span>, <span class="ruby-ivar">@global_config</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">settings</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">value</span> = <span class="ruby-identifier">converted_value</span>(<span class="ruby-identifier">settings</span>[<span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">raw_key</span>)], <span class="ruby-identifier">raw_key</span>)
<span class="ruby-constant">Validator</span>.<span class="ruby-identifier">validate!</span>(<span class="ruby-identifier">raw_key</span>, <span class="ruby-identifier">value</span>, <span class="ruby-identifier">settings</span>.<span class="ruby-identifier">to_hash</span>.<span class="ruby-identifier">dup</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="private-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Private Instance Methods</h3>
</header>
<div id="method-i-array_to_s" class="method-detail ">
<div class="method-heading">
<span class="method-name">array_to_s</span><span
class="method-args">(array)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="array_to_s-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 336</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">array_to_s</span>(<span class="ruby-identifier">array</span>)
<span class="ruby-identifier">array</span> = <span class="ruby-constant">Array</span>(<span class="ruby-identifier">array</span>)
<span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">array</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">array</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">":"</span>).<span class="ruby-identifier">tr</span>(<span class="ruby-string">" "</span>, <span class="ruby-string">":"</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-converted_value" class="method-detail ">
<div class="method-heading">
<span class="method-name">converted_value</span><span
class="method-args">(value, key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="converted_value-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 363</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">converted_value</span>(<span class="ruby-identifier">value</span>, <span class="ruby-identifier">key</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">is_array</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">to_array</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword">elsif</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">nil?</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">elsif</span> <span class="ruby-identifier">is_bool</span>(<span class="ruby-identifier">key</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">value</span> <span class="ruby-operator">==</span> <span class="ruby-string">"false"</span>
<span class="ruby-identifier">to_bool</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword">elsif</span> <span class="ruby-identifier">is_num</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_i</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-global_config_file" class="method-detail ">
<div class="method-heading">
<span class="method-name">global_config_file</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="global_config_file-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 377</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">global_config_file</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">ENV</span>[<span class="ruby-string">"BUNDLE_CONFIG"</span>] <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-constant">ENV</span>[<span class="ruby-string">"BUNDLE_CONFIG"</span>].<span class="ruby-identifier">empty?</span>
<span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">ENV</span>[<span class="ruby-string">"BUNDLE_CONFIG"</span>])
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">user_bundle_path</span>(<span class="ruby-string">"config"</span>)
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">PermissionError</span>, <span class="ruby-constant">GenericSystemCallError</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-is_array" class="method-detail ">
<div class="method-heading">
<span class="method-name">is_array</span><span
class="method-args">(key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="is_array-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 327</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">is_array</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-constant">ARRAY_KEYS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-is_bool" class="method-detail ">
<div class="method-heading">
<span class="method-name">is_bool</span><span
class="method-args">(name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="is_bool-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 310</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">is_bool</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-constant">BOOL_KEYS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-operator">||</span> <span class="ruby-constant">BOOL_KEYS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">parent_setting_for</span>(<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>))
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-is_num" class="method-detail ">
<div class="method-heading">
<span class="method-name">is_num</span><span
class="method-args">(key)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="is_num-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 323</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">is_num</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-constant">NUMBER_KEYS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-load_config" class="method-detail ">
<div class="method-heading">
<span class="method-name">load_config</span><span
class="method-args">(config_file)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="load_config-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 393</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">load_config</span>(<span class="ruby-identifier">config_file</span>)
<span class="ruby-keyword">return</span> {} <span class="ruby-keyword">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">config_file</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">ignore_config?</span>
<span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">filesystem_access</span>(<span class="ruby-identifier">config_file</span>, <span class="ruby-value">:read</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">valid_file</span> = <span class="ruby-identifier">file</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-identifier">file</span>.<span class="ruby-identifier">size</span>.<span class="ruby-identifier">zero?</span>
<span class="ruby-keyword">return</span> {} <span class="ruby-keyword">unless</span> <span class="ruby-identifier">valid_file</span>
<span class="ruby-identifier">require_relative</span> <span class="ruby-string">"yaml_serializer"</span>
<span class="ruby-constant">YAMLSerializer</span>.<span class="ruby-identifier">load</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-local_config_file" class="method-detail ">
<div class="method-heading">
<span class="method-name">local_config_file</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="local_config_file-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 389</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">local_config_file</span>
<span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@root</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">"config"</span>) <span class="ruby-keyword">if</span> <span class="ruby-ivar">@root</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parent_setting_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">parent_setting_for</span><span
class="method-args">(name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="parent_setting_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 298</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parent_setting_for</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">split_specific_setting_for</span>(<span class="ruby-identifier">name</span>)[<span class="ruby-value">0</span>]
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_key" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_key</span><span
class="method-args">(raw_key, value, hash, file)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_key-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 342</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_key</span>(<span class="ruby-identifier">raw_key</span>, <span class="ruby-identifier">value</span>, <span class="ruby-identifier">hash</span>, <span class="ruby-identifier">file</span>)
<span class="ruby-identifier">raw_key</span> = <span class="ruby-identifier">raw_key</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-identifier">value</span> = <span class="ruby-identifier">array_to_s</span>(<span class="ruby-identifier">value</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">is_array</span>(<span class="ruby-identifier">raw_key</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key_for</span>(<span class="ruby-identifier">raw_key</span>)
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">key</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">value</span>
<span class="ruby-identifier">hash</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">hash</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">nil?</span>
<span class="ruby-constant">Validator</span>.<span class="ruby-identifier">validate!</span>(<span class="ruby-identifier">raw_key</span>, <span class="ruby-identifier">converted_value</span>(<span class="ruby-identifier">value</span>, <span class="ruby-identifier">raw_key</span>), <span class="ruby-identifier">hash</span>)
<span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">file</span>
<span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">filesystem_access</span>(<span class="ruby-identifier">file</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span>
<span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">mkdir_p</span>(<span class="ruby-identifier">p</span>.<span class="ruby-identifier">dirname</span>)
<span class="ruby-identifier">require_relative</span> <span class="ruby-string">"yaml_serializer"</span>
<span class="ruby-identifier">p</span>.<span class="ruby-identifier">open</span>(<span class="ruby-string">"w"</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">write</span>(<span class="ruby-constant">YAMLSerializer</span>.<span class="ruby-identifier">dump</span>(<span class="ruby-identifier">hash</span>)) }
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-specific_gem_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">specific_gem_for</span><span
class="method-args">(name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="specific_gem_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 302</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">specific_gem_for</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">split_specific_setting_for</span>(<span class="ruby-identifier">name</span>)[<span class="ruby-value">1</span>]
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-split_specific_setting_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">split_specific_setting_for</span><span
class="method-args">(name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="split_specific_setting_for-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 306</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">split_specific_setting_for</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">name</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">"."</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-to_array" class="method-detail ">
<div class="method-heading">
<span class="method-name">to_array</span><span
class="method-args">(value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="to_array-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 331</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_array</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword">return</span> [] <span class="ruby-keyword">unless</span> <span class="ruby-identifier">value</span>
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">":"</span>).<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_sym</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-to_bool" class="method-detail ">
<div class="method-heading">
<span class="method-name">to_bool</span><span
class="method-args">(value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="to_bool-source">
<pre><span class="ruby-comment"># File lib/bundler/settings.rb, line 314</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_bool</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword">case</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-keyword">nil</span>, <span class="ruby-regexp">/\A(false|f|no|n|0|)\z/i</span>, <span class="ruby-keyword">false</span>
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
</section>
</main>
<footer id="validator-badges" role="contentinfo">
<p><a href="https://validator.w3.org/check/referer">Validate</a>
<p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.1.
<p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>