[Console] Simplify using invokable commands when the component is used standalone

HypeMC · HypeMC · commit 5cf2a0dc1a87 · 2025-05-10T10:33:07.000+02:00
diff --git a/src/Symfony/Component/Console/Application.php b/src/Symfony/Component/Console/Application.php
@@ -11,6 +11,7 @@
 
 namespace Symfony\Component\Console;
 
+use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Command\CompleteCommand;
 use Symfony\Component\Console\Command\DumpCompletionCommand;
@@ -28,6 +29,7 @@
 use Symfony\Component\Console\Event\ConsoleTerminateEvent;
 use Symfony\Component\Console\Exception\CommandNotFoundException;
 use Symfony\Component\Console\Exception\ExceptionInterface;
+use Symfony\Component\Console\Exception\InvalidArgumentException;
 use Symfony\Component\Console\Exception\LogicException;
 use Symfony\Component\Console\Exception\NamespaceNotFoundException;
 use Symfony\Component\Console\Exception\RuntimeException;
@@ -565,6 +567,31 @@ public function add(Command $command): ?Command
         return $command;
     }
 
+    public function addInvokable(object $command): ?Command
+    {
+        if (!\is_callable($command)) {
+            throw new InvalidArgumentException('The command must be an invokable object.');
+        }
+        if ($command instanceof \Closure) {
+            throw new InvalidArgumentException('The command cannot be an anonymous function.');
+        }
+
+        if ($command instanceof Command) {
+            return $this->add($command);
+        }
+
+        /** @var AsCommand $attribute */
+        $attribute = ((new \ReflectionObject($command))->getAttributes(AsCommand::class)[0] ?? null)?->newInstance()
+            ?? throw new LogicException(\sprintf('The command must use the "%s" attribute.', AsCommand::class));
+
+        return $this->add(
+            (new Command($attribute->name))
+                ->setDescription($attribute->description ?? '')
+                ->setHelp($attribute->help ?? '')
+                ->setCode($command)
+        );
+    }
+
     /**
      * Returns a registered command by name or alias.
      *
diff --git a/src/Symfony/Component/Console/CHANGELOG.md b/src/Symfony/Component/Console/CHANGELOG.md
@@ -15,6 +15,7 @@ CHANGELOG
  * Deprecate returning a non-integer value from a `\Closure` function set via `Command::setCode()`
  * Mark `#[AsCommand]` attribute as `@final`
  * Add support for `SignalableCommandInterface` with invokable commands
+ * Simplify using invokable commands when the component is used standalone
 
 7.2
 ---
diff --git a/src/Symfony/Component/Console/Tests/ApplicationTest.php b/src/Symfony/Component/Console/Tests/ApplicationTest.php
@@ -16,6 +16,7 @@
 use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Command\HelpCommand;
+use Symfony\Component\Console\Command\InvokableCommand;
 use Symfony\Component\Console\Command\LazyCommand;
 use Symfony\Component\Console\Command\SignalableCommandInterface;
 use Symfony\Component\Console\CommandLoader\CommandLoaderInterface;
@@ -28,6 +29,8 @@
 use Symfony\Component\Console\Event\ConsoleSignalEvent;
 use Symfony\Component\Console\Event\ConsoleTerminateEvent;
 use Symfony\Component\Console\Exception\CommandNotFoundException;
+use Symfony\Component\Console\Exception\InvalidArgumentException;
+use Symfony\Component\Console\Exception\LogicException;
 use Symfony\Component\Console\Exception\NamespaceNotFoundException;
 use Symfony\Component\Console\Helper\FormatterHelper;
 use Symfony\Component\Console\Helper\HelperSet;
@@ -239,6 +242,49 @@ public function testAddCommandWithEmptyConstructor()
         (new Application())->add(new \Foo5Command());
     }
 
+    public function testAddInvokable()
+    {
+        $application = new Application();
+        $application->addInvokable($foo = new InvokableTestCommand());
+        $commands = $application->all();
+
+        $this->assertInstanceOf(Command::class, $command = $commands['invokable']);
+        $this->assertEquals(new InvokableCommand($command, $foo), (new \ReflectionObject($command))->getProperty('code')->getValue($command));
+    }
+
+    public function testAddInvokableWithExtendedCommand()
+    {
+        $application = new Application();
+        $application->addInvokable($foo = new InvokableExtendedTestCommand());
+        $commands = $application->all();
+
+        $this->assertEquals($foo, $commands['invokable-extended']);
+    }
+
+    /**
+     * @dataProvider provideInvalidInvokableCommands
+     */
+    public function testAddInvokableThrowsExceptionOnInvalidCommand(object $command, string $expectedException, string $expectedExceptionMessage)
+    {
+        $application = new Application();
+
+        $this->expectException($expectedException);
+        $this->expectExceptionMessage($expectedExceptionMessage);
+
+        $application->addInvokable($command);
+    }
+
+    public static function provideInvalidInvokableCommands(): iterable
+    {
+        yield 'not a callable' => [new class {}, InvalidArgumentException::class, 'The command must be an invokable object.'];
+        yield 'a closure' => [function () {}, InvalidArgumentException::class, 'The command cannot be an anonymous function.'];
+        yield 'without the #[AsCommand] attribute' => [new class {
+            public function __invoke()
+            {
+            }
+        }, LogicException::class, \sprintf('The command must use the "%s" attribute.', AsCommand::class)];
+    }
+
     public function testHasGet()
     {
         $application = new Application();
@@ -2514,6 +2560,22 @@ public function isEnabled(): bool
     }
 }
 
+#[AsCommand(name: 'invokable')]
+class InvokableTestCommand
+{
+    public function __invoke(): int
+    {
+    }
+}
+
+#[AsCommand(name: 'invokable-extended')]
+class InvokableExtendedTestCommand extends Command
+{
+    public function __invoke(): int
+    {
+    }
+}
+
 #[AsCommand(name: 'signal')]
 class BaseSignableCommand extends Command
 {
