add new show methods: dynamicText

Author: inhere

examples/Controllers/HomeController.php

@@ -45,6 +45,7 @@ protected static function commandAliases(): array
             'ml' => 'multiList',
             'ms' => 'multiSelect',
             'sl' => 'splitLine',
+            'dt' => 'dynamicText',
         ];
     }
 
@@ -374,6 +375,23 @@ public function pointingCommand()
         Show::pointing('Done', true);
     }
 
+    /**
+     * dynamic text message example, by Show::dynamicText
+     */
+    public function dynamicTextCommand()
+    {
+        $dt = Show::dynamicText('Complete', 'Download file: xyz.zip ... ');
+        $dt->send('Start');
+
+        foreach (['Request','Downloading', 'Save'] as $txt) {
+            \sleep(2);
+            $dt->send($txt);
+        }
+
+        \sleep(2);
+        $dt->send(false);
+    }
+
     /**
      * a progress bar example show, by Show::progressBar()
      * @options

src/Utils/Show.php

@@ -1068,6 +1068,49 @@ public static function counterTxt(string $msg, $doneMsg = null)
         yield false;
     }
 
+    /**
+     * @param string $doneMsg
+     * @param string|null $fixMsg
+     * @return \Generator
+     */
+    public static function dynamicText(string $doneMsg, string $fixMsg = null)
+    {
+        $counter = 0;
+        $finished = false;
+        // $tpl = Cli::isSupportColor() ? "\x0D\x1B[2K" : "\x0D\r";
+        $tpl = Cli::isSupportColor() ? "\x0D\x1B[2K" : "\x0D";
+
+        if ($fixMsg) {
+            $tpl .= self::getStyle()->render($fixMsg);
+        }
+
+        $tpl .= '%s';
+        $doneMsg = $doneMsg ? self::getStyle()->render($doneMsg) : '';
+
+        while (true) {
+            if ($finished) {
+                return;
+            }
+
+            $msg = yield;
+
+            if ($msg === false) {
+                $counter++;
+                $finished = true;
+                $msg = $doneMsg ?: '';
+            }
+
+            printf($tpl, $msg);
+
+            if ($finished) {
+                echo "\n";
+                break;
+            }
+        }
+
+        yield $counter;
+    }
+
     /**
      * @param int $total
      * @param string $msg