RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (677) hide show

data/doc/rdoc/more/classes/Downloader.html DELETED

@@ -1,512 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: Downloader</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />Downloader</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/downloader_rb.html">lib/more/facets/downloader.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-Object
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><h1><a href="Downloader.html">Downloader</a></h1>
-<p>
-Tool module for downloading files and extracting archive files. Currently
-this is console-based but in the future will have SOC for any <a
-href="Downloader.html#M000095">interface</a>.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000098">add_mirror</a></span>
-  <span style="padding-right: 5px;"><a href="#M000099">add_mirrors</a></span>
-  <span style="padding-right: 5px;"><a href="#M000105">compute_checksum</a></span>
-  <span style="padding-right: 5px;"><a href="#M000104">download</a></span>
-  <span style="padding-right: 5px;"><a href="#M000106">extract</a></span>
-  <span style="padding-right: 5px;"><a href="#M000101">fetch</a></span>
-  <span style="padding-right: 5px;"><a href="#M000095">interface</a></span>
-  <span style="padding-right: 5px;"><a href="#M000096">interface=</a></span>
-  <span style="padding-right: 5px;"><a href="#M000100">mirrors</a></span>
-  <span style="padding-right: 5px;"><a href="#M000102">monitored_download</a></span>
-  <span style="padding-right: 5px;"><a href="#M000097">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000103">prioritize_urls</a></span>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>destination</td>
-    <td class='attr-desc'></td>
-  </tr>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>region</td>
-    <td class='attr-desc'></td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000097"></a><b>new</b>( destination, mirrors=nil, region=nil, &amp;config )
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000097_source')" id="l_M000097_source">+</a> ]</p>
-  <div id="M000097_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 66</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>( <span class="ruby-identifier">destination</span>, <span class="ruby-identifier">mirrors</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">region</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">config</span> )
-    <span class="ruby-ivar">@destination</span> = <span class="ruby-identifier">destination</span>
-    <span class="ruby-ivar">@mirrors</span> = []
-    <span class="ruby-identifier">add_mirrors</span>( <span class="ruby-identifier">mirrors</span> ) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mirrors</span>
-    <span class="ruby-ivar">@region</span> = (<span class="ruby-identifier">region</span> <span class="ruby-operator">||</span> <span class="ruby-value str">'US'</span>).<span class="ruby-identifier">to_s</span>
-    <span class="ruby-identifier">config</span>.<span class="ruby-identifier">call</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">config</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000098"></a><b>add_mirror</b>( url, region=nil )
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000098_source')" id="l_M000098_source">+</a> ]</p>
-  <div id="M000098_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 76</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_mirror</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">region</span>=<span class="ruby-keyword kw">nil</span> )
-    <span class="ruby-ivar">@mirrors</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">Mirror</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">region</span> )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000099"></a><b>add_mirrors</b>( mirrors )
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000099_source')" id="l_M000099_source">+</a> ]</p>
-  <div id="M000099_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 80</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_mirrors</span>( <span class="ruby-identifier">mirrors</span> )
-    <span class="ruby-identifier">mirrors</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">mirror</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">mirror</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">String</span>
-        <span class="ruby-identifier">url</span>, <span class="ruby-identifier">rgn</span> = <span class="ruby-operator">*</span><span class="ruby-identifier">mirror</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">' '</span>)
-        <span class="ruby-identifier">add_mirror</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">rgn</span>.<span class="ruby-identifier">unbracket</span> )
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
-        <span class="ruby-identifier">add_mirror</span>( <span class="ruby-operator">*</span><span class="ruby-identifier">mirror</span> )
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Hash</span>
-        <span class="ruby-identifier">add_mirror</span>( <span class="ruby-identifier">mirror</span>[<span class="ruby-identifier">:url</span>], <span class="ruby-identifier">mirror</span>[<span class="ruby-identifier">:region</span>] )
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Mirror</span>
-        <span class="ruby-ivar">@mirrors</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">mirror</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unrecogized mirror definition #{mirror.inspect}&quot;</span>
-      <span class="ruby-keyword kw">end</span>
-    }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000105"></a><b>compute_checksum</b>( local_path )
-  </div>
-  <div class="description">
-  <p>
-<a href="Downloader.html#M000105">compute_checksum</a>
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000105_source')" id="l_M000105_source">+</a> ]</p>
-  <div id="M000105_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 240</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compute_checksum</span>( <span class="ruby-identifier">local_path</span> )
-    <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>( <span class="ruby-identifier">local_path</span> )
-      <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-identifier">local_path</span> ) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">local_file</span><span class="ruby-operator">|</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Digest</span><span class="ruby-operator">::</span><span class="ruby-constant">MD5</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">local_file</span>.<span class="ruby-identifier">read</span> ).<span class="ruby-identifier">hexdigest</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000104"></a><b>download</b>( url, filepath, checksum='', est_size=nil )
-  </div>
-  <div class="description">
-  <p>
-currently can only <a href="Downloader.html#M000104">download</a> a single
-compressed file does not handle downloading an uncompressed directory tree
-(should it? doubt it)
-</p>
-<p>
-currently this displays progress to STDOUT; either their should be a way to
-activate/deactivate or preferably use ducktype singletons (more on that
-later, see google://_whytheluckystiff if interested) of course I prefer
-chain messaging but matz said no :(
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000104_source')" id="l_M000104_source">+</a> ]</p>
-  <div id="M000104_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 179</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">download</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">checksum</span>=<span class="ruby-value str">''</span>, <span class="ruby-identifier">est_size</span>=<span class="ruby-keyword kw">nil</span> )
-    <span class="ruby-identifier">checksum</span> = <span class="ruby-identifier">checksum</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>
-    <span class="ruby-identifier">est_size</span> = <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">est_size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-    <span class="ruby-identifier">download_complete</span> = <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">interface</span>
-      <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">preparing_to_download</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>( <span class="ruby-identifier">filepath</span> ), <span class="ruby-identifier">url</span>, <span class="ruby-identifier">est_size</span> )
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">progress_total</span> = <span class="ruby-identifier">est_size</span> <span class="ruby-value">? </span><span class="ruby-identifier">est_size</span> <span class="ruby-operator">:</span> <span class="ruby-value">100000000</span>  <span class="ruby-comment cmt"># pretend 100MB if no size</span>
-    <span class="ruby-identifier">pbar</span> = <span class="ruby-constant">ProgressBar</span>.<span class="ruby-identifier">new</span>( <span class="ruby-value str">&quot;Status&quot;</span>, <span class="ruby-identifier">progress_total</span>, <span class="ruby-constant">STDOUT</span> )
-    <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">bar_mark</span> = <span class="ruby-value str">&quot;=&quot;</span>
-    <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">format</span> = <span class="ruby-value str">&quot;%-6s %3d%% %s %s&quot;</span>
-    <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">file_transfer_mode</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">est_size</span>
-    <span class="ruby-identifier">progress_proc</span> = <span class="ruby-identifier">proc</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">posit</span><span class="ruby-operator">|</span> <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">set</span>(<span class="ruby-identifier">posit</span>) }
-    <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">sync</span> = <span class="ruby-keyword kw">true</span>
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-identifier">local_file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-identifier">filepath</span>, <span class="ruby-value str">'wb'</span> )
-      <span class="ruby-identifier">remote_file</span> = <span class="ruby-identifier">open</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">:progress_proc</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">progress_proc</span> )
-      <span class="ruby-identifier">local_file</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">remote_file</span>.<span class="ruby-identifier">read</span>
-    <span class="ruby-keyword kw">rescue</span>
-      <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">halt</span>
-      <span class="ruby-identifier">download_complete</span> = <span class="ruby-keyword kw">nil</span>
-      <span class="ruby-identifier">raise</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">pbar</span>.<span class="ruby-identifier">finish</span>
-      <span class="ruby-identifier">download_complete</span> = <span class="ruby-identifier">filepath</span>
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-identifier">remote_file</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">remote_file</span>.<span class="ruby-identifier">nil?</span>
-      <span class="ruby-identifier">local_file</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">local_file</span>.<span class="ruby-identifier">nil?</span>
-      <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">sync</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">checksum</span>.<span class="ruby-identifier">empty?</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">ChecksumError</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">compute_checksum</span>(<span class="ruby-identifier">filepath</span>) <span class="ruby-operator">!=</span> <span class="ruby-identifier">checksum</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">interface</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">checksum</span>.<span class="ruby-identifier">empty?</span>
-        <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">lacks_checksum</span>( <span class="ruby-identifier">compute_checksum</span>(<span class="ruby-identifier">filepath</span>), <span class="ruby-identifier">:md5</span> )
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">est_size</span>
-        <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">lacks_size</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">size</span>(<span class="ruby-identifier">filepath</span>) )
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">download_complete</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">interface</span>
-        <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">downloaded</span>( <span class="ruby-identifier">filepath</span> )
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">download_complete</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000106"></a><b>extract</b>( local_path )
-  </div>
-  <div class="description">
-  <p>
-<a href="Downloader.html#M000106">extract</a>
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000106_source')" id="l_M000106_source">+</a> ]</p>
-  <div id="M000106_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 250</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">extract</span>( <span class="ruby-identifier">local_path</span> )
-    <span class="ruby-identifier">success</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-identifier">local_dir</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">dirname</span>(<span class="ruby-identifier">local_path</span>)
-    <span class="ruby-identifier">local_file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">local_path</span>)
-    <span class="ruby-identifier">current_dir</span> = <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">getwd</span>
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-identifier">local_dir</span>)
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">local_file</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/.*gz$/</span>
-          <span class="ruby-identifier">system</span> <span class="ruby-node">&quot;tar -xzf #{local_file}&quot;</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/.*bz2$/</span>
-          <span class="ruby-identifier">system</span> <span class="ruby-node">&quot;tar -xjf #{local_file}&quot;</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/.zip$/</span>
-          <span class="ruby-identifier">system</span> <span class="ruby-node">&quot;unzip #{local_file}&quot;</span>
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">success</span> = <span class="ruby-keyword kw">false</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">rescue</span>
-      <span class="ruby-identifier">success</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">success</span> = <span class="ruby-keyword kw">true</span>
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-identifier">current_dir</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">interface</span>
-      <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">extracted</span>( <span class="ruby-identifier">local_path</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">success</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000101"></a><b>fetch</b>( file, checksum=0, est_size=0, force=false )
-  </div>
-  <div class="description">
-  <p>
-<a href="Downloader.html#M000101">fetch</a>
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000101_source')" id="l_M000101_source">+</a> ]</p>
-  <div id="M000101_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 104</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fetch</span>( <span class="ruby-identifier">file</span>, <span class="ruby-identifier">checksum</span>=<span class="ruby-value">0</span>, <span class="ruby-identifier">est_size</span>=<span class="ruby-value">0</span>, <span class="ruby-identifier">force</span>=<span class="ruby-keyword kw">false</span> )
-    <span class="ruby-identifier">urls</span> = <span class="ruby-identifier">mirrors</span>.<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">m</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;#{m.url.chomp('/')}/#{file}&quot;</span> }
-    <span class="ruby-identifier">urls</span> = <span class="ruby-identifier">prioritize_urls</span>( <span class="ruby-identifier">urls</span> )
-    <span class="ruby-identifier">filepath</span> = <span class="ruby-node">&quot;#{destination.chomp('/')}/#{file}&quot;</span>
-    <span class="ruby-identifier">monitored_download</span>( <span class="ruby-identifier">urls</span>, <span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">checksum</span>, <span class="ruby-identifier">est_size</span>, <span class="ruby-identifier">force</span> )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000095"></a><b>interface</b>()
-  </div>
-  <div class="description">
-  <p>
-delegate to an <a href="Downloader.html#M000095">interface</a> (under
-development)
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000095_source')" id="l_M000095_source">+</a> ]</p>
-  <div id="M000095_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 61</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">interface</span> ; <span class="ruby-ivar">@interface</span>; <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000096"></a><b>interface=</b>(iface)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000096_source')" id="l_M000096_source">+</a> ]</p>
-  <div id="M000096_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 62</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">interface=</span>(<span class="ruby-identifier">iface</span>)
-    <span class="ruby-ivar">@interface</span> = <span class="ruby-identifier">iface</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000100"></a><b>mirrors</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000100_source')" id="l_M000100_source">+</a> ]</p>
-  <div id="M000100_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 98</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mirrors</span>
-    <span class="ruby-ivar">@mirrors</span>.<span class="ruby-identifier">sort</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">a</span>,<span class="ruby-identifier">b</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">region</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">region</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> ( <span class="ruby-identifier">b</span>.<span class="ruby-identifier">region</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">region</span> <span class="ruby-value">? </span><span class="ruby-operator">-</span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span> ) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000102"></a><b>monitored_download</b>( urls, filepath, checksum, est_size=0, force=false )
-  </div>
-  <div class="description">
-  <p>
-regional_urls - array of arrays of [ url, region, md5, expected_size ]
-local_region - region of the user&#8216;s system to_dir - where to store
-downloaded file (full path) force - <a
-href="Downloader.html#M000104">download</a> even if file already exists
-locally
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000102_source')" id="l_M000102_source">+</a> ]</p>
-  <div id="M000102_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 125</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">monitored_download</span>( <span class="ruby-identifier">urls</span>, <span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">checksum</span>, <span class="ruby-identifier">est_size</span>=<span class="ruby-value">0</span>, <span class="ruby-identifier">force</span>=<span class="ruby-keyword kw">false</span> )
-    <span class="ruby-identifier">checksum</span> = <span class="ruby-identifier">checksum</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>
-    <span class="ruby-identifier">est_size</span> = <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">est_size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-    <span class="ruby-identifier">success</span>=<span class="ruby-keyword kw">nil</span>
-    <span class="ruby-comment cmt"># source file exists and passes checksum then we need not fetch</span>
-    <span class="ruby-comment cmt">#file_path = File.join(to_dir,File.basename(url[0]))</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">filepath</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">compute_checksum</span>(<span class="ruby-identifier">filepath</span>) <span class="ruby-operator">==</span> <span class="ruby-identifier">checksum</span> <span class="ruby-keyword kw">and</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">force</span>
-        <span class="ruby-identifier">interface</span>.<span class="ruby-identifier">report</span>(<span class="ruby-value str">&quot;File has already been fetched and passes checksum.&quot;</span>)
-        <span class="ruby-identifier">success</span> = <span class="ruby-identifier">filepath</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">filepath</span>)
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">success</span>
-      <span class="ruby-comment cmt"># download</span>
-      <span class="ruby-identifier">urls</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">url</span><span class="ruby-operator">|</span>
-        <span class="ruby-keyword kw">begin</span>
-          <span class="ruby-comment cmt">#file_path = File.join(to_dir,File.basename(url[0]))</span>
-          <span class="ruby-comment cmt">#file_checksum = url[2].to_s.strip</span>
-          <span class="ruby-comment cmt">#file_size = url[3].to_i</span>
-          <span class="ruby-identifier">success</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">download</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">checksum</span>, <span class="ruby-identifier">est_size</span> )
-          <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">success</span>
-        <span class="ruby-keyword kw">rescue</span>
-          <span class="ruby-keyword kw">next</span>
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">success</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000103"></a><b>prioritize_urls</b>( urls )
-  </div>
-  <div class="description">
-  <p>
-In the future we may test each connection for fastest <a
-href="Downloader.html#M000104">download</a>
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000103_source')" id="l_M000103_source">+</a> ]</p>
-  <div id="M000103_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/downloader.rb, line 163</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">prioritize_urls</span>( <span class="ruby-identifier">urls</span> )
-    <span class="ruby-identifier">urls</span>
-    <span class="ruby-comment cmt"># put local region first</span>
-    <span class="ruby-comment cmt">#prioritized_urls = regional_urls.find_all { |a| a[1] == local_region }</span>
-    <span class="ruby-comment cmt">#prioritized_urls.concat regional_urls.find_all { |a| a[1] != local_region }</span>
-    <span class="ruby-comment cmt">#return prioritized_urls</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>