feat: add new common methods getOptDefine

Author: inhere

src/Contract/ParserInterface.php

@@ -9,6 +9,8 @@
 
 namespace Toolkit\PFlag\Contract;
 
+use Toolkit\PFlag\FlagsParser;
+
 /**
  * interface ParserInterface
  */
@@ -127,6 +129,14 @@ public function hasInputOpt(string $name): bool;
      */
     public function getOpt(string $name, $default = null);
 
+    /**
+     * @param string $name
+     *
+     * @return array
+     * @see FlagsParser::DEFINE_ITEM
+     */
+    public function getOptDefine(string $name): array;
+
     /**
      * Set option value, will format and validate value.
      *
@@ -173,6 +183,7 @@ public function getArgIndex($nameOrIndex): int;
      * @param string|int $nameOrIndex
      *
      * @return array
+     * @see FlagsParser::DEFINE_ITEM
      */
     public function getArgDefine($nameOrIndex): array;
 
@@ -231,12 +242,13 @@ public function getArgsHelpData(): array;
      */
     public function getOptsHelpData(): array;
 
+    public function lock(): void;
+
+    public function unlock(): void;
+
     /**
      * @return bool
      */
     public function isLocked(): bool;
 
-    public function lock(): void;
-
-    public function unlock(): void;
 }

src/Flags.php

@@ -867,7 +867,7 @@ public function hasOpt(string $name): bool
      */
     public function getOpt(string $name, $default = null)
     {
-        $opt = $this->getDefinedOption($name);
+        $opt = $this->getOption($name);
         if (!$opt) { // not exist
             throw new FlagException("flag option '$name' is undefined");
         }
@@ -899,7 +899,7 @@ public function setOpt(string $name, $value): void
      */
     public function setTrustedOpt(string $name, $value): void
     {
-        $opt = $this->getDefinedOption($name);
+        $opt = $this->getOption($name);
         if (!$opt) { // not exist option
             throw new FlagException("flag option '$name' is undefined");
         }
@@ -917,6 +917,21 @@ public function getOption(string $name): ?Option
         return $this->options[$name] ?? null;
     }
 
+    /**
+     * @param string $name
+     *
+     * @return array
+     */
+    public function getOptDefine(string $name): array
+    {
+        $opt = $this->getOption($name);
+        if (!$opt) { // not exist option
+            throw new FlagException("flag option '$name' is undefined");
+        }
+
+        return $opt->toArray();
+    }
+
     /**
      * @param string $name
      *

src/SFlags.php

@@ -813,6 +813,21 @@ public function getOpt(string $name, $default = null)
         return $default ?? FlagType::getDefault($define['type']);
     }
 
+    /**
+     * @param string $name
+     *
+     * @return array
+     */
+    public function getOptDefine(string $name): array
+    {
+        $define = $this->optDefines[$name] ?? [];
+        if (!$define) { // not exist
+            throw new FlagException("flag option '$name' is undefined");
+        }
+
+        return $define;
+    }
+
     /**
      * @param string $name
      * @param mixed $value