Merge pull request #9 from karam-mustafa/v1.2.0

add tasks log

Author: karam-mustafa

docs/commands.md

@@ -8,7 +8,10 @@ Usage
         "php artisan make:model ControllerName",
         // and you can define unlimited commands
     );
-    $process->start();
+    $process->start()
+     // if ypu want to see the tasks log,
+     //  you can fetch the tasks lists by calling the function
+     ->getTasts();
 
 ```
 * Define multiple process and execute them by run function.
@@ -22,7 +25,10 @@ Usage
     );
 
     // run function will allows you to get the output from the execution process.
-    $process->run();
+    $process->run()
+     // if ypu want to see the tasks log,
+     //  you can fetch the tasks lists by calling the function
+     ->getTasts();
 
 ```
 * Add options.
@@ -47,6 +53,9 @@ Usage
     );
 
     // run or start your tasks.
-    $process->start();
+    $process->start()
+     // if ypu want to see the tasks log,
+     //  you can fetch the tasks lists by calling the function
+     ->getTasts();
 
 ```

docs/php.md

@@ -4,14 +4,20 @@ Usage
 each task must be a callback function as you can see in the below example.
 
 ```shell
+
+    // if you are enable the output from the options
+    // you can see the outputs are printed.
     $process = \SOS\MultiProcess\Facades\MultiProcessFacade::setTasks(
         function () {
-            return \Illuminate\Support\Facades\DB::statement('delete from users where id = 5');
+            echo 'The first task to run';
         }, function () {
-            return \Illuminate\Support\Facades\DB::statement('delete from users where id = 6');
+            echo 'The second task to run';
         }
     );
-    $process->runPHP();
+    $process->runPHP()
+     // if ypu want to see the tasks log,
+     //  you can fetch the tasks lists by calling the function
+     ->getTasts();
 ```
 * Add options.
 
@@ -21,10 +27,12 @@ each task must be a callback function as you can see in the below example.
     // you can change them from the file
     // or you can basicly added them from the setter function.
     $process = \SOS\MultiProcess\Facades\MultiProcessFacade::setTasks(
-        "php artisan make:model modelName",
-        "php artisan make:model ControllerName",
-        // and you can define unlimited commands
-    )->setOptions([
+        function () {
+            echo 'The first task to run';
+        }, function () {
+            echo 'The second task to run';
+        }
+    ->setOptions([
        'timeOut' => 60,
        'ideTimeOut' => 60,
        'enableOutput' => true,
@@ -35,7 +43,9 @@ each task must be a callback function as you can see in the below example.
     );
 
     // run or start your tasks.
-    $process->start();
-
+    $process->runPHP()
+    // if ypu want to see the tasks log,
+    //  you can fetch the tasks lists by calling the function
+    ->getTasts();
 ```
 

phpunit.xml.dist

@@ -6,7 +6,7 @@
         </include>
     </coverage>
     <testsuites>
-        <testsuite name="Spatie Test Suite">
+        <testsuite name="Test Suite">
             <directory>tests</directory>
         </testsuite>
     </testsuites>

src/Classes/MultiProcess.php

@@ -296,12 +296,17 @@ private function resolveNotRunningProcess($callback)
             foreach ($this->processing as $i => $runningProcess) {
                 if (!$runningProcess->isRunning()) {
 
+                    // Remove this task from processing list and run it.
+                    // then register the task log tell that task is now running
+                    // and when the task finished register a new log.
                     unset($this->processing[$i]);
 
                     $this->process(function (Process $process) use ($callback) {
                         return $callback($process);
                     });
 
+                    $this->registerTaskLog($i, 'task is running');
+
                     $this->finishTask($i);
                 }
             }
@@ -342,6 +347,8 @@ private function finishTask($key)
         if (isset($this->tasks[$key])) {
             $this->tasks[$key]['state'] = $this->completedState;
         }
+
+        $this->registerTaskLog($key, 'task finished');
     }
 
     /**
@@ -394,4 +401,21 @@ private function higherOrderRun()
         };
     }
 
+
+    /**
+     * when any task change it status, this function must register log that describe the changes.
+     *
+     * @param $key
+     * @param  string  $string
+     *
+     * @author karam mustafa
+     */
+    private function registerTaskLog($key, $string)
+    {
+        if (!isset($this->tasks[$key]['log'])) {
+            $this->tasks[$key]['log'] = [];
+        }
+        array_push($this->tasks[$key]['log'], $string);
+    }
+
 }