Split detail page contracts

2026-03-19 19:04:28 +01:00
parent f6046c9168
commit 522705dd33
21 changed files with 729 additions and 121 deletions
--- a/lib/Console/ConsoleApplication.php
+++ b/lib/Console/ConsoleApplication.php
@@ -0,0 +1,94 @@
+<?php
+
+namespace MintyPHP\Console;
+
+/**
+ * Minimal CLI command dispatcher.
+ *
+ * Parses argv into command name, positional args, and --options,
+ * then dispatches to the matching registered Command instance.
+ */
+final class ConsoleApplication
+{
+    /** @var array<string, Command> */
+    private array $commands = [];
+
+    public function register(Command $command): void
+    {
+        $this->commands[$command->name()] = $command;
+    }
+
+    /**
+     * @param list<string> $argv Raw CLI arguments (including script name at [0])
+     */
+    public function run(array $argv): int
+    {
+        $commandName = $argv[1] ?? '';
+
+        if ($commandName === '' || $commandName === 'list' || $commandName === '--help') {
+            $this->printCommandList();
+            return 0;
+        }
+
+        if (!isset($this->commands[$commandName])) {
+            fwrite(STDERR, "Unknown command: {$commandName}\n\n");
+            $this->printCommandList();
+            return 1;
+        }
+
+        [$args, $options] = self::parseArgv(array_slice($argv, 2));
+
+        return $this->commands[$commandName]->execute($args, $options);
+    }
+
+    private function printCommandList(): void
+    {
+        fwrite(STDOUT, "Usage: php bin/console <command> [arguments] [options]\n\n");
+        fwrite(STDOUT, "Available commands:\n");
+
+        // Group by namespace prefix
+        $grouped = [];
+        foreach ($this->commands as $name => $command) {
+            $parts = explode(':', $name, 2);
+            $group = count($parts) === 2 ? $parts[0] : '';
+            $grouped[$group][$name] = $command->description();
+        }
+        ksort($grouped);
+
+        foreach ($grouped as $group => $commands) {
+            if ($group !== '') {
+                fwrite(STDOUT, " {$group}\n");
+            }
+            ksort($commands);
+            foreach ($commands as $name => $description) {
+                fwrite(STDOUT, sprintf("  %-30s %s\n", $name, $description));
+            }
+        }
+    }
+
+    /**
+     * @param list<string> $tokens
+     * @return array{list<string>, array<string, string|bool>}
+     */
+    private static function parseArgv(array $tokens): array
+    {
+        $args = [];
+        $options = [];
+
+        foreach ($tokens as $token) {
+            if (str_starts_with($token, '--')) {
+                $option = substr($token, 2);
+                if (str_contains($option, '=')) {
+                    [$key, $value] = explode('=', $option, 2);
+                    $options[$key] = $value;
+                } else {
+                    $options[$option] = true;
+                }
+            } else {
+                $args[] = $token;
+            }
+        }
+
+        return [$args, $options];
+    }
+}