feat(generator/console): add make:controller, make:model commands and the generator attribute

composer.json

@@ -150,5 +150,10 @@
             "composer phpunit",
             "composer phpstan"
         ]
+    },
+    "config": {
+        "allow-plugins": {
+            "php-http/discovery": true
+        }
     }
 }

phpstan.neon.dist

@@ -1,39 +1,42 @@
 includes:
-	- phpstan-baseline.neon
-	- vendor/phpat/phpat/extension.neon
-	- vendor/spaze/phpstan-disallowed-calls/extension.neon
+    - phpstan-baseline.neon
+    - vendor/phpat/phpat/extension.neon
+    - vendor/spaze/phpstan-disallowed-calls/extension.neon
 services:
-	-
-		class: Tests\Tempest\Architecture\ArchitectureTestCase
-		tags:
-			- phpat.test
+    -
+        class: Tests\Tempest\Architecture\ArchitectureTestCase
+        tags:
+            - phpat.test
 parameters:
-	level: 5
-	tmpDir: .cache/phpstan
-	excludePaths:
-	    - tests/Integration/View/blade/cache/**.php
-	paths:
-		- src
-		- tests
-	ignoreErrors:
+    level: 5
+    tmpDir: .cache/phpstan
+    excludePaths:
+        - tests/Integration/View/blade/cache/**.php
+    paths:
+        - src
+        - tests
+    ignoreErrors:
 
-		-
-			message: '#.*#'
-			path: src/Tempest/Http/src/Exceptions/exception.php
-		-
-		    message: '#.*exec*#'
-		    path: src/Tempest/Console/src/Terminal/Terminal.php
+        -
+            message: '#.*#'
+            path: src/Tempest/Http/src/Exceptions/exception.php
+        -
+            message: '#.*exec*#'
+            path: src/Tempest/Console/src/Terminal/Terminal.php
+        -
+            message: "#^Tempest\\\\Console\\\\ConsoleCommand should be final$#"
+            path: src/Tempest/Console/src/ConsoleCommand.php
 
-	disallowedFunctionCalls:
-		-
-			function: 'exec()'
-		-
-			function: 'eval()'
-		-
-			function: 'dd()'
-		-
-			function: 'dump()'
-		-
-			function: 'phpinfo()'
-		-
-			function: 'var_dump()'
+    disallowedFunctionCalls:
+        -
+            function: 'exec()'
+        -
+            function: 'eval()'
+        -
+            function: 'dd()'
+        -
+            function: 'dump()'
+        -
+            function: 'phpinfo()'
+        -
+            function: 'var_dump()'

src/Tempest/Console/src/Actions/ExecuteConsoleCommand.php

@@ -5,12 +5,15 @@
 namespace Tempest\Console\Actions;
 
 use Closure;
+use RuntimeException;
 use Tempest\Console\ConsoleConfig;
 use Tempest\Console\ConsoleInputBuilder;
 use Tempest\Console\ExitCode;
+use Tempest\Console\GeneratorCommand;
 use Tempest\Console\Initializers\Invocation;
 use Tempest\Console\Input\ConsoleArgumentBag;
 use Tempest\Container\Container;
+use Tempest\Reflection\MethodReflector;
 
 final readonly class ExecuteConsoleCommand
 {
@@ -36,17 +39,19 @@ private function getCallable(array $commandMiddleware): Closure
     {
         $callable = function (Invocation $invocation) {
             $consoleCommand = $invocation->consoleCommand;
-
-            $handler = $consoleCommand->handler;
-
-            $consoleCommandClass = $this->container->get($handler->getDeclaringClass()->getName());
-
             $inputBuilder = new ConsoleInputBuilder($consoleCommand, $invocation->argumentBag);
-
-            $consoleCommand->handler->invokeArgs(
-                $consoleCommandClass,
-                $inputBuilder->build(),
-            );
+            $handler = ($consoleCommand instanceof GeneratorCommand)
+                ? $consoleCommand->makeHandler()
+                : $consoleCommand->handler;
+
+            match (true) {
+                is_callable($handler) => $handler($inputBuilder->build()),
+                ($handler instanceof MethodReflector) => $handler->invokeArgs(
+                    $this->container->get($handler->getDeclaringClass()->getName()),
+                    $inputBuilder->build()
+                ),
+                default => throw new RuntimeException('Command handler cannot be resolved.'), // @phpstan-ignore-line
+            };
 
             return ExitCode::SUCCESS;
         };

src/Tempest/Console/src/Commands/Generators/MakeControllerCommand.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Commands\Generators;
+
+use Tempest\Console\ConsoleArgument;
+use Tempest\Console\GeneratorCommand;
+use Tempest\Console\Stubs\ControllerStub;
+use Tempest\Generation\HasGeneratorCommand;
+use Tempest\Generation\StubFileGenerator;
+
+final class MakeControllerCommand
+{
+    use HasGeneratorCommand;
+
+    #[GeneratorCommand(
+        name       : 'make:controller',
+        description: 'Create a new controller class with a basic route',
+        aliases    : ['controller:make', 'controller:create', 'create:controller'],
+    )]
+    public function __invoke(
+        #[ConsoleArgument(
+            help: 'The name of the controller class to create ( "Controller" will be suffixed )',
+        )]
+        string $className,
+        ?string $controllerPath = null,
+        ?string $controllerView = null,
+    ): StubFileGenerator {
+        $suggestedPath = $this->getSuggestedPath(
+            className  : $className,
+            pathPrefix : 'Controllers',
+            classSuffix: 'Controller',
+        );
+        $targetPath = $this->promptTargetPath($suggestedPath);
+        $shouldOverride = $this->askForOverride($targetPath);
+
+        return new StubFileGenerator(
+            stubFile      : ControllerStub::class,
+            targetPath    : $targetPath,
+            shouldOverride: $shouldOverride,
+            replacements  : [
+                'dummy-path' => $controllerPath,
+                'dummy-view' => $controllerView,
+            ],
+        );
+    }
+}

src/Tempest/Console/src/Commands/Generators/MakeModelCommand.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Commands\Generators;
+
+use Tempest\Console\ConsoleArgument;
+use Tempest\Console\GeneratorCommand;
+use Tempest\Console\Stubs\DatabaseModelStub;
+use Tempest\Console\Stubs\ModelStub;
+use Tempest\Generation\HasGeneratorCommand;
+use Tempest\Generation\StubFileGenerator;
+
+final class MakeModelCommand
+{
+    use HasGeneratorCommand;
+
+    #[GeneratorCommand(
+        name       : 'make:model',
+        description: 'Create a new model class',
+        aliases    : ['model:make', 'model:create', 'create:model'],
+    )]
+    public function __invoke(
+        #[ConsoleArgument(
+            help: 'The name of the model class to create ( "Model" will be suffixed )',
+        )]
+        string $className,
+        #[ConsoleArgument(
+            help: 'Whether the model is a database model',
+        )]
+        bool $isDatabaseModel = false,
+    ): StubFileGenerator {
+        $suggestedPath = $this->getSuggestedPath(
+            className  : $className,
+            pathPrefix : 'Models',
+            classSuffix: 'Model',
+        );
+        $targetPath = $this->promptTargetPath($suggestedPath);
+        $shouldOverride = $this->askForOverride($targetPath);
+
+        return new StubFileGenerator(
+            stubFile      : $isDatabaseModel ? DatabaseModelStub::class : ModelStub::class,
+            targetPath    : $targetPath,
+            shouldOverride: $shouldOverride,
+        );
+    }
+}

src/Tempest/Console/src/ConsoleCommand.php

@@ -9,7 +9,7 @@
 use Tempest\Reflection\MethodReflector;
 
 #[Attribute]
-final class ConsoleCommand
+class ConsoleCommand
 {
     public MethodReflector $handler;
 

src/Tempest/Console/src/Discovery/ConsoleCommandDiscovery.php

@@ -6,6 +6,7 @@
 
 use Tempest\Console\ConsoleCommand;
 use Tempest\Console\ConsoleConfig;
+use Tempest\Console\GeneratorCommand;
 use Tempest\Container\Container;
 use Tempest\Core\Discovery;
 use Tempest\Core\HandlesDiscoveryCache;
@@ -41,7 +42,7 @@ public function createCachePayload(): string
 
     public function restoreCachePayload(Container $container, string $payload): void
     {
-        $commands = unserialize($payload, ['allowed_classes' => [ConsoleCommand::class, MethodReflector::class]]);
+        $commands = unserialize($payload, ['allowed_classes' => [GeneratorCommand::class, ConsoleCommand::class, MethodReflector::class]]);
 
         $this->consoleConfig->commands = $commands;
     }

src/Tempest/Console/src/GeneratorCommand.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console;
+
+use Attribute;
+use Closure;
+use Tempest\Generation\StubFileGenerator;
+use function Tempest\get;
+use function Tempest\Support\arr;
+
+/**
+ * Defines a console command that is specifically for generating files.
+ */
+#[Attribute(Attribute::TARGET_METHOD)]
+final class GeneratorCommand extends ConsoleCommand
+{
+    /**
+     * Make the handler for the given command.
+     * This allow the console to run this handler without altering the command structure.
+     *
+     * @return Closure(array<mixed> $params) The command handler.
+     */
+    public function makeHandler(): Closure
+    {
+        return function (array $params): void {
+            // Resolve all generators and run them.
+            arr(
+                $this->handler->invokeArgs(
+                    get($this->handler->getDeclaringClass()->getName()),
+                    $params
+                )
+            )
+                ->filter(fn ($generator) => $generator instanceof StubFileGenerator)
+                ->each(fn (StubFileGenerator $generator) => $generator->generate());
+        };
+    }
+}

src/Tempest/Console/src/Stubs/ControllerStub.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Stubs;
+
+use Tempest\Http\Get;
+use function Tempest\view;
+use Tempest\View\View;
+
+final class ControllerStub
+{
+    #[Get(uri: '/dummy-path')]
+    public function __invoke(): View
+    {
+        return view('dummy-view');
+    }
+}

src/Tempest/Console/src/Stubs/DatabaseModelStub.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Stubs;
+
+use Tempest\Database\DatabaseModel;
+use Tempest\Database\IsDatabaseModel;
+use Tempest\Validation\Rules\Length;
+
+final class DatabaseModelStub implements DatabaseModel
+{
+    use IsDatabaseModel;
+
+    public function __construct(
+        #[Length(min: 1, max: 120)]
+        public string $title
+    ) {
+    }
+}

src/Tempest/Console/src/Stubs/ModelStub.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Stubs;
+
+use Tempest\Validation\Rules\Length;
+
+final class ModelStub
+{
+    public function __construct(
+        #[Length(min: 1, max: 120)]
+        public string $title
+    ) {
+    }
+}

src/Tempest/Database/src/Migrations/CreateMigrationsTable.php

@@ -4,12 +4,14 @@
 
 namespace Tempest\Database\Migrations;
 
+use Tempest\Core\DoNotDiscover;
 use Tempest\Database\Migration;
 use Tempest\Database\Migrations\Migration as Model;
 use Tempest\Database\QueryStatement;
 use Tempest\Database\QueryStatements\CreateTableStatement;
 use Tempest\Database\QueryStatements\DropTableStatement;
 
+#[DoNotDiscover]
 final readonly class CreateMigrationsTable implements Migration
 {
     public function getName(): string