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

facets 2.5.2 → 2.6.0

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>