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/core/classes/Exception.html DELETED

@@ -1,163 +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: Exception</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 />Exception</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/exception/suppress_rb.html">lib/core/facets/exception/suppress.rb</a>
-<a href="../files/lib/core/facets/exception/detail_rb.html">lib/core/facets/exception/detail.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="Object.html">
-Object
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000237">detail</a></span>
-  <span style="padding-right: 5px;"><a href="#M000236">suppress</a></span>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000236"></a><b>suppress</b>(*exception_classes) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Supress errors while executing a block, with execptions.
-</p>
-<p>
-CREDIT: David Heinemeier Hansson, Thomas Sawyer
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000236_source')" id="l_M000236_source">+</a> ]</p>
-  <div id="M000236_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/exception/suppress.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">suppress</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">exception_classes</span>)
-    <span class="ruby-identifier">exception_classes</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">e</span> <span class="ruby-operator">&lt;</span> <span class="ruby-keyword kw">self</span>
-        <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;exception #{e} not a subclass of #{self}&quot;</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">begin</span> <span class="ruby-keyword kw">yield</span>
-    <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">exception_classes</span>.<span class="ruby-identifier">any?</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">cls</span><span class="ruby-operator">|</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-identifier">cls</span>) }
-    <span class="ruby-keyword kw">end</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="M000237"></a><b>detail</b>()
-  </div>
-  <div class="description">
-  <p>
-Pretty string output of exception/error object useful for helpful debug
-messages.
-</p>
-<p>
-Input: The <a href="Exception.html">Exception</a>/StandardError object
-</p>
-<p>
-Output: The pretty printed string
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000237_source')" id="l_M000237_source">+</a> ]</p>
-  <div id="M000237_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/exception/detail.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">detail</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-node">%{#{message}\n  #{backtrace.join(&quot;\n  &quot;)}\n  LOGGED FROM: #{caller[0]}}</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/core/classes/FalseClass.html DELETED

@@ -1,131 +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: FalseClass</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 />FalseClass</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/boolean_rb.html">lib/core/facets/boolean.rb</a>
-<a href="../files/lib/core/facets/blank_rb.html">lib/core/facets/blank.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="Object.html">
-Object
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000074">blank?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000073">to_bool</a></span>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000074"></a><b>blank?</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000074_source')" id="l_M000074_source">+</a> ]</p>
-  <div id="M000074_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/blank.rb, line 26</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blank?</span>
-    <span class="ruby-keyword kw">true</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000073"></a><b>to_bool</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">+</a> ]</p>
-  <div id="M000073_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 147</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_bool</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/core/classes/File.html DELETED

@@ -1,576 +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: File</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 />File</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/file/rootname_rb.html">lib/core/facets/file/rootname.rb</a>
-<a href="../files/lib/core/facets/file/split_root_rb.html">lib/core/facets/file/split_root.rb</a>
-<a href="../files/lib/core/facets/file/null_rb.html">lib/core/facets/file/null.rb</a>
-<a href="../files/lib/core/facets/file/create_rb.html">lib/core/facets/file/create.rb</a>
-<a href="../files/lib/core/facets/file/write_rb.html">lib/core/facets/file/write.rb</a>
-<a href="../files/lib/core/facets/file/writelines_rb.html">lib/core/facets/file/writelines.rb</a>
-<a href="../files/lib/core/facets/file/append_rb.html">lib/core/facets/file/append.rb</a>
-<a href="../files/lib/core/facets/file/split_all_rb.html">lib/core/facets/file/split_all.rb</a>
-<a href="../files/lib/core/facets/file/rewrite_rb.html">lib/core/facets/file/rewrite.rb</a>
-<a href="../files/lib/core/facets/file/read_rb.html">lib/core/facets/file/read.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="Object.html">
-Object
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000260">append</a></span>
-  <span style="padding-right: 5px;"><a href="#M000257">create</a></span>
-  <span style="padding-right: 5px;"><a href="#M000256">null</a></span>
-  <span style="padding-right: 5px;"><a href="#M000265">read_binary</a></span>
-  <span style="padding-right: 5px;"><a href="#M000266">read_list</a></span>
-  <span style="padding-right: 5px;"><a href="#M000262">rewrite</a></span>
-  <span style="padding-right: 5px;"><a href="#M000263">rewrite!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000254">rootname</a></span>
-  <span style="padding-right: 5px;"><a href="#M000264">sanitize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000261">split_all</a></span>
-  <span style="padding-right: 5px;"><a href="#M000255">split_root</a></span>
-  <span style="padding-right: 5px;"><a href="#M000258">write</a></span>
-  <span style="padding-right: 5px;"><a href="#M000259">writelines</a></span>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000260"></a><b>append</b>( file, str )
-  </div>
-  <div class="description">
-  <p>
-Append to a file.
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000260_source')" id="l_M000260_source">+</a> ]</p>
-  <div id="M000260_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/append.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">append</span>( <span class="ruby-identifier">file</span>, <span class="ruby-identifier">str</span> )
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-identifier">file</span>, <span class="ruby-value str">'ab'</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">str</span>
-    }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000257"></a><b>create</b>(path, str='', &amp;blk)
-  </div>
-  <div class="description">
-  <p>
-Creates a new file, or overwrites an existing file, and writes a string
-into it. Can also take a block just like File#open, which is yielded
-<em>after</em> the string is writ.
-</p>
-<pre>
-  str = 'The content for the file'
-  File.create('myfile.txt', str)
-</pre>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000257_source')" id="l_M000257_source">+</a> ]</p>
-  <div id="M000257_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/create.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">create</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">str</span>=<span class="ruby-value str">''</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
-    <span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">'wb'</span>) <span class="ruby-keyword kw">do</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">str</span>
-      <span class="ruby-identifier">blk</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">f</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">blk</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="M000256"></a><b>null</b>()
-  </div>
-  <div class="description">
-  <p>
-Platform dependent <a href="File.html#M000256">null</a> device.
-</p>
-<p>
-CREDIT: Daniel Burger
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000256_source')" id="l_M000256_source">+</a> ]</p>
-  <div id="M000256_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/null.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">null</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-constant">RUBY_PLATFORM</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/mswin/i</span>
-      <span class="ruby-value str">'NUL'</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/amiga/i</span>
-      <span class="ruby-value str">'NIL:'</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/openvms/i</span>
-      <span class="ruby-value str">'NL:'</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-value str">'/dev/null'</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="M000265"></a><b>read_binary</b>(fname)
-  </div>
-  <div class="description">
-  <p>
-Read in a file as binary data.
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000265_source')" id="l_M000265_source">+</a> ]</p>
-  <div id="M000265_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 18</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_binary</span>(<span class="ruby-identifier">fname</span>)
-    <span class="ruby-identifier">open</span>(<span class="ruby-identifier">fname</span>, <span class="ruby-value str">'rb'</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">read</span>
-    }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000266"></a><b>read_list</b>(filepath, chomp_string='')
-  </div>
-  <div class="description">
-  <p>
-Reads in a file, removes blank lines and remarks (lines starting with
-&#8217;#&#8217;) and then returns an array of all the remaining lines.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000266_source')" id="l_M000266_source">+</a> ]</p>
-  <div id="M000266_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 30</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_list</span>(<span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">chomp_string</span>=<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">farr</span> = <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">farr</span> = <span class="ruby-identifier">read</span>(<span class="ruby-identifier">filepath</span>).<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;\n&quot;</span>)
-    <span class="ruby-identifier">farr</span>.<span class="ruby-identifier">collect!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">l</span> = <span class="ruby-identifier">line</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">chomp</span>(<span class="ruby-identifier">chomp_string</span>)
-      (<span class="ruby-identifier">l</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">l</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">'#'</span>) <span class="ruby-operator">?</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">l</span>
-    }
-    <span class="ruby-identifier">farr</span>.<span class="ruby-identifier">compact</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000262"></a><b>rewrite</b>(name, mode = &quot;&quot;) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Opens a file as a string and writes back the string to the file at the end
-of the block.
-</p>
-<p>
-Returns the number of written bytes or <tt>nil</tt> if the file
-wasn&#8216;t modified.
-</p>
-<p>
-Note that the file will even be written back in case the block raises an
-exception.
-</p>
-<p>
-Mode can either be &quot;b&quot; or &quot;+&quot; and specifies to open the
-file in binary mode (no mapping of the plattform&#8216;s newlines to
-&quot;\n&quot; is done) or to <a href="File.html#M000260">append</a> to it.
-</p>
-<pre>
-  # Reverse contents of &quot;message&quot;
-  File.rewrite(&quot;message&quot;) { |str| str.reverse }
-  # Replace &quot;foo&quot; by &quot;bar&quot; in &quot;binary&quot;
-  File.rewrite(&quot;binary&quot;, &quot;b&quot;) { |str| str.gsub(&quot;foo&quot;, &quot;bar&quot;) }
-</pre>
-<p>
-IMPORTANT: The old version of this method required in place modification of
-the file string. The new version will <a href="File.html#M000258">write</a>
-whatever the block returns instead!!!
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000262_source')" id="l_M000262_source">+</a> ]</p>
-  <div id="M000262_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 28</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Need to supply block to File.rewrite&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Numeric</span>) <span class="ruby-keyword kw">then</span>
-      <span class="ruby-identifier">flag</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-identifier">mode</span>, <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;b&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">BINARY</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;+&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">APPEND</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">delete!</span>(<span class="ruby-value str">&quot;^b+&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;r#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> } <span class="ruby-comment cmt">#rescue &quot;&quot;</span>
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-identifier">old_str</span>.<span class="ruby-identifier">clone</span>
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-identifier">new_str</span> = <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">old_str</span>)
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">old_str</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">new_str</span>
-        <span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;w#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">new_str</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="M000263"></a><b>rewrite!</b>(name, mode = &quot;&quot;) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-In place version of <a href="File.html#M000262">rewrite</a>. This version
-of method requires that the string be modified in place within the block.
-</p>
-<pre>
-  # Reverse contents of &quot;message&quot;
-  File.rewrite(&quot;message&quot;) { |str| str.reverse! }
-  # Replace &quot;foo&quot; by &quot;bar&quot; in &quot;binary&quot;
-  File.rewrite(&quot;binary&quot;, &quot;b&quot;) { |str| str.gsub!(&quot;foo&quot;, &quot;bar&quot;) }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000263_source')" id="l_M000263_source">+</a> ]</p>
-  <div id="M000263_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 62</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite!</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Need to supply block to File.rewrite&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Numeric</span>) <span class="ruby-keyword kw">then</span>
-      <span class="ruby-identifier">flag</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-identifier">mode</span>, <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;b&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">BINARY</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;+&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">APPEND</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">delete!</span>(<span class="ruby-value str">&quot;^b+&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;r#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> } <span class="ruby-comment cmt">#rescue &quot;&quot;</span>
-    <span class="ruby-identifier">new_str</span> = <span class="ruby-identifier">old_str</span>.<span class="ruby-identifier">clone</span>
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">new_str</span>)
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">old_str</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">new_str</span>
-        <span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;w#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">str</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="M000254"></a><b>rootname</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Returns onlt the first portion of the directory of a file path name.
-</p>
-<pre>
-  File.rootname('lib/jump.rb')  #=&gt; 'lib'
-  File.rootname('/jump.rb')     #=&gt; '/'
-  File.rootname('jump.rb')      #=&gt; '.'
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000254_source')" id="l_M000254_source">+</a> ]</p>
-  <div id="M000254_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rootname.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rootname</span>(<span class="ruby-identifier">path</span>)
-    <span class="ruby-comment cmt"># this should be fairly robust</span>
-    <span class="ruby-identifier">path_re</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'['</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Separator</span> <span class="ruby-operator">+</span> <span class="ruby-value str">%q{\/}</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">']'</span>)
-    <span class="ruby-identifier">head</span>, <span class="ruby-identifier">tail</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-identifier">path_re</span>, <span class="ruby-value">2</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'.'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">head</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'/'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">head</span>.<span class="ruby-identifier">empty?</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">head</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000264"></a><b>sanitize</b>(filename)
-  </div>
-  <div class="description">
-  <p>
-Cleans up a filename to ensure it will work on filesystem.
-</p>
-<p>
-CREDIT: George Moschovitis
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000264_source')" id="l_M000264_source">+</a> ]</p>
-  <div id="M000264_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sanitize</span>(<span class="ruby-identifier">filename</span>)
-    <span class="ruby-identifier">filename</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot;\\&quot;</span>, <span class="ruby-value str">&quot;/&quot;</span>)) <span class="ruby-comment cmt"># work-around for IE</span>
-    <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/[^a-zA-Z0-9\.\-\+_]/</span>,<span class="ruby-value str">&quot;_&quot;</span>)
-    <span class="ruby-identifier">filename</span> = <span class="ruby-node">&quot;_#{filename}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^\.+$/</span>
-    <span class="ruby-identifier">filename</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000261"></a><b>split_all</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Splits a file path into an array of individual path components. This
-differs from <tt>File.split</tt>, which divides the path into only two
-parts, directory path and basename.
-</p>
-<pre>
-  File.split_all(&quot;a/b/c&quot;) =&gt;  ['a', 'b', 'c']
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000261_source')" id="l_M000261_source">+</a> ]</p>
-  <div id="M000261_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/split_all.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">split_all</span>(<span class="ruby-identifier">path</span>)
-    <span class="ruby-identifier">head</span>, <span class="ruby-identifier">tail</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">split</span>(<span class="ruby-identifier">path</span>)
-    <span class="ruby-keyword kw">return</span> [<span class="ruby-identifier">tail</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">head</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'.'</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">tail</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'/'</span>
-    <span class="ruby-keyword kw">return</span> [<span class="ruby-identifier">head</span>, <span class="ruby-identifier">tail</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">head</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'/'</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">split_all</span>(<span class="ruby-identifier">head</span>) <span class="ruby-operator">+</span> [<span class="ruby-identifier">tail</span>]
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000255"></a><b>split_root</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Return the head of path from the rest of the path.
-</p>
-<pre>
-  File.split_root('etc/xdg/gtk')  #=&gt; ['etc', 'xdg/gtk']
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000255_source')" id="l_M000255_source">+</a> ]</p>
-  <div id="M000255_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/split_root.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">split_root</span>(<span class="ruby-identifier">path</span>)
-    <span class="ruby-identifier">path_re</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'['</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Separator</span> <span class="ruby-operator">+</span> <span class="ruby-value str">%q{\/}</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">']'</span>)
-    <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-identifier">path_re</span>, <span class="ruby-value">2</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000258"></a><b>write</b>(path, data)
-  </div>
-  <div class="description">
-  <p>
-Writes the given data to the given path and closes the file. This is done
-in binary mode, complementing <tt>IO.read</tt> in standard Ruby.
-</p>
-<p>
-Returns the number of bytes written.
-</p>
-<p>
-CREDIT: Gavin Sinclair
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000258_source')" id="l_M000258_source">+</a> ]</p>
-  <div id="M000258_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 15</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">&quot;wb&quot;</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">data</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="M000259"></a><b>writelines</b>(path, data)
-  </div>
-  <div class="description">
-  <p>
-Writes the given array of data to the given path and closes the file. This
-is done in binary mode, complementing <tt>IO.readlines</tt> in standard
-Ruby.
-</p>
-<p>
-Note that <tt>readlines</tt> (the standard Ruby method) returns an array of
-lines <em>with newlines intact</em>, whereas <tt><a
-href="File.html#M000259">writelines</a></tt> uses <tt>puts</tt>, and so
-appends newlines if necessary. In this small way, <tt>readlines</tt> and
-<tt><a href="File.html#M000259">writelines</a></tt> are not exact
-opposites.
-</p>
-<p>
-Returns <tt>nil</tt>.
-</p>
-<p>
-CREDIT: Noah Gibbs, Gavin Sinclair
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000259_source')" id="l_M000259_source">+</a> ]</p>
-  <div id="M000259_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/writelines.rb, line 16</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">writelines</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">&quot;wb&quot;</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">file</span>.<span class="ruby-identifier">puts</span>(<span class="ruby-identifier">data</span>)
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>