[Console] Updated section 'Building a single Command Application' wit…

…h the new 'SingleCommandApplication'
symfony · OskarStark · Jan 16, 2020 · Jan 10, 2020 · Jan 15, 2020 · 70d523c7c581f973e2ee589f3ce4946077a718e9
commit 70d523c7c581f973e2ee589f3ce4946077a718e9
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
@@ -5,34 +5,36 @@ Building a single Command Application
 =====================================

 When building a command line tool, you may not need to provide several commands.
-In such case, having to pass the command name each time is tedious. Fortunately,
-it is possible to remove this need by declaring a single command application::
+In such case, having to pass the command name each time is tedious.
+
+.. versionadded:: 5.1
+
+    The class :class:`Symfony\\Component\\Console\\SingleCommandApplication` was
+    introduced in Symfony 5.1.
+
+Fortunately, it is possible to remove this need by declaring a single command
+application::

    #!/usr/bin/env php
    <?php
    require __DIR__.'/vendor/autoload.php';

-    use Symfony\Component\Console\Application;
    use Symfony\Component\Console\Input\InputArgument;
    use Symfony\Component\Console\Input\InputInterface;
    use Symfony\Component\Console\Input\InputOption;
    use Symfony\Component\Console\Output\OutputInterface;
-
-    (new Application('echo', '1.0.0'))
-        ->register('echo')
-            ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
-            ->addOption('bar', null, InputOption::VALUE_REQUIRED)
-            ->setCode(function(InputInterface $input, OutputInterface $output) {
-                // output arguments and options
-            })
-        ->getApplication()
-        ->setDefaultCommand('echo', true) // Single command application
+    use Symfony\Component\Console\SingleCommandApplication;
+
+    (new SingleCommandApplication())
+        ->setName('My Super Command') // Optional
+        ->setVersion('1.0.0') // Optional
+        ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
+        ->addOption('bar', null, InputOption::VALUE_REQUIRED)
+        ->setCode(function (InputInterface $input, OutputInterface $output) {
+            // output arguments and options
+        })
        ->run();

-The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
-accepts a boolean as second parameter. If true, the command ``echo`` will then
-always be used, without having to pass its name.
-
 You can still register a command as usual::

    #!/usr/bin/env php
@@ -49,3 +51,7 @@ You can still register a command as usual::

    $application->setDefaultCommand($command->getName(), true);
    $application->run();
+
+The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
+accepts a boolean as second parameter. If true, the command ``echo`` will then
+always be used, without having to pass its name.