feat: allow wp-cli commands to run asynchronously

Author: carlalexander

src/Command/AbstractCommand.php

@@ -342,7 +342,9 @@ protected function retryApi(callable $callable, string $message, ConsoleOutput $
      */
     protected function wait(callable $callable, int $timeout = 60, int $sleep = 1)
     {
-        $timeout += time();
+        if (0 !== $timeout) {
+            $timeout += time();
+        }
 
         do {
             $result = $callable();

src/Command/WpCliCommand.php

@@ -38,16 +38,19 @@ protected function configure()
             ->setName(self::NAME)
             ->setDescription('Execute a WP-CLI command')
             ->addArgument('wp-command', InputArgument::IS_ARRAY, 'The WP-CLI command to execute')
-            ->addOption('environment', null, InputOption::VALUE_REQUIRED, 'The environment name', 'staging');
+            ->addOption('environment', null, InputOption::VALUE_REQUIRED, 'The environment name', 'staging')
+            ->addOption('async', null, InputOption::VALUE_NONE, 'Execute WP-CLI command asynchronously');
     }
 
     /**
      * {@inheritdoc}
      */
     protected function perform(InputInterface $input, ConsoleOutput $output)
     {
+        $async = $this->getBooleanOption($input, 'async');
         $command = implode(' ', $this->getArrayArgument($input, 'wp-command'));
         $environment = (string) $this->getStringOption($input, 'environment');
+        $exitCode = 0;
 
         if (empty($command) && $input->isInteractive()) {
             $command = $output->ask('Please enter the WP-CLI command to run');
@@ -61,15 +64,19 @@ protected function perform(InputInterface $input, ConsoleOutput $output)
             throw new RuntimeException(sprintf('The "wp %s" command isn\'t available remotely', $command));
         }
 
-        $output->info(sprintf('Running "<comment>wp %s</comment>" on "<comment>%s</comment>" environment', $command, $environment));
+        $output->info(sprintf('Running "<comment>wp %s</comment>" %s "<comment>%s</comment>" environment', $command, $async ? 'asynchronously on' : 'on', $environment));
 
         $result = $this->invokeEnvironmentFunction($environment, [
             'php' => sprintf('bin/wp %s', $command),
-        ], Arr::get($this->projectConfiguration->getEnvironment($environment), 'console.timeout', 60));
+        ], $async ? 0 : Arr::get($this->projectConfiguration->getEnvironment($environment), 'console.timeout', 60));
 
-        $output->newLine();
-        $output->write("${result['output']}");
+        if (!$async) {
+            $output->newLine();
+            $output->write("${result['output']}");
 
-        return $result['exitCode'];
+            $exitCode = $result['exitCode'];
+        }
+
+        return $exitCode;
     }
 }