3 namespace pharext\Cli\Args
;
11 function __construct($prog, Args
$args) {
16 function __toString() {
17 $usage = "Usage:\n\n \$ ";
18 $usage .= $this->prog
;
20 list($flags, $required, $optional, $positional) = $this->listSpec();
22 $usage .= $this->dumpFlags($flags);
25 $usage .= $this->dumpRequired($required);
28 $usage .= $this->dumpOptional($optional);
31 $usage .= $this->dumpPositional($positional);
34 $help = $this->dumpHelp($positional);
36 return $usage . "\n\n" . $help . "\n";
44 foreach ($this->args
->getSpec() as $spec) {
45 if (is_numeric($spec[0])) {
46 $positional[] = $spec;
47 } elseif ($spec[3] & Args
::REQUIRED
) {
49 } elseif ($spec[3] & (Args
::OPTARG|Args
::REQARG
)) {
56 return [$flags, $required, $optional, $positional]
57 +
compact("flags", "required", "optional", "positional");
60 function dumpFlags(array $flags) {
61 return sprintf(" [-%s]", implode("", array_column($flags, 0)));
64 function dumpRequired(array $required) {
66 foreach ($required as $req) {
67 $dump .= sprintf(" -%s <%s>", $req[0], $req[1]);
72 function dumpOptional(array $optional) {
73 $req = array_filter($optional, function($a) {
74 return $a[3] & Args
::REQARG
;
76 $opt = array_filter($optional, function($a) {
77 return $a[3] & Args
::OPTARG
;
82 $dump .= sprintf(" [-%s <arg>]", implode("|-", array_column($req, 0)));
85 $dump .= sprintf(" [-%s [<arg>]]", implode("|-", array_column($opt, 0)));
90 function dumpPositional(array $positional) {
93 foreach ($positional as $pos) {
94 $conv[$pos[0]][] = $pos;
97 foreach ($conv as $positional) {
98 $args = implode("|", array_column($positional, 1));
99 if ($positional[0][3] & Args
::REQUIRED
) {
100 $dump .= sprintf(" <%s>", $args);
102 $dump .= sprintf(" [<%s>]", $args);
104 if ($positional[0][3] & Args
::MULTI
) {
105 $dump .= sprintf(" [<%s>]...", $args);
108 foreach ($positional as $pos) {
109 if ($pos[3] & Args::REQUIRED) {
110 $dump .= sprintf(" <%s>", $pos[1]);
113 //$dump .= sprintf(" [<%s>]", $pos[1]);
115 if ($pos[3] & Args::MULTI) {
116 $dump .= sprintf(" [<%s>]...", $pos[1]);
124 function calcMaxLen() {
125 $spc = $this->args
->getSpec();
126 $max = max(array_map("strlen", array_column($spc, 1)));
127 $max +
= $max %
8 +
2;
131 function dumpHelp() {
132 $max = $this->calcMaxLen();
134 foreach ($this->args
->getSpec() as $spec) {
136 if (is_numeric($spec[0])) {
137 $dump .= sprintf("-- %s ", $spec[1]);
138 } elseif (isset($spec[0])) {
139 $dump .= sprintf("-%s|", $spec[0]);
141 if (!is_numeric($spec[0])) {
142 $dump .= sprintf("--%s ", $spec[1]);
144 if ($spec[3] & Args
::REQARG
) {
146 } elseif ($spec[3] & Args
::OPTARG
) {
152 $space = str_repeat(" ", $max-strlen($spec[1])+
3*!isset($spec[0]));
154 $dump .= str_replace("\n", "\n $space", $spec[2]);
156 if ($spec[3] & Args
::REQUIRED
) {
157 $dump .= " (REQUIRED)";
159 if ($spec[3] & Args
::MULTI
) {
160 $dump .= " (MULTIPLE)";
162 if (isset($spec[4])) {
163 $dump .= sprintf(" [%s]", $spec[4]);