up: add more help method in Cli and CliHelper

Author: inhere

.github/changelog.yml

@@ -1,27 +1,37 @@
-options:
-  title: '## Chanage Log'
-  style: gh-release
+title: '## Change Log'
+# style allow: simple, markdown(mkdown), ghr(gh-release)
+style: gh-release
+# group names
+names: [Refactor, Fixed, Feature, Update, Other]
+# if empty will auto fetch by git remote
+#repo_url: https://github.com/gookit/gitw
+
 filters:
-  # message length >= 12
-  - name: msgLen
-    minLen: 12
-  # message words >= 3
-  - name: wordsLen
-    minLen: 3
+  # message length should >= 12
+  - name: msg_len
+    min_len: 12
+  # message words should >= 3
+  - name: words_len
+    min_len: 3
+  - name: keyword
+    keyword: format code
+    exclude: true
   - name: keywords
-    keywords: ['format code']
+    keywords: format code, action test
     exclude: true
 
+# group match rules
 # not matched will use 'Other' group.
-groups:
-  - name: New
-    contains: [add, new]
+rules:
+  - name: Refactor
+    start_withs: [refactor, break]
+    contains: ['refactor:']
   - name: Fixed
-    startWiths: [add, new]
-    contains: [add, new]
-  - name: Feat
-    startWiths: [feat]
-    contains: [feature]
+    start_withs: [fix]
+    contains: ['fix:']
+  - name: Feature
+    start_withs: [feat, new]
+    contains: ['feat:']
   - name: Update
-    startWiths: [update, 'up:']
-    contains: []
+    start_withs: [update]
+    contains: ['update:', 'up:']

.github/workflows/php.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        php: [8.0, 8.1]
+        php: [8.0, 8.1, 8.2]
         os: [ubuntu-latest, macOS-latest] # windows-latest,
 #        include:
 #          - os: 'ubuntu-latest'

src/Cli.php

@@ -15,6 +15,7 @@
 use Toolkit\Cli\Color\Prompt;
 use Toolkit\Cli\Traits\ReadMessageTrait;
 use Toolkit\Cli\Traits\WriteMessageTrait;
+use Toolkit\Stdlib\Str;
 use function array_shift;
 use function count;
 use function date;
@@ -301,4 +302,15 @@ public static function stripAnsiCode(string $string): string
     {
         return preg_replace('/\033\[[\d;?]*\w/', '', $string);
     }
+
+    /**
+     * @param array $args
+     * @param string $prefix
+     *
+     * @return string
+     */
+    public static function toCmdline(array $args, string $prefix = ''): string
+    {
+        return Str::shellQuotesToLine($args, $prefix);
+    }
 }

src/Helper/CliHelper.php

@@ -9,6 +9,7 @@
 
 namespace Toolkit\Cli\Helper;
 
+use Toolkit\Stdlib\Str;
 use function escapeshellarg;
 use function is_bool;
 use function is_numeric;
@@ -92,4 +93,15 @@ public static function escapeToken(string $token): string
     {
         return preg_match('{^[\w-]+$}', $token) ? $token : escapeshellarg($token);
     }
+
+    /**
+     * @param array $args
+     * @param string $prefix
+     *
+     * @return string
+     */
+    public static function toCmdline(array $args, string $prefix = ''): string
+    {
+        return Str::shellQuotesToLine($args, $prefix);
+    }
 }