Add functional test for the console execution result assertions

runCommand() and assertCommandIsSuccessful/Failed/IsInvalid/ResultEquals are
Symfony 8.1+ only, so they are covered on this branch.

Author: TavoNiievez

src/Command/ResultCommand.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Command;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\ConsoleOutputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand(ResultCommand::COMMAND_NAME, 'A command exercising the execution result paths.')]
+final class ResultCommand extends Command
+{
+    public const COMMAND_NAME = 'app:result-command';
+
+    protected function configure(): void
+    {
+        $this->addOption('fail', null, InputOption::VALUE_NONE);
+        $this->addOption('invalid', null, InputOption::VALUE_NONE);
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        if ($input->getOption('invalid')) {
+            $output->writeln('Invalid input.');
+
+            return Command::INVALID;
+        }
+
+        if ($input->getOption('fail')) {
+            if ($output instanceof ConsoleOutputInterface) {
+                $output->getErrorOutput()->writeln('Something failed.');
+            }
+
+            return Command::FAILURE;
+        }
+
+        $output->writeln('All good.');
+
+        return Command::SUCCESS;
+    }
+}

tests/Functional/ConsoleCest.php

@@ -5,6 +5,7 @@
 namespace App\Tests\Functional;
 
 use App\Command\ExampleCommand;
+use App\Command\ResultCommand;
 use App\Tests\Support\FunctionalTester;
 
 final class ConsoleCest
@@ -29,4 +30,15 @@ public function runSymfonyConsoleCommand(FunctionalTester $I)
         );
         $I->assertStringContainsString('Bye world!', $output);
     }
+
+    public function consoleExecutionResult(FunctionalTester $I): void
+    {
+        $I->assertCommandIsSuccessful($I->runCommand(ResultCommand::COMMAND_NAME));
+        $I->assertCommandFailed($I->runCommand(ResultCommand::COMMAND_NAME, ['--fail' => true]));
+        $I->assertCommandIsInvalid($I->runCommand(ResultCommand::COMMAND_NAME, ['--invalid' => true]));
+
+        $result = $I->runCommand(ResultCommand::COMMAND_NAME, ['--fail' => true]);
+        $I->assertStringContainsString('Something failed.', $result->getErrorOutput());
+        $I->assertCommandResultEquals($result, expectedStatusCode: 1);
+    }
 }