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

facets 2.5.2 → 2.6.0

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

Files changed (677) hide show

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

@@ -1,194 +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: BaseX</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 />BaseX</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/basex_rb.html">lib/more/facets/basex.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="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000710">convert_base</a></span>
-  <span style="padding-right: 5px;"><a href="#M000709">decode</a></span>
-  <span style="padding-right: 5px;"><a href="#M000708">encode</a></span>
-  <span style="padding-right: 5px;"><a href="#M000707">new</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">BASE62</td>
-    <td>=</td>
-    <td class="attr-value">[&quot;0&quot;..&quot;9&quot;, &quot;a&quot;..&quot;z&quot;, &quot;A&quot;..&quot;Z&quot;].map { |r| r.to_a }.flatten</td>
-  </tr>
-  </table>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>chars</td>
-    <td class='attr-desc'></td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000707"></a><b>new</b>(chars=BASE62)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000707_source')" id="l_M000707_source">+</a> ]</p>
-  <div id="M000707_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">chars</span>=<span class="ruby-constant">BASE62</span>)
-    <span class="ruby-ivar">@chars</span>  = <span class="ruby-identifier">chars</span>
-    <span class="ruby-ivar">@base</span>   = <span class="ruby-ivar">@chars</span>.<span class="ruby-identifier">size</span>
-    <span class="ruby-ivar">@values</span> = <span class="ruby-constant">Hash</span>[<span class="ruby-operator">*</span>(<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-ivar">@base</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> [ <span class="ruby-ivar">@chars</span>[<span class="ruby-identifier">i</span>], <span class="ruby-identifier">i</span> ] }.<span class="ruby-identifier">flatten</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="M000710"></a><b>convert_base</b>(digits, from_base, to_base)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000710_source')" id="l_M000710_source">+</a> ]</p>
-  <div id="M000710_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 25</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">digits</span>, <span class="ruby-identifier">from_base</span>, <span class="ruby-identifier">to_base</span>)
-    <span class="ruby-identifier">bignum</span> = <span class="ruby-value">0</span>
-    <span class="ruby-identifier">digits</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">digit</span><span class="ruby-operator">|</span> <span class="ruby-identifier">bignum</span> = <span class="ruby-identifier">bignum</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">from_base</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">digit</span> }
-    <span class="ruby-identifier">converted</span> = []
-    <span class="ruby-keyword kw">until</span> <span class="ruby-identifier">bignum</span>.<span class="ruby-identifier">zero?</span>
-      <span class="ruby-identifier">bignum</span>, <span class="ruby-identifier">digit</span> = <span class="ruby-identifier">bignum</span>.<span class="ruby-identifier">divmod</span> <span class="ruby-identifier">to_base</span>
-      <span class="ruby-identifier">converted</span>.<span class="ruby-identifier">push</span> <span class="ruby-identifier">digit</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">converted</span>.<span class="ruby-identifier">reverse</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000709"></a><b>decode</b>(encoded)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000709_source')" id="l_M000709_source">+</a> ]</p>
-  <div id="M000709_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 19</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decode</span>(<span class="ruby-identifier">encoded</span>)
-    <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">encoded</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
-      <span class="ruby-ivar">@values</span>[<span class="ruby-identifier">c</span>]
-    }, <span class="ruby-ivar">@base</span>, <span class="ruby-value">256</span>).<span class="ruby-identifier">pack</span>(<span class="ruby-value str">&quot;C*&quot;</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000708"></a><b>encode</b>(byte_string)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000708_source')" id="l_M000708_source">+</a> ]</p>
-  <div id="M000708_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encode</span>(<span class="ruby-identifier">byte_string</span>)
-    <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">byte_string</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">&quot;C*&quot;</span>), <span class="ruby-value">256</span>, <span class="ruby-ivar">@base</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span>
-      <span class="ruby-ivar">@chars</span>[<span class="ruby-identifier">d</span>]
-    }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">''</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

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

@@ -1,541 +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: BiCrypt</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 />BiCrypt</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/bicrypt_rb.html">lib/more/facets/bicrypt.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="BiCrypt.html">BiCrypt</a></h1>
-<p>
-A simple two-way encryption class.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000548">block_size</a></span>
-  <span style="padding-right: 5px;"><a href="#M000559">carefully_open_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000555">decrypt_block</a></span>
-  <span style="padding-right: 5px;"><a href="#M000561">decrypt_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000553">decrypt_pair</a></span>
-  <span style="padding-right: 5px;"><a href="#M000558">decrypt_stream</a></span>
-  <span style="padding-right: 5px;"><a href="#M000563">decrypt_string</a></span>
-  <span style="padding-right: 5px;"><a href="#M000554">encrypt_block</a></span>
-  <span style="padding-right: 5px;"><a href="#M000560">encrypt_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000552">encrypt_pair</a></span>
-  <span style="padding-right: 5px;"><a href="#M000557">encrypt_stream</a></span>
-  <span style="padding-right: 5px;"><a href="#M000562">encrypt_string</a></span>
-  <span style="padding-right: 5px;"><a href="#M000551">f</a></span>
-  <span style="padding-right: 5px;"><a href="#M000556">generate_initialization_vector</a></span>
-  <span style="padding-right: 5px;"><a href="#M000549">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000550">precalculate_S_table</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">ULONG</td>
-    <td>=</td>
-    <td class="attr-value">0x100000000</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000549"></a><b>new</b>(userKey)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000549_source')" id="l_M000549_source">+</a> ]</p>
-  <div id="M000549_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 37</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">userKey</span>)
-    <span class="ruby-comment cmt"># These are the S-boxes given in Applied Cryptography 2nd Ed., p. 333</span>
-    <span class="ruby-ivar">@sBox</span> = [
-      [<span class="ruby-value">4</span>, <span class="ruby-value">10</span>, <span class="ruby-value">9</span>, <span class="ruby-value">2</span>, <span class="ruby-value">13</span>, <span class="ruby-value">8</span>, <span class="ruby-value">0</span>, <span class="ruby-value">14</span>, <span class="ruby-value">6</span>, <span class="ruby-value">11</span>, <span class="ruby-value">1</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">15</span>, <span class="ruby-value">5</span>, <span class="ruby-value">3</span>],
-      [<span class="ruby-value">14</span>, <span class="ruby-value">11</span>, <span class="ruby-value">4</span>, <span class="ruby-value">12</span>, <span class="ruby-value">6</span>, <span class="ruby-value">13</span>, <span class="ruby-value">15</span>, <span class="ruby-value">10</span>, <span class="ruby-value">2</span>, <span class="ruby-value">3</span>, <span class="ruby-value">8</span>, <span class="ruby-value">1</span>, <span class="ruby-value">0</span>, <span class="ruby-value">7</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>],
-      [<span class="ruby-value">5</span>, <span class="ruby-value">8</span>, <span class="ruby-value">1</span>, <span class="ruby-value">13</span>, <span class="ruby-value">10</span>, <span class="ruby-value">3</span>, <span class="ruby-value">4</span>, <span class="ruby-value">2</span>, <span class="ruby-value">14</span>, <span class="ruby-value">15</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">6</span>, <span class="ruby-value">0</span>, <span class="ruby-value">9</span>, <span class="ruby-value">11</span>],
-      [<span class="ruby-value">7</span>, <span class="ruby-value">13</span>, <span class="ruby-value">10</span>, <span class="ruby-value">1</span>, <span class="ruby-value">0</span>, <span class="ruby-value">8</span>, <span class="ruby-value">9</span>, <span class="ruby-value">15</span>, <span class="ruby-value">14</span>, <span class="ruby-value">4</span>, <span class="ruby-value">6</span>, <span class="ruby-value">12</span>, <span class="ruby-value">11</span>, <span class="ruby-value">2</span>, <span class="ruby-value">5</span>, <span class="ruby-value">3</span>],
-      [<span class="ruby-value">6</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">1</span>, <span class="ruby-value">5</span>, <span class="ruby-value">15</span>, <span class="ruby-value">13</span>, <span class="ruby-value">8</span>, <span class="ruby-value">4</span>, <span class="ruby-value">10</span>, <span class="ruby-value">9</span>, <span class="ruby-value">14</span>, <span class="ruby-value">0</span>, <span class="ruby-value">3</span>, <span class="ruby-value">11</span>, <span class="ruby-value">2</span>],
-      [<span class="ruby-value">4</span>, <span class="ruby-value">11</span>, <span class="ruby-value">10</span>, <span class="ruby-value">0</span>, <span class="ruby-value">7</span>, <span class="ruby-value">2</span>, <span class="ruby-value">1</span>, <span class="ruby-value">13</span>, <span class="ruby-value">3</span>, <span class="ruby-value">6</span>, <span class="ruby-value">8</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>, <span class="ruby-value">12</span>, <span class="ruby-value">15</span>, <span class="ruby-value">14</span>],
-      [<span class="ruby-value">13</span>, <span class="ruby-value">11</span>, <span class="ruby-value">4</span>, <span class="ruby-value">1</span>, <span class="ruby-value">3</span>, <span class="ruby-value">15</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>, <span class="ruby-value">0</span>, <span class="ruby-value">10</span>, <span class="ruby-value">14</span>, <span class="ruby-value">7</span>, <span class="ruby-value">6</span>, <span class="ruby-value">8</span>, <span class="ruby-value">2</span>, <span class="ruby-value">12</span>],
-      [<span class="ruby-value">1</span>, <span class="ruby-value">15</span>, <span class="ruby-value">13</span>, <span class="ruby-value">0</span>, <span class="ruby-value">5</span>, <span class="ruby-value">7</span>, <span class="ruby-value">10</span>, <span class="ruby-value">4</span>, <span class="ruby-value">9</span>, <span class="ruby-value">2</span>, <span class="ruby-value">3</span>, <span class="ruby-value">14</span>, <span class="ruby-value">6</span>, <span class="ruby-value">11</span>, <span class="ruby-value">8</span>, <span class="ruby-value">12</span>]
-    ]
-    <span class="ruby-comment cmt"># These are the S-boxes given in the GOST source code listing in Applied</span>
-    <span class="ruby-comment cmt"># Cryptography 2nd Ed., p. 644.  They appear to be from the DES S-boxes</span>
-    <span class="ruby-comment cmt"># [13,  2,  8,  4,  6, 15, 11,  1, 10,  9,  3, 14,  5,  0, 12,  7 ],</span>
-    <span class="ruby-comment cmt"># [ 4, 11,  2, 14, 15,  0,  8, 13,  3, 12,  9,  7,  5, 10,  6,  1 ],</span>
-    <span class="ruby-comment cmt"># [12,  1, 10, 15,  9,  2,  6,  8,  0, 13,  3,  4, 14,  7,  5, 11 ],</span>
-    <span class="ruby-comment cmt"># [ 2, 12,  4,  1,  7, 10, 11,  6,  8,  5,  3, 15, 13,  0, 14,  9 ],</span>
-    <span class="ruby-comment cmt"># [ 7, 13, 14,  3,  0,  6,  9, 10,  1,  2,  8,  5, 11, 12,  4, 15 ],</span>
-    <span class="ruby-comment cmt"># [10,  0,  9, 14,  6,  3, 15,  5,  1, 13, 12,  7, 11,  4,  2,  8 ],</span>
-    <span class="ruby-comment cmt"># [15,  1,  8, 14,  6, 11,  3,  4,  9,  7,  2, 13, 12,  0,  5, 10 ],</span>
-    <span class="ruby-comment cmt"># [14,  4, 13,  1,  2, 15, 11,  8,  3, 10,  6, 12,  5,  9,  0,  7 ]</span>
-    <span class="ruby-comment cmt"># precalculate the S table</span>
-    <span class="ruby-ivar">@sTable</span> = <span class="ruby-identifier">precalculate_S_table</span>()
-    <span class="ruby-comment cmt"># derive the 32-byte key from the user-supplied key</span>
-    <span class="ruby-identifier">userKeyLength</span> = <span class="ruby-identifier">userKey</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-ivar">@key</span> = <span class="ruby-identifier">userKey</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">31</span>].<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span><span class="ruby-value">32</span>)
-    <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">userKeyLength</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">32</span>)
-      <span class="ruby-identifier">userKeyLength</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">31</span>) { <span class="ruby-ivar">@key</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">0</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="M000548"></a><b>block_size</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000548_source')" id="l_M000548_source">+</a> ]</p>
-  <div id="M000548_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 33</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">block_size</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-value">8</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000559"></a><b>carefully_open_file</b>(filename, mode)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000559_source')" id="l_M000559_source">+</a> ]</p>
-  <div id="M000559_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 217</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mode</span>)
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-identifier">aFile</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mode</span>)
-    <span class="ruby-keyword kw">rescue</span>
-      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Sorry. There was a problem opening the file &lt;#{filename}&gt;.&quot;</span>
-      <span class="ruby-identifier">aFile</span>.<span class="ruby-identifier">close</span>() <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">aFile</span>.<span class="ruby-identifier">nil?</span>
-      <span class="ruby-identifier">raise</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">aFile</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000555"></a><b>decrypt_block</b>(block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000555_source')" id="l_M000555_source">+</a> ]</p>
-  <div id="M000555_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 147</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">decrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">decrypted</span> = [<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">decrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000561"></a><b>decrypt_file</b>(cryptFilename, plainFilename)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000561_source')" id="l_M000561_source">+</a> ]</p>
-  <div id="M000561_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 238</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-identifier">plainFilename</span>)
-    <span class="ruby-identifier">cryptFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-value str">'rb'</span>)
-    <span class="ruby-identifier">plainFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-value str">'wb+'</span>)
-    <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptFile</span>, <span class="ruby-identifier">plainFile</span>)
-    <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">closed?</span>
-    <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">closed?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000553"></a><b>decrypt_pair</b>(xl, xr)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000553_source')" id="l_M000553_source">+</a> ]</p>
-  <div id="M000553_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 117</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    <span class="ruby-value">3</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    }
-    <span class="ruby-keyword kw">return</span>([<span class="ruby-identifier">xr</span>, <span class="ruby-identifier">xl</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000558"></a><b>decrypt_stream</b>(cryptStream, plainStream)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000558_source')" id="l_M000558_source">+</a> ]</p>
-  <div id="M000558_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 199</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptStream</span>, <span class="ruby-identifier">plainStream</span>)
-    <span class="ruby-comment cmt"># Cypher-block-chain mode</span>
-    <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>())
-    <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">block</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>()))
-      <span class="ruby-identifier">decrypted</span> = <span class="ruby-identifier">decrypt_block</span>(<span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">plainText</span> = <span class="ruby-identifier">decrypted</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-      <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">plainText</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">eof?</span>
-      <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">block</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># write the final block, omitting the padding</span>
-    <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">plainText</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">remainingMessageBytes</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span>).<span class="ruby-identifier">first</span>
-    <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">times</span> { <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">shift</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000563"></a><b>decrypt_string</b>(cryptText)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000563_source')" id="l_M000563_source">+</a> ]</p>
-  <div id="M000563_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 256</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_string</span>(<span class="ruby-identifier">cryptText</span>)
-    <span class="ruby-identifier">cryptStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">cryptText</span>)
-    <span class="ruby-identifier">plainStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptStream</span>, <span class="ruby-identifier">plainStream</span>)
-    <span class="ruby-identifier">plainText</span> = <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">string</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">plainText</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000554"></a><b>encrypt_block</b>(block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000554_source')" id="l_M000554_source">+</a> ]</p>
-  <div id="M000554_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 139</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">encrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">encrypted</span> = [<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">encrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000560"></a><b>encrypt_file</b>(plainFilename, cryptFilename)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000560_source')" id="l_M000560_source">+</a> ]</p>
-  <div id="M000560_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 229</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-identifier">cryptFilename</span>)
-    <span class="ruby-identifier">plainFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-value str">'rb'</span>)
-    <span class="ruby-identifier">cryptFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-value str">'wb+'</span>)
-    <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainFile</span>, <span class="ruby-identifier">cryptFile</span>)
-    <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">closed?</span>
-    <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">closed?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000552"></a><b>encrypt_pair</b>(xl, xr)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000552_source')" id="l_M000552_source">+</a> ]</p>
-  <div id="M000552_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 94</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-value">3</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    }
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    <span class="ruby-keyword kw">return</span>([<span class="ruby-identifier">xr</span>, <span class="ruby-identifier">xl</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000557"></a><b>encrypt_stream</b>(plainStream, cryptStream)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000557_source')" id="l_M000557_source">+</a> ]</p>
-  <div id="M000557_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 168</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainStream</span>, <span class="ruby-identifier">cryptStream</span>)
-    <span class="ruby-comment cmt"># Cypher-block-chain mode</span>
-    <span class="ruby-identifier">initVector</span> = <span class="ruby-identifier">generate_initialization_vector</span>(<span class="ruby-identifier">block_size</span>() <span class="ruby-operator">/</span> <span class="ruby-value">4</span>)
-    <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">initVector</span>)
-    <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">chain</span>)
-    <span class="ruby-keyword kw">while</span> ((<span class="ruby-identifier">block</span> = <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>())) <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">block</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">block_size</span>()))
-      <span class="ruby-identifier">block</span> = <span class="ruby-identifier">block</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-      <span class="ruby-identifier">encrypted</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">encrypted</span>)
-      <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">encrypted</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># write the final block</span>
-    <span class="ruby-comment cmt"># At most block_size()-1 bytes can be part of the message.</span>
-    <span class="ruby-comment cmt"># That means the final byte can be used to store the number of meaningful</span>
-    <span class="ruby-comment cmt"># bytes in the final block</span>
-    <span class="ruby-identifier">block</span> = <span class="ruby-value str">''</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">nil?</span>
-    <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">remainingMessageBytes</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-comment cmt"># we use 7-bit characters to avoid possible strange behavior on the Mac</span>
-    <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-identifier">block_size</span>()<span class="ruby-operator">-</span><span class="ruby-value">2</span>) { <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rand</span>(<span class="ruby-value">128</span>).<span class="ruby-identifier">chr</span> }
-    <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">chr</span>
-    <span class="ruby-identifier">block</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">block</span> = <span class="ruby-identifier">block</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-    <span class="ruby-identifier">encrypted</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">encrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000562"></a><b>encrypt_string</b>(plainText)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000562_source')" id="l_M000562_source">+</a> ]</p>
-  <div id="M000562_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 247</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_string</span>(<span class="ruby-identifier">plainText</span>)
-    <span class="ruby-identifier">plainStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">plainText</span>)
-    <span class="ruby-identifier">cryptStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainStream</span>, <span class="ruby-identifier">cryptStream</span>)
-    <span class="ruby-identifier">cryptText</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">string</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">cryptText</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000551"></a><b>f</b>(longWord)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000551_source')" id="l_M000551_source">+</a> ]</p>
-  <div id="M000551_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 88</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">longWord</span>)
-    <span class="ruby-identifier">longWord</span> = <span class="ruby-identifier">longWord</span> <span class="ruby-operator">%</span> <span class="ruby-constant">ULONG</span>
-    <span class="ruby-identifier">a</span>, <span class="ruby-identifier">b</span>, <span class="ruby-identifier">c</span>, <span class="ruby-identifier">d</span> = [<span class="ruby-identifier">longWord</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'L'</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'CCCC'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-ivar">@sTable</span>[<span class="ruby-value">3</span>][<span class="ruby-identifier">d</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">2</span>][<span class="ruby-identifier">c</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">1</span>][<span class="ruby-identifier">b</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">a</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000556"></a><b>generate_initialization_vector</b>(words)
-  </div>
-  <div class="description">
-  <p>
-When this module is mixed in with an encryption class, the class must
-provide three methods: <a
-href="BiCrypt.html#M000554">encrypt_block</a>(block) and <a
-href="BiCrypt.html#M000555">decrypt_block</a>(block) and <a
-href="BiCrypt.html#M000548">block_size</a>()
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000556_source')" id="l_M000556_source">+</a> ]</p>
-  <div id="M000556_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 158</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">generate_initialization_vector</span>(<span class="ruby-identifier">words</span>)
-    <span class="ruby-identifier">srand</span>(<span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_i</span>)
-    <span class="ruby-identifier">vector</span> = <span class="ruby-value str">&quot;&quot;</span>
-    <span class="ruby-identifier">words</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">vector</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">rand</span>(<span class="ruby-constant">ULONG</span>)].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'N'</span>)
-    }
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">vector</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000550"></a><b>precalculate_S_table</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000550_source')" id="l_M000550_source">+</a> ]</p>
-  <div id="M000550_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 74</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">precalculate_S_table</span>()
-    <span class="ruby-identifier">sTable</span> = [[], [], [], []]
-    <span class="ruby-value">0</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">3</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-      <span class="ruby-value">0</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">255</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">t</span> = <span class="ruby-ivar">@sBox</span>[<span class="ruby-value">2</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span>][<span class="ruby-identifier">j</span> <span class="ruby-operator">%</span> <span class="ruby-value">16</span>] <span class="ruby-operator">|</span> (<span class="ruby-ivar">@sBox</span>[<span class="ruby-value">2</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span><span class="ruby-operator">+</span><span class="ruby-value">1</span>][<span class="ruby-identifier">j</span><span class="ruby-operator">/</span><span class="ruby-value">16</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">4</span>)
-        <span class="ruby-identifier">u</span> = (<span class="ruby-value">8</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span> <span class="ruby-operator">+</span> <span class="ruby-value">11</span>) <span class="ruby-operator">%</span> <span class="ruby-value">32</span>
-        <span class="ruby-identifier">v</span> = (<span class="ruby-identifier">t</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">u</span>) <span class="ruby-operator">|</span> (<span class="ruby-identifier">t</span> <span class="ruby-operator">&gt;&gt;</span> (<span class="ruby-value">32</span><span class="ruby-operator">-</span><span class="ruby-identifier">u</span>))
-        <span class="ruby-identifier">sTable</span>[<span class="ruby-identifier">i</span>][<span class="ruby-identifier">j</span>] = (<span class="ruby-identifier">v</span> <span class="ruby-operator">%</span> <span class="ruby-constant">ULONG</span>)
-      }
-    }
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">sTable</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>