update readme. update example demo

Author: inhere

README.md

@@ -8,6 +8,27 @@
 
 Generic PHP command line flags parse library
 
+## Features
+
+- Generic parse CLI options and arguments.
+- Support set value data type(`int,string,bool,array`), will auto format input value.
+- Support set default value for option/argument.
+- Support set option/argument is required.
+- Support set validator for check input value.
+- Support auto generate help message.
+
+**Arguments**:
+
+- Support binding named arguemnt
+- Support define array argument
+
+**Options**:
+
+- Support long option `--long`
+- Support short option `-s -a value`, allow set multi short names.
+- Support define array option
+  - eg: `--tag php --tag go` will get `tag: [php, go]`
+
 ## Install
 
 **composer**
@@ -29,8 +50,12 @@ use Toolkit\PFlag\Flags;
 
 require dirname(__DIR__) . '/test/bootstrap.php';
 
+$flags = $_SERVER['argv'];
+// NOTICE: must shift first element.
+$scriptFile = array_shift($flags);
+
 $fs = Flags::new();
-// with some config
+// can with some config
 $fs->setScriptFile($scriptFile);
 /** @see Flags::$settings */
 $fs->setSettings([
@@ -97,6 +122,8 @@ $fs->addArgument($arg);
 use Toolkit\PFlag\Flags;
 use Toolkit\PFlag\FlagType;
 
+// ...
+
 if (!$fs->parse($flags)) {
     // on render help
     return;

example/flags-demo.php

@@ -8,6 +8,8 @@
  * @license  MIT
  */
 
+use Toolkit\Cli\Cli;
+use Toolkit\PFlag\Exception\FlagException;
 use Toolkit\PFlag\Flag\Argument;
 use Toolkit\PFlag\Flag\Option;
 use Toolkit\PFlag\Flags;
@@ -70,8 +72,24 @@
 $fs->addArgument($arg);
 
 // edump($fs);
-if (!$fs->parse($flags)) {
-    // on render help
+
+// do parsing
+try {
+    if (!$fs->parse($flags)) {
+        // on render help
+        return;
+    }
+} catch (\Throwable $e) {
+    if ($e instanceof FlagException) {
+        Cli::colored('ERROR: ' . $e->getMessage(), 'error');
+    } else {
+        $code = $e->getCode() !== 0 ? $e->getCode() : -1;
+        $eTpl = "Exception(%d): %s\nFile: %s(Line %d)\nTrace:\n%s\n";
+
+        // print exception message
+        printf($eTpl, $code, $e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
+    }
+
     return;
 }
 

example/sflags-demo.php

@@ -8,6 +8,8 @@
  * @license  MIT
  */
 
+use Toolkit\Cli\Cli;
+use Toolkit\PFlag\Exception\FlagException;
 use Toolkit\PFlag\SFlags;
 
 require dirname(__DIR__) . '/test/bootstrap.php';
@@ -38,7 +40,23 @@
 $fs->setOptRules($optRules);
 $fs->setArgRules($argRules);
 
-if (!$fs->parse($flags)) {
+// do parsing
+try {
+    if (!$fs->parse($flags)) {
+        // on render help
+        return;
+    }
+} catch (\Throwable $e) {
+    if ($e instanceof FlagException) {
+        Cli::colored('ERROR: ' . $e->getMessage(), 'error');
+    } else {
+        $code = $e->getCode() !== 0 ? $e->getCode() : -1;
+        $eTpl = "Exception(%d): %s\nFile: %s(Line %d)\nTrace:\n%s\n";
+
+        // print exception message
+        printf($eTpl, $code, $e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
+    }
+
     return;
 }