style: format codes by cs fix

Author: inhere

.php_cs

@@ -3,7 +3,7 @@
 $header = <<<'EOF'
 This file is part of toolkit/cli-utils.
 
-@link     https://github.com/php-toolkit/cli-utils
+@homepage https://github.com/php-toolkit/cli-utils
 @author   https://github.com/inhere
 @license  MIT
 EOF;

README.md

@@ -48,7 +48,7 @@ $rendered = Highlighter::create()->highlight(file_get_contents(__FILE__));
 
 ![colors](example/cli-php-file-highlight.png)
 
-## Parse CLI arguments and options
+## Parse CLI arguments & options
 
 ```php
 use Toolkit\Cli\Flags;
@@ -57,7 +57,7 @@ $argv = $_SERVER['argv'];
 // notice: must shift first element.
 $script = \array_shift($argv);
 // do parse
-list($args, $shortOpts, $longOpts) = Flags::parseArgv($argv);
+[$args, $shortOpts, $longOpts] = Flags::parseArgv($argv);
 ```
 
 ## Build CLI application
@@ -87,7 +87,7 @@ $app->addCommand('test', function ($app) {
 }, 'the description text for the command: test');
 ```
 
-Use closure with config:
+Use closure with a config:
 
 ```php
 $app->addByConfig(function ($app) {
@@ -105,6 +105,8 @@ $app->addByConfig(function ($app) {
 Use an object:
 
 ```php
+use Toolkit\Cli\App;
+
 class MyCommand
 {
     public function getHelpConfig(): array
@@ -158,7 +160,7 @@ $down = Download::file($url, '');
 $down->start();
 ```
 
-### Progress bar output:
+**Progress bar output:**
 
 ```text
 Connected...
@@ -170,7 +172,7 @@ Mime-type: application/octet-stream
 [========================================>                                                           ] 40% (3076/7590 kb)
 ```
 
-### Progress text output:
+**Progress text output:**
 
 ```text
 Download: http://no2.php.net/distributions/php-7.2.5.tar.bz2

example/color.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */

example/down.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */

example/high.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */

src/App.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */
@@ -100,7 +100,7 @@ class App
      * Class constructor.
      *
      * @param array $config
-     * @param array $argv
+     * @param array|null $argv
      */
     public function __construct(array $config = [], array $argv = null)
     {
@@ -148,7 +148,6 @@ protected function findCommand(): void
         }
 
         $newArgs = [];
-
         foreach ($this->args as $key => $value) {
             if ($key === 0) {
                 $this->command = trim($value);
@@ -168,20 +167,32 @@ protected function findCommand(): void
      * @throws InvalidArgumentException
      */
     public function dispatch(bool $exit = true): void
+    {
+        $status = $this->doHandle();
+
+        if ($exit) {
+            $this->stop($status);
+        }
+    }
+
+    /**
+     * @return int
+     */
+    protected function doHandle(): int
     {
         if (!$command = $this->command) {
             $this->displayHelp();
-            return;
+            return 0;
         }
 
         if (!isset($this->commands[$command])) {
             $this->displayHelp("The command '{$command}' is not exists!");
-            return;
+            return 0;
         }
 
         if (isset($this->opts['h']) || isset($this->opts['help'])) {
             $this->displayCommandHelp($command);
-            return;
+            return 0;
         }
 
         try {
@@ -190,9 +201,7 @@ public function dispatch(bool $exit = true): void
             $status = $this->handleException($e);
         }
 
-        if ($exit) {
-            $this->stop($status);
-        }
+        return $status;
     }
 
     /**
@@ -360,7 +369,7 @@ public function commands(array $commands): void
     public function displayHelp(string $err = ''): void
     {
         if ($err) {
-            echo Color::render("<red>ERROR</red>: $err\n\n");
+            Color::println("<red>ERROR</red>: $err\n");
         }
 
         // help
@@ -383,8 +392,7 @@ public function displayHelp(string $err = ''): void
 
         $help .= "\nFor command usage please run: <cyan>{$this->script} COMMAND -h</cyan>";
 
-        echo Color::render($help) . PHP_EOL;
-        exit(0);
+        Color::println($help);
     }
 
     /**
@@ -427,7 +435,7 @@ public function displayCommandHelp(string $name): void
             ]);
         }
 
-        echo Color::render($help);
+        Color::println($help);
     }
 
     /**

src/Cli.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */
@@ -63,7 +63,7 @@ public static function style(): Style
 
     /**
      * @param string           $text
-     * @param string|int|array $style
+     * @param string|int|array|null $style
      *
      * @return string
      */

src/Color.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */
@@ -18,6 +18,7 @@
 use function sprintf;
 use function strip_tags;
 use function strpos;
+use const PHP_EOL;
 
 /**
  * Class Color
@@ -299,7 +300,7 @@ public static function println($messages, string $style = 'info'): void
     {
         $string = is_array($messages) ? implode("\n", $messages) : (string)$messages;
 
-        echo self::render($string . "\n", $style);
+        echo self::render($string, $style) . PHP_EOL;
     }
 
     /**
@@ -344,11 +345,11 @@ public static function render(string $text, $style = null): string
         if (is_string($style)) {
             $color = self::STYLES[$style] ?? '';
 
-            // custom style: [self::FG_GREEN, self::BG_WHITE, self::UNDERSCORE]
+        // custom style: [self::FG_GREEN, self::BG_WHITE, self::UNDERSCORE]
         } elseif (is_array($style)) {
             $color = implode(';', $style);
 
-            // user color tag: <info>message</info>
+        // user color tag: <info>message</info>
         } elseif (strpos($text, '</') > 0) {
             return self::parseTag($text);
         }

src/ColorCode.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */
@@ -172,7 +172,6 @@ public static function fromString(string $string)
                     break;
                 default:
                     throw new RuntimeException('Invalid option');
-                    break;
             }
         }
 

src/ColorTag.php

@@ -2,7 +2,7 @@
 /**
  * This file is part of toolkit/cli-utils.
  *
- * @link     https://github.com/inhere
+ * @link     https://github.com/php-toolkit/cli-utils
  * @author   https://github.com/inhere
  * @license  MIT
  */