add method then

Author: cesargb

README.md

@@ -17,24 +17,16 @@ composer require cesargb/php-log-rotation
 
 ## Usage
 
-This is an example:
-
 ```php
 use Cesargb\Log\Rotation;
 
 $rotation = new Rotation();
 
-// Rotate a file
-$rotation->rotate('file.log');
-
-// Log files are rotated 10 times before being removed, 366 default
-$rotation->files(30)->rotate('file.log');
-
-// Compress file rotated
-$rotation->compress()->rotate('file.log');
-
-// Log files are rotated only if they grow bigger then 1024 bytes
-$rotation->minSize(1024)->rotate('file.log');
+$rotation
+    ->compress() // Optional, compress the file after rotated
+    ->files(30) // Optional, files are rotated 30 times before being removed
+    ->minSize(1024) // Optional, are rotated when they grow bigger than 1024 bytes
+    ->rotate('file.log');
 ```
 
 ## Test

src/Rotation.php

@@ -3,8 +3,8 @@
 namespace Cesargb\Log;
 
 use Cesargb\Log\Compress\Gz;
-use LogicException;
 use Cesargb\Log\Processors\RotativeProcessor;
+use LogicException;
 
 class Rotation
 {
@@ -14,6 +14,8 @@ class Rotation
 
     private int $_minSize = 0;
 
+    private $thenCallback = null;
+
     public function __construct()
     {
         $this->processor = new RotativeProcessor();
@@ -59,16 +61,30 @@ public function minSize(int $bytes): self
         return $this;
     }
 
+    /**
+     * Call function if roteted was sucessfull and pass
+     * the file as argument.
+     *
+     * @param callable $callable
+     * @return self
+     */
+    public function then(callable $callable): self
+    {
+        $this->thenCallback = $callable;
+
+        return $this;
+    }
+
     /**
      * Rotate file
      *
      * @param string $file
-     * @return string|null
+     * @return boolean true if rotated was successful
      */
-    public function rotate(string $file): ?string
+    public function rotate(string $file): bool
     {
         if (!$this->canRotate($file)) {
-            return null;
+            return false;
         }
 
         $fileRotate = $this->moveContentToTempFile($file);
@@ -81,7 +97,11 @@ public function rotate(string $file): ?string
             $fileRotated = $gz->handler($fileRotated);
         }
 
-        return $fileRotated;
+        if ($fileRotated && $this->thenCallback) {
+            call_user_func($this->thenCallback, $fileRotated);
+        }
+
+        return ! empty($fileRotated);
     }
 
     /**

tests/Compress/GzTest.php

@@ -2,7 +2,6 @@
 
 namespace Cesargb\Log\Test\Processors;
 
-use LogicException;
 use Cesargb\Log\Rotation;
 use Cesargb\Log\Test\TestCase;
 
@@ -24,12 +23,12 @@ public function test_rotation_processor_with_gz_processor()
 
         file_put_contents(self::DIR_WORK.'file.log', $content);
 
-        $rotated_file = $rotation->rotate(self::DIR_WORK.'file.log');
+        $rotation->then(function ($fileRotated) {
+            $this->assertEquals(self::DIR_WORK.'file.log.1.gz', $fileRotated);
+        })->rotate(self::DIR_WORK.'file.log');
 
         $this->assertStringEqualsFile(self::DIR_WORK.'file.log', '');
 
-        $this->assertEquals(self::DIR_WORK.'file.log.1.gz', $rotated_file);
-
         $this->assertFileExists(self::DIR_WORK.'file.log.1.gz');
 
         $this->assertEquals($content, implode("", gzfile(self::DIR_WORK.'file.log.1.gz')));

tests/RotationTest.php

@@ -6,7 +6,7 @@
 use Cesargb\Log\Rotation;
 use Cesargb\Log\Test\TestCase;
 
-class RotativeTest extends TestCase
+class RotationTest extends TestCase
 {
     public function test_log_rotating_if_file_not_exists()
     {