Update sleeper to nanoseconds

Author: Aleksandr Denisyuk

README.md

@@ -26,14 +26,14 @@ Configure BackOff and ExceptionClassifier to retry your business logic when an e
 <?php
 
 use Orangesoft\BackOff\ExponentialBackOff;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Retry\ExceptionClassifier\ExceptionClassifier;
 use Orangesoft\BackOff\Retry\Retry;
 
 $backOff = new ExponentialBackOff(
     maxAttempts: 3,
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
 );
 
 $exceptionClassifier = new ExceptionClassifier([

docs/index.md

@@ -15,13 +15,13 @@ Configure base time, cap time, strategy and jitter. All options are required:
 
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Strategy\ExponentialStrategy;
 use Orangesoft\BackOff\Jitter\NullJitter;
 
 $generator = new Generator(
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
     strategy: new ExponentialStrategy(multiplier: 2),
     jitter: new NullJitter(),
 );
@@ -48,13 +48,13 @@ Enabled Jitter allows to add a noise for the back-off time. Turn on it is very s
 
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Strategy\ExponentialStrategy;
 use Orangesoft\BackOff\Jitter\EqualJitter;
 
 $generator = new Generator(
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
     strategy: new ExponentialStrategy(multiplier: 2),
     jitter: new EqualJitter(),
 );
@@ -71,14 +71,14 @@ Pass the duration time to Sleeper as below:
 
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Strategy\ExponentialStrategy;
 use Orangesoft\BackOff\Jitter\NullJitter;
 use Orangesoft\BackOff\Sleeper\Sleeper;
 
 $generator = new Generator(
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
     strategy: new ExponentialStrategy(multiplier: 2),
     jitter: new NullJitter(),
 );
@@ -88,21 +88,10 @@ $sleeper = new Sleeper();
 /** @var DurationInterface $duration */
 $duration = $generator->generate(attempt: 3);
 
-// usleep(8000000)
+// time_nanosleep(8, 0)
 $sleeper->sleep($duration);
 ```
 
-Configure base time and cap time with microseconds precision because Sleeper converts the duration to integer before sleep and truncates numbers after point. For example 1 nanosecond is 0.001 microseconds, so it would to converted to 0:
-
-```text
-+--------------+-------------+
-| Nanoseconds  |           1 |
-| Microseconds |       0.001 |
-| Milliseconds |    0.000001 |
-| Seconds      | 0.000000001 |
-+--------------+-------------+
-```
-
 Use nanoseconds for high-precision calculations.
 
 ## Use BackOff
@@ -114,15 +103,15 @@ BackOff accepts Generator and Sleeper dependencies:
 
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Strategy\ExponentialStrategy;
 use Orangesoft\BackOff\Jitter\NullJitter;
 use Orangesoft\BackOff\Sleeper\Sleeper;
 use Orangesoft\BackOff\BackOff;
 
 $generator = new Generator(
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
     strategy: new ExponentialStrategy(multiplier: 2),
     jitter: new NullJitter(),
 );
@@ -146,14 +135,14 @@ Use back-off decorators to quick instance. For example [ExponentialBackOff](../s
 <?php
 
 use Orangesoft\BackOff\ExponentialBackOff;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Jitter\NullJitter;
 use Orangesoft\BackOff\Sleeper\Sleeper;
 
 $backOff = new ExponentialBackOff(
     maxAttempts: 3,
-    baseTime: new Milliseconds(1_000),
-    capTime: new Milliseconds(60_000),
+    baseTime: new Seconds(1),
+    capTime: new Seconds(60),
     multiplier: 2,
     jitter: new NullJitter(),
     sleeper: new Sleeper(),
@@ -176,13 +165,13 @@ Configure BackOff and ExceptionClassifier to retry your business logic when an e
 <?php
 
 use Orangesoft\BackOff\ExponentialBackOff;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Retry\ExceptionClassifier\ExceptionClassifier;
 use Orangesoft\BackOff\Retry\Retry;
 
 $backOff = new ExponentialBackOff(
     maxAttempts: 3,
-    baseTime: new Milliseconds(1_000),
+    baseTime: new Seconds(1),
 );
 
 $exceptionClassifier = new ExceptionClassifier([

src/ConstantBackOff.php

@@ -5,7 +5,7 @@
 namespace Orangesoft\BackOff;
 
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Jitter\JitterInterface;
 use Orangesoft\BackOff\Jitter\NullJitter;
@@ -19,8 +19,8 @@ final class ConstantBackOff implements BackOffInterface
 
     public function __construct(
         int|float $maxAttempts = 3,
-        DurationInterface $baseTime = new Milliseconds(1_000),
-        DurationInterface $capTime = new Milliseconds(60_000),
+        DurationInterface $baseTime = new Seconds(1),
+        DurationInterface $capTime = new Seconds(60),
         JitterInterface $jitter = new NullJitter(),
         SleeperInterface $sleeper = new Sleeper(),
     ) {

src/DecorrelatedBackOff.php

@@ -5,7 +5,7 @@
 namespace Orangesoft\BackOff;
 
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Jitter\NullJitter;
 use Orangesoft\BackOff\Sleeper\Sleeper;
@@ -18,8 +18,8 @@ final class DecorrelatedBackOff implements BackOffInterface
 
     public function __construct(
         int|float $maxAttempts = 3,
-        DurationInterface $baseTime = new Milliseconds(1_000),
-        DurationInterface $capTime = new Milliseconds(60_000),
+        DurationInterface $baseTime = new Seconds(1),
+        DurationInterface $capTime = new Seconds(60),
         int $multiplier = 3,
         SleeperInterface $sleeper = new Sleeper(),
     ) {

src/ExponentialBackOff.php

@@ -5,7 +5,7 @@
 namespace Orangesoft\BackOff;
 
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Jitter\JitterInterface;
 use Orangesoft\BackOff\Jitter\NullJitter;
@@ -19,8 +19,8 @@ final class ExponentialBackOff implements BackOffInterface
 
     public function __construct(
         int|float $maxAttempts = 3,
-        DurationInterface $baseTime = new Milliseconds(1_000),
-        DurationInterface $capTime = new Milliseconds(60_000),
+        DurationInterface $baseTime = new Seconds(1),
+        DurationInterface $capTime = new Seconds(60),
         int $multiplier = 2,
         JitterInterface $jitter = new NullJitter(),
         SleeperInterface $sleeper = new Sleeper(),

src/LinearBackOff.php

@@ -5,7 +5,7 @@
 namespace Orangesoft\BackOff;
 
 use Orangesoft\BackOff\Duration\DurationInterface;
-use Orangesoft\BackOff\Duration\Milliseconds;
+use Orangesoft\BackOff\Duration\Seconds;
 use Orangesoft\BackOff\Generator\Generator;
 use Orangesoft\BackOff\Jitter\JitterInterface;
 use Orangesoft\BackOff\Jitter\NullJitter;
@@ -19,8 +19,8 @@ final class LinearBackOff implements BackOffInterface
 
     public function __construct(
         int|float $maxAttempts = 3,
-        DurationInterface $baseTime = new Milliseconds(1_000),
-        DurationInterface $capTime = new Milliseconds(60_000),
+        DurationInterface $baseTime = new Seconds(1),
+        DurationInterface $capTime = new Seconds(60),
         JitterInterface $jitter = new NullJitter(),
         SleeperInterface $sleeper = new Sleeper(),
     ) {

src/Sleeper/Sleeper.php

@@ -10,8 +10,9 @@ final class Sleeper implements SleeperInterface
 {
     public function sleep(DurationInterface $duration): void
     {
-        $microseconds = (int) $duration->asMicroseconds();
+        $seconds = (int) $duration->asSeconds();
+        $nanoseconds = (int) $duration->asNanoseconds() - $seconds * 1_000_000_000;
 
-        usleep($microseconds);
+        time_nanosleep($seconds, $nanoseconds);
     }
 }

tests/Sleeper/SleeperTest.php

@@ -17,11 +17,11 @@ public function testSleep(): void
 
         $timer = new Timer();
 
-        $milliseconds = new Nanoseconds(1_000);
+        $nanoseconds = new Nanoseconds(1_000);
 
         $timer->start();
 
-        $sleeper->sleep($milliseconds);
+        $sleeper->sleep($nanoseconds);
 
         $duration = $timer->stop();