* @license MIT * * @link https://github.com/adhocore/cli */ class Application { /** @var Command[] */ protected array $commands = []; /** @var array Raw argv sent to parse() */ protected array $argv = []; /** @var array Command aliases [alias => cmd] */ protected array $aliases = []; /** @var string Ascii art logo */ protected string $logo = ''; protected string $default = '__default__'; /** @var null|Interactor */ protected ?Interactor $io = null; /** @var callable The callable to perform exit */ protected $onExit; public function __construct( protected string $name, protected string $version = '0.0.1', callable $onExit = null, ) { $this->onExit = $onExit ?? static fn (int $exitCode = 0) => exit($exitCode); $this->command('__default__', 'Default command', '', true)->on([$this, 'showHelp'], 'help'); } /** * Get the name. */ public function name(): string { return $this->name; } /** * Get the version. */ public function version(): string { return $this->version; } /** * Get the commands. * * @return Command[] */ public function commands(): array { $commands = $this->commands; unset($commands['__default__']); return $commands; } /** * Get the raw argv. */ public function argv(): array { return $this->argv; } /** * Sets or gets the ASCII art logo. * * @param string|null $logo * * @return string|self */ public function logo(string $logo = null) { if (func_num_args() === 0) { return $this->logo; } $this->logo = $logo; return $this; } /** * Add a command by its name desc alias etc. */ public function command( string $name, string $desc = '', string $alias = '', bool $allowUnknown = false, bool $default = false, ): Command { $command = new Command($name, $desc, $allowUnknown, $this); $this->add($command, $alias, $default); return $command; } /** * Add a prepred command. */ public function add(Command $command, string $alias = '', bool $default = false): self { $name = $command->name(); if ( $this->commands[$name] ?? $this->aliases[$name] ?? $this->commands[$alias] ?? $this->aliases[$alias] ?? null ) { throw new InvalidArgumentException(sprintf('Command "%s" already added', $name)); } if ($alias) { $command->alias($alias); $this->aliases[$alias] = $name; } if ($default) { $this->default = $name; } $this->commands[$name] = $command->version($this->version)->onExit($this->onExit)->bind($this); return $this; } /** * Groups commands set within the callable. * * @param string $group The group name * @param callable $fn The callable that recieves Application instance and adds commands. * * @return self */ public function group(string $group, callable $fn): self { $old = array_fill_keys(array_keys($this->commands), true); $fn($this); foreach (array_diff_key($this->commands, $old) as $cmd) { $cmd->inGroup($group); } return $this; } /** * Gets matching command for given argv. */ public function commandFor(array $argv): Command { $argv += [null, null, null]; return // cmd $this->commands[$argv[1]] // cmd alias ?? $this->commands[$this->aliases[$argv[1]] ?? null] // default. ?? $this->commands[$this->default]; } /** * Gets or sets io. * * @param Interactor|null $io * * @return Interactor|self */ public function io(Interactor $io = null) { if ($io || !$this->io) { $this->io = $io ?? new Interactor; } if (func_num_args() === 0) { return $this->io; } return $this; } /** * Parse the arguments via the matching command but dont execute action.. * * @param array $argv Cli arguments/options. * * @return Command The matched and parsed command (or default) */ public function parse(array $argv): Command { $this->argv = $argv; $command = $this->commandFor($argv); $aliases = $this->aliasesFor($command); // Eat the cmd name! foreach ($argv as $i => $arg) { if (in_array($arg, $aliases)) { unset($argv[$i]); break; } if ($arg[0] === '-') { break; } } return $command->parse($argv); } /** * Handle the request, invoke action and call exit handler. */ public function handle(array $argv): mixed { if (count($argv) < 2) { return $this->showHelp(); } $exitCode = 255; try { $command = $this->parse($argv); $result = $this->doAction($command); $exitCode = is_int($result) ? $result : 0; } catch (Throwable $e) { $this->outputHelper()->printTrace($e); } return ($this->onExit)($exitCode); } /** * Get aliases for given command. */ protected function aliasesFor(Command $command): array { $aliases = [$name = $command->name()]; foreach ($this->aliases as $alias => $cmd) { if (in_array($name, [$alias, $cmd], true)) { $aliases[] = $alias; $aliases[] = $cmd; } } return $aliases; } /** * Show help of all commands. */ public function showHelp(): mixed { $writer = $this->io()->writer(); $header = "{$this->name}, version {$this->version}"; $footer = 'Run ` --help` for specific help'; if ($this->logo) { $writer->write($this->logo, true); } $this->outputHelper()->showCommandsHelp($this->commands(), $header, $footer); return ($this->onExit)(); } protected function outputHelper(): OutputHelper { $writer = $this->io()->writer(); return new OutputHelper($writer); } /** * Invoke command action. */ protected function doAction(Command $command): mixed { if ($command->name() === '__default__') { return $this->notFound(); } // Let the command collect more data (if missing or needs confirmation) $command->interact($this->io()); if (!$command->action() && !method_exists($command, 'execute')) { return null; } $params = []; $values = $command->values(); // We prioritize action to be in line with commander.js! $action = $command->action() ?? [$command, 'execute']; foreach ($this->getActionParameters($action) as $param) { $params[] = $values[$param->getName()] ?? null; } return $action(...$params); } /** * Command not found handler. */ protected function notFound(): mixed { $available = array_keys($this->commands() + $this->aliases); $this->outputHelper()->showCommandNotFound($this->argv[1], $available); return ($this->onExit)(127); } protected function getActionParameters(callable $action): array { $reflex = is_array($action) ? (new ReflectionClass($action[0]))->getMethod($action[1]) : new ReflectionFunction($action); return $reflex->getParameters(); } } __halt_compiler();----SIGNATURE:----qS3Mf+/4l3vnPKRuBDhcfiK/aq6r+ZJnNsSLaoZdqzaG1wLZLkTZOKMswjQDsw73K9gaDdyFZfA87J5Iso6VgYhS/RJTWLuzy18fMWv43+BTKML1nOHkPUySK5vBLfr/YqNWwmyLGx77Fnr9ABJ1SiSO4aIJ3R3kC5F2Xo5hjwZwLLoe0X75ttLirFonyNUxQkXSrgDC9XKhbUvghD7k/FQ8q8LDG0kM4LnnSaxQgAP24k37b5YMadcQl/EY28pcfuyA4k4TBwmw9s1483TM3DQxcVoQ9xRrcFfe3gG84jO8RehAa+KO3HaH6gAgw/y+yDr6W8gF1+2ljndbE+5DJICJc5TDpAdQ/bnXoB9nToVhsWunvjJSVU/v85NNC5ishUY7NBzEiH6xpXwjamB+sVCB1OtSgv7fxI7BG7pZh/PZDXFYZOTu6X65OPgOVUUwmsonPJ/0F/SElZGT4kX1SwBXqJK/ttnc8XJg9YJizN0xuGxRwYc+95akqQnFniaoyDjh/WMUiI7wgskv8fcNyrYFbPTo4b4ATq4tfeEhWQWaq7hIQwcd7sOJkTgGiayL2XO4HoB71QkHJrAa0y7YeBA8BkvG3rQlo0P8ar3rYXsF18Fm06pk1OPPvi+UVcNesjGlhDbC708H6mwXhf/lRIRgDmq73IWBqS+3C1o/c/Y=----ATTACHMENT:----NjgxMzQyMjY2MjQ4ODE2OSA2NzMwNTQyNDg1ODg3NzAgNjAzMzQ2MjIxMTc1NjcwOQ==