File: C:/Ruby27-x64/share/doc/ruby/html/Bundler/Dsl.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>class Bundler::Dsl - 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>
<div id="includes-section" class="nav-section">
<h3>Included Modules</h3>
<ul class="link-list">
<li><a class="include" href="RubyDsl.html">Bundler::RubyDsl</a>
</ul>
</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-evaluate">::evaluate</a>
<li ><a href="#method-c-new">::new</a>
<li ><a href="#method-i-add_git_sources">#add_git_sources</a>
<li ><a href="#method-i-check_primary_source_safety">#check_primary_source_safety</a>
<li ><a href="#method-i-env">#env</a>
<li ><a href="#method-i-eval_gemfile">#eval_gemfile</a>
<li ><a href="#method-i-gem">#gem</a>
<li ><a href="#method-i-gemfile_root">#gemfile_root</a>
<li ><a href="#method-i-gemspec">#gemspec</a>
<li ><a href="#method-i-git">#git</a>
<li ><a href="#method-i-git_source">#git_source</a>
<li ><a href="#method-i-github">#github</a>
<li ><a href="#method-i-group">#group</a>
<li ><a href="#method-i-install_if">#install_if</a>
<li ><a href="#method-i-method_missing">#method_missing</a>
<li ><a href="#method-i-normalize_group_options">#normalize_group_options</a>
<li ><a href="#method-i-normalize_hash">#normalize_hash</a>
<li ><a href="#method-i-normalize_options">#normalize_options</a>
<li ><a href="#method-i-normalize_source">#normalize_source</a>
<li ><a href="#method-i-path">#path</a>
<li ><a href="#method-i-platform">#platform</a>
<li ><a href="#method-i-platforms">#platforms</a>
<li ><a href="#method-i-plugin">#plugin</a>
<li ><a href="#method-i-source">#source</a>
<li ><a href="#method-i-to_definition">#to_definition</a>
<li ><a href="#method-i-valid_keys">#valid_keys</a>
<li ><a href="#method-i-validate_keys">#validate_keys</a>
<li ><a href="#method-i-warn_deprecated_git_source">#warn_deprecated_git_source</a>
<li ><a href="#method-i-with_source">#with_source</a>
</ul>
</div>
</div>
</nav>
<main role="main" aria-labelledby="class-Bundler::Dsl">
<h1 id="class-Bundler::Dsl" class="class">
class Bundler::Dsl
</h1>
<section class="description">
</section>
<section id="5Buntitled-5D" class="documentation-section">
<section class="constants-list">
<header>
<h3>Constants</h3>
</header>
<dl>
<dt id="VALID_KEYS">VALID_KEYS
<dd>
<dt id="VALID_PLATFORMS">VALID_PLATFORMS
<dd>
</dl>
</section>
<section class="attribute-method-details" class="method-section">
<header>
<h3>Attributes</h3>
</header>
<div id="attribute-i-dependencies" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">dependencies</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
</div>
</div>
<div id="attribute-i-gemspecs" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">gemspecs</span><span
class="attribute-access-type">[R]</span>
</div>
<div class="method-description">
</div>
</div>
</section>
<section id="public-class-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Class Methods</h3>
</header>
<div id="method-c-evaluate" class="method-detail ">
<div class="method-heading">
<span class="method-name">evaluate</span><span
class="method-args">(gemfile, lockfile, unlock)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="evaluate-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 10</span>
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">evaluate</span>(<span class="ruby-identifier">gemfile</span>, <span class="ruby-identifier">lockfile</span>, <span class="ruby-identifier">unlock</span>)
<span class="ruby-identifier">builder</span> = <span class="ruby-identifier">new</span>
<span class="ruby-identifier">builder</span>.<span class="ruby-identifier">eval_gemfile</span>(<span class="ruby-identifier">gemfile</span>)
<span class="ruby-identifier">builder</span>.<span class="ruby-identifier">to_definition</span>(<span class="ruby-identifier">lockfile</span>, <span class="ruby-identifier">unlock</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-new" class="method-detail ">
<div class="method-heading">
<span class="method-name">new</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="new-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 24</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>
<span class="ruby-ivar">@source</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@sources</span> = <span class="ruby-constant">SourceList</span>.<span class="ruby-identifier">new</span>
<span class="ruby-ivar">@git_sources</span> = {}
<span class="ruby-ivar">@dependencies</span> = []
<span class="ruby-ivar">@groups</span> = []
<span class="ruby-ivar">@install_conditionals</span> = []
<span class="ruby-ivar">@optional_groups</span> = []
<span class="ruby-ivar">@platforms</span> = []
<span class="ruby-ivar">@env</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@ruby_version</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@gemspecs</span> = []
<span class="ruby-ivar">@gemfile</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@gemfiles</span> = []
<span class="ruby-identifier">add_git_sources</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-env" class="method-detail ">
<div class="method-heading">
<span class="method-name">env</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="env-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 268</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">env</span>(<span class="ruby-identifier">name</span>)
<span class="ruby-identifier">old</span> = <span class="ruby-ivar">@env</span>
<span class="ruby-ivar">@env</span> = <span class="ruby-identifier">name</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-ivar">@env</span> = <span class="ruby-identifier">old</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-eval_gemfile" class="method-detail ">
<div class="method-heading">
<span class="method-name">eval_gemfile</span><span
class="method-args">(gemfile, contents = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="eval_gemfile-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 41</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">eval_gemfile</span>(<span class="ruby-identifier">gemfile</span>, <span class="ruby-identifier">contents</span> = <span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">expanded_gemfile_path</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">gemfile</span>).<span class="ruby-identifier">expand_path</span>(<span class="ruby-ivar">@gemfile</span> <span class="ruby-operator">&&</span> <span class="ruby-ivar">@gemfile</span>.<span class="ruby-identifier">parent</span>)
<span class="ruby-identifier">original_gemfile</span> = <span class="ruby-ivar">@gemfile</span>
<span class="ruby-ivar">@gemfile</span> = <span class="ruby-identifier">expanded_gemfile_path</span>
<span class="ruby-ivar">@gemfiles</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">expanded_gemfile_path</span>
<span class="ruby-identifier">contents</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">read_file</span>(<span class="ruby-ivar">@gemfile</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-identifier">instance_eval</span>(<span class="ruby-identifier">contents</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">tap</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">untaint</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">RUBY_VERSION</span> <span class="ruby-operator"><</span> <span class="ruby-string">"2.7"</span> }, <span class="ruby-identifier">gemfile</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-value">1</span>)
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">e</span> <span class="ruby-comment"># rubocop:disable Lint/RescueException</span>
<span class="ruby-identifier">message</span> = <span class="ruby-string">"There was an error "</span> \
<span class="ruby-node">"#{e.is_a?(GemfileEvalError) ? "evaluating" : "parsing"} "</span> \
<span class="ruby-node">"`#{File.basename gemfile.to_s}`: #{e.message}"</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">DSLError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">gemfile</span>, <span class="ruby-identifier">e</span>.<span class="ruby-identifier">backtrace</span>, <span class="ruby-identifier">contents</span>)
<span class="ruby-keyword">ensure</span>
<span class="ruby-ivar">@gemfile</span> = <span class="ruby-identifier">original_gemfile</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-gem" class="method-detail ">
<div class="method-heading">
<span class="method-name">gem</span><span
class="method-args">(name, *args)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="gem-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 94</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">gem</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> {}
<span class="ruby-identifier">options</span>[<span class="ruby-string">"gemfile"</span>] = <span class="ruby-ivar">@gemfile</span>
<span class="ruby-identifier">version</span> = <span class="ruby-identifier">args</span> <span class="ruby-operator">||</span> [<span class="ruby-string">">= 0"</span>]
<span class="ruby-identifier">normalize_options</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">version</span>, <span class="ruby-identifier">options</span>)
<span class="ruby-identifier">dep</span> = <span class="ruby-constant">Dependency</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">version</span>, <span class="ruby-identifier">options</span>)
<span class="ruby-comment"># if there's already a dependency with this name we try to prefer one</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">current</span> = <span class="ruby-ivar">@dependencies</span>.<span class="ruby-identifier">find</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">name</span> }
<span class="ruby-identifier">deleted_dep</span> = <span class="ruby-ivar">@dependencies</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">current</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">current</span>.<span class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span class="ruby-value">:development</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">current</span>.<span class="ruby-identifier">requirement</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">requirement</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">deleted_dep</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span class="ruby-value">:development</span>
<span class="ruby-identifier">update_prompt</span> = <span class="ruby-string">""</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-ivar">@gemfile</span>) <span class="ruby-operator">==</span> <span class="ruby-constant">Injector</span><span class="ruby-operator">::</span><span class="ruby-constant">INJECTED_GEMS</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">requirements_list</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">">= 0"</span>) <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-identifier">current</span>.<span class="ruby-identifier">requirements_list</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">">= 0"</span>)
<span class="ruby-identifier">update_prompt</span> = <span class="ruby-string">". Gem already added"</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">update_prompt</span> = <span class="ruby-node">". If you want to update the gem version, run `bundle update #{current.name}`"</span>
<span class="ruby-identifier">update_prompt</span> <span class="ruby-operator">+=</span> <span class="ruby-string">". You may also need to change the version requirement specified in the Gemfile if it's too restrictive."</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">current</span>.<span class="ruby-identifier">requirements_list</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">">= 0"</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-string">"You cannot specify the same gem twice with different version requirements.\n"</span> \
<span class="ruby-node">"You specified: #{current.name} (#{current.requirement}) and #{dep.name} (#{dep.requirement})"</span> \
<span class="ruby-node">"#{update_prompt}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">ui</span>.<span class="ruby-identifier">warn</span> <span class="ruby-node">"Your Gemfile lists the gem #{current.name} (#{current.requirement}) more than once.\n"</span> \
<span class="ruby-string">"You should probably keep only one of them.\n"</span> \
<span class="ruby-string">"Remove any duplicate entries and specify the gem only once.\n"</span> \
<span class="ruby-string">"While it's not a problem now, it could cause errors if you change the version of one of them later."</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">current</span>.<span class="ruby-identifier">source</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">source</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">deleted_dep</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span class="ruby-value">:development</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-string">"You cannot specify the same gem twice coming from different sources.\n"</span> \
<span class="ruby-node">"You specified that #{dep.name} (#{dep.requirement}) should come from "</span> \
<span class="ruby-node">"#{current.source || "an unspecified source"} and #{dep.source}\n"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@dependencies</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">dep</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-gemspec" class="method-detail ">
<div class="method-heading">
<span class="method-name">gemspec</span><span
class="method-args">(opts = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="gemspec-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 58</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">gemspec</span>(<span class="ruby-identifier">opts</span> = <span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">opts</span> <span class="ruby-operator">||=</span> {}
<span class="ruby-identifier">path</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-value">:path</span>] <span class="ruby-operator">||</span> <span class="ruby-string">"."</span>
<span class="ruby-identifier">glob</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-value">:glob</span>]
<span class="ruby-identifier">name</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-value">:name</span>]
<span class="ruby-identifier">development_group</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-value">:development_group</span>] <span class="ruby-operator">||</span> <span class="ruby-value">:development</span>
<span class="ruby-identifier">expanded_path</span> = <span class="ruby-identifier">gemfile_root</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">path</span>)
<span class="ruby-identifier">gemspecs</span> = <span class="ruby-constant">Dir</span>[<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">expanded_path</span>, <span class="ruby-string">"{,*}.gemspec"</span>)].<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">g</span><span class="ruby-operator">|</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">load_gemspec</span>(<span class="ruby-identifier">g</span>) }.<span class="ruby-identifier">compact</span>
<span class="ruby-identifier">gemspecs</span>.<span class="ruby-identifier">reject!</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">name</span> } <span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span>
<span class="ruby-constant">Index</span>.<span class="ruby-identifier">sort_specs</span>(<span class="ruby-identifier">gemspecs</span>)
<span class="ruby-identifier">specs_by_name_and_version</span> = <span class="ruby-identifier">gemspecs</span>.<span class="ruby-identifier">group_by</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> [<span class="ruby-identifier">s</span>.<span class="ruby-identifier">name</span>, <span class="ruby-identifier">s</span>.<span class="ruby-identifier">version</span>] }
<span class="ruby-keyword">case</span> <span class="ruby-identifier">specs_by_name_and_version</span>.<span class="ruby-identifier">size</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">1</span>
<span class="ruby-identifier">specs</span> = <span class="ruby-identifier">specs_by_name_and_version</span>.<span class="ruby-identifier">values</span>.<span class="ruby-identifier">first</span>
<span class="ruby-identifier">spec</span> = <span class="ruby-identifier">specs</span>.<span class="ruby-identifier">find</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">match_platform</span>(<span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">local_platform</span>) } <span class="ruby-operator">||</span> <span class="ruby-identifier">specs</span>.<span class="ruby-identifier">first</span>
<span class="ruby-ivar">@gemspecs</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">spec</span>
<span class="ruby-identifier">gem_platforms</span> = <span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">Dependency</span><span class="ruby-operator">::</span><span class="ruby-constant">REVERSE_PLATFORM_MAP</span>[<span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">GemHelpers</span>.<span class="ruby-identifier">generic_local_platform</span>]
<span class="ruby-identifier">gem</span> <span class="ruby-identifier">spec</span>.<span class="ruby-identifier">name</span>, <span class="ruby-value">:name</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">spec</span>.<span class="ruby-identifier">name</span>, <span class="ruby-value">:path</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">path</span>, <span class="ruby-value">:glob</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">glob</span>, <span class="ruby-value">:platforms</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">gem_platforms</span>
<span class="ruby-identifier">group</span>(<span class="ruby-identifier">development_group</span>) <span class="ruby-keyword">do</span>
<span class="ruby-identifier">spec</span>.<span class="ruby-identifier">development_dependencies</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">dep</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">gem</span> <span class="ruby-identifier">dep</span>.<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span>(<span class="ruby-identifier">dep</span>.<span class="ruby-identifier">requirement</span>.<span class="ruby-identifier">as_list</span> <span class="ruby-operator">+</span> [<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:development</span>])
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-node">"There are no gemspecs at #{expanded_path}"</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-node">"There are multiple gemspecs at #{expanded_path}. "</span> \
<span class="ruby-string">"Please use the :name option to specify which one should be used"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-git" class="method-detail ">
<div class="method-heading">
<span class="method-name">git</span><span
class="method-args">(uri, options = {}, &blk)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="git-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 209</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">git</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">options</span> = {}, <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">msg</span> = <span class="ruby-string">"You can no longer specify a git source by itself. Instead, \n"</span> \
<span class="ruby-string">"either use the :git option on a gem, or specify the gems that \n"</span> \
<span class="ruby-string">"bundler should find in the git source by passing a block to \n"</span> \
<span class="ruby-string">"the git method, like: \n\n"</span> \
<span class="ruby-string">" git 'git://github.com/rails/rails.git' do\n"</span> \
<span class="ruby-string">" gem 'rails'\n"</span> \
<span class="ruby-string">" end"</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">DeprecatedError</span>, <span class="ruby-identifier">msg</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">with_source</span>(<span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_git_source</span>(<span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">options</span>).<span class="ruby-identifier">merge</span>(<span class="ruby-string">"uri"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">uri</span>)), <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-git_source" class="method-detail ">
<div class="method-heading">
<span class="method-name">git_source</span><span
class="method-args">(name, &block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="git_source-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 173</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">git_source</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-string">"You need to pass a block to #git_source"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">valid_keys</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-node">"You cannot use #{name} as a git source. It "</span> \
<span class="ruby-node">"is a reserved key. Reserved keys are: #{valid_keys.join(", ")}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@git_sources</span>[<span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>] = <span class="ruby-identifier">block</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-github" class="method-detail ">
<div class="method-heading">
<span class="method-name">github</span><span
class="method-args">(repo, options = {}) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="github-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 224</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">github</span>(<span class="ruby-identifier">repo</span>, <span class="ruby-identifier">options</span> = {})
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">"GitHub sources require a block"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">DeprecatedError</span>, <span class="ruby-string">"The #github method has been removed"</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">skip_default_git_sources?</span>
<span class="ruby-identifier">github_uri</span> = <span class="ruby-ivar">@git_sources</span>[<span class="ruby-string">"github"</span>].<span class="ruby-identifier">call</span>(<span class="ruby-identifier">repo</span>)
<span class="ruby-identifier">git_options</span> = <span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">options</span>).<span class="ruby-identifier">merge</span>(<span class="ruby-string">"uri"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">github_uri</span>)
<span class="ruby-identifier">git_source</span> = <span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_git_source</span>(<span class="ruby-identifier">git_options</span>)
<span class="ruby-identifier">with_source</span>(<span class="ruby-identifier">git_source</span>) { <span class="ruby-keyword">yield</span> }
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-group" class="method-detail ">
<div class="method-heading">
<span class="method-name">group</span><span
class="method-args">(*args) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="group-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 237</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">group</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> {}
<span class="ruby-identifier">normalize_group_options</span>(<span class="ruby-identifier">options</span>, <span class="ruby-identifier">args</span>)
<span class="ruby-ivar">@groups</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">args</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-string">"optional"</span>]
<span class="ruby-identifier">optional_groups</span> = <span class="ruby-identifier">args</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@optional_groups</span>
<span class="ruby-ivar">@optional_groups</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">optional_groups</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> { <span class="ruby-ivar">@groups</span>.<span class="ruby-identifier">pop</span> }
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-install_if" class="method-detail ">
<div class="method-heading">
<span class="method-name">install_if</span><span
class="method-args">(*args) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="install_if-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 253</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">install_if</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-ivar">@install_conditionals</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">args</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> { <span class="ruby-ivar">@install_conditionals</span>.<span class="ruby-identifier">pop</span> }
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-method_missing" class="method-detail ">
<div class="method-heading">
<span class="method-name">method_missing</span><span
class="method-args">(name, *args)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="method_missing-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 280</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">method_missing</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">"Undefined local variable or method `#{name}' for Gemfile"</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">(path, options = {}, &blk)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="path-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 186</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">path</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">options</span> = {}, <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">msg</span> = <span class="ruby-string">"You can no longer specify a path source by itself. Instead, \n"</span> \
<span class="ruby-string">"either use the :path option on a gem, or specify the gems that \n"</span> \
<span class="ruby-string">"bundler should find in the path source by passing a block to \n"</span> \
<span class="ruby-string">"the path method, like: \n\n"</span> \
<span class="ruby-string">" path 'dir/containing/rails' do\n"</span> \
<span class="ruby-string">" gem 'rails'\n"</span> \
<span class="ruby-string">" end\n\n"</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">DeprecatedError</span>, <span class="ruby-identifier">msg</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">disable_multisource?</span>
<span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">major_deprecation</span>(<span class="ruby-value">2</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">strip</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">source_options</span> = <span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">options</span>).<span class="ruby-identifier">merge</span>(
<span class="ruby-string">"path"</span> <span class="ruby-operator">=></span> <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">path</span>),
<span class="ruby-string">"root_path"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">gemfile_root</span>,
<span class="ruby-string">"gemspec"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">gemspecs</span>.<span class="ruby-identifier">find</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">g</span><span class="ruby-operator">|</span> <span class="ruby-identifier">g</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">options</span>[<span class="ruby-string">"name"</span>] }
)
<span class="ruby-identifier">source</span> = <span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_path_source</span>(<span class="ruby-identifier">source_options</span>)
<span class="ruby-identifier">with_source</span>(<span class="ruby-identifier">source</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-platform" class="method-detail method-alias">
<div class="method-heading">
<span class="method-name">platform</span><span
class="method-args">(*platforms)</span>
</div>
<div class="method-description">
</div>
<div class="aliases">
Alias for: <a href="Dsl.html#method-i-platforms">platforms</a>
</div>
</div>
<div id="method-i-platforms" class="method-detail ">
<div class="method-heading">
<span class="method-name">platforms</span><span
class="method-args">(*platforms) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="platforms-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 260</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">platforms</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">platforms</span>)
<span class="ruby-ivar">@platforms</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">platforms</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-identifier">platforms</span>.<span class="ruby-identifier">each</span> { <span class="ruby-ivar">@platforms</span>.<span class="ruby-identifier">pop</span> }
<span class="ruby-keyword">end</span></pre>
</div>
</div>
<div class="aliases">
Also aliased as: <a href="Dsl.html#method-i-platform">platform</a>
</div>
</div>
<div id="method-i-plugin" class="method-detail ">
<div class="method-heading">
<span class="method-name">plugin</span><span
class="method-args">(*args)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="plugin-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 276</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">plugin</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-comment"># Pass on</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-source" class="method-detail ">
<div class="method-heading">
<span class="method-name">source</span><span
class="method-args">(source, *args, &blk)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="source-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 148</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">source</span>(<span class="ruby-identifier">source</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Hash</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> {}
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">options</span>)
<span class="ruby-identifier">source</span> = <span class="ruby-identifier">normalize_source</span>(<span class="ruby-identifier">source</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-string">"type"</span>)
<span class="ruby-identifier">options</span>[<span class="ruby-string">"type"</span>] = <span class="ruby-identifier">options</span>[<span class="ruby-string">"type"</span>].<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">unless</span> <span class="ruby-constant">Plugin</span>.<span class="ruby-identifier">source?</span>(<span class="ruby-identifier">options</span>[<span class="ruby-string">"type"</span>])
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-node">"No plugin sources available for #{options["type"]}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-string">"You need to pass a block to #source with :type option"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">source_opts</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-string">"uri"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">source</span>)
<span class="ruby-identifier">with_source</span>(<span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_plugin_source</span>(<span class="ruby-identifier">options</span>[<span class="ruby-string">"type"</span>], <span class="ruby-identifier">source_opts</span>), <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">elsif</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-identifier">with_source</span>(<span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_rubygems_source</span>(<span class="ruby-string">"remotes"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">source</span>), <span class="ruby-operator">&</span><span class="ruby-identifier">blk</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">check_primary_source_safety</span>(<span class="ruby-ivar">@sources</span>)
<span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">global_rubygems_source</span> = <span class="ruby-identifier">source</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-to_definition" class="method-detail ">
<div class="method-heading">
<span class="method-name">to_definition</span><span
class="method-args">(lockfile, unlock)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="to_definition-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 233</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_definition</span>(<span class="ruby-identifier">lockfile</span>, <span class="ruby-identifier">unlock</span>)
<span class="ruby-constant">Definition</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">lockfile</span>, <span class="ruby-ivar">@dependencies</span>, <span class="ruby-ivar">@sources</span>, <span class="ruby-identifier">unlock</span>, <span class="ruby-ivar">@ruby_version</span>, <span class="ruby-ivar">@optional_groups</span>, <span class="ruby-ivar">@gemfiles</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-add_git_sources" class="method-detail ">
<div class="method-heading">
<span class="method-name">add_git_sources</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="add_git_sources-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 286</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">add_git_sources</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">skip_default_git_sources?</span>
<span class="ruby-identifier">git_source</span>(<span class="ruby-value">:github</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">repo_name</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">warn_deprecated_git_source</span>(<span class="ruby-value">:github</span>, <span class="ruby-identifier"><<-'RUBY'</span>.<span class="ruby-identifier">strip</span>, <span class="ruby-string">'Change any "reponame" :github sources to "username/reponame".'</span>)
<span class="ruby-value">"https://github.com/#{repo_name}.git"
</span><span class="ruby-identifier"> RUBY</span>
<span class="ruby-identifier">repo_name</span> = <span class="ruby-node">"#{repo_name}/#{repo_name}"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">repo_name</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">"/"</span>)
<span class="ruby-node">"https://github.com/#{repo_name}.git"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">git_source</span>(<span class="ruby-value">:gist</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">repo_name</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">warn_deprecated_git_source</span>(<span class="ruby-value">:gist</span>, <span class="ruby-string">'"https://gist.github.com/#{repo_name}.git"'</span>)
<span class="ruby-node">"https://gist.github.com/#{repo_name}.git"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">git_source</span>(<span class="ruby-value">:bitbucket</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">repo_name</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">warn_deprecated_git_source</span>(<span class="ruby-value">:bitbucket</span>, <span class="ruby-identifier"><<-'RUBY'</span>.<span class="ruby-identifier">strip</span>)
<span class="ruby-value">user_name, repo_name = repo_name.split("/")
repo_name ||= user_name
"https://#{user_name}@bitbucket.org/#{user_name}/#{repo_name}.git"
</span><span class="ruby-identifier"> RUBY</span>
<span class="ruby-identifier">user_name</span>, <span class="ruby-identifier">repo_name</span> = <span class="ruby-identifier">repo_name</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">"/"</span>)
<span class="ruby-identifier">repo_name</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">user_name</span>
<span class="ruby-node">"https://#{user_name}@bitbucket.org/#{user_name}/#{repo_name}.git"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-check_primary_source_safety" class="method-detail ">
<div class="method-heading">
<span class="method-name">check_primary_source_safety</span><span
class="method-args">(source_list)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="check_primary_source_safety-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 447</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">check_primary_source_safety</span>(<span class="ruby-identifier">source_list</span>)
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">source_list</span>.<span class="ruby-identifier">rubygems_primary_remotes</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">source_list</span>.<span class="ruby-identifier">global_rubygems_source</span>.<span class="ruby-identifier">nil?</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">disable_multisource?</span>
<span class="ruby-identifier">msg</span> = <span class="ruby-string">"This Gemfile contains multiple primary sources. "</span> \
<span class="ruby-string">"Each source after the first must include a block to indicate which gems "</span> \
<span class="ruby-string">"should come from that source"</span>
<span class="ruby-keyword">unless</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">feature_flag</span>.<span class="ruby-identifier">bundler_2_mode?</span>
<span class="ruby-identifier">msg</span> <span class="ruby-operator">+=</span> <span class="ruby-string">". To downgrade this error to a warning, run "</span> \
<span class="ruby-string">"`bundle config unset disable_multisource`"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileEvalError</span>, <span class="ruby-identifier">msg</span>
<span class="ruby-keyword">else</span>
<span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">major_deprecation</span> <span class="ruby-value">2</span>, <span class="ruby-string">"Your Gemfile contains multiple primary sources. "</span> \
<span class="ruby-string">"Using `source` more than once without a block is a security risk, and "</span> \
<span class="ruby-string">"may result in installing unexpected gems. To resolve this warning, use "</span> \
<span class="ruby-string">"a block to indicate which gems should come from the secondary source. "</span> \
<span class="ruby-string">"To upgrade this warning to an error, run `bundle config set "</span> \
<span class="ruby-string">"disable_multisource true`."</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-gemfile_root" class="method-detail ">
<div class="method-heading">
<span class="method-name">gemfile_root</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="gemfile_root-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 586</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">gemfile_root</span>
<span class="ruby-ivar">@gemfile</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Bundler</span>.<span class="ruby-identifier">default_gemfile</span>
<span class="ruby-ivar">@gemfile</span>.<span class="ruby-identifier">dirname</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-normalize_group_options" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_group_options</span><span
class="method-args">(opts, groups)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="normalize_group_options-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 401</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_group_options</span>(<span class="ruby-identifier">opts</span>, <span class="ruby-identifier">groups</span>)
<span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">opts</span>)
<span class="ruby-identifier">groups</span> = <span class="ruby-identifier">groups</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">group</span><span class="ruby-operator">|</span> <span class="ruby-node">":#{group}"</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-string">", "</span>)
<span class="ruby-identifier">validate_keys</span>(<span class="ruby-node">"group #{groups}"</span>, <span class="ruby-identifier">opts</span>, <span class="ruby-node">%w[optional]</span>)
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"optional"</span>] <span class="ruby-operator">||=</span> <span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-normalize_hash" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_hash</span><span
class="method-args">(opts)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="normalize_hash-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 327</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_hash</span>(<span class="ruby-identifier">opts</span>)
<span class="ruby-identifier">opts</span>.<span class="ruby-identifier">keys</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">opts</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>] = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opts</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-normalize_options" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_options</span><span
class="method-args">(name, version, opts)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="normalize_options-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 338</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_options</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">version</span>, <span class="ruby-identifier">opts</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Symbol</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">%(You need to specify gem names as Strings. Use 'gem "#{name}"' instead)</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/\s/</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">%('#{name}' is not a valid gem name because it contains whitespace)</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-string">%(an empty gem name is not valid)</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">normalize_hash</span>(<span class="ruby-identifier">opts</span>)
<span class="ruby-identifier">git_names</span> = <span class="ruby-ivar">@git_sources</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>)
<span class="ruby-identifier">validate_keys</span>(<span class="ruby-node">"gem '#{name}'"</span>, <span class="ruby-identifier">opts</span>, <span class="ruby-identifier">valid_keys</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">git_names</span>)
<span class="ruby-identifier">groups</span> = <span class="ruby-ivar">@groups</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"group"</span>] = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-string">"groups"</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-string">"group"</span>]
<span class="ruby-identifier">groups</span>.<span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>(<span class="ruby-identifier">opts</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-string">"group"</span>))
<span class="ruby-identifier">groups</span> = [<span class="ruby-value">:default</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">groups</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">install_if</span> = <span class="ruby-ivar">@install_conditionals</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">install_if</span>.<span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>(<span class="ruby-identifier">opts</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-string">"install_if"</span>))
<span class="ruby-identifier">install_if</span> = <span class="ruby-identifier">install_if</span>.<span class="ruby-identifier">reduce</span>(<span class="ruby-keyword">true</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">memo</span>, <span class="ruby-identifier">val</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">memo</span> <span class="ruby-operator">&&</span> (<span class="ruby-identifier">val</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">val</span>.<span class="ruby-identifier">call</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">val</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">platforms</span> = <span class="ruby-ivar">@platforms</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"platforms"</span>] = <span class="ruby-identifier">opts</span>[<span class="ruby-string">"platform"</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-string">"platforms"</span>]
<span class="ruby-identifier">platforms</span>.<span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>(<span class="ruby-identifier">opts</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-string">"platforms"</span>))
<span class="ruby-identifier">platforms</span>.<span class="ruby-identifier">map!</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_sym</span>)
<span class="ruby-identifier">platforms</span>.<span class="ruby-identifier">each</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-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">VALID_PLATFORMS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">p</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">"`#{p}` is not a valid platform. The available options are: #{VALID_PLATFORMS.inspect}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># Save sources passed in a key</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-string">"source"</span>)
<span class="ruby-identifier">source</span> = <span class="ruby-identifier">normalize_source</span>(<span class="ruby-identifier">opts</span>[<span class="ruby-string">"source"</span>])
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"source"</span>] = <span class="ruby-ivar">@sources</span>.<span class="ruby-identifier">add_rubygems_source</span>(<span class="ruby-string">"remotes"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">source</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">git_name</span> = (<span class="ruby-identifier">git_names</span> <span class="ruby-operator">&</span> <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">keys</span>).<span class="ruby-identifier">last</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@git_sources</span>[<span class="ruby-identifier">git_name</span>]
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"git"</span>] = <span class="ruby-ivar">@git_sources</span>[<span class="ruby-identifier">git_name</span>].<span class="ruby-identifier">call</span>(<span class="ruby-identifier">opts</span>[<span class="ruby-identifier">git_name</span>])
<span class="ruby-keyword">end</span>
<span class="ruby-node">%w[git path]</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">type</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">param</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">type</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">version</span>.<span class="ruby-identifier">first</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">version</span>.<span class="ruby-identifier">first</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^\s*=?\s*(\d[^\s]*)\s*$/</span>
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-string">"name"</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">name</span>, <span class="ruby-string">"version"</span> <span class="ruby-operator">=></span> <span class="ruby-node">$1</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">options</span> = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">source</span> = <span class="ruby-identifier">send</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">param</span>, <span class="ruby-identifier">options</span>) {}
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"source"</span>] = <span class="ruby-identifier">source</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"source"</span>] <span class="ruby-operator">||=</span> <span class="ruby-ivar">@source</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"env"</span>] <span class="ruby-operator">||=</span> <span class="ruby-ivar">@env</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"platforms"</span>] = <span class="ruby-identifier">platforms</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"group"</span>] = <span class="ruby-identifier">groups</span>
<span class="ruby-identifier">opts</span>[<span class="ruby-string">"should_include"</span>] = <span class="ruby-identifier">install_if</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-normalize_source" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_source</span><span
class="method-args">(source)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="normalize_source-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 433</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_source</span>(<span class="ruby-identifier">source</span>)
<span class="ruby-keyword">case</span> <span class="ruby-identifier">source</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:gemcutter</span>, <span class="ruby-value">:rubygems</span>, <span class="ruby-value">:rubyforge</span>
<span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">major_deprecation</span> <span class="ruby-value">2</span>, <span class="ruby-node">"The source :#{source} is deprecated because HTTP "</span> \
<span class="ruby-string">"requests are insecure.\nPlease change your source to 'https://"</span> \
<span class="ruby-string">"rubygems.org' if possible, or 'http://rubygems.org' if not."</span>
<span class="ruby-string">"http://rubygems.org"</span>
<span class="ruby-keyword">when</span> <span class="ruby-constant">String</span>
<span class="ruby-identifier">source</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">"Unknown source '#{source}'"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-valid_keys" class="method-detail ">
<div class="method-heading">
<span class="method-name">valid_keys</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="valid_keys-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 334</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">valid_keys</span>
<span class="ruby-ivar">@valid_keys</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">VALID_KEYS</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-validate_keys" class="method-detail ">
<div class="method-heading">
<span class="method-name">validate_keys</span><span
class="method-args">(command, opts, valid_keys)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="validate_keys-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 410</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">validate_keys</span>(<span class="ruby-identifier">command</span>, <span class="ruby-identifier">opts</span>, <span class="ruby-identifier">valid_keys</span>)
<span class="ruby-identifier">invalid_keys</span> = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">valid_keys</span>
<span class="ruby-identifier">git_source</span> = <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">&</span> <span class="ruby-ivar">@git_sources</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-string">"branch"</span>] <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span>(<span class="ruby-identifier">opts</span>[<span class="ruby-string">"git"</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-string">"github"</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">git_source</span>.<span class="ruby-identifier">any?</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">GemfileError</span>, <span class="ruby-node">%(The `branch` option for `#{command}` is not allowed. Only gems with a git source can specify a branch)</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">true</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">invalid_keys</span>.<span class="ruby-identifier">any?</span>
<span class="ruby-identifier">message</span> = <span class="ruby-constant">String</span>.<span class="ruby-identifier">new</span>
<span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"You passed #{invalid_keys.map {|k| ":" + k }.join(", ")} "</span>
<span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">invalid_keys</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">1</span>
<span class="ruby-node">"as options for #{command}, but they are invalid."</span>
<span class="ruby-keyword">else</span>
<span class="ruby-node">"as an option for #{command}, but it is invalid."</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-node">" Valid options are: #{valid_keys.join(", ")}."</span>
<span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-string">" You may be able to resolve this by upgrading Bundler to the newest version."</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOption</span>, <span class="ruby-identifier">message</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-warn_deprecated_git_source" class="method-detail ">
<div class="method-heading">
<span class="method-name">warn_deprecated_git_source</span><span
class="method-args">(name, replacement, additional_message = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="warn_deprecated_git_source-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 469</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">warn_deprecated_git_source</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">replacement</span>, <span class="ruby-identifier">additional_message</span> = <span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">additional_message</span> <span class="ruby-operator">&&=</span> <span class="ruby-node">" #{additional_message}"</span>
<span class="ruby-identifier">replacement</span> = <span class="ruby-keyword">if</span> <span class="ruby-identifier">replacement</span>.<span class="ruby-identifier">count</span>(<span class="ruby-string">"\n"</span>).<span class="ruby-identifier">zero?</span>
<span class="ruby-node">"{|repo_name| #{replacement} }"</span>
<span class="ruby-keyword">else</span>
<span class="ruby-node">"do |repo_name|\n#{replacement.to_s.gsub(/^/, " ")}\n end"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-constant">Bundler</span><span class="ruby-operator">::</span><span class="ruby-constant">SharedHelpers</span>.<span class="ruby-identifier">major_deprecation</span> <span class="ruby-value">3</span>, <span class="ruby-identifier"><<-EOS</span>
<span class="ruby-value">The :#{name} git source is deprecated, and will be removed in the future.#{additional_message} Add this code to the top of your Gemfile to ensure it continues to work:
git_source(:#{name}) #{replacement}
</span><span class="ruby-identifier"> EOS</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-with_source" class="method-detail ">
<div class="method-heading">
<span class="method-name">with_source</span><span
class="method-args">(source) { || ... }</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="with_source-source">
<pre><span class="ruby-comment"># File lib/bundler/dsl.rb, line 316</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">with_source</span>(<span class="ruby-identifier">source</span>)
<span class="ruby-identifier">old_source</span> = <span class="ruby-ivar">@source</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
<span class="ruby-ivar">@source</span> = <span class="ruby-identifier">source</span>
<span class="ruby-keyword">yield</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">source</span>
<span class="ruby-keyword">ensure</span>
<span class="ruby-ivar">@source</span> = <span class="ruby-identifier">old_source</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>