feat(documentator): Command lara-asp-documentator:preprocess to pre…

…process Markdown files.

packages/documentator/composer.json

@@ -23,6 +23,7 @@
     "composer/semver": "^3.2",
     "laravel/framework": "^9.21.0|^10.0.0",
     "symfony/filesystem": "^6.3.0",
+    "symfony/finder": "^6.3.0",
     "symfony/process": "^6.3.0",
     "lastdragon-ru/lara-asp-core": "self.version",
     "lastdragon-ru/lara-asp-serializer": "self.version"

packages/documentator/src/Commands/Preprocess.php

@@ -0,0 +1,55 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\Documentator\Commands;
+
+use Illuminate\Console\Command;
+use LastDragon_ru\LaraASP\Core\Utils\Cast;
+use LastDragon_ru\LaraASP\Documentator\Package;
+use LastDragon_ru\LaraASP\Documentator\Preprocessor\Preprocessor;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Finder\Finder;
+
+use function file_put_contents;
+use function getcwd;
+
+#[AsCommand(name: Preprocess::Name)]
+class Preprocess extends Command {
+    public const Name = Package::Name.':preprocess';
+
+    /**
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.PropertyTypeHint.MissingNativeTypeHint
+     * @var string|null
+     */
+    public $description = 'Preprocess Markdown files.';
+
+    /**
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.PropertyTypeHint.MissingNativeTypeHint
+     * @var string
+     */
+    public $signature = self::Name.<<<'SIGNATURE'
+        {path? : directory to process}
+    SIGNATURE;
+
+    public function __invoke(Preprocessor $preprocessor): void {
+        $cwd    = getcwd();
+        $path   = Cast::toString($this->argument('path') ?? $cwd);
+        $finder = Finder::create()
+            ->ignoreVCSIgnored(true)
+            ->in($path)
+            ->exclude('vendor')
+            ->exclude('node_modules')
+            ->files()
+            ->name('*.md');
+
+        foreach ($finder as $file) {
+            $this->components->task($file->getPathname(), static function () use ($preprocessor, $file): bool {
+                $path    = $file->getPath();
+                $content = $file->getContents();
+                $result  = $preprocessor->process($path, $content);
+
+                return $content === $result
+                    || file_put_contents($file->getPathname(), $result) !== false;
+            });
+        }
+    }
+}

packages/documentator/src/Provider.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Support\ServiceProvider;
 use LastDragon_ru\LaraASP\Core\Concerns\ProviderWithViews;
+use LastDragon_ru\LaraASP\Documentator\Commands\Preprocess;
 use LastDragon_ru\LaraASP\Documentator\Commands\Requirements;
 
 class Provider extends ServiceProvider {
@@ -13,6 +14,7 @@ public function boot(): void {
         $this->bootViews();
         $this->commands(
             Requirements::class,
+            Preprocess::class,
         );
     }