feat(console): add make:config command (tempestphp#863)

src/Tempest/Console/src/Commands/MakeConfigCommand.php

@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Commands;
+
+use InvalidArgumentException;
+use Tempest\Console\ConsoleArgument;
+use Tempest\Console\ConsoleCommand;
+use Tempest\Console\Enums\ConfigType;
+use Tempest\Core\PublishesFiles;
+use Tempest\Generation\DataObjects\StubFile;
+use Tempest\Generation\Exceptions\FileGenerationAbortedException;
+use Tempest\Generation\Exceptions\FileGenerationFailedException;
+use function Tempest\Support\str;
+
+final class MakeConfigCommand
+{
+    use PublishesFiles;
+
+    #[ConsoleCommand(
+        name: 'make:config',
+        description: 'Creates a new config class',
+        aliases: ['config:make', 'config:create', 'create:config'],
+    )]
+    public function __invoke(
+        #[ConsoleArgument(
+            name: 'type',
+            help: 'The type of the config to create',
+        )]
+        ConfigType $configType,
+    ): void {
+        try {
+            $stubFile = $this->getStubFileFromConfigType($configType);
+            $suggestedPath = str($this->getSuggestedPath('Dummy'))
+                ->replace('Dummy', $configType->value . '.config')
+                ->toString();
+            $targetPath = $this->promptTargetPath($suggestedPath);
+            $shouldOverride = $this->askForOverride($targetPath);
+
+            $this->stubFileGenerator->generateRawFile(
+                stubFile: $stubFile,
+                targetPath: $targetPath,
+                shouldOverride: $shouldOverride,
+            );
+
+            $this->success(sprintf('Middleware successfully created at "%s".', $targetPath));
+        } catch (FileGenerationAbortedException|FileGenerationFailedException|InvalidArgumentException $e) {
+            $this->error($e->getMessage());
+        }
+    }
+
+    private function getStubFileFromConfigType(ConfigType $configType): StubFile
+    {
+        try {
+            $stubPath = dirname(__DIR__) . '/Stubs';
+
+            return match ($configType) {
+                ConfigType::CONSOLE => StubFile::from($stubPath . '/console.config.stub.php'),
+                ConfigType::CACHE => StubFile::from($stubPath . '/cache.config.stub.php'),
+                ConfigType::LOG => StubFile::from($stubPath . '/log.config.stub.php'),
+                ConfigType::COMMAND_BUS => StubFile::from($stubPath . '/command-bus.config.stub.php'),
+                ConfigType::EVENT_BUS => StubFile::from($stubPath . '/event-bus.config.stub.php'),
+                ConfigType::VIEW => StubFile::from($stubPath . '/view.config.stub.php'),
+                ConfigType::BLADE => StubFile::from($stubPath . '/blade.config.stub.php'),
+                ConfigType::TWIG => StubFile::from($stubPath . '/twig.config.stub.php'),
+                ConfigType::DATABASE => StubFile::from($stubPath . '/database.config.stub.php'), // @phpstan-ignore match.alwaysTrue (Because this is a guardrail for the future implementations)
+                default => throw new InvalidArgumentException(sprintf('The "%s" config type has no supported stub file.', $configType->value)),
+            };
+        } catch (InvalidArgumentException $invalidArgumentException) {
+            throw new FileGenerationFailedException(sprintf('Cannot retrieve stub file: %s', $invalidArgumentException->getMessage()));
+        }
+    }
+}

src/Tempest/Console/src/Enums/ConfigType.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Console\Enums;
+
+/**
+ * Represents available config types in Tempest.
+ */
+enum ConfigType: string
+{
+    case DATABASE = 'database';
+    case TWIG = 'twig';
+    case BLADE = 'blade';
+    case VIEW = 'view';
+    case EVENT_BUS = 'event-bus';
+    case COMMAND_BUS = 'command-bus';
+    case LOG = 'log';
+    case CACHE = 'cache';
+    case CONSOLE = 'console';
+}

src/Tempest/Console/src/Stubs/blade.config.stub.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\View\Renderers\BladeConfig;
+
+return new BladeConfig(
+    viewPaths: [
+        __DIR__ . '/../views/',
+    ],
+    cachePath: __DIR__ . '/../views/cache/',
+);

src/Tempest/Console/src/Stubs/cache.config.stub.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+use Symfony\Component\Cache\Adapter\FilesystemAdapter;
+use Tempest\Cache\CacheConfig;
+
+return new CacheConfig(
+    projectCachePool: new FilesystemAdapter(
+        directory: __DIR__ . '/../../../../.cache',
+    ),
+);

src/Tempest/Console/src/Stubs/command-bus.config.stub.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\CommandBus\CommandBusConfig;
+
+return new CommandBusConfig(
+    middleware: [
+        // Add your command bus middleware here.
+    ],
+);

src/Tempest/Console/src/Stubs/console.config.stub.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\Console\ConsoleConfig;
+use Tempest\Console\Middleware\ConsoleExceptionMiddleware;
+use Tempest\Console\Middleware\HelpMiddleware;
+use Tempest\Console\Middleware\InvalidCommandMiddleware;
+use Tempest\Console\Middleware\OverviewMiddleware;
+use Tempest\Console\Middleware\ResolveOrRescueMiddleware;
+
+return new ConsoleConfig(
+    name: 'Console Name',
+    middleware: [
+        OverviewMiddleware::class,
+        ConsoleExceptionMiddleware::class,
+        ResolveOrRescueMiddleware::class,
+        InvalidCommandMiddleware::class,
+        HelpMiddleware::class,
+    ],
+);

src/Tempest/Console/src/Stubs/database.config.stub.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\Database\Connections\MySqlConnection;
+use Tempest\Database\DatabaseConfig;
+use function Tempest\env;
+
+return new DatabaseConfig(
+    connection: new MySqlConnection(
+        host: env('DB_HOST'),
+        port: env('DB_PORT'),
+        username: env('DB_USERNAME'),
+        password: env('DB_PASSWORD'),
+        database: env('DB_DATABASE'),
+    ),
+);

src/Tempest/Console/src/Stubs/event-bus.config.stub.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\EventBus\EventBusConfig;
+
+return new EventBusConfig(
+    middleware: [
+        // Add your event bus middleware here.
+    ],
+);

src/Tempest/Console/src/Stubs/log.config.stub.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\Log\Channels\AppendLogChannel;
+use Tempest\Log\LogConfig;
+
+return new LogConfig(
+    channels: [
+        new AppendLogChannel(
+            path: __DIR__ . '/../logs/project.log',
+        ),
+    ],
+    serverLogPath: '/path/to/nginx.log',
+);

src/Tempest/Console/src/Stubs/twig.config.stub.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\View\Renderers\TwigConfig;
+
+return new TwigConfig(
+    viewPaths: [
+        __DIR__ . '/../views/',
+    ],
+    cachePath: __DIR__ . '/../views/cache/',
+);

src/Tempest/Console/src/Stubs/view.config.stub.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+use Tempest\View\Renderers\TwigViewRenderer;
+use Tempest\View\ViewConfig;
+
+return new ViewConfig(
+    rendererClass: TwigViewRenderer::class,
+);

src/Tempest/Database/src/Builder/ModelQueryBuilder.php

@@ -71,7 +71,7 @@ public function all(mixed ...$bindings): array
     }
 
     /**
-     * @param \Closure(TModelClass[] $models): void $closure
+     * @param Closure(TModelClass[] $models): void $closure
      */
     public function chunk(Closure $closure, int $amountPerChunk = 200): void
     {

src/Tempest/Database/src/QueryStatements/AlterTableStatement.php

@@ -17,7 +17,8 @@ public function __construct(
         private readonly string $tableName,
         private array $statements = [],
         private array $createIndexStatements = [],
-    ) {}
+    ) {
+    }
 
     /** @param class-string<\Tempest\Database\DatabaseModel> $modelClass */
     public static function forModel(string $modelClass): self

src/Tempest/Database/src/QueryStatements/CreateTableStatement.php

@@ -17,7 +17,8 @@ public function __construct(
         private readonly string $tableName,
         private array $statements = [],
         private array $indexStatements = [],
-    ) {}
+    ) {
+    }
 
     /** @param class-string<\Tempest\Database\DatabaseModel> $modelClass */
     public static function forModel(string $modelClass): self
@@ -38,8 +39,7 @@ public function belongsTo(
         OnDelete $onDelete = OnDelete::RESTRICT,
         OnUpdate $onUpdate = OnUpdate::NO_ACTION,
         bool $nullable = false,
-    ): self
-    {
+    ): self {
         [$localTable, $localKey] = explode('.', $local);
 
         $this->integer($localKey, nullable: $nullable);
@@ -58,8 +58,7 @@ public function text(
         string $name,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new TextStatement(
             name: $name,
             nullable: $nullable,
@@ -74,8 +73,7 @@ public function varchar(
         int $length = 255,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new VarcharStatement(
             name: $name,
             size: $length,
@@ -90,8 +88,7 @@ public function char(
         string $name,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new CharStatement(
             name: $name,
             nullable: $nullable,
@@ -106,8 +103,7 @@ public function integer(
         bool $unsigned = false,
         bool $nullable = false,
         ?int $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new IntegerStatement(
             name: $name,
             unsigned: $unsigned,
@@ -122,8 +118,7 @@ public function float(
         string $name,
         bool $nullable = false,
         ?float $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new FloatStatement(
             name: $name,
             nullable: $nullable,
@@ -137,8 +132,7 @@ public function datetime(
         string $name,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new DatetimeStatement(
             name: $name,
             nullable: $nullable,
@@ -152,8 +146,7 @@ public function date(
         string $name,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new DateStatement(
             name: $name,
             nullable: $nullable,
@@ -167,8 +160,7 @@ public function boolean(
         string $name,
         bool $nullable = false,
         ?bool $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new BooleanStatement(
             name: $name,
             nullable: $nullable,
@@ -182,8 +174,7 @@ public function json(
         string $name,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new JsonStatement(
             name: $name,
             nullable: $nullable,
@@ -198,8 +189,7 @@ public function set(
         array $values,
         bool $nullable = false,
         ?string $default = null,
-    ): self
-    {
+    ): self {
         $this->statements[] = new SetStatement(
             name: $name,
             values: $values,

src/Tempest/Generation/src/DataObjects/StubFile.php

@@ -4,8 +4,9 @@
 
 namespace Tempest\Generation\DataObjects;
 
-use Exception;
+use InvalidArgumentException;
 use Nette\InvalidStateException;
+use ReflectionException;
 use Tempest\Generation\ClassManipulator;
 use Tempest\Generation\Enums\StubFileType;
 
@@ -32,9 +33,9 @@ public static function from(string $pathOrClass): self
                 filePath: $pathOrClass,
                 type: StubFileType::CLASS_FILE,
             );
-        } catch (InvalidStateException) {
+        } catch (InvalidStateException|ReflectionException) {
             if (! file_exists($pathOrClass)) {
-                throw new Exception(sprintf('The file "%s" does not exist.', $pathOrClass));
+                throw new InvalidArgumentException(sprintf('The file "%s" does not exist.', $pathOrClass));
             }
 
             return new self(