feat: add a simple cli command app implements

Author: inhere

.github/changelog.yml

@@ -0,0 +1,27 @@
+options:
+  title: '## Chanage Log'
+  style: gh-release
+filters:
+  # message length >= 12
+  - name: msgLen
+    minLen: 12
+  # message words >= 3
+  - name: wordsLen
+    minLen: 3
+  - name: keywords
+    keywords: ['format code']
+    exclude: true
+
+# not matched will use 'Other' group.
+groups:
+  - name: New
+    keywords: [add, new]
+  - name: Fixed
+    startWiths: [add, new]
+    keywords: [add, new]
+  - name: Feat
+    startWiths: [feat]
+    keywords: [feature]
+  - name: Update
+    startWiths: [update, 'up:']
+    keywords: []

example/liteApp

@@ -0,0 +1,23 @@
+#!/usr/bin/env php
+<?php
+
+use Toolkit\Cli\CliApp;
+
+define('BASE_PATH', dirname(__DIR__));
+
+require dirname(__DIR__) . '/test/bootstrap.php';
+
+// run:
+// php example/mycmd
+// php example/mycmd -i abc --lon def ag1 ag2 ag3
+$cmd = CliApp::new('cmd1', 'this is my cli application');
+$cmd->addOpt('info', 'i', 'Output some information');
+$cmd->addOpt('long-option-name', 'lon', 'this is a long option for command');
+$cmd->addArg('arg1', 'this is first argument');
+
+$cmd->setHandler(function (CliApp $cmd) {
+  var_dump($cmd->getOpts(), $cmd->getArgs(), $cmd->getRemainArgs());
+});
+
+$cmd->run();
+

example/mycmd

@@ -11,10 +11,11 @@
 
 use RuntimeException;
 use Toolkit\Cli\Color\Alert;
-use Toolkit\Cli\Color\Prompt;
 use Toolkit\Cli\Color\ColorTag;
+use Toolkit\Cli\Color\Prompt;
 use Toolkit\Cli\Traits\ReadMessageTrait;
 use Toolkit\Cli\Traits\WriteMessageTrait;
+use function array_shift;
 use function count;
 use function date;
 use function defined;
@@ -26,8 +27,10 @@
 use function json_encode;
 use function preg_replace;
 use function sprintf;
+use function str_ends_with;
 use function stream_isatty;
 use function strtoupper;
+use function substr;
 use function trim;
 use const DIRECTORY_SEPARATOR;
 use const JSON_PRETTY_PRINT;
@@ -44,18 +47,25 @@
  * @method static prompt(string|array|mixed $message, string $style = 'info')
  *
  * @method static red(string ...$message) Print red color message line.
+ * @method static redf(string $format, ...$args) Print red color message, use like sprintf.
  * @method static cyan(string ...$message) Print cyan color message line.
+ * @method static cyanf(string $format, ...$args) Print cyan color message, use like sprintf.
  * @method static blue(string ...$message) Print blue color message line.
  * @method static green(string ...$message) Print green color message line.
  * @method static magenta(string ...$message) Print cyan color message line.
  * @method static yellow(string ...$message) Print yellow color message line.
  *
  * @method static error(string ...$message) Print error style message line.
+ * @method static errorf(string $format, ...$args) Print error style message, use like sprintf.
  * @method static warn(string ...$message) Print warn style message line.
+ * @method static warnf(string $format, ...$args) Print warn style message, use like sprintf.
  * @method static info(string ...$message) Print info style message line.
+ * @method static infof(string $format, ...$args) Print info style message, use like sprintf.
  * @method static note(string ...$message) Print note style message line.
+ * @method static notef(string $format, ...$args) Print note style message, use like sprintf.
  * @method static notice(string ...$message) Print notice style message line.
  * @method static success(string ...$message) Print success style message line.
+ * @method static successf(string $format, ...$args) Print success style message, use like sprintf.
  */
 class Cli
 {
@@ -83,6 +93,18 @@ public static function __callStatic(string $method, array $args): void
             return;
         }
 
+        // use like sprintf
+        if (str_ends_with($method, 'f') ) {
+            $realName = substr($method, 0, -1);
+
+            if (isset(Color::STYLES[$realName]) && count($args) > 1) {
+                $fmt = (string)array_shift($args);
+                $msg = count($args) > 1 ? sprintf($fmt, ...$args) : $fmt;
+                echo Color::render($msg, $realName);
+                return;
+            }
+        }
+
         throw new RuntimeException('call unknown method: ' . $method);
     }
 
@@ -147,7 +169,7 @@ public static function color(string $text, array|string $style = null): string
      * @param array  $data
      * @param string $type
      * @param array{writeOpts:array} $labels
-     * @deprecated please use Clog::info();
+     * @deprecated please use Util\Clog::log()
      */
     public static function clog(string $msg, array $data = [], string $type = 'info', array $labels = []): void
     {