Added: dev/buildr/1.5.7/site/rdoc/Buildr/Filter.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Filter.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Filter.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,698 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::Filter - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../"; +</script> + +<script src="../js/jquery.js"></script> +<script src="../js/darkfish.js"></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-i-add">#add</a> + + <li ><a href="#method-i-clear">#clear</a> + + <li ><a href="#method-i-exclude">#exclude</a> + + <li ><a href="#method-i-from">#from</a> + + <li ><a href="#method-i-include">#include</a> + + <li ><a href="#method-i-into">#into</a> + + <li ><a href="#method-i-pattern_match">#pattern_match</a> + + <li ><a href="#method-i-run">#run</a> + + <li ><a href="#method-i-target">#target</a> + + <li ><a href="#method-i-to_s">#to_s</a> + + <li ><a href="#method-i-using">#using</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::Filter"> + <h1 id="class-Buildr::Filter" class="class"> + class Buildr::Filter + </h1> + + <section class="description"> + +<p>A filter knows how to copy files from one directory to another, applying +mappings to the contents of these files.</p> + +<p>You can specify the mapping using a <a href="../Hash.html">Hash</a>, and it +will map ${key} fields found in each source file into the appropriate value +in the target file. For example:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">using</span> <span class="ruby-string">'version'</span>=<span class="ruby-operator">></span><span class="ruby-string">'1.2'</span>, <span class="ruby-string">'build'</span>=<span class="ruby-operator">></span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> +</pre> + +<p>will replace all occurrences of <code>${version}</code> with +<code>1.2</code>, and <code>${build}</code> with the current date/time.</p> + +<p>You can also specify the mapping by passing a proc or a method, that will +be called for each source file, with the file name and content, returning +the modified content.</p> + +<p>Without any mapping, the filter simply copies files from the source +directory into the target directory.</p> + +<p>A filter has one target directory, but you can specify any number of source +directories, either when creating the filter or calling <a +href="Filter.html#method-i-from">from</a>. Include/exclude patterns are +specified relative to the source directories, so:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">include</span> <span class="ruby-string">'*.png'</span> +</pre> + +<p>will only include PNG files from any of the source directories. In the same +way, you can use regular expressions, so:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">include</span> <span class="ruby-regexp">/picture_.*\.png/</span> +</pre> + +<p>will only include PNG files starting with picture_ from any of the sources +directories.</p> + +<p>See Buildr#filter.</p> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + + + <section class="attribute-method-details" class="method-section"> + <header> + <h3>Attributes</h3> + </header> + + + <div id="attribute-i-sources" class="method-detail"> + <div class="method-heading attribute-method-heading"> + <span class="method-name">sources</span><span + class="attribute-access-type">[R]</span> + </div> + + <div class="method-description"> + + <p>Returns the list of source directories (each being a file task).</p> + + </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-add" class="method-detail method-alias"> + + <div class="method-heading"> + <span class="method-name">add</span><span + class="method-args">(*files)</span> + + </div> + + + <div class="method-description"> + + + + + + + </div> + + + + + <div class="aliases"> + Alias for: <a href="Filter.html#method-i-include">include</a> + </div> + + </div> + + + <div id="method-i-clear" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + clear → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Clear filter sources and include/exclude patterns</p> + + + + + <div class="method-source-code" id="clear-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 58</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">clear</span> + <span class="ruby-ivar">@include</span> = [] + <span class="ruby-ivar">@exclude</span> = [] + <span class="ruby-ivar">@sources</span> = <span class="ruby-constant">FileList</span>[] + <span class="ruby-ivar">@mapper</span> = <span class="ruby-constant">Mapper</span>.<span class="ruby-identifier">new</span> + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-exclude" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + exclude(*files) → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Specifies files to exclude and returns self. See FileList#exclude.</p> + + + + + <div class="method-source-code" id="exclude-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 120</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">exclude</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">files</span>) + <span class="ruby-ivar">@exclude</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">files</span>.<span class="ruby-identifier">flatten</span> + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-from" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + from(*sources) → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Adds additional directories from which to copy resources.</p> + +<p>For example:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">from</span>(<span class="ruby-string">'src'</span>).<span class="ruby-identifier">into</span>(<span class="ruby-string">'target'</span>).<span class="ruby-identifier">using</span>(<span class="ruby-string">'build'</span>=<span class="ruby-operator">></span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>) +</pre> + + + + + <div class="method-source-code" id="from-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 73</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">from</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">sources</span>) + <span class="ruby-ivar">@sources</span> <span class="ruby-operator">|=</span> <span class="ruby-identifier">sources</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">dir</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">dir</span>.<span class="ruby-identifier">to_s</span>)) } + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-include" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + include(*files) → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Specifies files to include and returns self. See FileList#include.</p> + +<p>By default all files are included. You can use this method to only include +specific files from the source directory.</p> + + + + + <div class="method-source-code" id="include-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 110</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">include</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">files</span>) + <span class="ruby-ivar">@include</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">files</span>.<span class="ruby-identifier">flatten</span> + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + <div class="aliases"> + Also aliased as: <a href="Filter.html#method-i-add">add</a> + </div> + + + + </div> + + + <div id="method-i-into" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + into(dir) → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Sets the target directory into which files are copied and returns self.</p> + +<p>For example:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">from</span>(<span class="ruby-string">'src'</span>).<span class="ruby-identifier">into</span>(<span class="ruby-string">'target'</span>).<span class="ruby-identifier">using</span>(<span class="ruby-string">'build'</span>=<span class="ruby-operator">></span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>) +</pre> + + + + + <div class="method-source-code" id="into-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 97</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">into</span>(<span class="ruby-identifier">dir</span>) + <span class="ruby-ivar">@target_dir</span> = <span class="ruby-identifier">dir</span>.<span class="ruby-identifier">to_s</span> + <span class="ruby-ivar">@target</span> = <span class="ruby-keyword">nil</span> + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-run" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + run → boolean + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Runs the filter.</p> + + + + + <div class="method-source-code" id="run-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 170</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">run</span> + <span class="ruby-identifier">copy_map</span> = <span class="ruby-identifier">copy_map</span>() + + <span class="ruby-identifier">mkpath</span> <span class="ruby-identifier">target</span>.<span class="ruby-identifier">to_s</span> + <span class="ruby-keyword">return</span> <span class="ruby-keyword">false</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">copy_map</span>.<span class="ruby-identifier">empty?</span> + + <span class="ruby-identifier">copy_map</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span>, <span class="ruby-identifier">source</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">dest</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">target</span>.<span class="ruby-identifier">to_s</span>) + <span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">source</span>) + <span class="ruby-identifier">mkpath</span> <span class="ruby-identifier">dest</span> + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">mkpath</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">dirname</span>(<span class="ruby-identifier">dest</span>) + <span class="ruby-keyword">if</span> <span class="ruby-ivar">@mapper</span>.<span class="ruby-identifier">mapper_type</span> + <span class="ruby-identifier">mapped</span> = <span class="ruby-ivar">@mapper</span>.<span class="ruby-identifier">transform</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">source</span>, <span class="ruby-string">'rb'</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> }, <span class="ruby-identifier">path</span>) + <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">dest</span>, <span class="ruby-string">'wb'</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span> <span class="ruby-identifier">mapped</span> } + <span class="ruby-keyword">else</span> <span class="ruby-comment"># no mapping</span> + <span class="ruby-identifier">cp</span> <span class="ruby-identifier">source</span>, <span class="ruby-identifier">dest</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-constant">File</span>.<span class="ruby-identifier">chmod</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">stat</span>(<span class="ruby-identifier">source</span>).<span class="ruby-identifier">mode</span> <span class="ruby-operator">|</span> <span class="ruby-value">0200</span>, <span class="ruby-identifier">dest</span>) + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">touch</span> <span class="ruby-identifier">target</span>.<span class="ruby-identifier">to_s</span> + <span class="ruby-keyword">true</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-target" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">target</span><span + class="method-args">()</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p>The target directory as a file task.</p> + + + + + <div class="method-source-code" id="target-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 79</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">target</span> + <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">unless</span> <span class="ruby-ivar">@target_dir</span> + <span class="ruby-keyword">unless</span> <span class="ruby-ivar">@target</span> + <span class="ruby-ivar">@target</span> = <span class="ruby-identifier">file</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-ivar">@target_dir</span>)) { <span class="ruby-operator">|</span><span class="ruby-identifier">task</span><span class="ruby-operator">|</span> <span class="ruby-identifier">run</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@target</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">task</span> } + <span class="ruby-ivar">@target</span>.<span class="ruby-identifier">enhance</span> <span class="ruby-ivar">@include</span>.<span class="ruby-identifier">select</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">is_a?</span>(<span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">FileTask</span>)} + <span class="ruby-ivar">@target</span>.<span class="ruby-identifier">enhance</span> <span class="ruby-ivar">@exclude</span>.<span class="ruby-identifier">select</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">is_a?</span>(<span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">FileTask</span>)} + <span class="ruby-ivar">@target</span>.<span class="ruby-identifier">enhance</span> <span class="ruby-identifier">copy_map</span>.<span class="ruby-identifier">values</span> + <span class="ruby-keyword">end</span> + <span class="ruby-ivar">@target</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-to_s" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">to_s</span><span + class="method-args">()</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p>Returns the target directory.</p> + + + + + <div class="method-source-code" id="to_s-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 196</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">to_s</span> + <span class="ruby-identifier">target</span>.<span class="ruby-identifier">to_s</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-using" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + using(mapping) → self + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + <div class="method-heading"> + <span class="method-callseq"> + using { |file_name, contents| ... } → self + </span> + + </div> + + + + <div class="method-description"> + + <p>Specifies the mapping to use and returns self.</p> + +<p>The most typical mapping uses a <a href="../Hash.html">Hash</a>, and the +default mapping uses the Maven style, so <code>${key}</code> are mapped to +the values. You can change that by passing a different format as the first +argument. Currently supports:</p> +<ul><li> +<p>:ant â Map <code>@key@</code>.</p> +</li><li> +<p>:maven â Map <code>${key}</code> (default).</p> +</li><li> +<p>:ruby â Map <code>#{key}</code>.</p> +</li><li> +<p>:erb â Map <code><%= key %></code>.</p> +</li><li> +<p>Regexp â Maps the matched data (e.g. <code>/=(.*?)=/</code></p> +</li></ul> + +<p>For example:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">using</span> <span class="ruby-string">'version'</span>=<span class="ruby-operator">></span><span class="ruby-string">'1.2'</span> +</pre> + +<p>Is the same as:</p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">using</span> :<span class="ruby-identifier">maven</span>, <span class="ruby-string">'version'</span>=<span class="ruby-operator">></span><span class="ruby-string">'1.2'</span> +</pre> + +<p>You can also pass a proc or method. It will be called with the file name +and content, to return the mapped content.</p> + +<p>Without any mapping, all files are copied as is.</p> + +<p>To register new mapping type see the <a +href="Filter/Mapper.html">Mapper</a> class.</p> + + + + + <div class="method-source-code" id="using-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 161</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">using</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-ivar">@mapper</span>.<span class="ruby-identifier">using</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + </section> + + <section id="protected-instance-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Protected Instance Methods</h3> + </header> + + + <div id="method-i-pattern_match" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + pattern_match(file, pattern) → boolean + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>This method returns true if the file name matches the pattern. The pattern +may be a String, a Regexp or a Proc.</p> + + + + + <div class="method-source-code" id="pattern_match-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 208</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">pattern_match</span>(<span class="ruby-identifier">file</span>, <span class="ruby-identifier">pattern</span>) + <span class="ruby-keyword">case</span> + <span class="ruby-keyword">when</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Regexp</span>) + <span class="ruby-keyword">return</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">pattern</span>) + <span class="ruby-keyword">when</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>) + <span class="ruby-keyword">return</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">fnmatch</span>(<span class="ruby-identifier">pattern</span>, <span class="ruby-identifier">file</span>) + <span class="ruby-keyword">when</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Proc</span>) + <span class="ruby-keyword">return</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">file</span>) + <span class="ruby-keyword">when</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">FileTask</span>) + <span class="ruby-keyword">return</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">file</span>) + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">raise</span> <span class="ruby-node">"Cannot interpret pattern #{pattern}"</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="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> +
Added: dev/buildr/1.5.7/site/rdoc/Buildr/Filter/Mapper.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Filter/Mapper.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Filter/Mapper.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,342 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::Filter::Mapper - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../../"; +</script> + +<script src="../../js/jquery.js"></script> +<script src="../../js/darkfish.js"></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-i-is_binary-3F">#is_binary?</a> + + <li ><a href="#method-i-transform">#transform</a> + + <li ><a href="#method-i-using">#using</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::Filter::Mapper"> + <h1 id="class-Buildr::Filter::Mapper" class="class"> + class Buildr::Filter::Mapper + </h1> + + <section class="description"> + +<p>This class implements content replacement logic for <a +href="../Filter.html">Filter</a>.</p> + +<p>To register a new template engine @:foo@, extend this class with a method +like:</p> + +<pre class="ruby"><span class="ruby-keyword">def</span> <span class="ruby-identifier">foo_transform</span>(<span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span> = <span class="ruby-keyword">nil</span>) + <span class="ruby-comment"># if this method yields a key, the value comes from the mapping hash</span> + <span class="ruby-identifier">content</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/world/</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">str</span><span class="ruby-operator">|</span> <span class="ruby-keyword">yield</span> <span class="ruby-operator">:</span><span class="ruby-identifier">bar</span> } +<span class="ruby-keyword">end</span> +</pre> + +<p>Then you can use :foo mapping type on a <a href="../Filter.html">Filter</a></p> + +<pre class="ruby"><span class="ruby-identifier">filter</span>.<span class="ruby-identifier">using</span> :<span class="ruby-identifier">foo</span>, :<span class="ruby-identifier">bar</span> =<span class="ruby-operator">></span> :<span class="ruby-identifier">baz</span> +</pre> + +<p>Or all by your own, simply</p> + +<pre class="ruby"><span class="ruby-constant">Mapper</span>.<span class="ruby-identifier">new</span>(:<span class="ruby-identifier">foo</span>, :<span class="ruby-identifier">bar</span> =<span class="ruby-operator">></span> :<span class="ruby-identifier">baz</span>).<span class="ruby-identifier">transform</span>(<span class="ruby-string">"Hello world"</span>) <span class="ruby-comment"># => "Hello baz"</span> +</pre> + +<p>You can handle configuration arguments by providing a @*_config@ method +like:</p> + +<pre class="ruby"><span class="ruby-comment"># The return value of this method is available with the :config accessor.</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">moo_config</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">"Expected moo block"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">block_given?</span> + { :<span class="ruby-identifier">moos</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">args</span>, :<span class="ruby-identifier">callback</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">block</span> } +<span class="ruby-keyword">end</span> + +<span class="ruby-keyword">def</span> <span class="ruby-identifier">moo_transform</span>(<span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span> = <span class="ruby-keyword">nil</span>) + <span class="ruby-identifier">content</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/moo+/i</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">str</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">moos</span> = <span class="ruby-keyword">yield</span> <span class="ruby-operator">:</span><span class="ruby-identifier">moos</span> <span class="ruby-comment"># same than config[:moos]</span> + <span class="ruby-identifier">moo</span> = <span class="ruby-identifier">moos</span>[<span class="ruby-identifier">str</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">3</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">str</span> + <span class="ruby-identifier">config</span>[:<span class="ruby-identifier">callback</span>].<span class="ruby-identifier">call</span>(<span class="ruby-identifier">moo</span>) + <span class="ruby-keyword">end</span> +<span class="ruby-keyword">end</span> +</pre> + +<p>Usage for the @:moo@ mapper would be something like:</p> + +<pre class="ruby"><span class="ruby-identifier">mapper</span> = <span class="ruby-constant">Mapper</span>.<span class="ruby-identifier">new</span>(:<span class="ruby-identifier">moo</span>, <span class="ruby-string">'ooone'</span>, <span class="ruby-string">'twoo'</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">str</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">i</span> = <span class="ruby-keyword">nil</span>; <span class="ruby-identifier">str</span>.<span class="ruby-identifier">capitalize</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/\w/</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">send</span>( (<span class="ruby-identifier">i</span> = <span class="ruby-operator">!</span><span class="ruby-identifier">i</span>) <span class="ruby-operator">?</span> <span class="ruby-string">'upcase'</span> <span class="ruby-operator">:</span> <span class="ruby-string">'downcase'</span> ) } +<span class="ruby-keyword">end</span> +<span class="ruby-identifier">mapper</span>.<span class="ruby-identifier">transform</span>(<span class="ruby-string">'Moo cow, mooo cows singing mooooo'</span>) <span class="ruby-comment"># => 'OoOnE cow, TwOo cows singing MoOoOo'</span> +</pre> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + <section class="constants-list"> + <header> + <h3>Constants</h3> + </header> + <dl> + + <dt id="BINARY_FILES">BINARY_FILES + + <dd> + + + </dl> + </section> + + + + <section class="attribute-method-details" class="method-section"> + <header> + <h3>Attributes</h3> + </header> + + + <div id="attribute-i-config" class="method-detail"> + <div class="method-heading attribute-method-heading"> + <span class="method-name">config</span><span + class="attribute-access-type">[R]</span> + </div> + + <div class="method-description"> + + + + </div> + </div> + + <div id="attribute-i-mapper_type" class="method-detail"> + <div class="method-heading attribute-method-heading"> + <span class="method-name">mapper_type</span><span + class="attribute-access-type">[R]</span> + </div> + + <div class="method-description"> + + + + </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-is_binary-3F" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">is_binary?</span><span + class="method-args">(content, path)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + + + + + + <div class="method-source-code" id="is_binary-3F-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 314</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">is_binary?</span>(<span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span>) + <span class="ruby-operator">!</span><span class="ruby-operator">!</span><span class="ruby-identifier">path</span> <span class="ruby-operator">&&</span> <span class="ruby-constant">BINARY_FILES</span>.<span class="ruby-identifier">any?</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">glob</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">fnmatch</span>(<span class="ruby-identifier">glob</span>, <span class="ruby-identifier">path</span>) } +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-transform" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">transform</span><span + class="method-args">(content, path = nil)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + + + + + + <div class="method-source-code" id="transform-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 318</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">transform</span>(<span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span> = <span class="ruby-keyword">nil</span>) + <span class="ruby-keyword">return</span> <span class="ruby-identifier">content</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">is_binary?</span>(<span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span>) + <span class="ruby-identifier">type</span> = <span class="ruby-constant">Regexp</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">mapper_type</span> <span class="ruby-operator">?</span> <span class="ruby-value">:regexp</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">mapper_type</span> + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">"Invalid mapper type: #{type.inspect}"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-node">"#{type}_transform"</span>, <span class="ruby-keyword">true</span>) + <span class="ruby-keyword">self</span>.<span class="ruby-identifier">__send__</span>(<span class="ruby-node">"#{type}_transform"</span>, <span class="ruby-identifier">content</span>, <span class="ruby-identifier">path</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span> <span class="ruby-identifier">config</span>[<span class="ruby-identifier">key</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">config</span>[<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>] } +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-using" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">using</span><span + class="method-args">(*args, &block)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + + + + + + <div class="method-source-code" id="using-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/filter.rb, line 288</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">using</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-keyword">case</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span> + <span class="ruby-keyword">when</span> <span class="ruby-constant">Hash</span> <span class="ruby-comment"># Maven hash mapping</span> + <span class="ruby-identifier">using</span> <span class="ruby-value">:maven</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> + <span class="ruby-keyword">when</span> <span class="ruby-constant">Binding</span> <span class="ruby-comment"># Erb binding</span> + <span class="ruby-identifier">using</span> <span class="ruby-value">:erb</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> + <span class="ruby-keyword">when</span> <span class="ruby-constant">Symbol</span> <span class="ruby-comment"># Mapping from a method</span> + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">"Unknown mapping type: #{args.first}"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-node">"#{args.first}_transform"</span>, <span class="ruby-keyword">true</span>) + <span class="ruby-identifier">configure</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-keyword">when</span> <span class="ruby-constant">Regexp</span> <span class="ruby-comment"># Mapping using a regular expression</span> + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">'Expected regular expression followed by mapping hash'</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">2</span> <span class="ruby-operator">&&</span> <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>] + <span class="ruby-ivar">@mapper_type</span>, <span class="ruby-ivar">@config</span> = <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> + <span class="ruby-keyword">else</span> + <span class="ruby-keyword">unless</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">nil?</span> + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">'Expected proc, method or a block'</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">1</span> <span class="ruby-operator">||</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">block</span>) + <span class="ruby-ivar">@mapper_type</span> = <span class="ruby-value">:callback</span> + <span class="ruby-identifier">config</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">block</span> + <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">'Expected proc, method or callable'</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">config</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>) + <span class="ruby-ivar">@config</span> = <span class="ruby-identifier">config</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">self</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + </section> + + </section> +</main> + + +<footer id="validator-badges" role="contentinfo"> + <p><a href="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> + Added: dev/buildr/1.5.7/site/rdoc/Buildr/GitRelease.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/GitRelease.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/GitRelease.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,304 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::GitRelease - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../"; +</script> + +<script src="../js/jquery.js"></script> +<script src="../js/darkfish.js"></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">Buildr::Release + +</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-applies_to-3F">::applies_to?</a> + + <li class="calls-super" ><a href="#method-i-check">#check</a> + + <li ><a href="#method-i-tag_release">#tag_release</a> + + <li class="calls-super" ><a href="#method-i-update_version_to_next">#update_version_to_next</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::GitRelease"> + <h1 id="class-Buildr::GitRelease" class="class"> + class Buildr::GitRelease + </h1> + + <section class="description"> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + + + + + <section id="public-class-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Public Class Methods</h3> + </header> + + + <div id="method-c-applies_to-3F" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">applies_to?</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="applies_to-3F-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/build.rb, line 508</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">applies_to?</span> + <span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-string">'.git/config'</span> + <span class="ruby-keyword">true</span> + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">curr_pwd</span> = <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">pwd</span> + <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-string">'..'</span>) <span class="ruby-keyword">do</span> + <span class="ruby-keyword">return</span> <span class="ruby-keyword">false</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">curr_pwd</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">pwd</span> <span class="ruby-comment"># Means going up one level is not possible.</span> + <span class="ruby-identifier">applies_to?</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="public-instance-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Public Instance Methods</h3> + </header> + + + <div id="method-i-check" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">check</span><span + class="method-args">()</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p>Fails if one of these 2 conditions are not met:</p> + +<pre>1. the repository is clean: no content staged or unstaged +2. some remote repositories are defined but the current branch does not track any</pre> + + + <div class="method-calls-super"> + Calls superclass method + + </div> + + + + <div class="method-source-code" id="check-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/build.rb, line 524</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">check</span> + <span class="ruby-keyword">super</span> + <span class="ruby-identifier">uncommitted</span> = <span class="ruby-constant">Git</span>.<span class="ruby-identifier">uncommitted_files</span> + <span class="ruby-identifier">fail</span> <span class="ruby-node">"Uncommitted files violate the First Principle Of Release!\n#{uncommitted.join("\n")}"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">uncommitted</span>.<span class="ruby-identifier">empty?</span> + <span class="ruby-identifier">fail</span> <span class="ruby-string">"You are releasing from a local branch that does not track a remote!"</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-tag_release" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">tag_release</span><span + class="method-args">(tag)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p>Add a tag reference in .git/refs/tags and push it to the remote if any. If +a tag with the same name already exists it will get deleted (in both local +and remote repositories).</p> + + + + + <div class="method-source-code" id="tag_release-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/build.rb, line 533</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">tag_release</span>(<span class="ruby-identifier">tag</span>) + <span class="ruby-keyword">unless</span> <span class="ruby-identifier">this_version</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">extract_version</span> + <span class="ruby-identifier">info</span> <span class="ruby-node">"Committing buildfile with version number #{extract_version}"</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">commit</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">version_file</span>), <span class="ruby-identifier">message</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">push</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">info</span> <span class="ruby-node">"Tagging release #{tag}"</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">git</span> <span class="ruby-string">'tag'</span>, <span class="ruby-string">'-d'</span>, <span class="ruby-identifier">tag</span> <span class="ruby-keyword">rescue</span> <span class="ruby-keyword">nil</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">git</span> <span class="ruby-string">'push'</span>, <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span>, <span class="ruby-node">":refs/tags/#{tag}"</span> <span class="ruby-keyword">rescue</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">git</span> <span class="ruby-string">'tag'</span>, <span class="ruby-string">'-a'</span>, <span class="ruby-identifier">tag</span>, <span class="ruby-string">'-m'</span>, <span class="ruby-node">"[buildr] Cutting release #{tag}"</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">git</span> <span class="ruby-string">'push'</span>, <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span>, <span class="ruby-string">'tag'</span>, <span class="ruby-identifier">tag</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-update_version_to_next" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">update_version_to_next</span><span + class="method-args">()</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + + + + <div class="method-calls-super"> + Calls superclass method + + </div> + + + + <div class="method-source-code" id="update_version_to_next-source"> + <pre><span class="ruby-comment"># File lib/buildr/core/build.rb, line 546</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">update_version_to_next</span> + <span class="ruby-keyword">super</span> + <span class="ruby-identifier">info</span> <span class="ruby-node">"Current version is now #{extract_version}"</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">commit</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">version_file</span>), <span class="ruby-identifier">message</span> + <span class="ruby-constant">Git</span>.<span class="ruby-identifier">push</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">Git</span>.<span class="ruby-identifier">remote</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + </section> + + </section> +</main> + + +<footer id="validator-badges" role="contentinfo"> + <p><a href="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> + Added: dev/buildr/1.5.7/site/rdoc/Buildr/Groovy.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Groovy.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Groovy.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,111 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>module Buildr::Groovy - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../"; +</script> + +<script src="../js/jquery.js"></script> +<script src="../js/darkfish.js"></script> + +<link href="../css/fonts.css" rel="stylesheet"> +<link href="../css/rdoc.css" rel="stylesheet"> + + + +<body id="top" role="document" class="module"> +<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> +</nav> + +<main role="main" aria-labelledby="module-Buildr::Groovy"> + <h1 id="module-Buildr::Groovy" class="module"> + module Buildr::Groovy + </h1> + + <section class="description"> + +<p>The <a href="Groovy.html">Groovy</a> module</p> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + <section class="constants-list"> + <header> + <h3>Constants</h3> + </header> + <dl> + + <dt id="REQUIRES">REQUIRES + + <dd> + + + </dl> + </section> + + + + + + </section> +</main> + + +<footer id="validator-badges" role="contentinfo"> + <p><a href="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> + Added: dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/EasyB.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/EasyB.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/EasyB.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,235 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::Groovy::EasyB - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../../"; +</script> + +<script src="../../js/jquery.js"></script> +<script src="../../js/darkfish.js"></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">Buildr::TestFramework::JavaBDD + +</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-dependencies">::dependencies</a> + + <li ><a href="#method-c-version">::version</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::Groovy::EasyB"> + <h1 id="class-Buildr::Groovy::EasyB" class="class"> + class Buildr::Groovy::EasyB + </h1> + + <section class="description"> + +<p><a href="EasyB.html">EasyB</a> is a <a href="../Groovy.html">Groovy</a> +based BDD framework. To use in your project:</p> + +<pre class="ruby"><span class="ruby-identifier">test</span>.<span class="ruby-identifier">using</span> :<span class="ruby-identifier">easyb</span> +</pre> + +<p>This framework will search in your project for:</p> + +<pre>src/spec/groovy /*Story.groovy +src/spec/groovy/ *Specification.groovy</pre> + +<p>Support the following options:</p> +<ul><li> +<p>:format â Report format :txt or :xml, default is :txt</p> +</li><li> +<p>:properties â <a href="../../Hash.html">Hash</a> of properties passed to +the test suite.</p> +</li><li> +<p>:java_args â Arguments passed to the JVM.</p> +</li></ul> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + <section class="constants-list"> + <header> + <h3>Constants</h3> + </header> + <dl> + + <dt id="OPTIONS">OPTIONS + + <dd> + + + <dt id="TESTS_PATTERN">TESTS_PATTERN + + <dd> + + + <dt id="VERSION">VERSION + + <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-dependencies" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">dependencies</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="dependencies-source"> + <pre><span class="ruby-comment"># File lib/buildr/groovy/bdd.rb, line 45</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">dependencies</span> + <span class="ruby-ivar">@dependencies</span> <span class="ruby-operator">||=</span> [<span class="ruby-node">"org.easyb:easyb:jar:#{version}"</span>, + <span class="ruby-string">'org.codehaus.groovy:groovy:jar:1.5.3'</span>,<span class="ruby-string">'asm:asm:jar:2.2.3'</span>, + <span class="ruby-string">'commons-cli:commons-cli:jar:1.0'</span>,<span class="ruby-string">'antlr:antlr:jar:2.7.7'</span>] +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-c-version" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">version</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="version-source"> + <pre><span class="ruby-comment"># File lib/buildr/groovy/bdd.rb, line 41</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">version</span> + <span class="ruby-constant">Buildr</span>.<span class="ruby-identifier">settings</span>.<span class="ruby-identifier">build</span>[<span class="ruby-string">'jbehave'</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">VERSION</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + </section> + + </section> +</main> + + +<footer id="validator-badges" role="contentinfo"> + <p><a href="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> + Added: dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/GroovySH.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/GroovySH.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/GroovySH.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,196 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::Groovy::GroovySH - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../../"; +</script> + +<script src="../../js/jquery.js"></script> +<script src="../../js/darkfish.js"></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="../Shell/Base.html">Buildr::Shell::Base</a> + +</div> + + <div id="includes-section" class="nav-section"> + <h3>Included Modules</h3> + + <ul class="link-list"> + + + <li><a class="include" href="../JRebel.html">Buildr::JRebel</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-i-launch">#launch</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::Groovy::GroovySH"> + <h1 id="class-Buildr::Groovy::GroovySH" class="class"> + class Buildr::Groovy::GroovySH + </h1> + + <section class="description"> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + <section class="constants-list"> + <header> + <h3>Constants</h3> + </header> + <dl> + + <dt id="SUFFIX">SUFFIX + + <dd> + + + </dl> + </section> + + + + + + <section id="public-instance-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Public Instance Methods</h3> + </header> + + + <div id="method-i-launch" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">launch</span><span + class="method-args">(task)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + + + + + + <div class="method-source-code" id="launch-source"> + <pre><span class="ruby-comment"># File lib/buildr/groovy/shell.rb, line 25</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">launch</span>(<span class="ruby-identifier">task</span>) + <span class="ruby-identifier">cp</span> = <span class="ruby-constant">Groovy</span>.<span class="ruby-identifier">dependencies</span> <span class="ruby-operator">+</span> + <span class="ruby-identifier">project</span>.<span class="ruby-identifier">compile</span>.<span class="ruby-identifier">dependencies</span> <span class="ruby-operator">+</span> + [ <span class="ruby-identifier">project</span>.<span class="ruby-identifier">path_to</span>(<span class="ruby-value">:target</span>, <span class="ruby-value">:classes</span>) ] <span class="ruby-operator">+</span> + <span class="ruby-identifier">task</span>.<span class="ruby-identifier">classpath</span> + <span class="ruby-identifier">props</span> = <span class="ruby-identifier">jrebel_props</span>(<span class="ruby-identifier">project</span>).<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">task</span>.<span class="ruby-identifier">properties</span>) + <span class="ruby-identifier">java_args</span> = <span class="ruby-identifier">jrebel_args</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">task</span>.<span class="ruby-identifier">java_args</span> + + <span class="ruby-identifier">groovy_home</span> = <span class="ruby-keyword">nil</span> + <span class="ruby-keyword">if</span> <span class="ruby-identifier">groovy_home</span> + <span class="ruby-identifier">cmd_args</span> = <span class="ruby-node">" -classpath '#{cp.join(File::SEPARATOR)}'"</span> + <span class="ruby-identifier">trace</span> <span class="ruby-node">"groovysh #{cmd_args}"</span> + <span class="ruby-identifier">system</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-node">"bin#{File::SEPARATOR}groovysh#{SUFFIX}"</span>, <span class="ruby-identifier">groovy_home</span>) <span class="ruby-operator">+</span> <span class="ruby-identifier">cmd_args</span>) + <span class="ruby-keyword">else</span> + <span class="ruby-constant">Java</span><span class="ruby-operator">::</span><span class="ruby-constant">Commands</span>.<span class="ruby-identifier">java</span> <span class="ruby-string">'org.codehaus.groovy.tools.shell.Main'</span>, { + <span class="ruby-value">:properties</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">props</span>, + <span class="ruby-value">:classpath</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">cp</span>, + <span class="ruby-value">:java_args</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">java_args</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="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> + Added: dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/Groovyc.html ============================================================================== --- dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/Groovyc.html (added) +++ dev/buildr/1.5.7/site/rdoc/Buildr/Groovy/Groovyc.html Sat Feb 16 02:53:28 2019 @@ -0,0 +1,208 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Buildr::Groovy::Groovyc - buildr</title> + +<script type="text/javascript"> + var rdoc_rel_prefix = "../../"; +</script> + +<script src="../../js/jquery.js"></script> +<script src="../../js/darkfish.js"></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">Buildr::Compiler::Base + +</div> + + + + + </div> +</nav> + +<main role="main" aria-labelledby="class-Buildr::Groovy::Groovyc"> + <h1 id="class-Buildr::Groovy::Groovyc" class="class"> + class Buildr::Groovy::Groovyc + </h1> + + <section class="description"> + +<p><a href="Groovyc.html">Groovyc</a> compiler:</p> + +<pre class="ruby"><span class="ruby-identifier">compile</span>.<span class="ruby-identifier">using</span>(:<span class="ruby-identifier">groovyc</span>) +</pre> + +<p>You need to require 'buildr/groovy/compiler' if you need to use +this compiler.</p> + +<p>Used by default if .groovy files are found in the src/main/groovy directory +(or src/test/groovy) and sets the target directory to target/classes (or +target/test/classes).</p> + +<p><a href="Groovyc.html">Groovyc</a> is a joint compiler, this means that +when selected for a project, this compiler is used to compile both groovy +and java sources. It's recommended that <a +href="../Groovy.html">Groovy</a> sources are placed in the src/main/groovy +directory, even though this compiler also looks in src/main/java</p> + +<p><a href="Groovyc.html">Groovyc</a> accepts the following options:</p> +<ul><li> +<p>:encoding â Encoding of source files</p> +</li><li> +<p>:verbose â Asks the compiler for verbose output, true when +running in verbose mode.</p> +</li><li> +<p>:fork â Whether to execute groovyc using a spawned instance of +the JVM; defaults to no</p> +</li><li> +<p>:memoryInitialSize â The initial size of the memory for the underlying VM, +if using fork mode; ignored otherwise.</p> + +<pre>Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)</pre> +</li><li> +<p>:memoryMaximumSize â The maximum size of the memory for the underlying VM, +if using fork mode; ignored otherwise.</p> + +<pre>Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)</pre> +</li><li> +<p>:listfiles â Indicates whether the source files to be compiled will +be listed; defaults to no</p> +</li><li> +<p>:stacktrace â If true each compile error message will contain a +stacktrace</p> +</li><li> +<p>:warnings â Issue warnings when compiling. True when running in +verbose mode.</p> +</li><li> +<p>:debug â Generates bytecode with debugging information. Set +from the debug</p> + +<pre>environment variable/global option.</pre> +</li><li> +<p>:deprecation â If true, shows deprecation messages. False by +default.</p> +</li><li> +<p>:optimise â Generates faster bytecode by applying optimisations to +the program.</p> +</li><li> +<p>:source â Source code compatibility.</p> +</li><li> +<p>:target â Bytecode compatibility.</p> +</li><li> +<p>:javac â <a href="../../Hash.html">Hash</a> of options passed +to the ant javac task</p> +</li></ul> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + <section class="constants-list"> + <header> + <h3>Constants</h3> + </header> + <dl> + + <dt id="ANT_TASK">ANT_TASK + + <dd> + + + <dt id="GROOVYC_OPTIONS">GROOVYC_OPTIONS + + <dd> + + + <dt id="JAVAC_OPTIONS">JAVAC_OPTIONS + + <dd> + + + <dt id="OPTIONS">OPTIONS + + <dd> + + + <dt id="REQUIRES">REQUIRES + + <dd><p>The groovyc compiler jars are added to classpath at load time, if you want +to customize artifact versions, you must set them on the</p> + +<pre class="ruby"><span class="ruby-identifier">artifact_ns</span>(<span class="ruby-constant">Buildr</span><span class="ruby-operator">::</span><span class="ruby-constant">Groovy</span><span class="ruby-operator">::</span><span class="ruby-constant">Groovyc</span>).<span class="ruby-identifier">groovy</span> = <span class="ruby-string">'1.7.1'</span> +</pre> + +<p>namespace before this file is required.</p> + + + </dl> + </section> + + + + + + </section> +</main> + + +<footer id="validator-badges" role="contentinfo"> + <p><a href="http://validator.w3.org/check/referer">Validate</a> + <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.2. + <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>. +</footer> +