ripxplore 0.0.1 → 0.0.2

data/doc/classes/FileCache.html

@@ -94,10 +94,17 @@ downloaded to the local cache
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000138">get</a>&nbsp;&nbsp;
-      <a href="#M000135">local_name</a>&nbsp;&nbsp;
-      <a href="#M000136">new</a>&nbsp;&nbsp;
-      <a href="#M000137">purge</a>&nbsp;&nbsp;
+      <a href="#M000202">cache_name_for_native_file</a>&nbsp;&nbsp;
+      <a href="#M000201">cache_name_for_url</a>&nbsp;&nbsp;
+      <a href="#M000207">file_system_image_urls_in_cache</a>&nbsp;&nbsp;
+      <a href="#M000210">force_native_file_to_cache</a>&nbsp;&nbsp;
+      <a href="#M000206">get_file_system_image</a>&nbsp;&nbsp;
+      <a href="#M000205">get_url</a>&nbsp;&nbsp;
+      <a href="#M000208">make_file_system_image_list</a>&nbsp;&nbsp;
+      <a href="#M000203">new</a>&nbsp;&nbsp;
+      <a href="#M000211">purge_native_file_from_cache</a>&nbsp;&nbsp;
+      <a href="#M000204">purge_url</a>&nbsp;&nbsp;
+      <a href="#M000209">random_file_system_image</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -118,7 +125,17 @@ downloaded to the local cache
       <div class="name-list">
         <table>
         <tr class="top-aligned-row context-row">
-          <td class="context-item-name">cache_dir</td>
+          <td class="context-item-name">native_file_cache_dir</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">url_cache_dir</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">url_cache_list</td>
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc"></td>
         </tr>
@@ -132,13 +149,13 @@ downloaded to the local cache
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000136" class="method-detail">
-        <a name="M000136"></a>
+      <div id="method-M000203" class="method-detail">
+        <a name="M000203"></a>
 
         <div class="method-heading">
-          <a href="FileCache.src/M000136.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCache.src/M000136.html');return false;">
-          <span class="method-name">new</span><span class="method-args">(cache_dir)</span>
+          <a href="FileCache.src/M000203.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000203.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(url_cache_dir,native_file_cache_dir)</span>
           </a>
         </div>
       
@@ -148,13 +165,13 @@ downloaded to the local cache
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000138" class="method-detail">
-        <a name="M000138"></a>
+      <div id="method-M000202" class="method-detail">
+        <a name="M000202"></a>
 
         <div class="method-heading">
-          <a href="FileCache.src/M000138.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCache.src/M000138.html');return false;">
-          <span class="method-name">get</span><span class="method-args">(url)</span>
+          <a href="FileCache.src/M000202.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000202.html');return false;">
+          <span class="method-name">cache_name_for_native_file</span><span class="method-args">(native_file,extension)</span>
           </a>
         </div>
       
@@ -162,32 +179,125 @@ downloaded to the local cache
         </div>
       </div>
 
-      <div id="method-M000135" class="method-detail">
-        <a name="M000135"></a>
+      <div id="method-M000201" class="method-detail">
+        <a name="M000201"></a>
 
         <div class="method-heading">
-          <a href="FileCache.src/M000135.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCache.src/M000135.html');return false;">
-          <span class="method-name">local_name</span><span class="method-args">(url)</span>
+          <a href="FileCache.src/M000201.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000201.html');return false;">
+          <span class="method-name">cache_name_for_url</span><span class="method-args">(url)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000207" class="method-detail">
+        <a name="M000207"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000207.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000207.html');return false;">
+          <span class="method-name">file_system_image_urls_in_cache</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000210" class="method-detail">
+        <a name="M000210"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000210.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000210.html');return false;">
+          <span class="method-name">force_native_file_to_cache</span><span class="method-args">(native_file,method_to_cache_on_native_file,extension)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000206" class="method-detail">
+        <a name="M000206"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000206.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000206.html');return false;">
+          <span class="method-name">get_file_system_image</span><span class="method-args">(url)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000205" class="method-detail">
+        <a name="M000205"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000205.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000205.html');return false;">
+          <span class="method-name">get_url</span><span class="method-args">(url)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000208" class="method-detail">
+        <a name="M000208"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000208.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000208.html');return false;">
+          <span class="method-name">make_file_system_image_list</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000211" class="method-detail">
+        <a name="M000211"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000211.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000211.html');return false;">
+          <span class="method-name">purge_native_file_from_cache</span><span class="method-args">(native_file)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000204" class="method-detail">
+        <a name="M000204"></a>
+
+        <div class="method-heading">
+          <a href="FileCache.src/M000204.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000204.html');return false;">
+          <span class="method-name">purge_url</span><span class="method-args">(url)</span>
           </a>
         </div>
       
         <div class="method-description">
-          <p>
-create a <a href="FileCache.html#M000135">local_name</a> for a URL. format
-of <a href="FileCache.html#M000135">local_name</a>
-&quot;#{cache_dir}/#{Digest::MD5.hexdigest(url)}&quot;
-</p>
         </div>
       </div>
 
-      <div id="method-M000137" class="method-detail">
-        <a name="M000137"></a>
+      <div id="method-M000209" class="method-detail">
+        <a name="M000209"></a>
 
         <div class="method-heading">
-          <a href="FileCache.src/M000137.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCache.src/M000137.html');return false;">
-          <span class="method-name">purge</span><span class="method-args">(url)</span>
+          <a href="FileCache.src/M000209.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCache.src/M000209.html');return false;">
+          <span class="method-name">random_file_system_image</span><span class="method-args">(collection_type=nil)</span>
           </a>
         </div>
       

data/doc/classes/FileCache.src/M000201.html

@@ -0,0 +1,18 @@
+<?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>cache_name_for_url (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 22</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cache_name_for_url</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-node">&quot;#{url_cache_dir}/#{Digest::MD5.hexdigest(url)}.cached&quot;</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000202.html

@@ -0,0 +1,20 @@
+<?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>cache_name_for_native_file (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 26</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cache_name_for_native_file</span>(<span class="ruby-identifier">native_file</span>,<span class="ruby-identifier">extension</span>)
+    <span class="ruby-identifier">image</span>=<span class="ruby-identifier">native_file</span>.<span class="ruby-identifier">file_system_image</span>
+    <span class="ruby-identifier">index</span>=<span class="ruby-identifier">image</span>.<span class="ruby-identifier">files</span>.<span class="ruby-identifier">index</span>(<span class="ruby-identifier">native_file</span>)
+    <span class="ruby-node">&quot;#{native_file_cache_dir}/#{Digest::MD5.hexdigest(image.filename)}-#{index}.#{extension}&quot;</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000203.html

@@ -0,0 +1,24 @@
+<?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>new (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 32</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">url_cache_dir</span>,<span class="ruby-identifier">native_file_cache_dir</span>)
+    <span class="ruby-ivar">@url_cache_dir</span>=<span class="ruby-identifier">url_cache_dir</span>
+    <span class="ruby-ivar">@native_file_cache_dir</span>=<span class="ruby-identifier">native_file_cache_dir</span>
+    <span class="ruby-ivar">@url_cache_list</span>=<span class="ruby-node">&quot;#{url_cache_dir}/cache.urls&quot;</span>
+    <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span>(<span class="ruby-identifier">url_cache_dir</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">url_cache_dir</span>)
+    <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;cache directory #{url_cache_dir} invalid&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">url_cache_dir</span>)
+    <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span>(<span class="ruby-identifier">native_file_cache_dir</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">native_file_cache_dir</span>)
+    <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;cache directory #{native_file_cache_dir} invalid&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">native_file_cache_dir</span>)
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000204.html

@@ -0,0 +1,22 @@
+<?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>purge_url (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 42</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">purge_url</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-identifier">local_file_name</span>=<span class="ruby-identifier">cache_name_for_url</span>(<span class="ruby-identifier">url</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_file_name</span>) <span class="ruby-keyword kw">then</span>
+      <span class="ruby-constant">RipXploreLog</span>.<span class="ruby-identifier">log</span> <span class="ruby-node">&quot;purging local copy of #{url}&quot;</span>
+      <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">local_file_name</span>)
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000205.html

@@ -0,0 +1,32 @@
+<?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>get_url (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 50</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_url</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-identifier">local_file_name</span>=<span class="ruby-identifier">cache_name_for_url</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">local_file_name</span>) <span class="ruby-keyword kw">then</span>
+      <span class="ruby-constant">RipXploreLog</span>.<span class="ruby-identifier">log</span> <span class="ruby-node">&quot;downloading #{url}&quot;</span>
+      <span class="ruby-identifier">remote_file</span>=<span class="ruby-identifier">open</span>(<span class="ruby-identifier">url</span>,<span class="ruby-value str">&quot;rb&quot;</span>)
+      <span class="ruby-identifier">local_file</span>=<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">local_file_name</span>,<span class="ruby-value str">&quot;wb&quot;</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-identifier">local_file</span>.<span class="ruby-identifier">close</span>
+      <span class="ruby-identifier">local_file_info_filename</span>=<span class="ruby-node">&quot;#{local_file_name}.info&quot;</span>
+      <span class="ruby-identifier">local_file_info_file</span>=<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">local_file_info_filename</span>,<span class="ruby-value str">&quot;w&quot;</span>)
+      <span class="ruby-identifier">local_file_info_file</span><span class="ruby-operator">&lt;&lt;</span><span class="ruby-identifier">url</span>
+      <span class="ruby-identifier">local_file_info_file</span>.<span class="ruby-identifier">close</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">file</span>=<span class="ruby-constant">FileCacheItem</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">local_file_name</span>,<span class="ruby-value str">&quot;rb&quot;</span>)
+    <span class="ruby-identifier">file</span>.<span class="ruby-identifier">set_path</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-identifier">file</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000206.html

@@ -0,0 +1,21 @@
+<?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>get_file_system_image (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 68</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_file_system_image</span>(<span class="ruby-identifier">url</span>)
+    <span class="ruby-identifier">file</span>=<span class="ruby-identifier">get_url</span>(<span class="ruby-identifier">url</span>)    
+    <span class="ruby-identifier">image</span>=<span class="ruby-constant">RipXplore</span>.<span class="ruby-identifier">best_fit_from_file</span>(<span class="ruby-identifier">file</span>)
+    <span class="ruby-ivar">@@file_system_image_urls</span><span class="ruby-operator">&lt;&lt;</span><span class="ruby-identifier">url</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-operator">!</span><span class="ruby-ivar">@@file_system_image_urls</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@@file_system_image_urls</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">url</span>))    
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">image</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000207.html

@@ -0,0 +1,22 @@
+<?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>file_system_image_urls_in_cache (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 76</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">file_system_image_urls_in_cache</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@file_system_image_urls</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">then</span>
+      <span class="ruby-identifier">make_file_system_image_list</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-ivar">@url_cache_list</span>)
+      <span class="ruby-ivar">@@file_system_image_urls</span>=<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-ivar">@url_cache_list</span>,<span class="ruby-value str">&quot;r&quot;</span>).<span class="ruby-identifier">readlines</span>.<span class="ruby-identifier">collect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">url</span><span class="ruby-operator">|</span> <span class="ruby-identifier">url</span>.<span class="ruby-identifier">chomp</span>}
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-ivar">@@file_system_image_urls</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000208.html

@@ -0,0 +1,23 @@
+<?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>make_file_system_image_list (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 84</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">make_file_system_image_list</span>
+    <span class="ruby-identifier">urls</span>=[]
+    <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>(<span class="ruby-node">&quot;#{url_cache_dir}/*.cached.info&quot;</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">info_file</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">url</span>=<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">info_file</span>,<span class="ruby-value str">&quot;r&quot;</span>).<span class="ruby-identifier">read</span>.<span class="ruby-identifier">chomp</span>
+      <span class="ruby-identifier">urls</span><span class="ruby-operator">&lt;&lt;</span><span class="ruby-identifier">url</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-constant">FileSystemImage</span>.<span class="ruby-identifier">is_file_system_image_filename?</span>(<span class="ruby-identifier">url</span>))
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-ivar">@url_cache_list</span>,<span class="ruby-value str">&quot;w&quot;</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span><span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">urls</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;\n&quot;</span>)}
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000209.html

@@ -0,0 +1,27 @@
+<?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>random_file_system_image (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 94</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">random_file_system_image</span>(<span class="ruby-identifier">collection_type</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-identifier">all_image_urls</span>=<span class="ruby-identifier">file_system_image_urls_in_cache</span>    
+    <span class="ruby-identifier">all_image_urls</span>.<span class="ruby-identifier">length</span>.<span class="ruby-identifier">times</span> <span class="ruby-keyword kw">do</span>
+      <span class="ruby-keyword kw">begin</span>
+        <span class="ruby-identifier">index</span>=<span class="ruby-identifier">rand</span>(<span class="ruby-identifier">all_image_urls</span>.<span class="ruby-identifier">length</span>)
+        <span class="ruby-identifier">image</span>=<span class="ruby-identifier">get_file_system_image</span>(<span class="ruby-identifier">all_image_urls</span>[<span class="ruby-identifier">index</span><span class="ruby-operator">%</span><span class="ruby-identifier">all_image_urls</span>.<span class="ruby-identifier">length</span>])
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">image</span> <span class="ruby-keyword kw">if</span> ((<span class="ruby-identifier">collection_type</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>) <span class="ruby-operator">||</span> (<span class="ruby-identifier">image</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">collection_type</span>).<span class="ruby-identifier">length</span><span class="ruby-operator">&gt;</span><span class="ruby-value">0</span>))
+      <span class="ruby-keyword kw">rescue</span> <span class="ruby-comment cmt">#silently swallow any exception</span>
+      <span class="ruby-keyword kw">end</span>    
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">raise</span> <span class="ruby-value str">'no suitable image found in cache'</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000210.html

@@ -0,0 +1,24 @@
+<?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>force_native_file_to_cache (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 107</span>
+<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">force_native_file_to_cache</span>(<span class="ruby-identifier">native_file</span>,<span class="ruby-identifier">method_to_cache_on_native_file</span>,<span class="ruby-identifier">extension</span>)
+  <span class="ruby-identifier">cache_filename</span>=<span class="ruby-identifier">cache_name_for_native_file</span>(<span class="ruby-identifier">native_file</span>,<span class="ruby-identifier">extension</span>)
+  <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">cache_filename</span>) <span class="ruby-keyword kw">then</span>    
+      <span class="ruby-identifier">local_file</span>=<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">cache_filename</span>,<span class="ruby-value str">&quot;wb&quot;</span>)      
+      <span class="ruby-identifier">local_file</span><span class="ruby-operator">&lt;&lt;</span><span class="ruby-identifier">native_file</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">method_to_cache_on_native_file</span>)
+      <span class="ruby-identifier">local_file</span>.<span class="ruby-identifier">close</span>        
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">cache_filename</span>
+<span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCache.src/M000211.html

@@ -0,0 +1,21 @@
+<?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>purge_native_file_from_cache (FileCache)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 117</span>
+<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">purge_native_file_from_cache</span>(<span class="ruby-identifier">native_file</span>)
+  <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>(<span class="ruby-identifier">cache_name_for_native_file</span>(<span class="ruby-identifier">native_file</span>,<span class="ruby-value str">'*'</span>)).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
+    <span class="ruby-constant">RipXploreLog</span>.<span class="ruby-identifier">log</span> <span class="ruby-node">&quot;purging local #{filename}&quot;</span>
+    <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">filename</span>)  
+  <span class="ruby-keyword kw">end</span>
+<span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCacheItem.html

@@ -86,8 +86,8 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000166">path</a>&nbsp;&nbsp;
-      <a href="#M000165">set_path</a>&nbsp;&nbsp;
+      <a href="#M000236">path</a>&nbsp;&nbsp;
+      <a href="#M000235">set_path</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -109,12 +109,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000166" class="method-detail">
-        <a name="M000166"></a>
+      <div id="method-M000236" class="method-detail">
+        <a name="M000236"></a>
 
         <div class="method-heading">
-          <a href="FileCacheItem.src/M000166.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCacheItem.src/M000166.html');return false;">
+          <a href="FileCacheItem.src/M000236.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCacheItem.src/M000236.html');return false;">
           <span class="method-name">path</span><span class="method-args">()</span>
           </a>
         </div>
@@ -123,12 +123,12 @@
         </div>
       </div>
 
-      <div id="method-M000165" class="method-detail">
-        <a name="M000165"></a>
+      <div id="method-M000235" class="method-detail">
+        <a name="M000235"></a>
 
         <div class="method-heading">
-          <a href="FileCacheItem.src/M000165.html" target="Code" class="method-signature"
-            onclick="popupCode('FileCacheItem.src/M000165.html');return false;">
+          <a href="FileCacheItem.src/M000235.html" target="Code" class="method-signature"
+            onclick="popupCode('FileCacheItem.src/M000235.html');return false;">
           <span class="method-name">set_path</span><span class="method-args">(path)</span>
           </a>
         </div>

data/doc/classes/FileCacheItem.src/M000235.html

@@ -0,0 +1,18 @@
+<?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>set_path (FileCacheItem)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_path</span>(<span class="ruby-identifier">path</span>)
+    <span class="ruby-ivar">@path</span>=<span class="ruby-identifier">path</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileCacheItem.src/M000236.html

@@ -0,0 +1,18 @@
+<?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>path (FileCacheItem)</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" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/FileCache.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">path</span>
+    <span class="ruby-ivar">@path</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/FileContainer.html

@@ -77,6 +77,13 @@
 
 
   <div id="contextContent">
+    <div id="diagram">
+      <map id="map" name="map">
+  <area shape="rect" coords="5,101,104,149"      href="FileContainer.html" alt="FileContainer" />
+  <area shape="rect" coords="19,5,91,53"      href="Array.html" alt="Array" />
+</map>
+<img src="../dot/f_4.png" usemap="#map" border="0" alt="dot/f_4.png">
+    </div>
 
     <div id="description">
       <p>