Add JSON format option for orm:mapping:describe command output

Author: stlgaits

src/Tools/Console/Command/MappingDescribeCommand.php

@@ -10,6 +10,7 @@
 use Doctrine\ORM\Mapping\FieldMapping;
 use Doctrine\Persistence\Mapping\MappingException;
 use InvalidArgumentException;
+use JsonException;
 use Symfony\Component\Console\Completion\CompletionInput;
 use Symfony\Component\Console\Completion\CompletionSuggestions;
 use Symfony\Component\Console\Input\InputArgument;
@@ -55,6 +56,7 @@ protected function configure(): void
              ->addArgument('entityName', InputArgument::REQUIRED, 'Full or partial name of entity')
              ->setDescription('Display information about mapped objects')
              ->addOption('em', null, InputOption::VALUE_REQUIRED, 'Name of the entity manager to operate on')
+            ->addOption('format', null, InputOption::VALUE_REQUIRED, 'Output format (json, text)', 'text')
              ->setHelp(<<<'EOT'
 The %command.full_name% command describes the metadata for the given full or partial entity class name.
 
@@ -63,6 +65,15 @@ protected function configure(): void
 Or:
 
     <info>%command.full_name%</info> MyEntity
+
+To output the metadata in JSON format, use the <info>--format</info> option:
+
+  <info>%command.full_name% My\Namespace\Entity\MyEntity --format=json</info>
+
+To use a specific entity manager (e.g., for multi-DB projects), use the <info>--em</info> option:
+
+  <info>%command.full_name% My\Namespace\Entity\MyEntity --em=my_custom_entity_manager</info>
+
 EOT);
     }
 
@@ -72,7 +83,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $entityManager = $this->getEntityManager($input);
 
-        $this->displayEntity($input->getArgument('entityName'), $entityManager, $ui);
+        $this->displayEntity($input->getArgument('entityName'), $entityManager, $ui, $input->getOption('format'));
 
         return 0;
     }
@@ -89,6 +100,10 @@ public function complete(CompletionInput $input, CompletionSuggestions $suggesti
 
             $suggestions->suggestValues(array_values($entities));
         }
+
+        if ($input->mustSuggestOptionValuesFor('format')) {
+            $suggestions->suggestValues(array_values($this->getAvailableFormatOptions()));
+        }
     }
 
     /**
@@ -100,9 +115,47 @@ private function displayEntity(
         string $entityName,
         EntityManagerInterface $entityManager,
         SymfonyStyle $ui,
+        string|null $format,
     ): void {
         $metadata = $this->getClassMetadata($entityName, $entityManager);
 
+        if ($format === 'json') {
+            $ui->text(json_encode(
+                [
+                    'name' => $metadata->name,
+                    'rootEntityName' => $metadata->rootEntityName,
+                    'customGeneratorDefinition' => $this->formatValueToJson($metadata->customGeneratorDefinition),
+                    'customRepositoryClassName' => $metadata->customRepositoryClassName,
+                    'isMappedSuperclass' => $metadata->isMappedSuperclass,
+                    'isEmbeddedClass' => $metadata->isEmbeddedClass,
+                    'parentClasses' => $metadata->parentClasses,
+                    'subClasses' => $metadata->subClasses,
+                    'embeddedClasses' => $metadata->embeddedClasses,
+                    'identifier' => $metadata->identifier,
+                    'inheritanceType' => $metadata->inheritanceType,
+                    'discriminatorColumn' => $this->formatValueToJson($metadata->discriminatorColumn),
+                    'discriminatorValue' => $metadata->discriminatorValue,
+                    'discriminatorMap' => $metadata->discriminatorMap,
+                    'generatorType' => $metadata->generatorType,
+                    'table' => $this->formatValueToJson($metadata->table),
+                    'isIdentifierComposite' => $metadata->isIdentifierComposite,
+                    'containsForeignIdentifier' => $metadata->containsForeignIdentifier,
+                    'containsEnumIdentifier' => $metadata->containsEnumIdentifier,
+                    'sequenceGeneratorDefinition' => $this->formatValueToJson($metadata->sequenceGeneratorDefinition),
+                    'changeTrackingPolicy' => $metadata->changeTrackingPolicy,
+                    'isVersioned' => $metadata->isVersioned,
+                    'versionField' => $metadata->versionField,
+                    'isReadOnly' => $metadata->isReadOnly,
+                    'entityListeners' => $metadata->entityListeners,
+                    'associationMappings' => $this->formatMappingsToJson($metadata->associationMappings),
+                    'fieldMappings' => $this->formatMappingsToJson($metadata->fieldMappings),
+                ],
+                JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR,
+            ));
+
+            return;
+        }
+
         $ui->table(
             ['Field', 'Value'],
             array_merge(
@@ -115,7 +168,7 @@ private function displayEntity(
                     $this->formatField('Embedded class?', $metadata->isEmbeddedClass),
                     $this->formatField('Parent classes', $metadata->parentClasses),
                     $this->formatField('Sub classes', $metadata->subClasses),
-                    $this->formatField('Embedded classes', $metadata->subClasses),
+                    $this->formatField('Embedded classes', $metadata->embeddedClasses),
                     $this->formatField('Identifier', $metadata->identifier),
                     $this->formatField('Inheritance type', $metadata->inheritanceType),
                     $this->formatField('Discriminator column', $metadata->discriminatorColumn),
@@ -240,6 +293,22 @@ private function formatValue(mixed $value): string
         throw new InvalidArgumentException(sprintf('Do not know how to format value "%s"', print_r($value, true)));
     }
 
+    /** @throws JsonException */
+    private function formatValueToJson(mixed $value): mixed
+    {
+        if (is_object($value)) {
+            $value = (array) $value;
+        }
+
+        if (is_array($value)) {
+            foreach ($value as $k => $v) {
+                $value[$k] = $this->formatValueToJson($v);
+            }
+        }
+
+        return $value;
+    }
+
     /**
      * Add the given label and value to the two column table output
      *
@@ -281,6 +350,22 @@ private function formatMappings(array $propertyMappings): array
         return $output;
     }
 
+    /**
+     * @param array<string, FieldMapping|AssociationMapping> $propertyMappings
+     *
+     * @return array<string, mixed>
+     */
+    private function formatMappingsToJson(array $propertyMappings): array
+    {
+        $output = [];
+
+        foreach ($propertyMappings as $propertyName => $mapping) {
+            $output[$propertyName] = $this->formatValueToJson((array) $mapping);
+        }
+
+        return $output;
+    }
+
     /**
      * Format the entity listeners
      *
@@ -293,4 +378,10 @@ private function formatEntityListeners(array $entityListeners): array
     {
         return $this->formatField('Entity listeners', array_map('get_class', $entityListeners));
     }
+
+    /** @return string[] */
+    private function getAvailableFormatOptions(): array
+    {
+        return ['text', 'json'];
+    }
 }

tests/Tests/ORM/Tools/Console/Command/MappingDescribeCommandTest.php

@@ -16,6 +16,8 @@
 use Symfony\Component\Console\Tester\CommandCompletionTester;
 use Symfony\Component\Console\Tester\CommandTester;
 
+use function json_decode;
+
 /**
  * Tests for {@see \Doctrine\ORM\Tools\Console\Command\MappingDescribeCommand}
  */
@@ -56,6 +58,25 @@ public function testShowSpecificFuzzySingle(): void
         self::assertStringContainsString('Root entity name', $display);
     }
 
+    public function testShowSpecificFuzzySingleJson(): void
+    {
+        $this->tester->execute([
+            'command' => $this->command->getName(),
+            'entityName' => 'AttractionInfo',
+            '--format' => 'json',
+        ]);
+
+        $display     = $this->tester->getDisplay();
+        $decodedJson = json_decode($display, true);
+
+        self::assertJson($display);
+        self::assertSame(AttractionInfo::class, $decodedJson['name']);
+        self::assertArrayHasKey('rootEntityName', $decodedJson);
+        self::assertArrayHasKey('fieldMappings', $decodedJson);
+        self::assertArrayHasKey('associationMappings', $decodedJson);
+        self::assertArrayHasKey('id', $decodedJson['fieldMappings']);
+    }
+
     public function testShowSpecificFuzzyAmbiguous(): void
     {
         $this->expectException(InvalidArgumentException::class);
@@ -111,5 +132,10 @@ public static function provideCompletionSuggestions(): iterable
                 'Doctrine\\\\Tests\\\\Models\\\\Cache\\\\Bar',
             ],
         ];
+
+        yield 'format option value' => [
+            ['--format='],
+            ['text', 'json'],
+        ];
     }
 }