refactor: use Builder in CLI command

Migrate GenerateCommand to use Builder with withGenerator() hook for
processor/config customization. Add saveAs() to Result for file output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: DerManoMann

src/Builder.php

@@ -64,7 +64,7 @@ public function setLogger(LoggerInterface $logger): static
      * The callable receives a default Generator and may either modify it in-place
      * or return a fully configured instance.
      *
-     * @param callable(Generator): ?Generator $hook
+     * @param callable(Generator): (Generator|void) $hook
      */
     public function withGenerator(callable $hook): static
     {

src/Builder/Result.php

@@ -7,6 +7,7 @@
 namespace OpenApi\Builder;
 
 use OpenApi\Annotations\OpenApi;
+use OpenApi\OpenApiException;
 
 /**
  * Result container for a build operation.
@@ -86,4 +87,17 @@ public function toYaml(int $inline = 10, int $indent = 4): string
 
         return $this->openApi->toYaml();
     }
+
+    public function saveAs(string $filename, string $format = 'auto'): void
+    {
+        if ($format === 'auto') {
+            $format = strtolower(substr($filename, -5)) === '.json' ? 'json' : 'yaml';
+        }
+
+        $content = strtolower($format) === 'json' ? $this->toJson() : $this->toYaml();
+
+        if (file_put_contents($filename, $content) === false) {
+            throw new OpenApiException('Failed to save to "' . $filename . '"');
+        }
+    }
 }

src/Console/GenerateCommand.php

@@ -6,7 +6,8 @@
 
 namespace OpenApi\Console;
 
-use OpenApi\Annotations as OA;
+use OpenApi\Builder;
+use OpenApi\Builder\Result;
 use OpenApi\Generator;
 use OpenApi\Utils\SourceFinder;
 use Symfony\Component\Console\Attribute\AsCommand;
@@ -45,50 +46,61 @@ public function __invoke(#[MapInput] GenerateInput $input, SymfonyStyle $io): in
             return 0;
         }
 
-        $openapi = $this->generate($input);
+        $result = $this->generate($input);
 
         if (!$input->output) {
             if ($input->format->isJson()) {
-                echo $openapi->toJson();
+                echo $result->toJson();
             } else {
-                echo $openapi->toYaml();
+                echo $result->toYaml();
             }
             echo "\n";
         } else {
             $outputPath = $input->output;
             if (is_dir($outputPath)) {
                 $outputPath .= '/openapi.yaml';
             }
-            $openapi->saveAs($outputPath, $input->format->value);
+            $result->saveAs($outputPath, $input->format->value);
         }
 
         return $this->logger->hasErrored() ? 1 : 0;
     }
 
-    private function generate(GenerateInput $input): OA\OpenApi
+    protected function generate(GenerateInput $input): Result
     {
-        $generator = new Generator($this->logger);
-
-        foreach ($input->addProcessor as $processor) {
-            $class = '\OpenApi\Processors\\' . ucfirst((string) $processor);
-            if (class_exists($class)) {
-                $processor = new $class();
-            } elseif (class_exists($processor)) {
-                $processor = new $processor();
-            }
-            $generator->getProcessorPipeline()->add($processor);
+        $builder = (new Builder())
+            ->addSource(new SourceFinder($input->paths, $input->exclude, $input->pattern))
+            ->setLogger($this->logger);
+
+        if ($input->version !== null) {
+            $builder->setVersion($input->version);
         }
 
-        foreach ($input->removeProcessor as $processor) {
-            $class = class_exists($processor)
-                ? $processor
-                : '\OpenApi\Processors\\' . ucfirst((string) $processor);
-            $generator->getProcessorPipeline()->remove($class);
+        if ($input->config || $input->addProcessor || $input->removeProcessor) {
+            $builder->withGenerator(function (Generator $generator) use ($input): void {
+                if ($input->config) {
+                    $generator->setConfig($input->config);
+                }
+
+                foreach ($input->addProcessor as $processor) {
+                    $class = '\OpenApi\Processors\\' . ucfirst((string) $processor);
+                    if (class_exists($class)) {
+                        $processor = new $class();
+                    } elseif (class_exists($processor)) {
+                        $processor = new $processor();
+                    }
+                    $generator->getProcessorPipeline()->add($processor);
+                }
+
+                foreach ($input->removeProcessor as $processor) {
+                    $class = class_exists($processor)
+                        ? $processor
+                        : '\OpenApi\Processors\\' . ucfirst((string) $processor);
+                    $generator->getProcessorPipeline()->remove($class);
+                }
+            });
         }
 
-        return $generator
-            ->setVersion($input->version)
-            ->setConfig($input->config)
-            ->generate(new SourceFinder($input->paths, $input->exclude, $input->pattern));
+        return $builder->build();
     }
 }