Merge pull request #4 from okdana/precision

Add optional precision argument to format()

Author: Bilge

README.md

@@ -41,7 +41,8 @@ By default all values are rounded to the nearest integer.
 ```
 > 513 KiB
 
-Increasing the precision with `setPrecision($precision)` allows the specified amount of digits after the decimal point.
+The default precision can be increased with `setPrecision($precision)`. Increasing the precision allows the specified amount of digits after the decimal point.
+
 ```php
 (new ByteFormatter)->setPrecision(2)->format(0x80233);
 ```
@@ -55,6 +56,13 @@ needed.
 ```
 > 512.5 KiB
 
+The default precision can be overridden on a per-format basis using the optional precision argument to `format()`.
+
+```php
+(new ByteFormatter)->setPrecision(2)->format(0x80233, 4);
+```
+> 512.5498 KiB
+
 Output format
 -------------
 

src/Byte/ByteFormatter.php

@@ -34,11 +34,12 @@ public function __construct(UnitDecorator $unitDecorator = null)
         ;
     }
 
-    public function format($bytes)
+    public function format($bytes, $precision = null)
     {
+        $precision = $precision === null ? $this->precision : $precision;
         $log = log($bytes, $this->base);
         $exponent = max(0, $log|0);
-        $value = round(pow($this->base, $log - $exponent), $this->precision);
+        $value = round(pow($this->base, $log - $exponent), $precision);
         $units = $this->getUnitDecorator()->decorate($exponent, $this->base, $value);
 
         return trim(sprintf($this->normalizedFormat, $value, $units));

test/Integration/ByteFormatterTest.php

@@ -78,6 +78,7 @@ public function provideDecimalIntegers()
     public function testPrecision($integer, $formatted)
     {
         $this->assertSame($formatted, $this->formatter->setPrecision(2)->format($integer));
+        $this->assertSame($formatted, $this->formatter->setPrecision(5)->format($integer, 2));
     }
 
     public function providePrecisionIntegers()

test/Integration/DocumentationTest.php

@@ -22,6 +22,8 @@ public function testPrecision()
         $this->assertSame('512.55 KiB', (new ByteFormatter)->setPrecision(2)->format(0x80233));
 
         $this->assertSame('512.5 KiB', (new ByteFormatter)->setPrecision(2)->format(0x80200));
+
+        $this->assertSame('512.5498 KiB', (new ByteFormatter)->setPrecision(2)->format(0x80233, 4));
     }
 
     public function testOutputFormat()