blackbox 1.0.1 → 1.1.0

data/doc/BB.html

@@ -80,7 +80,7 @@
   
     <dt class="r1 last">Defined in:</dt>
     <dd class="r1 last">lib/blackbox/hash.rb<span class="defines">,<br />
-  lib/blackbox/string.rb,<br /> lib/blackbox/crypto.rb,<br /> lib/blackbox/version.rb</span>
+  lib/blackbox/string.rb,<br /> lib/blackbox/number.rb,<br /> lib/blackbox/crypto.rb,<br /> lib/blackbox/version.rb</span>
 </dd>
   
 </dl>
@@ -90,7 +90,7 @@
 <p class="children">
   
     
-      <strong class="modules">Modules:</strong> <span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span>, <span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span>, <span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span>
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span>, <span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span>, <span class='object_link'><a href="BB/Number.html" title="BB::Number (module)">Number</a></span>, <span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span>
     
   
     
@@ -104,7 +104,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.0.0</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.1.0</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -120,9 +120,9 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:55 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/BB/Crypto.html

@@ -397,19 +397,19 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 36</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_decrypt'>decrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
-  <span class='id identifier rubyid_aes'>aes</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>Cipher</span><span class='op'>::</span><span class='const'>Cipher</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='rparen'>)</span> 
-  <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_decrypt'>decrypt</span> 
-  <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_decrypt'>decrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_cipher'>cipher</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>Cipher</span><span class='op'>::</span><span class='const'>Cipher</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_decrypt'>decrypt</span>
+  <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span>
   <span class='kw'>if</span> <span class='id identifier rubyid_iv'>iv</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
     <span class='id identifier rubyid_iv_len'>iv_len</span> <span class='op'>=</span> <span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='period'>.</span><span class='id identifier rubyid_slice!'>slice!</span><span class='lparen'>(</span><span class='int'>0</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_unpack'>unpack</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>C</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
     <span class='kw'>unless</span> <span class='int'>0</span> <span class='op'>==</span> <span class='id identifier rubyid_iv_len'>iv_len</span>
-      <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='period'>.</span><span class='id identifier rubyid_slice!'>slice!</span><span class='lparen'>(</span><span class='int'>0</span><span class='op'>..</span><span class='id identifier rubyid_iv_len'>iv_len</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='period'>.</span><span class='id identifier rubyid_slice!'>slice!</span><span class='lparen'>(</span><span class='int'>0</span><span class='op'>..</span><span class='id identifier rubyid_iv_len'>iv_len</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span>
     <span class='kw'>end</span>
   <span class='kw'>else</span>
-    <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_iv'>iv</span>
+    <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_iv'>iv</span>
   <span class='kw'>end</span>
-  <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
+  <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -539,7 +539,7 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 70</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_decrypt_base64'>decrypt_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_decrypt_base64'>decrypt_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_decrypt'>decrypt</span><span class='lparen'>(</span><span class='const'>Base64</span><span class='period'>.</span><span class='id identifier rubyid_decode64'>decode64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -670,7 +670,7 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 93</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_decrypt_urlsafe_base64'>decrypt_urlsafe_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_decrypt_urlsafe_base64'>decrypt_urlsafe_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_decrypt'>decrypt</span><span class='lparen'>(</span><span class='const'>Base64</span><span class='period'>.</span><span class='id identifier rubyid_urlsafe_decode64'>urlsafe_decode64</span><span class='lparen'>(</span><span class='id identifier rubyid_ciphertext'>ciphertext</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -824,16 +824,16 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 16</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_encrypt'>encrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
-  <span class='id identifier rubyid_aes'>aes</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>Cipher</span><span class='op'>::</span><span class='const'>Cipher</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='rparen'>)</span> 
-  <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_encrypt'>encrypt</span> 
-  <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_encrypt'>encrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_cipher'>cipher</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>Cipher</span><span class='op'>::</span><span class='const'>Cipher</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_encrypt'>encrypt</span>
+  <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span>
   <span class='kw'>if</span> <span class='id identifier rubyid_iv'>iv</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
-    <span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_random_iv'>random_iv</span>
-    <span class='lbracket'>[</span><span class='id identifier rubyid_iv'>iv</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_pack'>pack</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>C</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_iv'>iv</span> <span class='op'>+</span> <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
+    <span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_random_iv'>random_iv</span>
+    <span class='lbracket'>[</span><span class='id identifier rubyid_iv'>iv</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_pack'>pack</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>C</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_iv'>iv</span> <span class='op'>+</span> <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
   <span class='kw'>else</span>
-    <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_iv'>iv</span>
-    <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_aes'>aes</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
+    <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_iv'>iv</span> <span class='op'>=</span> <span class='id identifier rubyid_iv'>iv</span>
+    <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_cipher'>cipher</span><span class='period'>.</span><span class='id identifier rubyid_final'>final</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -978,7 +978,7 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 59</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_encrypt_base64'>encrypt_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_encrypt_base64'>encrypt_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='const'>Base64</span><span class='period'>.</span><span class='id identifier rubyid_strict_encode64'>strict_encode64</span><span class='lparen'>(</span><span class='id identifier rubyid_encrypt'>encrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1123,7 +1123,7 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/blackbox/crypto.rb', line 82</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_encrypt_urlsafe_base64'>encrypt_urlsafe_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span> 
+<span class='kw'>def</span> <span class='id identifier rubyid_encrypt_urlsafe_base64'>encrypt_urlsafe_base64</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aes-256-cbc</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='const'>Base64</span><span class='period'>.</span><span class='id identifier rubyid_urlsafe_encode64'>urlsafe_encode64</span><span class='lparen'>(</span><span class='id identifier rubyid_encrypt'>encrypt</span><span class='lparen'>(</span><span class='id identifier rubyid_plaintext'>plaintext</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cipher_type'>cipher_type</span><span class='comma'>,</span> <span class='id identifier rubyid_iv'>iv</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1136,9 +1136,9 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:56 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/BB/Hash.html

@@ -331,10 +331,10 @@ BB::Hash.flatten_prop_style(input)
 
 <span class='kw'>def</span> <span class='id identifier rubyid_flatten_prop_style'>flatten_prop_style</span><span class='lparen'>(</span><span class='id identifier rubyid_input'>input</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_output'>output</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_input'>input</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='op'>|</span>
-    <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:prefix</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:prefix</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:delimiter</span><span class='rbracket'>]</span><span class='op'>||</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:prefix</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:prefix</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:delimiter</span><span class='rbracket'>]</span><span class='op'>||</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
     <span class='kw'>case</span> <span class='id identifier rubyid_value'>value</span>
     <span class='kw'>when</span> <span class='op'>::</span><span class='const'>Hash</span>
-      <span class='id identifier rubyid_flatten_prop_style'>flatten_prop_style</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='symbol'>:prefix</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='symbol'>:delimiter</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_output'>output</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_flatten_prop_style'>flatten_prop_style</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_merge'>merge</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='symbol'>:prefix</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_key'>key</span><span class='rbrace'>}</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_output'>output</span><span class='rparen'>)</span>
     <span class='kw'>when</span> <span class='const'>Array</span>
       <span class='id identifier rubyid_output'>output</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
     <span class='kw'>else</span>
@@ -432,9 +432,9 @@ BB::Hash.flatten_prop_style(input)
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:56 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/BB/String.html

@@ -231,9 +231,9 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:56 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/_index.html

@@ -123,6 +123,21 @@
         </ul>
       
         
+        <ul id="alpha_N" class="alpha">
+          <li class="letter">N</li>
+          <ul>
+            
+              <li>
+                <span class='object_link'><a href="BB/Number.html" title="BB::Number (module)">Number</a></span>
+                
+                  <small>(BB)</small>
+                
+              </li>
+            
+          </ul>
+        </ul>
+      
+        
         <ul id="alpha_S" class="alpha">
           <li class="letter">S</li>
           <ul>
@@ -146,9 +161,9 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:55 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/class_list.html

@@ -45,7 +45,7 @@
 
       <ul id="full_list" class="class">
         <li><span class='object_link'><a href="top-level-namespace.html" title=" (root)">Top Level Namespace</a></span></li>
-<li><a class='toggle'></a> <span class='object_link'><a href="BB.html" title="BB (module)">BB</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span><small class='search_info'>BB</small></li></ul>
+<li><a class='toggle'></a> <span class='object_link'><a href="BB.html" title="BB (module)">BB</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Number.html" title="BB::Number (module)">Number</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span><small class='search_info'>BB</small></li></ul>
 
       </ul>
     </div>

data/doc/file.README.html

@@ -95,9 +95,9 @@ BB::String.strip_ansi( ... )
 </div></div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:55 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/index.html

@@ -95,9 +95,9 @@ BB::String.strip_ansi( ... )
 </div></div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:55 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/doc/method_list.html

@@ -118,6 +118,30 @@
   </li>
   
 
+  <li class="r2 ">
+    <span class='object_link'><a href="BB/Number.html#to_human_size-class_method" title="BB::Number.to_human_size (method)">to_human_size</a></span>
+    
+      <small>BB::Number</small>
+    
+  </li>
+  
+
+  <li class="r1 ">
+    <span class='object_link'><a href="BB/Number.html#with_delimiter-class_method" title="BB::Number.with_delimiter (method)">with_delimiter</a></span>
+    
+      <small>BB::Number</small>
+    
+  </li>
+  
+
+  <li class="r2 ">
+    <span class='object_link'><a href="BB/Number.html#with_precision-class_method" title="BB::Number.with_precision (method)">with_precision</a></span>
+    
+      <small>BB::Number</small>
+    
+  </li>
+  
+
       </ul>
     </div>
   </body>

data/doc/top-level-namespace.html

@@ -103,9 +103,9 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Mar 30 02:17:55 2013 by
+  Generated on Sun Nov 22 18:25:23 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.5.2 (ruby-2.0.0).
+  0.8.5.2 (ruby-2.2.2).
 </div>
 
   </body>

data/lib/blackbox/crypto.rb

@@ -4,7 +4,7 @@ require 'base64'
 module BB
   # Crypto utilities.
   module Crypto
-    class << self 
+    class << self
       # Encrypt a String.
       #
       # @param [String] plaintext Input String (plaintext)
@@ -13,18 +13,18 @@ module BB
       # @param [String] iv Initialization vector
       # @return [String] When iv == nil: iv_length+iv+ciphertext
       # @return [String] When iv != nil: ciphertext
-      def encrypt(plaintext, key, cipher_type='aes-256-cbc', iv=nil) 
-        aes = OpenSSL::Cipher::Cipher.new(cipher_type) 
-        aes.encrypt 
-        aes.key = key 
+      def encrypt(plaintext, key, cipher_type='aes-256-cbc', iv=nil)
+        cipher = OpenSSL::Cipher::Cipher.new(cipher_type)
+        cipher.encrypt
+        cipher.key = key
         if iv.nil?
-          iv = aes.random_iv
-          [iv.length].pack('C') + iv + aes.update(plaintext) + aes.final
+          iv = cipher.random_iv
+          [iv.length].pack('C') + iv + cipher.update(plaintext) + cipher.final
         else
-          aes.iv = iv
-          aes.update(plaintext) + aes.final
+          cipher.iv = iv
+          cipher.update(plaintext) + cipher.final
         end
-      end 
+      end
 
       # Decrypt a String.
       #
@@ -33,21 +33,21 @@ module BB
       # @param [String] cipher_type OpenSSL cipher
       # @param [String] iv Initialization vector
       # @return [String] Plaintext
-      def decrypt(ciphertext, key, cipher_type='aes-256-cbc', iv=nil) 
-        aes = OpenSSL::Cipher::Cipher.new(cipher_type) 
-        aes.decrypt 
-        aes.key = key 
+      def decrypt(ciphertext, key, cipher_type='aes-256-cbc', iv=nil)
+        cipher = OpenSSL::Cipher::Cipher.new(cipher_type)
+        cipher.decrypt
+        cipher.key = key
         if iv.nil?
           iv_len = ciphertext.slice!(0).unpack('C')[0]
           unless 0 == iv_len
-            aes.iv = ciphertext.slice!(0..iv_len-1)
+            cipher.iv = ciphertext.slice!(0..iv_len-1)
           end
         else
-          aes.iv = iv
+          cipher.iv = iv
         end
-        aes.update(ciphertext) + aes.final
-      end 
- 
+        cipher.update(ciphertext) + cipher.final
+      end
+
       # Encrypt a String and encode the resulting ciphertext to Base64.
       #
       # @param [String] plaintext Input String (plaintext)
@@ -56,7 +56,7 @@ module BB
       # @param [String] iv Initialization vector
       # @return [String] When iv == nil: base64(iv_length+iv+ciphertext)
       # @return [String] When iv != nil: base64(ciphertext)
-      def encrypt_base64(plaintext, key, cipher_type='aes-256-cbc', iv=nil) 
+      def encrypt_base64(plaintext, key, cipher_type='aes-256-cbc', iv=nil)
         Base64.strict_encode64(encrypt(plaintext, key, cipher_type, iv))
       end
 
@@ -67,7 +67,7 @@ module BB
       # @param [String] cipher_type OpenSSL cipher
       # @param [String] iv Initialization vector
       # @return [String] Plaintext
-      def decrypt_base64(ciphertext, key, cipher_type='aes-256-cbc', iv=nil) 
+      def decrypt_base64(ciphertext, key, cipher_type='aes-256-cbc', iv=nil)
         decrypt(Base64.decode64(ciphertext), key, cipher_type, iv)
       end
 
@@ -79,7 +79,7 @@ module BB
       # @param [String] iv Initialization vector
       # @return [String] When iv == nil: urlsafe_base64(iv_length+iv+ciphertext)
       # @return [String] When iv != nil: urlsafe_base64(ciphertext)
-      def encrypt_urlsafe_base64(plaintext, key, cipher_type='aes-256-cbc', iv=nil) 
+      def encrypt_urlsafe_base64(plaintext, key, cipher_type='aes-256-cbc', iv=nil)
         Base64.urlsafe_encode64(encrypt(plaintext, key, cipher_type, iv))
       end
 
@@ -90,10 +90,10 @@ module BB
       # @param [String] cipher_type OpenSSL cipher
       # @param [String] iv Initialization vector
       # @return [String] Plaintext
-      def decrypt_urlsafe_base64(ciphertext, key, cipher_type='aes-256-cbc', iv=nil) 
+      def decrypt_urlsafe_base64(ciphertext, key, cipher_type='aes-256-cbc', iv=nil)
         decrypt(Base64.urlsafe_decode64(ciphertext), key, cipher_type, iv)
       end
-    end 
+    end
   end
 end
 

data/lib/blackbox/number.rb

@@ -0,0 +1,167 @@
+require 'blackbox/hash'
+
+module BB
+  # String utilities.
+  module Number
+    class << self
+      STORAGE_UNITS = ['byte', 'k', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y'].freeze
+
+      ##
+      # Formats the bytes in +size+ into a more understandable representation
+      # (e.g., giving it 1500 yields 1.5 KB). This method is useful for
+      # reporting file sizes to users. This method returns nil if
+      # +size+ cannot be converted into a number. You can customize the
+      # format in the +options+ hash.
+      #
+      # @overload to_human_size(number, options={})
+      #   @param [Fixnum] number
+      #     Number value to format.
+      #   @param [Hash] options
+      #     Options for formatter.
+      #   @option options [Fixnum] :precision (1)
+      #     Sets the level of precision.
+      #   @option options [String] :separator (".")
+      #     Sets the separator between the units.
+      #   @option options [String] :delimiter ("")
+      #     Sets the thousands delimiter.
+      #   @option options [String] :kilo (1024)
+      #     Sets the number of bytes in a kilobyte.
+      #   @option options [String] :format ("%n %u")
+      #     Sets the display format.
+      #
+      # @return [String] The formatted representation of bytes
+      #
+      # @example
+      #   to_human_size(123)                                          # => 123 Bytes
+      #   to_human_size(1234)                                         # => 1.2 KB
+      #   to_human_size(12345)                                        # => 12.1 KB
+      #   to_human_size(1234567)                                      # => 1.2 MB
+      #   to_human_size(1234567890)                                   # => 1.1 GB
+      #   to_human_size(1234567890123)                                # => 1.1 TB
+      #   to_human_size(1234567, :precision => 2)                     # => 1.18 MB
+      #   to_human_size(483989, :precision => 0)                      # => 473 KB
+      #   to_human_size(1234567, :precision => 2, :separator => ',')  # => 1,18 MB
+      #
+      def to_human_size(number, args={})
+         return nil if number.nil?
+
+         options = BB::Hash.symbolize_keys(args)
+
+         precision ||= (options[:precision] || 1)
+         separator ||= (options[:separator] || '.')
+         delimiter ||= (options[:delimiter] || '')
+         kilo      ||= (options[:kilo] || 1024)
+         storage_units_format ||= (options[:format] || '%n%u')
+
+         if number.to_i < kilo
+           #unit = I18n.translate(:'number.human.storage_units.units.byte', :locale => options[:locale], :count => number.to_i, :raise => true)
+           storage_units_format.gsub(/%n/, number.to_i.to_s).gsub(/%u/, '')
+         else
+           max_exp  = STORAGE_UNITS.size - 1
+           number   = Float(number)
+           exponent = (Math.log(number) / Math.log(kilo)).to_i # Convert to base 1024
+           exponent = max_exp if exponent > max_exp # we need this to avoid overflow for the highest unit
+           number  /= kilo ** exponent
+
+           unit = STORAGE_UNITS[exponent]
+
+           begin
+             escaped_separator = Regexp.escape(separator)
+             formatted_number = with_precision(number,
+               :precision => precision,
+               :separator => separator,
+               :delimiter => delimiter
+             ).sub(/(#{escaped_separator})(\d*[1-9])?0+\z/, '\1\2').sub(/#{escaped_separator}\z/, '')
+             storage_units_format.gsub(/%n/, formatted_number).gsub(/%u/, unit)
+           rescue => e
+             e
+             #number
+           end
+         end
+       end
+
+       ##
+       # Formats a +number+ with the specified level of <tt>:precision</tt> (e.g., 112.32 has a precision of 2).
+       # You can customize the format in the +options+ hash.
+       #
+       # @overload with_precision(number, options={})
+       #   @param [Fixnum, Float] number
+       #     Number value to format.
+       #   @param [Hash] options
+       #     Options for formatter.
+       #   @option options [Fixnum] :precision (3)
+       #     Sets the level of precision.
+       #   @option options [String] :separator (".")
+       #     Sets the separator between the units.
+       #   @option options [String] :delimiter ("")
+       #     Sets the thousands delimiter.
+       #
+       # @return [String] The formatted representation of the number.
+       #
+       # @example
+       #   with_precision(111.2345)                    # => 111.235
+       #   with_precision(111.2345, :precision => 2)   # => 111.23
+       #   with_precision(13, :precision => 5)         # => 13.00000
+       #   with_precision(389.32314, :precision => 0)  # => 389
+       #   with_precision(1111.2345, :precision => 2, :separator => ',', :delimiter => '.')
+       #   # => 1.111,23
+       #
+       def with_precision(number, args)
+         options = BB::Hash.symbolize_keys(args)
+
+         precision ||= (options[:precision] || 3)
+         separator ||= (options[:separator] || '.')
+         delimiter ||= (options[:delimiter] || '')
+
+         begin
+           rounded_number = (Float(number) * (10 ** precision)).round.to_f / 10 ** precision
+           with_delimiter("%01.#{precision}f" % rounded_number,
+             :separator => separator,
+             :delimiter => delimiter)
+         rescue
+           number
+         end
+       end
+
+       ##
+       # Formats a +number+ with grouped thousands using +delimiter+ (e.g., 12,324). You can
+       # customize the format in the +options+ hash.
+       #
+       # @overload with_delimiter(number, options={})
+       #   @param [Fixnum, Float] number
+       #     Number value to format.
+       #   @param [Hash] options
+       #     Options for formatter.
+       #   @option options [String] :delimiter (", ")
+       #     Sets the thousands delimiter.
+       #   @option options [String] :separator (".")
+       #     Sets the separator between the units.
+       #
+       # @return [String] The formatted representation of the number.
+       #
+       # @example
+       #   with_delimiter(12345678)                        # => 12,345,678
+       #   with_delimiter(12345678.05)                     # => 12,345,678.05
+       #   with_delimiter(12345678, :delimiter => ".")     # => 12.345.678
+       #   with_delimiter(12345678, :separator => ",")     # => 12,345,678
+       #   with_delimiter(98765432.98, :delimiter => " ", :separator => ",")
+       #   # => 98 765 432,98
+       #
+       def with_delimiter(number, args)
+         options = BB::Hash.symbolize_keys(args)
+
+         delimiter ||= (options[:delimiter] || '.')
+         separator ||= (options[:separator] || ',')
+
+         begin
+           parts = number.to_s.split('.')
+           parts[0].gsub!(/(\d)(?=(\d\d\d)+(?!\d))/, "\\1#{delimiter}")
+           parts.join(separator)
+         rescue
+           number
+         end
+       end
+     end
+   end
+end
+