Th3Mouk / OpenAPIGenerator

Command/GenerateCommand.php

<?php

declare(strict_types=1);

namespace Th3Mouk\OpenAPIGenerator\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Finder\Finder;
use Symfony\Component\Yaml\Yaml;
use Th3Mouk\OpenAPIGenerator\PathHelper;
use Traversable;

final class GenerateCommand extends Command
{
    protected function configure(): void
    {
        $this
            ->setName('generate')
            ->setDescription('Generate the openapi.json')
            ->addArgument('path', InputArgument::OPTIONAL, 'The path where generate the openapi.json file', '')
            ->addOption('pretty-json', 'p', InputOption::VALUE_NONE, 'Generate json file in pretty format');
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $this->generateJson($input);
        echo 'generated' . PHP_EOL;

        return 0;
    }

    private function generateJson(InputInterface $input): void
    {
        $template_file = (new Finder())
            ->in(getRootPath() . PathHelper::ROOT)
            ->files()
            ->name('openapi.yaml');

        if (!$template_file->hasResults()) {
            echo 'no openapi.yaml file found' . PHP_EOL;

            return;
        }

        $template = $this->getFirstElementOfFileIterator($template_file);

Are you sure the assignment to $template is correct as $this->getFirstElementOfFileIterator($template_file) targeting Th3Mouk\OpenAPIGenerator\Command\GenerateCommand::getFirstElementOfFileIterator() seems to always return null.

        $template   = Yaml::parse($template->getContents());
        $components = $template['components'] ?? [];

        $node_compactor = static fn (Traversable $node_iterator) => array_reduce(
            iterator_to_array($node_iterator),
            static fn ($carry, $item) => array_merge($carry, $item),
            [],
        );

        $components['schemas']         = (object) $node_compactor($this->getContentGenerator(PathHelper::SCHEMAS));
        $components['responses']       = (object) $node_compactor($this->getContentGenerator(PathHelper::RESPONSES));
        $components['parameters']      = (object) $node_compactor($this->getContentGenerator(PathHelper::PARAMETERS));
        $components['examples']        = (object) $node_compactor($this->getContentGenerator(PathHelper::EXAMPLES));
        $components['requestBodies']   = (object) $node_compactor($this->getContentGenerator(PathHelper::REQUEST_BODIES));
        $components['headers']         = (object) $node_compactor($this->getContentGenerator(PathHelper::HEADERS));
        $components['securitySchemes'] = (object) $node_compactor($this->getContentGenerator(PathHelper::SECURITY_SCHEMES));
        $components['links']           = (object) $node_compactor($this->getContentGenerator(PathHelper::LINKS));
        $components['callbacks']       = (object) $node_compactor($this->getContentGenerator(PathHelper::CALLBACKS));

        $template['paths']      = (object) $node_compactor($this->getContentGenerator(PathHelper::PATHS));
        $template['components'] = (object) $components;

        $arg_path = $input->getArgument('path');

        if (!is_string($arg_path)) {
            throw new \RuntimeException('Path argument must be a string');
        }

        $path = '/' !== substr($arg_path, 0, 1) ? '/' . $arg_path : $arg_path;

        $openapi_file_path = getRootPath() . $path . '/openapi.json';
        if (!$file = fopen($openapi_file_path, 'w')) {
            echo 'error generating openapi.json file' . PHP_EOL;

            return;
        }

        if ($input->getOption('pretty-json')) {
            fwrite($file, \json_encode($template, JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT));
            fclose($file);

            return;
        }

        fwrite($file, \json_encode($template, JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR));
        fclose($file);
    }

    /**
     * @return \Generator<mixed>
     */
    private function getContentGenerator(string $path): \Generator
    {
        foreach ((new Finder())->files()->in(getRootPath() . $path)->name('*.yaml') as $file) {
            yield Yaml::parse($file->getContents());
        }
    }

    /**
     * @return mixed|null
     */
    private function getFirstElementOfFileIterator(Finder $iterator)
    {
        foreach ($iterator as $element) {
            return $element;
        }

        return null;
    }
}