From 004471473f333c06bdd5c5560221ab0b6df12a8e Mon Sep 17 00:00:00 2001
From: Arnaud Oltra <43755813+olarno@users.noreply.github.com>
Date: Sun, 12 Nov 2023 11:37:29 -0500
Subject: [PATCH 1/2] [Console] Generate documentation command

---
 .../Command/GenerateDocumentationCommand.php  |  77 +++
 .../Integration/ConsoleIntegrationTest.php    |   7 +
 .../GenerateDocumentationCommandTest.php      |  79 +++
 .../testExecution_expectedExport.md           | 582 ++++++++++++++++++
 tests/FilteredCommandTestTrait.php            |  17 +
 5 files changed, 762 insertions(+)
 create mode 100644 packages/console/Command/GenerateDocumentationCommand.php
 create mode 100644 tests/Console/Command/GenerateDocumentationCommandTest.php
 create mode 100644 tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
 create mode 100644 tests/FilteredCommandTestTrait.php

diff --git a/packages/console/Command/GenerateDocumentationCommand.php b/packages/console/Command/GenerateDocumentationCommand.php
new file mode 100644
index 000000000..4f07c8cdd
--- /dev/null
+++ b/packages/console/Command/GenerateDocumentationCommand.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Draw\Component\Console\Command;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Helper\DescriptorHelper;
+use Symfony\Component\Console\Helper\ProgressBar;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Output\StreamOutput;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\Filesystem\Filesystem;
+
+#[AsCommand(name: 'draw:console:generate-documentation')]
+class GenerateDocumentationCommand extends Command
+{
+    protected function configure(): void
+    {
+        $this
+            ->setDescription('Generate a documentation for all the command of the application.')
+            ->addArgument('path', InputArgument::REQUIRED, 'The path where the documentation will be generated.');
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $io = new SymfonyStyle($input, $output);
+
+        $io->section('Generate documentation');
+
+        $filePath = $input->getArgument('path');
+
+        $filesystem = new Filesystem();
+
+        $directoryPath = \dirname($filePath);
+
+        if (!$filesystem->exists($directoryPath)) {
+            $filesystem->mkdir($directoryPath);
+        }
+
+        file_put_contents($filePath, '');
+
+        $file = fopen($filePath, 'w');
+
+        $commandOutput = new StreamOutput($file);
+
+        $commands = $this->getApplication()->all();
+
+        $progress = $io->createProgressBar(\count($commands));
+        $progress->setFormat(ProgressBar::FORMAT_DEBUG);
+
+        $descriptionHelper = new DescriptorHelper();
+
+        foreach ($commands as $command) {
+            $descriptionHelper->describe(
+                $commandOutput,
+                $command,
+                [
+                    'format' => 'md',
+                    'raw_text' => false,
+                ]
+            );
+
+            fwrite($file, "\n\n");
+
+            $progress->advance();
+        }
+
+        $progress->finish();
+
+        $io->newLine(2);
+        $io->success('Export completed');
+
+        return Command::SUCCESS;
+    }
+}
diff --git a/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php b/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
index 2a3a46be8..cc6578345 100644
--- a/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
+++ b/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
@@ -5,6 +5,7 @@
 use Doctrine\Bundle\DoctrineBundle\DependencyInjection\DoctrineExtension;
 use Draw\Bundle\FrameworkExtraBundle\DependencyInjection\Integration\ConsoleIntegration;
 use Draw\Bundle\FrameworkExtraBundle\DependencyInjection\Integration\IntegrationInterface;
+use Draw\Component\Console\Command\GenerateDocumentationCommand;
 use Draw\Component\Console\Command\PurgeExecutionCommand;
 use Draw\Component\Console\Entity\Execution;
 use Draw\Component\Console\EventListener\CommandFlowListener;
@@ -89,6 +90,12 @@ public static function provideTestLoad(): iterable
                 ],
             ],
             [
+                new ServiceConfiguration(
+                    'draw.console.command.generate_documentation_command',
+                    [
+                        GenerateDocumentationCommand::class,
+                    ],
+                ),
                 new ServiceConfiguration(
                     'draw.console.command.purge_execution_command',
                     [
diff --git a/tests/Console/Command/GenerateDocumentationCommandTest.php b/tests/Console/Command/GenerateDocumentationCommandTest.php
new file mode 100644
index 000000000..f2297fbd0
--- /dev/null
+++ b/tests/Console/Command/GenerateDocumentationCommandTest.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace App\Tests\Console\Command;
+
+use App\Tests\FilteredCommandTestTrait;
+use App\Tests\TestCase;
+use Draw\Component\Console\Command\GenerateDocumentationCommand;
+use Draw\Component\Tester\Application\CommandDataTester;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+
+/**
+ * @covers \Draw\Component\Console\Command\GenerateDocumentationCommand
+ */
+class GenerateDocumentationCommandTest extends TestCase
+{
+    use FilteredCommandTestTrait;
+
+    private bool $writeFile = true;
+
+    public function createCommand(): Command
+    {
+        return static::getContainer()->get(GenerateDocumentationCommand::class);
+    }
+
+    public function getCommandName(): string
+    {
+        return 'draw:console:generate-documentation';
+    }
+
+    public static function provideTestArgument(): iterable
+    {
+        yield [
+            'path',
+            InputArgument::REQUIRED,
+        ];
+
+    }
+
+    public static function provideTestOption(): iterable
+    {
+        return [];
+    }
+
+    public function testExecute(): void
+    {
+        $filePath = tempnam(sys_get_temp_dir(), 'testExecute');
+
+        register_shutdown_function(
+            function () use ($filePath): void {
+                if (file_exists($filePath)) {
+                    unlink($filePath);
+                }
+            }
+        );
+
+        $this->execute(['path' => $filePath])
+            ->test(
+                CommandDataTester::create()
+                    ->setExpectedDisplay([
+                        'Generate documentation',
+                        'Export completed',
+                    ])
+                    ->setExpectedErrorOutput(null)
+            );
+
+        if ($this->writeFile) {
+            file_put_contents(
+                __DIR__.'/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md',
+                file_get_contents($filePath)
+            );
+        }
+
+        static::assertFileEquals(
+            __DIR__.'/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md',
+            $filePath
+        );
+    }
+}
diff --git a/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md b/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
new file mode 100644
index 000000000..05a8f82ac
--- /dev/null
+++ b/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
@@ -0,0 +1,582 @@
+`help`
+------
+
+Display help for a command
+
+### Usage
+
+* `help [--format FORMAT] [--raw] [--] [<command_name>]`
+
+The help command displays help for a given command:
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit help list
+
+You can also output the help in other formats by using the --format option:
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit help --format=xml list
+
+To display the list of available commands, please use the list command.
+
+### Arguments
+
+#### `command_name`
+
+The command name
+
+* Is required: no
+* Is array: no
+* Default: `'help'`
+
+### Options
+
+#### `--format`
+
+The output format (txt, xml, json, or md)
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `'txt'`
+
+#### `--raw`
+
+To output raw command help
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--help|-h`
+
+Display help for the given command. When no command is given display help for the list command
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--quiet|-q`
+
+Do not output any message
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--verbose|-v|-vv|-vvv`
+
+Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--version|-V`
+
+Display this application version
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--ansi|--no-ansi`
+
+Force (or disable --no-ansi) ANSI output
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: yes
+* Default: `NULL`
+
+#### `--no-interaction|-n`
+
+Do not ask any interactive question
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+`list`
+------
+
+List commands
+
+### Usage
+
+* `list [--raw] [--format FORMAT] [--short] [--] [<namespace>]`
+
+The list command lists all commands:
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit list
+
+You can also display the commands for a specific namespace:
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit list test
+
+You can also output the information in other formats by using the --format option:
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit list --format=xml
+
+It's also possible to get raw list of commands (useful for embedding command runner):
+
+  /home/wwwroot/vendor/phpunit/phpunit/phpunit list --raw
+
+### Arguments
+
+#### `namespace`
+
+The namespace name
+
+* Is required: no
+* Is array: no
+* Default: `NULL`
+
+### Options
+
+#### `--raw`
+
+To output raw command list
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--format`
+
+The output format (txt, xml, json, or md)
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `'txt'`
+
+#### `--short`
+
+To skip describing commands' arguments
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--help|-h`
+
+Display help for the given command. When no command is given display help for the list command
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--quiet|-q`
+
+Do not output any message
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--verbose|-v|-vv|-vvv`
+
+Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--version|-V`
+
+Display this application version
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--ansi|--no-ansi`
+
+Force (or disable --no-ansi) ANSI output
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: yes
+* Default: `NULL`
+
+#### `--no-interaction|-n`
+
+Do not ask any interactive question
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+`_complete`
+-----------
+
+Internal command to provide shell completion suggestions
+
+### Usage
+
+* `_complete [-s|--shell SHELL] [-i|--input INPUT] [-c|--current CURRENT] [-S|--symfony SYMFONY]`
+
+Internal command to provide shell completion suggestions
+
+### Options
+
+#### `--shell|-s`
+
+The shell type ("bash")
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `NULL`
+
+#### `--input|-i`
+
+An array of input tokens (e.g. COMP_WORDS or argv)
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: yes
+* Is negatable: no
+* Default: `array ()`
+
+#### `--current|-c`
+
+The index of the "input" array that the cursor is in (e.g. COMP_CWORD)
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `NULL`
+
+#### `--symfony|-S`
+
+The version of the completion script
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `NULL`
+
+#### `--help|-h`
+
+Display help for the given command. When no command is given display help for the list command
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--quiet|-q`
+
+Do not output any message
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--verbose|-v|-vv|-vvv`
+
+Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--version|-V`
+
+Display this application version
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--ansi|--no-ansi`
+
+Force (or disable --no-ansi) ANSI output
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: yes
+* Default: `NULL`
+
+#### `--no-interaction|-n`
+
+Do not ask any interactive question
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+`completion`
+------------
+
+Dump the shell completion script
+
+### Usage
+
+* `completion [--debug] [--] [<shell>]`
+
+The completion command dumps the shell completion script required
+to use shell autocompletion (currently only bash completion is supported).
+
+Static installation
+-------------------
+
+Dump the script to a global completion file and restart your shell:
+
+    /home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash | sudo tee /etc/bash_completion.d/phpunit
+
+Or dump the script to a local file and source it:
+
+    /home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash > completion.sh
+
+    # source the file whenever you use the project
+    source completion.sh
+
+    # or add this line at the end of your "~/.bashrc" file:
+    source /path/to/completion.sh
+
+Dynamic installation
+--------------------
+
+Add this to the end of your shell configuration file (e.g. "~/.bashrc"):
+
+    eval "$(/home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash)"
+
+### Arguments
+
+#### `shell`
+
+The shell type (e.g. "bash"), the value of the "$SHELL" env var will be used if this is not given
+
+* Is required: no
+* Is array: no
+* Default: `NULL`
+
+### Options
+
+#### `--debug`
+
+Tail the completion debug log
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--help|-h`
+
+Display help for the given command. When no command is given display help for the list command
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--quiet|-q`
+
+Do not output any message
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--verbose|-v|-vv|-vvv`
+
+Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--version|-V`
+
+Display this application version
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--ansi|--no-ansi`
+
+Force (or disable --no-ansi) ANSI output
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: yes
+* Default: `NULL`
+
+#### `--no-interaction|-n`
+
+Do not ask any interactive question
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+`draw:console:generate-documentation`
+-------------------------------------
+
+Generate a documentation for all the command of the application.
+
+### Usage
+
+* `draw:console:generate-documentation [--aws-newest-instance-role AWS-NEWEST-INSTANCE-ROLE] [--draw-execution-id DRAW-EXECUTION-ID] [--draw-execution-ignore] [--] <path>`
+
+Generate a documentation for all the command of the application.
+
+### Arguments
+
+#### `path`
+
+The path where the documentation will be generated.
+
+* Is required: yes
+* Is array: no
+* Default: `NULL`
+
+### Options
+
+#### `--aws-newest-instance-role`
+
+The instance role the server must be the newest of to run the command.
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `NULL`
+
+#### `--draw-execution-id`
+
+The existing execution id of the command. Use internally by the DrawCommandBundle.
+
+* Accept value: yes
+* Is value required: yes
+* Is multiple: no
+* Is negatable: no
+* Default: `NULL`
+
+#### `--draw-execution-ignore`
+
+Flag to ignore login of the execution to the databases.
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--help|-h`
+
+Display help for the given command. When no command is given display help for the list command
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--quiet|-q`
+
+Do not output any message
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--verbose|-v|-vv|-vvv`
+
+Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--version|-V`
+
+Display this application version
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
+#### `--ansi|--no-ansi`
+
+Force (or disable --no-ansi) ANSI output
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: yes
+* Default: `NULL`
+
+#### `--no-interaction|-n`
+
+Do not ask any interactive question
+
+* Accept value: no
+* Is value required: no
+* Is multiple: no
+* Is negatable: no
+* Default: `false`
+
diff --git a/tests/FilteredCommandTestTrait.php b/tests/FilteredCommandTestTrait.php
new file mode 100644
index 000000000..c536190b9
--- /dev/null
+++ b/tests/FilteredCommandTestTrait.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Tests;
+
+use Draw\Component\Tester\Application\CommandTestTrait;
+
+trait FilteredCommandTestTrait
+{
+    use CommandTestTrait;
+
+    protected function filterDefinitionOptions(array $options): array
+    {
+        unset($options['aws-newest-instance-role'], $options['draw-execution-id'], $options['draw-execution-ignore']);
+
+        return $options;
+    }
+}

From f80dbcedecb312234f4edd83b1ea5a241d0f6fff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20Poirier=20Th=C3=A9or=C3=AAt?= <mpoiriert@gmail.com>
Date: Sun, 12 Nov 2023 14:32:30 -0500
Subject: [PATCH 2/2] [Console] Support ignore command

---
 config/packages/draw_framework_extra.yaml     |   8 +-
 .../Command/GenerateDocumentationCommand.php  |  14 +
 .../Event/GenerateDocumentationEvent.php      |  37 ++
 ...cumentationIgnoredCommandEventListener.php |  21 ++
 .../Integration/ConsoleIntegration.php        |  27 ++
 .../Integration/ConsoleIntegrationTest.php    |  21 ++
 .../GenerateDocumentationCommandTest.php      |  10 +-
 .../testExecution_expectedExport.md           | 356 ------------------
 8 files changed, 134 insertions(+), 360 deletions(-)
 create mode 100644 packages/console/Event/GenerateDocumentationEvent.php
 create mode 100644 packages/framework-extra-bundle/Console/EventListener/DocumentationIgnoredCommandEventListener.php

diff --git a/config/packages/draw_framework_extra.yaml b/config/packages/draw_framework_extra.yaml
index 7168e5569..3e415f705 100644
--- a/config/packages/draw_framework_extra.yaml
+++ b/config/packages/draw_framework_extra.yaml
@@ -5,7 +5,9 @@ draw_framework_extra:
 
   configuration: ~
 
-  console: ~
+  console:
+    documentation:
+      ignored_commands: [ 'completion', 'help', 'list' ]
 
   doctrine_extra: ~
 
@@ -38,7 +40,7 @@ draw_framework_extra:
     doctrine_message_bus_hook: ~
     retry:
       event_driven:
-        transports: ['async']
+        transports: [ 'async' ]
 
     serializer_event_dispatcher: ~
     versioning: ~
@@ -72,7 +74,7 @@ draw_framework_extra:
           all:
             tags: ~
           tag:
-            tags: ['Tags']
+            tags: [ 'Tags' ]
 
       sort_schema: true
 
diff --git a/packages/console/Command/GenerateDocumentationCommand.php b/packages/console/Command/GenerateDocumentationCommand.php
index 4f07c8cdd..00926f323 100644
--- a/packages/console/Command/GenerateDocumentationCommand.php
+++ b/packages/console/Command/GenerateDocumentationCommand.php
@@ -2,6 +2,7 @@
 
 namespace Draw\Component\Console\Command;
 
+use Draw\Component\Console\Event\GenerateDocumentationEvent;
 use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Helper\DescriptorHelper;
@@ -12,10 +13,16 @@
 use Symfony\Component\Console\Output\StreamOutput;
 use Symfony\Component\Console\Style\SymfonyStyle;
 use Symfony\Component\Filesystem\Filesystem;
+use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 
 #[AsCommand(name: 'draw:console:generate-documentation')]
 class GenerateDocumentationCommand extends Command
 {
+    public function __construct(private ?EventDispatcherInterface $eventDispatcher = null)
+    {
+        parent::__construct();
+    }
+
     protected function configure(): void
     {
         $this
@@ -53,6 +60,13 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $descriptionHelper = new DescriptorHelper();
 
         foreach ($commands as $command) {
+            $event = new GenerateDocumentationEvent($command);
+            $this->eventDispatcher?->dispatch($event);
+
+            if ($event->isIgnored()) {
+                continue;
+            }
+
             $descriptionHelper->describe(
                 $commandOutput,
                 $command,
diff --git a/packages/console/Event/GenerateDocumentationEvent.php b/packages/console/Event/GenerateDocumentationEvent.php
new file mode 100644
index 000000000..6cb9b2c89
--- /dev/null
+++ b/packages/console/Event/GenerateDocumentationEvent.php
@@ -0,0 +1,37 @@
+<?php
+
+namespace Draw\Component\Console\Event;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * Event when we generate the documentation of the application.
+ * It's dispatched for every command.
+ *
+ * You can ignore the documentation of a command by calling the ignore method.
+ */
+class GenerateDocumentationEvent extends Event
+{
+    private bool $ignore = false;
+
+    public function __construct(private Command $command)
+    {
+    }
+
+    public function getCommand(): Command
+    {
+        return $this->command;
+    }
+
+    public function ignore(): void
+    {
+        $this->ignore = true;
+        $this->stopPropagation();
+    }
+
+    public function isIgnored(): bool
+    {
+        return $this->ignore;
+    }
+}
diff --git a/packages/framework-extra-bundle/Console/EventListener/DocumentationIgnoredCommandEventListener.php b/packages/framework-extra-bundle/Console/EventListener/DocumentationIgnoredCommandEventListener.php
new file mode 100644
index 000000000..c291ad276
--- /dev/null
+++ b/packages/framework-extra-bundle/Console/EventListener/DocumentationIgnoredCommandEventListener.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace Draw\Bundle\FrameworkExtraBundle\Console\EventListener;
+
+use Draw\Component\Console\Event\GenerateDocumentationEvent;
+use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+class DocumentationIgnoredCommandEventListener
+{
+    public function __construct(private array $ignoredCommandNames)
+    {
+    }
+
+    #[AsEventListener]
+    public function onGenerateDocumentationEvent(GenerateDocumentationEvent $event): void
+    {
+        if (\in_array($event->getCommand()->getName(), $this->ignoredCommandNames)) {
+            $event->ignore();
+        }
+    }
+}
diff --git a/packages/framework-extra-bundle/DependencyInjection/Integration/ConsoleIntegration.php b/packages/framework-extra-bundle/DependencyInjection/Integration/ConsoleIntegration.php
index 0d7a00486..409f9a4b9 100644
--- a/packages/framework-extra-bundle/DependencyInjection/Integration/ConsoleIntegration.php
+++ b/packages/framework-extra-bundle/DependencyInjection/Integration/ConsoleIntegration.php
@@ -2,6 +2,8 @@
 
 namespace Draw\Bundle\FrameworkExtraBundle\DependencyInjection\Integration;
 
+use Draw\Bundle\FrameworkExtraBundle\Console\EventListener\DocumentationIgnoredCommandEventListener;
+use Draw\Bundle\FrameworkExtraBundle\DrawFrameworkExtraBundle;
 use Draw\Component\Console\Command\PurgeExecutionCommand;
 use Draw\Component\Console\Entity\Execution;
 use Draw\Component\Console\EventListener\CommandFlowListener;
@@ -41,6 +43,22 @@ public function load(array $config, PhpFileLoader $loader, ContainerBuilder $con
             $namespace,
             'draw.console.'
         );
+
+        $this->registerClasses(
+            $loader,
+            $namespace = 'Draw\\Bundle\\FrameworkExtraBundle\\Console\\',
+            \dirname((new \ReflectionClass(DrawFrameworkExtraBundle::class))->getFileName()).'/Console'
+        );
+
+        $container
+            ->getDefinition(DocumentationIgnoredCommandEventListener::class)
+            ->setArgument('$ignoredCommandNames', $config['documentation']['ignored_commands']);
+
+        $this->renameDefinitions(
+            $container,
+            $namespace,
+            'draw.console.'
+        );
     }
 
     public function addConfiguration(ArrayNodeDefinition $node): void
@@ -48,6 +66,15 @@ public function addConfiguration(ArrayNodeDefinition $node): void
         $node
             ->children()
                 ->booleanNode('ignore_disabled_command')->defaultFalse()->end()
+                ->arrayNode('documentation')
+                    ->addDefaultsIfNotSet()
+                    ->children()
+                        ->arrayNode('ignored_commands')
+                            ->defaultValue([])
+                            ->scalarPrototype()->end()
+                        ->end()
+                    ->end()
+                ->end()
             ->end();
     }
 
diff --git a/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php b/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
index cc6578345..8a860ef5d 100644
--- a/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
+++ b/packages/framework-extra-bundle/Tests/DependencyInjection/Integration/ConsoleIntegrationTest.php
@@ -3,6 +3,7 @@
 namespace Draw\Bundle\FrameworkExtraBundle\Tests\DependencyInjection\Integration;
 
 use Doctrine\Bundle\DoctrineBundle\DependencyInjection\DoctrineExtension;
+use Draw\Bundle\FrameworkExtraBundle\Console\EventListener\DocumentationIgnoredCommandEventListener;
 use Draw\Bundle\FrameworkExtraBundle\DependencyInjection\Integration\ConsoleIntegration;
 use Draw\Bundle\FrameworkExtraBundle\DependencyInjection\Integration\IntegrationInterface;
 use Draw\Component\Console\Command\GenerateDocumentationCommand;
@@ -33,6 +34,9 @@ public function getDefaultConfiguration(): array
     {
         return [
             'ignore_disabled_command' => false,
+            'documentation' => [
+                'ignored_commands' => [],
+            ],
         ];
     }
 
@@ -87,6 +91,11 @@ public static function provideTestLoad(): iterable
             [
                 [
                     'ignore_disabled_command' => true,
+                    'documentation' => [
+                        'ignored_commands' => [
+                            'help',
+                        ],
+                    ],
                 ],
             ],
             [
@@ -113,6 +122,18 @@ function (Definition $definition): void {
                         );
                     }
                 ),
+                new ServiceConfiguration(
+                    'draw.console.event_listener.documentation_ignored_command_event_listener',
+                    [
+                        DocumentationIgnoredCommandEventListener::class,
+                    ],
+                    function (Definition $definition): void {
+                        static::assertSame(
+                            ['help'],
+                            $definition->getArgument('$ignoredCommandNames')
+                        );
+                    }
+                ),
             ],
         ];
     }
diff --git a/tests/Console/Command/GenerateDocumentationCommandTest.php b/tests/Console/Command/GenerateDocumentationCommandTest.php
index f2297fbd0..8bff3374e 100644
--- a/tests/Console/Command/GenerateDocumentationCommandTest.php
+++ b/tests/Console/Command/GenerateDocumentationCommandTest.php
@@ -16,7 +16,7 @@ class GenerateDocumentationCommandTest extends TestCase
 {
     use FilteredCommandTestTrait;
 
-    private bool $writeFile = true;
+    private bool $writeFile = false;
 
     public function createCommand(): Command
     {
@@ -76,4 +76,12 @@ function () use ($filePath): void {
             $filePath
         );
     }
+
+    public function testWriteFile(): void
+    {
+        static::assertFalse(
+            $this->writeFile,
+            'Do not forget to put this variable back to false.'
+        );
+    }
 }
diff --git a/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md b/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
index 05a8f82ac..32da58785 100644
--- a/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
+++ b/tests/Console/Command/fixtures/GenerateDocumentationCommandTest/testExecution_expectedExport.md
@@ -1,241 +1,3 @@
-`help`
-------
-
-Display help for a command
-
-### Usage
-
-* `help [--format FORMAT] [--raw] [--] [<command_name>]`
-
-The help command displays help for a given command:
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit help list
-
-You can also output the help in other formats by using the --format option:
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit help --format=xml list
-
-To display the list of available commands, please use the list command.
-
-### Arguments
-
-#### `command_name`
-
-The command name
-
-* Is required: no
-* Is array: no
-* Default: `'help'`
-
-### Options
-
-#### `--format`
-
-The output format (txt, xml, json, or md)
-
-* Accept value: yes
-* Is value required: yes
-* Is multiple: no
-* Is negatable: no
-* Default: `'txt'`
-
-#### `--raw`
-
-To output raw command help
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--help|-h`
-
-Display help for the given command. When no command is given display help for the list command
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--quiet|-q`
-
-Do not output any message
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--verbose|-v|-vv|-vvv`
-
-Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--version|-V`
-
-Display this application version
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--ansi|--no-ansi`
-
-Force (or disable --no-ansi) ANSI output
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: yes
-* Default: `NULL`
-
-#### `--no-interaction|-n`
-
-Do not ask any interactive question
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-`list`
-------
-
-List commands
-
-### Usage
-
-* `list [--raw] [--format FORMAT] [--short] [--] [<namespace>]`
-
-The list command lists all commands:
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit list
-
-You can also display the commands for a specific namespace:
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit list test
-
-You can also output the information in other formats by using the --format option:
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit list --format=xml
-
-It's also possible to get raw list of commands (useful for embedding command runner):
-
-  /home/wwwroot/vendor/phpunit/phpunit/phpunit list --raw
-
-### Arguments
-
-#### `namespace`
-
-The namespace name
-
-* Is required: no
-* Is array: no
-* Default: `NULL`
-
-### Options
-
-#### `--raw`
-
-To output raw command list
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--format`
-
-The output format (txt, xml, json, or md)
-
-* Accept value: yes
-* Is value required: yes
-* Is multiple: no
-* Is negatable: no
-* Default: `'txt'`
-
-#### `--short`
-
-To skip describing commands' arguments
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--help|-h`
-
-Display help for the given command. When no command is given display help for the list command
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--quiet|-q`
-
-Do not output any message
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--verbose|-v|-vv|-vvv`
-
-Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--version|-V`
-
-Display this application version
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--ansi|--no-ansi`
-
-Force (or disable --no-ansi) ANSI output
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: yes
-* Default: `NULL`
-
-#### `--no-interaction|-n`
-
-Do not ask any interactive question
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
 `_complete`
 -----------
 
@@ -349,124 +111,6 @@ Do not ask any interactive question
 * Is negatable: no
 * Default: `false`
 
-`completion`
-------------
-
-Dump the shell completion script
-
-### Usage
-
-* `completion [--debug] [--] [<shell>]`
-
-The completion command dumps the shell completion script required
-to use shell autocompletion (currently only bash completion is supported).
-
-Static installation
--------------------
-
-Dump the script to a global completion file and restart your shell:
-
-    /home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash | sudo tee /etc/bash_completion.d/phpunit
-
-Or dump the script to a local file and source it:
-
-    /home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash > completion.sh
-
-    # source the file whenever you use the project
-    source completion.sh
-
-    # or add this line at the end of your "~/.bashrc" file:
-    source /path/to/completion.sh
-
-Dynamic installation
---------------------
-
-Add this to the end of your shell configuration file (e.g. "~/.bashrc"):
-
-    eval "$(/home/wwwroot/vendor/phpunit/phpunit/phpunit completion bash)"
-
-### Arguments
-
-#### `shell`
-
-The shell type (e.g. "bash"), the value of the "$SHELL" env var will be used if this is not given
-
-* Is required: no
-* Is array: no
-* Default: `NULL`
-
-### Options
-
-#### `--debug`
-
-Tail the completion debug log
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--help|-h`
-
-Display help for the given command. When no command is given display help for the list command
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--quiet|-q`
-
-Do not output any message
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--verbose|-v|-vv|-vvv`
-
-Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--version|-V`
-
-Display this application version
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
-#### `--ansi|--no-ansi`
-
-Force (or disable --no-ansi) ANSI output
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: yes
-* Default: `NULL`
-
-#### `--no-interaction|-n`
-
-Do not ask any interactive question
-
-* Accept value: no
-* Is value required: no
-* Is multiple: no
-* Is negatable: no
-* Default: `false`
-
 `draw:console:generate-documentation`
 -------------------------------------