Merge branch '3.x'

# Conflicts: #	.github/workflows/php.yml #	src/AbstractHandler.php #	src/Application.php #	src/Console.php #	src/Contract/InputFlagInterface.php #	src/Controller.php #	src/Flag/Argument.php #	src/Flag/CmdArgumentsTrait.php #	src/Flag/Flag.php #	src/Flag/FlagException.php #	src/Flag/Option.php #	src/IO/AbstractInput.php #	src/IO/Input.php #	test/BaseTestCase.php

Author: inhere

.github/changelog.yml

@@ -0,0 +1,27 @@
+options:
+ title: '## Change 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: [update]

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+ - package-ecosystem: composer
+ directory: "/"
+ schedule:
+ interval: daily
+ open-pull-requests-limit: 10
+
+ - package-ecosystem: "github-actions"
+ directory: "/"
+ schedule:
+ # Check for updates to GitHub Actions every weekday
+ interval: "daily"

.github/workflows/php.yml

@@ -15,8 +15,12 @@ jobs:
  strategy:
  fail-fast: true
  matrix:
- php: [7.2, 7.3, 7.4] #
+ php: [7.3, 7.4, 8.0] #
  os: [ubuntu-latest, macOS-latest] # windows-latest,
+ include:
+ - os: 'ubuntu-latest'
+ php: '7.2'
+ phpunit: '8.5.13'
 
  steps:
  - name: Checkout
@@ -37,7 +41,7 @@ jobs:
  uses: shivammathur/setup-php@v2
  with:
  php-version: ${{ matrix.php}}
- tools: pecl, php-cs-fixer, phpunit
+ tools: pecl, php-cs-fixer, phpunit:${{ matrix.phpunit }}
  extensions: mbstring, dom, fileinfo, mysql, openssl, igbinary, redis # , swoole-4.4.19 #optional, setup extensions
  ini-values: post_max_size=56M, short_open_tag=On #optional, setup php.ini configuration
  coverage: none #optional, setup coverage driver: xdebug, none
@@ -49,4 +53,4 @@ jobs:
  # Docs: https://getcomposer.org/doc/articles/scripts.md
 
  - name: Run unit tests
- run: php vendor/bin/phpunit
+ run: phpunit -vv

.gitignore

@@ -4,6 +4,8 @@
 
 .idea/
 .phpintel/
+.phpdoc/
+docs/api/
 caches/
 vendor/
 !README.md

CHANGELOG.md

@@ -2,8 +2,24 @@
 
 ## v4.0.x
 
-> begin at: 2020.08.21
+> begin at: 2020.08.21, branch `master`
 
+## v3.1.21
+
+## v3.1.20
+
+**update**
+
+- update some for error tips and single list
+- add before/after methods on run controller method.
+- support controller object cache on repeat fetch
+- enhance built in php serve util logic
+
+## v3.1.19
+
+> publish at 2021.04.20
+
+- up: use `Str::padByWidth` support zh-CN words on render table/list/panel
 
 ## v3.0.x
 

README.md

@@ -5,22 +5,23 @@
 [![Latest Stable Version](http://img.shields.io/packagist/v/inhere/console.svg)](https://packagist.org/packages/inhere/console)
 [![Github Actions Status](https://github.com/inhere/php-console/workflows/Unit-tests/badge.svg)](https://github.com/inhere/php-console/actions)
 
-A simple, full-featured php command line application library. 
+Full-featured php command line application library. 
 
 Provide console parameter parsing, command run, color style output, user information interaction, and special format information display.
 
 > **[中文README](./README.zh-CN.md)**
 
 ## Command line preview
 
-![app-command-list](https://raw.githubusercontent.com/inhere/php-console/master/docs/screenshots/app-command-list.png)
+![app-command-list](https://raw.githubusercontent.com/inhere/php-console/3.x/docs/screenshots/app-command-list.png)
 
 ## Features
 
 > Easy to use. Can be easily integrated into any existing project.
 
 - Command line application, `controller`, `command` parsing run on the command line
-- Support for setting aliases for commands. A command can have multiple aliases. Support command display/hide, enable/disable
+- Support for setting aliases for commands. A command can have multiple aliases. 
+- Support command display/hide, enable/disable.
 - Full-featured command line option parameter parsing (named parameters, short options `-s`, long options `--long`). 
 - The `input`, `output` of the command line, management, use
 - Command method comments are automatically parsed as help information (by default, `@usage` `@arguments` `@options` `@example`)
@@ -82,11 +83,30 @@ phpunit
 phpdbg -dauto_globals_jit=Off -qrr /usr/local/bin/phpunit --coverage-text
 ```
 
+## Debuging
+
+You can set debug level by ENV `CONSOLE_DEBUG=level`, global option `--debug level`
+
+```bash
+# by ENV
+$ CONSOLE_DEBUG=4 php examples/app
+$ CONSOLE_DEBUG=5 php examples/app
+# by global options
+$ php examples/app --debug 4
+```
+
+## Project use
+
+Check out these projects, which use https://github.com/inhere/php-console :
+
+- [kite](https://github.com/inhere/kite) Kite is a tool for help development.
+- More, please see [github used by](https://github.com/inhere/php-console/network/dependents?package_id=UGFja2FnZS01NDI5NzMxOTI%3D)
+
 ## License
 
 [MIT](LICENSE)
 
-## My other projects
+## My projects
 
 - [inhere/php-validate](https://github.com/inhere/php-validate) A compact and full-featured php verification library
 - [inhere/sroute](https://github.com/inhere/php-srouter) Lightweight and fast HTTP request routing library

README.zh-CN.md

@@ -11,7 +11,7 @@
 
 ## 命令行预览
 
-![app-command-list](https://raw.githubusercontent.com/inhere/php-console/master/docs/screenshots/app-command-list.png)
+![app-command-list](https://raw.githubusercontent.com/inhere/php-console/3.x/docs/screenshots/app-command-list.png)
 
 ## 功能概览
 
@@ -79,6 +79,25 @@ phpunit
 phpdbg -dauto_globals_jit=Off -qrr /usr/local/bin/phpunit --coverage-text
 ```
 
+## 开发调试
+
+你可以通过环境变量 `CONSOLE_DEBUG=level`, 全局选项 `--debug level` 设置debug级别
+
+```bash
+# by ENV
+$ CONSOLE_DEBUG=4 php examples/app
+$ CONSOLE_DEBUG=5 php examples/app
+# by global options
+$ php examples/app --debug 4
+```
+
+## 使用console的项目
+
+看看这些使用了 https://github.com/inhere/php-console 的项目:
+
+- [kite](https://github.com/inhere/kite) PHP编写的，方便本地开发和使用的一些CLI工具应用
+- More, please see [github used by](https://github.com/inhere/php-console/network/dependents?package_id=UGFja2FnZS01NDI5NzMxOTI%3D)
+
 ## License
 
 [MIT](LICENSE)

composer.json

@@ -24,11 +24,12 @@
  "require": {
  "php": ">7.2.0",
  "toolkit/cli-utils": "~1.0",
+ "toolkit/pflag": "~1.0",
  "toolkit/stdlib": "~1.0",
  "toolkit/sys-utils": "~1.0"
  },
  "require-dev": {
- "phpunit/phpunit": "~9.1"
+ "phpunit/phpunit": "^8.5 || ^9.1"
  },
  "autoload": {
  "psr-4": {

docs/screenshots/app-command-list.png

@@ -30,7 +30,7 @@ class CorCommand extends Command
  */
  public static function aliases(): array
  {
- return ['coro'];
+ return ['co', 'coro'];
  }
 
  /**