You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@buildr.apache.org by do...@apache.org on 2017/04/02 23:37:44 UTC

svn commit: r19013 [35/44] - in /dev/buildr/1.5.2: ./ dist/ site/ site/css/ site/images/ site/rdoc/ site/rdoc/Buildr/ site/rdoc/Buildr/ArchiveTask/ site/rdoc/Buildr/ArtifactNamespace/ site/rdoc/Buildr/Assets/ site/rdoc/Buildr/CPom/ site/rdoc/Buildr/Che...

Added: dev/buildr/1.5.2/site/rdoc/Buildr/Util.html
==============================================================================
--- dev/buildr/1.5.2/site/rdoc/Buildr/Util.html (added)
+++ dev/buildr/1.5.2/site/rdoc/Buildr/Util.html Sun Apr  2 23:37:43 2017
@@ -0,0 +1,497 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>module Buildr::Util - 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">
+    
+    
+    
+    
+    <!-- Method Quickref -->
+<div id="method-list-section" class="nav-section">
+  <h3>Methods</h3>
+
+  <ul class="link-list" role="directory">
+    
+    <li ><a href="#method-i-java_platform-3F">#java_platform?</a>
+    
+    <li ><a href="#method-i-normalize_path">#normalize_path</a>
+    
+    <li ><a href="#method-i-recursive_with_dot_files">#recursive_with_dot_files</a>
+    
+    <li ><a href="#method-i-relative_path">#relative_path</a>
+    
+    <li ><a href="#method-i-replace_extension">#replace_extension</a>
+    
+    <li ><a href="#method-i-ruby">#ruby</a>
+    
+    <li ><a href="#method-i-timestamp">#timestamp</a>
+    
+    <li ><a href="#method-i-uuid">#uuid</a>
+    
+    <li ><a href="#method-i-win_os-3F">#win_os?</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="module-Buildr::Util">
+  <h1 id="module-Buildr::Util" class="module">
+    module Buildr::Util
+  </h1>
+
+  <section class="description">
+    
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    
+     <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
+       <header>
+         <h3>Public Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-java_platform-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">java_platform?</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="java_platform-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 21</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">java_platform?</span>
+  <span class="ruby-operator">!</span><span class="ruby-operator">!</span>(<span class="ruby-constant">RUBY_PLATFORM</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/java/</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-normalize_path" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">normalize_path</span><span
+            class="method-args">(path, *dirs)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Just like File.expand_path, but for windows systems it capitalizes the
+drive name and ensures backslashes are used</p>
+          
+          
+
+          
+          <div class="method-source-code" id="normalize_path-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 61</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">dirs</span>)
+  <span class="ruby-identifier">path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">dirs</span>)
+  <span class="ruby-keyword">if</span> <span class="ruby-identifier">win_os?</span>
+    <span class="ruby-identifier">path</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-string">&#39;/&#39;</span>, <span class="ruby-string">&#39;\&#39;</span>).<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">/^[a-zA-Z]+:/</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">upcase</span> }
+  <span class="ruby-keyword">else</span>
+    <span class="ruby-identifier">path</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-recursive_with_dot_files" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">recursive_with_dot_files</span><span
+            class="method-args">(*dirs)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Generally speaking, it&#39;s not a good idea to operate on dot files (files
+starting with dot). These are considered invisible files (.svn, .hg,
+.irbrc, etc).  Dir.glob/FileList ignore them on purpose.  There are few
+cases where we do have to work with them (filter, zip), a better solution
+is welcome, maybe being more explicit with include.  For now, this will do.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="recursive_with_dot_files-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 111</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">recursive_with_dot_files</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">dirs</span>)
+  <span class="ruby-constant">FileList</span>[<span class="ruby-identifier">dirs</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-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>, <span class="ruby-string">&#39;/**/{*,.*}&#39;</span>) }].<span class="ruby-identifier">reject</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">file</span>) <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^[.]{1,2}$/</span> }
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-relative_path" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">relative_path</span><span
+            class="method-args">(to, from = '.')</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Return the path to the first argument, starting from the path provided by
+the second argument.</p>
+
+<p>For example:</p>
+
+<pre>relative_path(&#39;foo/bar&#39;, &#39;foo&#39;)
+=&gt; &#39;bar&#39;
+relative_path(&#39;foo/bar&#39;, &#39;baz&#39;)
+=&gt; &#39;../foo/bar&#39;
+relative_path(&#39;foo/bar&#39;)
+=&gt; &#39;foo/bar&#39;
+relative_path(&#39;/foo/bar&#39;, &#39;baz&#39;)
+=&gt; &#39;/foo/bar&#39;</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="relative_path-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 99</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">relative_path</span>(<span class="ruby-identifier">to</span>, <span class="ruby-identifier">from</span> = <span class="ruby-string">&#39;.&#39;</span>)
+  <span class="ruby-identifier">to</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">to</span>).<span class="ruby-identifier">cleanpath</span>
+  <span class="ruby-keyword">return</span> <span class="ruby-identifier">to</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">from</span>.<span class="ruby-identifier">nil?</span>
+  <span class="ruby-identifier">to_path</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">to</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-string">&quot;/&quot;</span>))
+  <span class="ruby-identifier">from_path</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">from</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-string">&quot;/&quot;</span>))
+  <span class="ruby-identifier">to_path</span>.<span class="ruby-identifier">relative_path_from</span>(<span class="ruby-identifier">from_path</span>).<span class="ruby-identifier">to_s</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-replace_extension" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            replace_extension(filename) &rarr; filename_with_updated_extension
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Replace the file extension, e.g.,</p>
+
+<pre>replace_extension(&quot;foo.zip&quot;, &quot;txt&quot;) =&gt; &quot;foo.txt&quot;</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="replace_extension-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 120</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">replace_extension</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">new_ext</span>)
+  <span class="ruby-identifier">ext</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">filename</span>)
+  <span class="ruby-keyword">if</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/\.$/</span>
+    <span class="ruby-identifier">filename</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">new_ext</span>
+  <span class="ruby-keyword">elsif</span> <span class="ruby-identifier">ext</span> <span class="ruby-operator">==</span> <span class="ruby-string">&quot;&quot;</span>
+    <span class="ruby-identifier">filename</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot;.&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">new_ext</span>
+  <span class="ruby-keyword">else</span>
+    <span class="ruby-identifier">filename</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-operator">-</span><span class="ruby-identifier">ext</span>.<span class="ruby-identifier">length</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">new_ext</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-ruby" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">ruby</span><span
+            class="method-args">(*args)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Runs Ruby with these command line arguments.  The last argument may be a
+hash, supporting the following keys:</p>
+
+<pre>:command  -- Runs the specified script (e.g., :command=&gt;&#39;gem&#39;)
+:sudo     -- Run as sudo on operating systems that require it.
+:verbose  -- Override Rake&#39;s verbose flag.</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="ruby-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 43</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">ruby</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+  <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {}
+  <span class="ruby-identifier">cmd</span> = []
+  <span class="ruby-identifier">ruby_bin</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-constant">RbConfig</span><span class="ruby-operator">::</span><span class="ruby-constant">CONFIG</span>[<span class="ruby-string">&#39;ruby_install_name&#39;</span>], <span class="ruby-constant">RbConfig</span><span class="ruby-operator">::</span><span class="ruby-constant">CONFIG</span>[<span class="ruby-string">&#39;bindir&#39;</span>])
+  <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:sudo</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span>(<span class="ruby-identifier">win_os?</span> <span class="ruby-operator">||</span> <span class="ruby-constant">Process</span>.<span class="ruby-identifier">uid</span> <span class="ruby-operator">==</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">stat</span>(<span class="ruby-identifier">ruby_bin</span>).<span class="ruby-identifier">uid</span>)
+    <span class="ruby-identifier">cmd</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&#39;sudo&#39;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&#39;-u&#39;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;##{File.stat(ruby_bin).uid}&quot;</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-identifier">cmd</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">ruby_bin</span>
+  <span class="ruby-identifier">cmd</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&#39;-S&#39;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:command</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:command</span>]
+  <span class="ruby-identifier">cmd</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">flatten</span>
+  <span class="ruby-identifier">cmd</span>.<span class="ruby-identifier">push</span> <span class="ruby-identifier">options</span>
+  <span class="ruby-identifier">sh</span> <span class="ruby-operator">*</span><span class="ruby-identifier">cmd</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ok</span>, <span class="ruby-identifier">status</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">ok</span> <span class="ruby-keyword">or</span> <span class="ruby-identifier">fail</span> <span class="ruby-node">&quot;Command ruby failed with status (#{status ? status.exitstatus : &#39;unknown&#39;}): [#{cmd.join(&quot; &quot;)}]&quot;</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-timestamp" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">timestamp</span><span
+            class="method-args">(file)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Return the timestamp of file, without having to create a file task</p>
+          
+          
+
+          
+          <div class="method-source-code" id="timestamp-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 71</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">timestamp</span>(<span class="ruby-identifier">file</span>)
+  <span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">file</span>)
+    <span class="ruby-constant">File</span>.<span class="ruby-identifier">mtime</span>(<span class="ruby-identifier">file</span>)
+  <span class="ruby-keyword">else</span>
+    <span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">EARLY</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-uuid" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">uuid</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="uuid-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 79</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">uuid</span>
+  <span class="ruby-keyword">return</span> <span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">uuid</span> <span class="ruby-keyword">if</span> <span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:uuid</span>)
+  <span class="ruby-identifier">ary</span> = <span class="ruby-constant">SecureRandom</span>.<span class="ruby-identifier">random_bytes</span>(<span class="ruby-value">16</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-string">&quot;NnnnnN&quot;</span>)
+  <span class="ruby-identifier">ary</span>[<span class="ruby-value">2</span>] = (<span class="ruby-identifier">ary</span>[<span class="ruby-value">2</span>] <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x0fff</span>) <span class="ruby-operator">|</span> <span class="ruby-value">0x4000</span>
+  <span class="ruby-identifier">ary</span>[<span class="ruby-value">3</span>] = (<span class="ruby-identifier">ary</span>[<span class="ruby-value">3</span>] <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x3fff</span>) <span class="ruby-operator">|</span> <span class="ruby-value">0x8000</span>
+  <span class="ruby-string">&quot;%08x-%04x-%04x-%04x-%04x%08x&quot;</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">ary</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-win_os-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">win_os?</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>In order to determine if we are running on a windows OS, prefer this
+function instead of using Gem.win_platform?.</p>
+
+<p>Gem.win_platform? only checks these RUBY_PLATFORM global, that in some
+cases like when running on JRuby is not sufficient for our purpose:</p>
+
+<p>For JRuby, the value for RUBY_PLATFORM will always be &#39;java&#39;
+That&#39;s why this function checks on <a
+href="'host_os'">Config::CONFIG</a></p>
+          
+          
+
+          
+          <div class="method-source-code" id="win_os-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/core/util.rb, line 34</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">win_os?</span>
+  <span class="ruby-operator">!</span><span class="ruby-operator">!</span>(<span class="ruby-constant">RbConfig</span><span class="ruby-operator">::</span><span class="ruby-constant">CONFIG</span>[<span class="ruby-string">&#39;host_os&#39;</span>] <span class="ruby-operator">=~</span> <span class="ruby-regexp">/windows|cygwin|bccwin|cygwin|djgpp|mingw|mswin|mswin32|wince/i</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.2/site/rdoc/Buildr/VersionRequirement.html
==============================================================================
--- dev/buildr/1.5.2/site/rdoc/Buildr/VersionRequirement.html (added)
+++ dev/buildr/1.5.2/site/rdoc/Buildr/VersionRequirement.html Sun Apr  2 23:37:43 2017
@@ -0,0 +1,617 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>class Buildr::VersionRequirement - 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-c-create">::create</a>
+    
+    <li ><a href="#method-c-requirement-3F">::requirement?</a>
+    
+    <li ><a href="#method-c-version-3F">::version?</a>
+    
+    <li ><a href="#method-i-26">#&amp;</a>
+    
+    <li ><a href="#method-i-composed-3F">#composed?</a>
+    
+    <li ><a href="#method-i-default">#default</a>
+    
+    <li ><a href="#method-i-operation">#operation</a>
+    
+    <li ><a href="#method-i-satisfied_by-3F">#satisfied_by?</a>
+    
+    <li ><a href="#method-i-to_s">#to_s</a>
+    
+    <li ><a href="#method-i-7C">#|</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="class-Buildr::VersionRequirement">
+  <h1 id="class-Buildr::VersionRequirement" class="class">
+    class Buildr::VersionRequirement
+  </h1>
+
+  <section class="description">
+    
+<p>See <a
+href="ArtifactNamespace.html#method-i-need">Buildr::ArtifactNamespace#need</a></p>
+
+<p>See <a
+href="ArtifactNamespace.html#method-i-need">Buildr::ArtifactNamespace#need</a></p>
+
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+    <section class="constants-list">
+      <header>
+        <h3>Constants</h3>
+      </header>
+      <dl>
+      
+        <dt id="BOOL_CHARS">BOOL_CHARS
+        
+        <dd>
+        
+      
+        <dt id="CMP_CHARS">CMP_CHARS
+        
+        <dd>
+        
+      
+        <dt id="CMP_PROCS">CMP_PROCS
+        
+        <dd>
+        
+      
+        <dt id="CMP_REGEX">CMP_REGEX
+        
+        <dd>
+        
+      
+        <dt id="VER_CHARS">VER_CHARS
+        
+        <dd>
+        
+      
+      </dl>
+    </section>
+    
+
+    
+    <section class="attribute-method-details" class="method-section">
+      <header>
+        <h3>Attributes</h3>
+      </header>
+
+      
+      <div id="attribute-i-negative" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">negative</span><span
+            class="attribute-access-type">[RW]</span>
+        </div>
+
+        <div class="method-description">
+        
+        
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-op" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">op</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-requirements" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">requirements</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-create" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            create(&quot; &gt;1 &lt;2 !(1.5) &quot;) &rarr; requirement
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>parse the <code>str</code> requirement</p>
+          
+          
+
+          
+          <div class="method-source-code" id="create-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 44</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">create</span>(<span class="ruby-identifier">str</span>)
+  <span class="ruby-identifier">instance_eval</span> <span class="ruby-identifier">normalize</span>(<span class="ruby-identifier">str</span>)
+<span class="ruby-keyword">rescue</span> <span class="ruby-constant">StandardError</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+  <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Failed to parse #{str.inspect} due to: #{e}&quot;</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-c-requirement-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">requirement?</span><span
+            class="method-args">(str)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>is <code>str</code> a version requirement?</p>
+          
+          
+
+          
+          <div class="method-source-code" id="requirement-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 36</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">requirement?</span>(<span class="ruby-identifier">str</span>)
+  <span class="ruby-node">/[#{BOOL_CHARS}#{CMP_CHARS}\(\)]/</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">str</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-c-version-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">version?</span><span
+            class="method-args">(str)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>is <code>str</code> a version string?</p>
+          
+          
+
+          
+          <div class="method-source-code" id="version-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 31</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">version?</span>(<span class="ruby-identifier">str</span>)
+  <span class="ruby-node">/^\s*[#{VER_CHARS}]+\s*$/</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">str</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-26" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">&amp;</span><span
+            class="method-args">(other)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Either modify the current requirement (if it&#39;s already an and
+operation) or create a new requirement</p>
+          
+          
+
+          
+          <div class="method-source-code" id="26-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 149</span>
+<span class="ruby-keyword">def</span> <span class="ruby-operator">&amp;</span>(<span class="ruby-identifier">other</span>)
+  <span class="ruby-identifier">operation</span>(<span class="ruby-value">:&amp;</span>, <span class="ruby-identifier">other</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-composed-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">composed?</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Is this object a composed requirement?</p>
+
+<pre>VersionRequirement.create(&#39;1&#39;).composed? -&gt; false
+VersionRequirement.create(&#39;1 | 2&#39;).composed? -&gt; true
+VersionRequirement.create(&#39;1 &amp; 2&#39;).composed? -&gt; true</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="composed-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 102</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">composed?</span>
+  <span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-default" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">default</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Return the last requirement on this object having an = operator.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="default-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 107</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">default</span>
+  <span class="ruby-identifier">default</span> = <span class="ruby-keyword">nil</span>
+  <span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">find</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">r</span>
+      <span class="ruby-keyword">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">negative</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">r</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">r</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">&#39;=&#39;</span>))
+        <span class="ruby-identifier">default</span> = <span class="ruby-identifier">r</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">to_s</span>
+      <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-identifier">default</span> = <span class="ruby-identifier">r</span>.<span class="ruby-identifier">default</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-identifier">default</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-satisfied_by-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">satisfied_by?</span><span
+            class="method-args">(version)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p><a href="Test.html">Test</a> if this requirement can be satisfied by
+<code>version</code></p>
+          
+          
+
+          
+          <div class="method-source-code" id="satisfied_by-3F-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 122</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">satisfied_by?</span>(<span class="ruby-identifier">version</span>)
+  <span class="ruby-keyword">return</span> <span class="ruby-keyword">false</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">version</span>
+  <span class="ruby-keyword">unless</span> <span class="ruby-identifier">version</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Gem</span><span class="ruby-operator">::</span><span class="ruby-constant">Version</span>)
+    <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Invalid version: #{version.inspect}&quot;</span> <span class="ruby-keyword">unless</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">version?</span>(<span class="ruby-identifier">version</span>)
+    <span class="ruby-comment"># dup required due to jruby 1.7.13 bug/feature that caches versions?</span>
+    <span class="ruby-identifier">version</span> = <span class="ruby-constant">Gem</span><span class="ruby-operator">::</span><span class="ruby-constant">Version</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value">0</span>).<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">tap</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">version</span> = <span class="ruby-identifier">version</span>.<span class="ruby-identifier">strip</span> }
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-identifier">message</span> = <span class="ruby-identifier">op</span> <span class="ruby-operator">==</span> <span class="ruby-value">:|</span> <span class="ruby-value">? </span><span class="ruby-operator">:</span><span class="ruby-identifier">any?</span> <span class="ruby-operator">:</span> <span class="ruby-value">:all?</span>
+  <span class="ruby-identifier">result</span> = <span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">send</span> <span class="ruby-identifier">message</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">req</span><span class="ruby-operator">|</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">req</span>
+      <span class="ruby-identifier">cmp</span>, <span class="ruby-identifier">rv</span> = <span class="ruby-operator">*</span><span class="ruby-identifier">req</span>
+      <span class="ruby-constant">CMP_PROCS</span>[<span class="ruby-identifier">cmp</span> <span class="ruby-operator">||</span> <span class="ruby-string">&#39;=&#39;</span>].<span class="ruby-identifier">call</span>(<span class="ruby-identifier">version</span>, <span class="ruby-identifier">rv</span>)
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-identifier">req</span>.<span class="ruby-identifier">satisfied_by?</span>(<span class="ruby-identifier">version</span>)
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-identifier">negative</span> <span class="ruby-operator">?</span> <span class="ruby-operator">!</span><span class="ruby-identifier">result</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">result</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>return the parsed expression</p>
+          
+          
+
+          
+          <div class="method-source-code" id="to_s-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 154</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">to_s</span>
+  <span class="ruby-identifier">str</span> = <span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&amp;</span><span class="ruby-value">:to_s</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">&quot; &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@op</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot; &quot;</span>).<span class="ruby-identifier">to_s</span>
+  <span class="ruby-identifier">str</span> = <span class="ruby-string">&quot;( &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">str</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot; )&quot;</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">negative</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
+  <span class="ruby-identifier">str</span> = <span class="ruby-string">&quot;!&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">str</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">negative</span>
+  <span class="ruby-identifier">str</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-7C" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">|</span><span
+            class="method-args">(other)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Either modify the current requirement (if it&#39;s already an or operation)
+or create a new requirement</p>
+          
+          
+
+          
+          <div class="method-source-code" id="7C-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 143</span>
+<span class="ruby-keyword">def</span> <span class="ruby-operator">|</span>(<span class="ruby-identifier">other</span>)
+  <span class="ruby-identifier">operation</span>(<span class="ruby-value">:|</span>, <span class="ruby-identifier">other</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-operation" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">operation</span><span
+            class="method-args">(op, other)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="operation-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/version_requirement.rb, line 164</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">operation</span>(<span class="ruby-identifier">op</span>, <span class="ruby-identifier">other</span>)
+  <span class="ruby-ivar">@op</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">op</span>
+  <span class="ruby-keyword">if</span> <span class="ruby-identifier">negative</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">negative</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@op</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">op</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
+    <span class="ruby-ivar">@requirements</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">requirements</span>.<span class="ruby-identifier">first</span>
+    <span class="ruby-keyword">self</span>
+  <span class="ruby-keyword">else</span>
+    <span class="ruby-keyword">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">op</span>, <span class="ruby-keyword">self</span>, <span class="ruby-identifier">other</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.2/site/rdoc/Buildr/ZipTask.html
==============================================================================
--- dev/buildr/1.5.2/site/rdoc/Buildr/ZipTask.html (added)
+++ dev/buildr/1.5.2/site/rdoc/Buildr/ZipTask.html Sun Apr  2 23:37:43 2017
@@ -0,0 +1,207 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>class Buildr::ZipTask - 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="ArchiveTask.html">Buildr::ArchiveTask</a>
+  
+</div>
+
+    <div id="includes-section" class="nav-section">
+  <h3>Included Modules</h3>
+
+  <ul class="link-list">
+  
+  
+    <li><span class="include">WithManifest</span>
+  
+  
+  </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-entry">#entry</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="class-Buildr::ZipTask">
+  <h1 id="class-Buildr::ZipTask" class="class">
+    class Buildr::ZipTask
+  </h1>
+
+  <section class="description">
+    
+<p>The <a href="ZipTask.html">ZipTask</a> creates a new <a
+href="../Zip.html">Zip</a> file. You can include any number of files and
+and directories, use exclusion patterns, and include files into specific
+directories.</p>
+
+<p>For example:</p>
+
+<pre class="ruby"><span class="ruby-identifier">zip</span>(<span class="ruby-string">&#39;test.zip&#39;</span>).<span class="ruby-identifier">tap</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">task</span><span class="ruby-operator">|</span>
+  <span class="ruby-identifier">task</span>.<span class="ruby-identifier">include</span> <span class="ruby-string">&#39;srcs&#39;</span>
+  <span class="ruby-identifier">task</span>.<span class="ruby-identifier">include</span> <span class="ruby-string">&#39;README&#39;</span>, <span class="ruby-string">&#39;LICENSE&#39;</span>
+<span class="ruby-keyword">end</span>
+</pre>
+
+<p>See Buildr#zip and <a href="ArchiveTask.html">ArchiveTask</a>.</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-compression_level" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">compression_level</span><span
+            class="attribute-access-type">[RW]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>Compression level for this <a href="../Zip.html">Zip</a>.</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-entry" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            entry(name) &rarr; Entry
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns a ZIP file entry. You can use this to check if the entry exists and
+its contents, for example:</p>
+
+<pre class="ruby"><span class="ruby-identifier">package</span>(:<span class="ruby-identifier">jar</span>).<span class="ruby-identifier">entry</span>(<span class="ruby-string">&quot;META-INF/LICENSE&quot;</span>).<span class="ruby-identifier">should</span> <span class="ruby-identifier">contain</span>(<span class="ruby-regexp">/Apache Software License/</span>)
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="entry-source">
+            <pre><span class="ruby-comment"># File lib/buildr/packaging/ziptask.rb, line 44</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">entry</span>(<span class="ruby-identifier">entry_name</span>)
+  <span class="ruby-operator">::</span><span class="ruby-constant">Zip</span><span class="ruby-operator">::</span><span class="ruby-constant">Entry</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">entry_name</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>
+