blackbox 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a6b362ded073826b4441800103177d20c63cd376
-  data.tar.gz: 85195d9a8093f574af176623253363d889748527
+  metadata.gz: cdaefa7436a7c8a81c9451794fb09b6f70ab7c3c
+  data.tar.gz: 403ccd62b87e73ecc8638bdbbddc5b27949c671e
 SHA512:
-  metadata.gz: 6b696580ad6f409dddbf1be7a5d02490c2e724013017d21d1ba060ffd7b58af03b0d1848e3fabca729808715413d63d17c4dfbcc9842b9cbb8dd5a8ed9e4894f
-  data.tar.gz: 818590456c83e9bcca705ca0524f2d1e6418b142ee6ce2ee2ea2c3235f6466ea05317c39081bc5402a302abb97b4ca8fedc072d048d8eedb003aa41e2268b55e
+  metadata.gz: 540618ca3b6c4995042203b2a66e11b8f76da4edf996ce04f1a4a64ccd411d74574b56c163bfd9634d3b03fb0f3b3faf191a0b6b98ec695592060b294474c841
+  data.tar.gz: f7ba66a6d44011d21125ce3657bb09abaaa1403bf6042f650a72fef3248a574ebc5371c0786dd9655b763677d234b9f6d247bed0d8f90155c512a9808054d489

data/.gitattributes

@@ -0,0 +1,2 @@
+doc/* linguist-documentation
+coverage/* linguist-documentation

data/Guardfile

@@ -0,0 +1,16 @@
+guard :rspec, cmd: "bundle exec rspec -f Fuubar" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/Makefile

@@ -0,0 +1,24 @@
+# 0. make test
+# 1. commit changes
+# 2. bump
+# 3. make release
+
+.PHONY: test doc release
+
+test:
+	bundle exec rake
+
+doc:
+	bundle exec yardoc
+
+push: test doc
+	git commit -m 'Documentation update' doc coverage README.md
+	git checkout gh-pages
+	git checkout master -- doc coverage
+	git commit -m 'Documentation update'
+	git checkout master
+	git push origin gh-pages
+
+release: test doc push
+	bundle exec rake release
+

data/blackbox.gemspec

@@ -23,4 +23,8 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency "simplecov"
   gem.add_development_dependency "redcarpet"
   gem.add_development_dependency "yard"
+  gem.add_development_dependency "bump"
+  gem.add_development_dependency "guard"
+  gem.add_development_dependency "guard-rspec"
+  gem.add_development_dependency "fuubar"
 end

data/coverage/.last_run.json

@@ -1,5 +1,5 @@
 {
   "result": {
-    "covered_percent": 100.0
+    "covered_percent": 95.79
   }
 }

data/coverage/.resultset.json

@@ -112,7 +112,7 @@
         null,
         null,
         1,
-        7,
+        100,
         null,
         null,
         null,
@@ -153,6 +153,175 @@
         null,
         null
       ],
+      "/home/moe/code/blackbox/lib/blackbox/number.rb": [
+        1,
+        null,
+        1,
+        null,
+        1,
+        1,
+        1,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        1,
+        11,
+        null,
+        11,
+        null,
+        11,
+        11,
+        11,
+        11,
+        11,
+        null,
+        11,
+        null,
+        1,
+        null,
+        10,
+        10,
+        10,
+        10,
+        10,
+        null,
+        10,
+        null,
+        10,
+        10,
+        10,
+        null,
+        null,
+        null,
+        null,
+        10,
+        0,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        1,
+        11,
+        null,
+        11,
+        11,
+        11,
+        null,
+        11,
+        11,
+        11,
+        null,
+        null,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null,
+        1,
+        12,
+        null,
+        12,
+        12,
+        null,
+        12,
+        12,
+        12,
+        12,
+        null,
+        0,
+        null,
+        null,
+        null,
+        null,
+        null,
+        null
+      ],
       "/home/moe/code/blackbox/lib/blackbox/string.rb": [
         1,
         null,
@@ -173,6 +342,6 @@
         null
       ]
     },
-    "timestamp": 1419394994
+    "timestamp": 1448213121
   }
 }

data/coverage/index.html

@@ -14,27 +14,27 @@
       <img src="./assets/0.7.1/loading.gif" alt="loading"/>
     </div>
     <div id="wrapper" style="display:none;">
-      <div class="timestamp">Generated <abbr class="timeago" title="2014-12-24T05:23:14+01:00">2014-12-24T05:23:14+01:00</abbr></div>
+      <div class="timestamp">Generated <abbr class="timeago" title="2015-11-22T18:25:21+01:00">2015-11-22T18:25:21+01:00</abbr></div>
       <ul class="group_tabs"></ul>
 
       <div id="content">
         <div class="file_list_container" id="AllFiles">
   <h2>
     <span class="group_name">All Files</span>
-    (<span class="covered_percent"><span class="green">100.0%</span></span>
+    (<span class="covered_percent"><span class="green">95.79%</span></span>
      covered at
      <span class="covered_strength">
        <span class="green">
-         81.7
+         65.07
        </span>
     </span> hits/line)
   </h2>
   <a name="AllFiles"></a>
   <div>
-    <b>3</b> files in total.
-    <b>50</b> relevant lines. 
-    <span class="green"><b>50</b> lines covered</span> and
-    <span class="red"><b>0</b> lines missed </span>
+    <b>4</b> files in total.
+    <b>95</b> relevant lines. 
+    <span class="green"><b>91</b> lines covered</span> and
+    <span class="red"><b>4</b> lines missed </span>
   </div>
   <table class="file_list">
     <thead>
@@ -67,7 +67,17 @@
         <td>13</td>
         <td>13</td>
         <td>0</td>
-        <td>7.5</td>
+        <td>14.7</td>
+      </tr>
+      
+      <tr>
+        <td class="strong"><a href="#7a135b0407697dbb00ab589a4ca6477d724b7276" class="src_link" title="lib/blackbox/number.rb">lib/blackbox/number.rb</a></td>
+        <td class="green strong">91.11 %</td>
+        <td>167</td>
+        <td>45</td>
+        <td>41</td>
+        <td>4</td>
+        <td>8.0</td>
       </tr>
       
       <tr>
@@ -149,7 +159,7 @@
         <li class="covered" data-hits="1" data-linenumber="7">
           <span class="hits">1</span>
           
-          <code class="ruby">    class &lt;&lt; self </code>
+          <code class="ruby">    class &lt;&lt; self</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="8">
@@ -203,25 +213,25 @@
         <li class="covered" data-hits="1" data-linenumber="16">
           <span class="hits">1</span>
           
-          <code class="ruby">      def encrypt(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def encrypt(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="697" data-linenumber="17">
           <span class="hits">697</span>
           
-          <code class="ruby">        aes = OpenSSL::Cipher::Cipher.new(cipher_type) </code>
+          <code class="ruby">        cipher = OpenSSL::Cipher::Cipher.new(cipher_type)</code>
         </li>
       
         <li class="covered" data-hits="697" data-linenumber="18">
           <span class="hits">697</span>
           
-          <code class="ruby">        aes.encrypt </code>
+          <code class="ruby">        cipher.encrypt</code>
         </li>
       
         <li class="covered" data-hits="697" data-linenumber="19">
           <span class="hits">697</span>
           
-          <code class="ruby">        aes.key = key </code>
+          <code class="ruby">        cipher.key = key</code>
         </li>
       
         <li class="covered" data-hits="697" data-linenumber="20">
@@ -233,13 +243,13 @@
         <li class="covered" data-hits="328" data-linenumber="21">
           <span class="hits">328</span>
           
-          <code class="ruby">          iv = aes.random_iv</code>
+          <code class="ruby">          iv = cipher.random_iv</code>
         </li>
       
         <li class="covered" data-hits="328" data-linenumber="22">
           <span class="hits">328</span>
           
-          <code class="ruby">          [iv.length].pack(&#39;C&#39;) + iv + aes.update(plaintext) + aes.final</code>
+          <code class="ruby">          [iv.length].pack(&#39;C&#39;) + iv + cipher.update(plaintext) + cipher.final</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="23">
@@ -251,13 +261,13 @@
         <li class="covered" data-hits="369" data-linenumber="24">
           <span class="hits">369</span>
           
-          <code class="ruby">          aes.iv = iv</code>
+          <code class="ruby">          cipher.iv = iv</code>
         </li>
       
         <li class="covered" data-hits="369" data-linenumber="25">
           <span class="hits">369</span>
           
-          <code class="ruby">          aes.update(plaintext) + aes.final</code>
+          <code class="ruby">          cipher.update(plaintext) + cipher.final</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="26">
@@ -269,7 +279,7 @@
         <li class="never" data-hits="" data-linenumber="27">
           
           
-          <code class="ruby">      end </code>
+          <code class="ruby">      end</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="28">
@@ -323,25 +333,25 @@
         <li class="covered" data-hits="1" data-linenumber="36">
           <span class="hits">1</span>
           
-          <code class="ruby">      def decrypt(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def decrypt(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="369" data-linenumber="37">
           <span class="hits">369</span>
           
-          <code class="ruby">        aes = OpenSSL::Cipher::Cipher.new(cipher_type) </code>
+          <code class="ruby">        cipher = OpenSSL::Cipher::Cipher.new(cipher_type)</code>
         </li>
       
         <li class="covered" data-hits="369" data-linenumber="38">
           <span class="hits">369</span>
           
-          <code class="ruby">        aes.decrypt </code>
+          <code class="ruby">        cipher.decrypt</code>
         </li>
       
         <li class="covered" data-hits="369" data-linenumber="39">
           <span class="hits">369</span>
           
-          <code class="ruby">        aes.key = key </code>
+          <code class="ruby">        cipher.key = key</code>
         </li>
       
         <li class="covered" data-hits="369" data-linenumber="40">
@@ -365,7 +375,7 @@
         <li class="covered" data-hits="180" data-linenumber="43">
           <span class="hits">180</span>
           
-          <code class="ruby">            aes.iv = ciphertext.slice!(0..iv_len-1)</code>
+          <code class="ruby">            cipher.iv = ciphertext.slice!(0..iv_len-1)</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="44">
@@ -383,7 +393,7 @@
         <li class="covered" data-hits="123" data-linenumber="46">
           <span class="hits">123</span>
           
-          <code class="ruby">          aes.iv = iv</code>
+          <code class="ruby">          cipher.iv = iv</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="47">
@@ -395,19 +405,19 @@
         <li class="covered" data-hits="369" data-linenumber="48">
           <span class="hits">369</span>
           
-          <code class="ruby">        aes.update(ciphertext) + aes.final</code>
+          <code class="ruby">        cipher.update(ciphertext) + cipher.final</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="49">
           
           
-          <code class="ruby">      end </code>
+          <code class="ruby">      end</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="50">
           
           
-          <code class="ruby"> </code>
+          <code class="ruby"></code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="51">
@@ -461,7 +471,7 @@
         <li class="covered" data-hits="1" data-linenumber="59">
           <span class="hits">1</span>
           
-          <code class="ruby">      def encrypt_base64(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def encrypt_base64(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="246" data-linenumber="60">
@@ -527,7 +537,7 @@
         <li class="covered" data-hits="1" data-linenumber="70">
           <span class="hits">1</span>
           
-          <code class="ruby">      def decrypt_base64(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def decrypt_base64(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="123" data-linenumber="71">
@@ -599,7 +609,7 @@
         <li class="covered" data-hits="1" data-linenumber="82">
           <span class="hits">1</span>
           
-          <code class="ruby">      def encrypt_urlsafe_base64(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def encrypt_urlsafe_base64(plaintext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="246" data-linenumber="83">
@@ -665,7 +675,7 @@
         <li class="covered" data-hits="1" data-linenumber="93">
           <span class="hits">1</span>
           
-          <code class="ruby">      def decrypt_urlsafe_base64(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil) </code>
+          <code class="ruby">      def decrypt_urlsafe_base64(ciphertext, key, cipher_type=&#39;aes-256-cbc&#39;, iv=nil)</code>
         </li>
       
         <li class="covered" data-hits="123" data-linenumber="94">
@@ -683,7 +693,7 @@
         <li class="never" data-hits="" data-linenumber="96">
           
           
-          <code class="ruby">    end </code>
+          <code class="ruby">    end</code>
         </li>
       
         <li class="never" data-hits="" data-linenumber="97">
@@ -776,8 +786,8 @@
           <code class="ruby">      def symbolize_keys(hash)</code>
         </li>
       
-        <li class="covered" data-hits="7" data-linenumber="10">
-          <span class="hits">7</span>
+        <li class="covered" data-hits="100" data-linenumber="10">
+          <span class="hits">100</span>
           
           <code class="ruby">        hash.each_with_object({}){|(k,v), h| h[k.to_sym] = v}</code>
         </li>
@@ -1020,6 +1030,1026 @@
   </pre>
 </div>
       
+        <div class="source_table" id="7a135b0407697dbb00ab589a4ca6477d724b7276">
+  <div class="header">
+    <h3>lib/blackbox/number.rb</h3>
+    <h4><span class="green">91.11 %</span> covered</h4>
+    <div>
+      <b>45</b> relevant lines. 
+      <span class="green"><b>41</b> lines covered</span> and
+      <span class="red"><b>4</b> lines missed.</span>
+    </div>
+  </div>
+  
+  <pre>
+    <ol>
+      
+        <li class="covered" data-hits="1" data-linenumber="1">
+          <span class="hits">1</span>
+          
+          <code class="ruby">require &#39;blackbox/hash&#39;</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="2">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="3">
+          <span class="hits">1</span>
+          
+          <code class="ruby">module BB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="4">
+          
+          
+          <code class="ruby">  # String utilities.</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="5">
+          <span class="hits">1</span>
+          
+          <code class="ruby">  module Number</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="6">
+          <span class="hits">1</span>
+          
+          <code class="ruby">    class &lt;&lt; self</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="7">
+          <span class="hits">1</span>
+          
+          <code class="ruby">      STORAGE_UNITS = [&#39;byte&#39;, &#39;k&#39;, &#39;M&#39;, &#39;G&#39;, &#39;T&#39;, &#39;P&#39;, &#39;E&#39;, &#39;Z&#39;, &#39;Y&#39;].freeze</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="8">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="9">
+          
+          
+          <code class="ruby">      ##</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="10">
+          
+          
+          <code class="ruby">      # Formats the bytes in +size+ into a more understandable representation</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="11">
+          
+          
+          <code class="ruby">      # (e.g., giving it 1500 yields 1.5 KB). This method is useful for</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="12">
+          
+          
+          <code class="ruby">      # reporting file sizes to users. This method returns nil if</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="13">
+          
+          
+          <code class="ruby">      # +size+ cannot be converted into a number. You can customize the</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="14">
+          
+          
+          <code class="ruby">      # format in the +options+ hash.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="15">
+          
+          
+          <code class="ruby">      #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="16">
+          
+          
+          <code class="ruby">      # @overload to_human_size(number, options={})</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="17">
+          
+          
+          <code class="ruby">      #   @param [Fixnum] number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="18">
+          
+          
+          <code class="ruby">      #     Number value to format.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="19">
+          
+          
+          <code class="ruby">      #   @param [Hash] options</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="20">
+          
+          
+          <code class="ruby">      #     Options for formatter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="21">
+          
+          
+          <code class="ruby">      #   @option options [Fixnum] :precision (1)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="22">
+          
+          
+          <code class="ruby">      #     Sets the level of precision.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="23">
+          
+          
+          <code class="ruby">      #   @option options [String] :separator (&quot;.&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="24">
+          
+          
+          <code class="ruby">      #     Sets the separator between the units.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="25">
+          
+          
+          <code class="ruby">      #   @option options [String] :delimiter (&quot;&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="26">
+          
+          
+          <code class="ruby">      #     Sets the thousands delimiter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="27">
+          
+          
+          <code class="ruby">      #   @option options [String] :kilo (1024)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="28">
+          
+          
+          <code class="ruby">      #     Sets the number of bytes in a kilobyte.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="29">
+          
+          
+          <code class="ruby">      #   @option options [String] :format (&quot;%n %u&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="30">
+          
+          
+          <code class="ruby">      #     Sets the display format.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="31">
+          
+          
+          <code class="ruby">      #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="32">
+          
+          
+          <code class="ruby">      # @return [String] The formatted representation of bytes</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="33">
+          
+          
+          <code class="ruby">      #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="34">
+          
+          
+          <code class="ruby">      # @example</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="35">
+          
+          
+          <code class="ruby">      #   to_human_size(123)                                          # =&gt; 123 Bytes</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="36">
+          
+          
+          <code class="ruby">      #   to_human_size(1234)                                         # =&gt; 1.2 KB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="37">
+          
+          
+          <code class="ruby">      #   to_human_size(12345)                                        # =&gt; 12.1 KB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="38">
+          
+          
+          <code class="ruby">      #   to_human_size(1234567)                                      # =&gt; 1.2 MB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="39">
+          
+          
+          <code class="ruby">      #   to_human_size(1234567890)                                   # =&gt; 1.1 GB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="40">
+          
+          
+          <code class="ruby">      #   to_human_size(1234567890123)                                # =&gt; 1.1 TB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="41">
+          
+          
+          <code class="ruby">      #   to_human_size(1234567, :precision =&gt; 2)                     # =&gt; 1.18 MB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="42">
+          
+          
+          <code class="ruby">      #   to_human_size(483989, :precision =&gt; 0)                      # =&gt; 473 KB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="43">
+          
+          
+          <code class="ruby">      #   to_human_size(1234567, :precision =&gt; 2, :separator =&gt; &#39;,&#39;)  # =&gt; 1,18 MB</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="44">
+          
+          
+          <code class="ruby">      #</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="45">
+          <span class="hits">1</span>
+          
+          <code class="ruby">      def to_human_size(number, args={})</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="46">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         return nil if number.nil?</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="47">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="48">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         options = BB::Hash.symbolize_keys(args)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="49">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="50">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         precision ||= (options[:precision] || 1)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="51">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         separator ||= (options[:separator] || &#39;.&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="52">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         delimiter ||= (options[:delimiter] || &#39;&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="53">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         kilo      ||= (options[:kilo] || 1024)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="54">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         storage_units_format ||= (options[:format] || &#39;%n%u&#39;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="55">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="56">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         if number.to_i &lt; kilo</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="57">
+          
+          
+          <code class="ruby">           #unit = I18n.translate(:&#39;number.human.storage_units.units.byte&#39;, :locale =&gt; options[:locale], :count =&gt; number.to_i, :raise =&gt; true)</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="58">
+          <span class="hits">1</span>
+          
+          <code class="ruby">           storage_units_format.gsub(/%n/, number.to_i.to_s).gsub(/%u/, &#39;&#39;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="59">
+          
+          
+          <code class="ruby">         else</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="60">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           max_exp  = STORAGE_UNITS.size - 1</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="61">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           number   = Float(number)</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="62">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           exponent = (Math.log(number) / Math.log(kilo)).to_i # Convert to base 1024</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="63">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           exponent = max_exp if exponent &gt; max_exp # we need this to avoid overflow for the highest unit</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="64">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           number  /= kilo ** exponent</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="65">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="66">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           unit = STORAGE_UNITS[exponent]</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="67">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="68">
+          <span class="hits">10</span>
+          
+          <code class="ruby">           begin</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="69">
+          <span class="hits">10</span>
+          
+          <code class="ruby">             escaped_separator = Regexp.escape(separator)</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="70">
+          <span class="hits">10</span>
+          
+          <code class="ruby">             formatted_number = with_precision(number,</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="71">
+          
+          
+          <code class="ruby">               :precision =&gt; precision,</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="72">
+          
+          
+          <code class="ruby">               :separator =&gt; separator,</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="73">
+          
+          
+          <code class="ruby">               :delimiter =&gt; delimiter</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="74">
+          
+          
+          <code class="ruby">             ).sub(/(#{escaped_separator})(\d*[1-9])?0+\z/, &#39;\1\2&#39;).sub(/#{escaped_separator}\z/, &#39;&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="10" data-linenumber="75">
+          <span class="hits">10</span>
+          
+          <code class="ruby">             storage_units_format.gsub(/%n/, formatted_number).gsub(/%u/, unit)</code>
+        </li>
+      
+        <li class="missed" data-hits="0" data-linenumber="76">
+          
+          
+          <code class="ruby">           rescue =&gt; e</code>
+        </li>
+      
+        <li class="missed" data-hits="0" data-linenumber="77">
+          
+          
+          <code class="ruby">             e</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="78">
+          
+          
+          <code class="ruby">             #number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="79">
+          
+          
+          <code class="ruby">           end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="80">
+          
+          
+          <code class="ruby">         end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="81">
+          
+          
+          <code class="ruby">       end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="82">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="83">
+          
+          
+          <code class="ruby">       ##</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="84">
+          
+          
+          <code class="ruby">       # Formats a +number+ with the specified level of &lt;tt&gt;:precision&lt;/tt&gt; (e.g., 112.32 has a precision of 2).</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="85">
+          
+          
+          <code class="ruby">       # You can customize the format in the +options+ hash.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="86">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="87">
+          
+          
+          <code class="ruby">       # @overload with_precision(number, options={})</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="88">
+          
+          
+          <code class="ruby">       #   @param [Fixnum, Float] number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="89">
+          
+          
+          <code class="ruby">       #     Number value to format.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="90">
+          
+          
+          <code class="ruby">       #   @param [Hash] options</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="91">
+          
+          
+          <code class="ruby">       #     Options for formatter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="92">
+          
+          
+          <code class="ruby">       #   @option options [Fixnum] :precision (3)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="93">
+          
+          
+          <code class="ruby">       #     Sets the level of precision.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="94">
+          
+          
+          <code class="ruby">       #   @option options [String] :separator (&quot;.&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="95">
+          
+          
+          <code class="ruby">       #     Sets the separator between the units.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="96">
+          
+          
+          <code class="ruby">       #   @option options [String] :delimiter (&quot;&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="97">
+          
+          
+          <code class="ruby">       #     Sets the thousands delimiter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="98">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="99">
+          
+          
+          <code class="ruby">       # @return [String] The formatted representation of the number.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="100">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="101">
+          
+          
+          <code class="ruby">       # @example</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="102">
+          
+          
+          <code class="ruby">       #   with_precision(111.2345)                    # =&gt; 111.235</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="103">
+          
+          
+          <code class="ruby">       #   with_precision(111.2345, :precision =&gt; 2)   # =&gt; 111.23</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="104">
+          
+          
+          <code class="ruby">       #   with_precision(13, :precision =&gt; 5)         # =&gt; 13.00000</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="105">
+          
+          
+          <code class="ruby">       #   with_precision(389.32314, :precision =&gt; 0)  # =&gt; 389</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="106">
+          
+          
+          <code class="ruby">       #   with_precision(1111.2345, :precision =&gt; 2, :separator =&gt; &#39;,&#39;, :delimiter =&gt; &#39;.&#39;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="107">
+          
+          
+          <code class="ruby">       #   # =&gt; 1.111,23</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="108">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="109">
+          <span class="hits">1</span>
+          
+          <code class="ruby">       def with_precision(number, args)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="110">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         options = BB::Hash.symbolize_keys(args)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="111">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="112">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         precision ||= (options[:precision] || 3)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="113">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         separator ||= (options[:separator] || &#39;.&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="114">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         delimiter ||= (options[:delimiter] || &#39;&#39;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="115">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="116">
+          <span class="hits">11</span>
+          
+          <code class="ruby">         begin</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="117">
+          <span class="hits">11</span>
+          
+          <code class="ruby">           rounded_number = (Float(number) * (10 ** precision)).round.to_f / 10 ** precision</code>
+        </li>
+      
+        <li class="covered" data-hits="11" data-linenumber="118">
+          <span class="hits">11</span>
+          
+          <code class="ruby">           with_delimiter(&quot;%01.#{precision}f&quot; % rounded_number,</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="119">
+          
+          
+          <code class="ruby">             :separator =&gt; separator,</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="120">
+          
+          
+          <code class="ruby">             :delimiter =&gt; delimiter)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="121">
+          
+          
+          <code class="ruby">         rescue</code>
+        </li>
+      
+        <li class="missed" data-hits="0" data-linenumber="122">
+          
+          
+          <code class="ruby">           number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="123">
+          
+          
+          <code class="ruby">         end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="124">
+          
+          
+          <code class="ruby">       end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="125">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="126">
+          
+          
+          <code class="ruby">       ##</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="127">
+          
+          
+          <code class="ruby">       # Formats a +number+ with grouped thousands using +delimiter+ (e.g., 12,324). You can</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="128">
+          
+          
+          <code class="ruby">       # customize the format in the +options+ hash.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="129">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="130">
+          
+          
+          <code class="ruby">       # @overload with_delimiter(number, options={})</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="131">
+          
+          
+          <code class="ruby">       #   @param [Fixnum, Float] number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="132">
+          
+          
+          <code class="ruby">       #     Number value to format.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="133">
+          
+          
+          <code class="ruby">       #   @param [Hash] options</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="134">
+          
+          
+          <code class="ruby">       #     Options for formatter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="135">
+          
+          
+          <code class="ruby">       #   @option options [String] :delimiter (&quot;, &quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="136">
+          
+          
+          <code class="ruby">       #     Sets the thousands delimiter.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="137">
+          
+          
+          <code class="ruby">       #   @option options [String] :separator (&quot;.&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="138">
+          
+          
+          <code class="ruby">       #     Sets the separator between the units.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="139">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="140">
+          
+          
+          <code class="ruby">       # @return [String] The formatted representation of the number.</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="141">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="142">
+          
+          
+          <code class="ruby">       # @example</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="143">
+          
+          
+          <code class="ruby">       #   with_delimiter(12345678)                        # =&gt; 12,345,678</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="144">
+          
+          
+          <code class="ruby">       #   with_delimiter(12345678.05)                     # =&gt; 12,345,678.05</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="145">
+          
+          
+          <code class="ruby">       #   with_delimiter(12345678, :delimiter =&gt; &quot;.&quot;)     # =&gt; 12.345.678</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="146">
+          
+          
+          <code class="ruby">       #   with_delimiter(12345678, :separator =&gt; &quot;,&quot;)     # =&gt; 12,345,678</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="147">
+          
+          
+          <code class="ruby">       #   with_delimiter(98765432.98, :delimiter =&gt; &quot; &quot;, :separator =&gt; &quot;,&quot;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="148">
+          
+          
+          <code class="ruby">       #   # =&gt; 98 765 432,98</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="149">
+          
+          
+          <code class="ruby">       #</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="150">
+          <span class="hits">1</span>
+          
+          <code class="ruby">       def with_delimiter(number, args)</code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="151">
+          <span class="hits">12</span>
+          
+          <code class="ruby">         options = BB::Hash.symbolize_keys(args)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="152">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="153">
+          <span class="hits">12</span>
+          
+          <code class="ruby">         delimiter ||= (options[:delimiter] || &#39;.&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="154">
+          <span class="hits">12</span>
+          
+          <code class="ruby">         separator ||= (options[:separator] || &#39;,&#39;)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="155">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="156">
+          <span class="hits">12</span>
+          
+          <code class="ruby">         begin</code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="157">
+          <span class="hits">12</span>
+          
+          <code class="ruby">           parts = number.to_s.split(&#39;.&#39;)</code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="158">
+          <span class="hits">12</span>
+          
+          <code class="ruby">           parts[0].gsub!(/(\d)(?=(\d\d\d)+(?!\d))/, &quot;\\1#{delimiter}&quot;)</code>
+        </li>
+      
+        <li class="covered" data-hits="12" data-linenumber="159">
+          <span class="hits">12</span>
+          
+          <code class="ruby">           parts.join(separator)</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="160">
+          
+          
+          <code class="ruby">         rescue</code>
+        </li>
+      
+        <li class="missed" data-hits="0" data-linenumber="161">
+          
+          
+          <code class="ruby">           number</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="162">
+          
+          
+          <code class="ruby">         end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="163">
+          
+          
+          <code class="ruby">       end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="164">
+          
+          
+          <code class="ruby">     end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="165">
+          
+          
+          <code class="ruby">   end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="166">
+          
+          
+          <code class="ruby">end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="167">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+    </ol>
+  </pre>
+</div>
+      
         <div class="source_table" id="b75f047c409859a12a41002ece7dbd0d81dd859d">
   <div class="header">
     <h3>lib/blackbox/string.rb</h3>