Add format option to debug:config command

alamirault · alamirault · commit 058f9f09b8cc · 2022-12-05T21:29:06.000+01:00
diff --git a/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md b/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+6.3
+---
+
+ * Add `--format` option to the `debug:config` command
+
 6.2
 ---
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/Command/ConfigDebugCommand.php b/src/Symfony/Bundle/FrameworkBundle/Command/ConfigDebugCommand.php
@@ -16,6 +16,7 @@
 use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Completion\CompletionInput;
 use Symfony\Component\Console\Completion\CompletionSuggestions;
+use Symfony\Component\Console\Exception\InvalidArgumentException;
 use Symfony\Component\Console\Exception\LogicException;
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
@@ -38,22 +39,14 @@
 #[AsCommand(name: 'debug:config', description: 'Dump the current configuration for an extension')]
 class ConfigDebugCommand extends AbstractConfigCommand
 {
-    public function __construct(string $name = null)
-    {
-        if (!class_exists(Yaml::class)) {
-            throw new \RuntimeException('The ConfigDebugCommand class requires the "Yaml" component. Install "symfony/yaml" to use it.');
-        }
-
-        parent::__construct($name);
-    }
-
     protected function configure()
     {
         $this
             ->setDefinition([
                 new InputArgument('name', InputArgument::OPTIONAL, 'The bundle name or the extension alias'),
                 new InputArgument('path', InputArgument::OPTIONAL, 'The configuration option path'),
                 new InputOption('resolve-env', null, InputOption::VALUE_NONE, 'Display resolved environment variable values instead of placeholders'),
+                new InputOption('format', null, InputOption::VALUE_REQUIRED, 'The output format (yaml or json)', 'yaml'),
             ])
             ->setHelp(<<<'EOF'
 The <info>%command.name%</info> command dumps the current configuration for an
@@ -64,13 +57,18 @@ protected function configure()
   <info>php %command.full_name% framework</info>
   <info>php %command.full_name% FrameworkBundle</info>
 
-For dumping a specific option, add its path as second argument:
+With the <info>--format</info> option specifies the format of the configuration,
+this is either <comment>yaml</comment> or <comment>json</comment>.
+When the option is not provided, <comment>yaml</comment> is used.
+
+  <info>php %command.full_name% FrameworkBundle --format=json</info>
+
+For dumping a specific option, add its path as second argument (only available for the yaml format):
 
   <info>php %command.full_name% framework serializer.enabled</info>
 
 EOF
-            )
-        ;
+            );
     }
 
     protected function execute(InputInterface $input, OutputInterface $output): int
@@ -101,16 +99,30 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $config = $this->getConfig($extension, $container, $input->getOption('resolve-env'));
 
+        $format = $input->getOption('format');
+
+        if ('yaml' === $format && !class_exists(Yaml::class)) {
+            $errorIo->error('Setting the "format" option to "yaml" requires the Symfony Yaml component. Try running "composer install symfony/yaml" or use "--format=json" instead.');
+
+            return 1;
+        }
+
         if (null === $path = $input->getArgument('path')) {
             $io->title(
                 sprintf('Current configuration for %s', $name === $extensionAlias ? sprintf('extension with alias "%s"', $extensionAlias) : sprintf('"%s"', $name))
             );
 
-            $io->writeln(Yaml::dump([$extensionAlias => $config], 10));
+            $io->writeln($this->convertToFormat([$extensionAlias => $config], $format));
 
             return 0;
         }
 
+        if ('yaml' !== $format) {
+            $errorIo->error('The "path" option is only available for the "yaml" format.');
+
+            return 1;
+        }
+
         try {
             $config = $this->getConfigForPath($config, $path, $extensionAlias);
         } catch (LogicException $e) {
@@ -121,11 +133,20 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $io->title(sprintf('Current configuration for "%s.%s"', $extensionAlias, $path));
 
-        $io->writeln(Yaml::dump($config, 10));
+        $io->writeln($this->convertToFormat($config, $format));
 
         return 0;
     }
 
+    private function convertToFormat(mixed $config, string $format): string
+    {
+        return match ($format) {
+            'yaml' => Yaml::dump($config, 10),
+            'json' => json_encode($config, \JSON_PRETTY_PRINT),
+            default => throw new InvalidArgumentException('Only the yaml and json formats are supported.'),
+        };
+    }
+
     private function compileContainer(): ContainerBuilder
     {
         $kernel = clone $this->getApplication()->getKernel();
@@ -203,6 +224,10 @@ public function complete(CompletionInput $input, CompletionSuggestions $suggesti
             } catch (LogicException) {
             }
         }
+
+        if ($input->mustSuggestOptionValuesFor('format')) {
+            $suggestions->suggestValues($this->getAvailableFormatOptions());
+        }
     }
 
     private function getAvailableBundles(bool $alias): array
@@ -237,4 +262,9 @@ private static function buildPathsCompletion(array $paths, string $prefix = ''):
 
         return $completionPaths;
     }
+
+    private function getAvailableFormatOptions(): array
+    {
+        return ['yaml', 'json'];
+    }
 }
diff --git a/src/Symfony/Bundle/FrameworkBundle/Tests/Functional/ConfigDebugCommandTest.php b/src/Symfony/Bundle/FrameworkBundle/Tests/Functional/ConfigDebugCommandTest.php
@@ -50,6 +50,19 @@ public function testDumpBundleOption()
         $this->assertStringContainsString('foo', $tester->getDisplay());
     }
 
+    public function testDumpAtPathWithFormat()
+    {
+        $tester = $this->createCommandTester();
+        $ret = $tester->execute([
+            'name' => 'test',
+            'path' => 'array',
+            '--format' => 'json',
+        ]);
+
+        $this->assertSame(1, $ret);
+        $this->assertStringContainsString('[ERROR] The "path" option is only available for the "yaml" format.', $tester->getDisplay());
+    }
+
     public function testParametersValuesAreResolved()
     {
         $tester = $this->createCommandTester();
@@ -157,6 +170,8 @@ public function provideCompletionSuggestions(): \Generator
         yield 'name (started CamelCase)' => [['Fra'], ['DefaultConfigTestBundle', 'ExtensionWithoutConfigTestBundle', 'FrameworkBundle', 'TestBundle']];
 
         yield 'name with existing path' => [['framework', ''], ['secret', 'router.resource', 'router.utf8', 'router.enabled', 'validation.enabled', 'default_locale']];
+
+        yield 'option --format' => [['--format', ''], ['yaml', 'json']];
     }
 
     private function createCommandTester(): CommandTester
