Merge pull request #18 from hypervel/feature/support-manual-failed-exception

Feat: Support `fail` function in command

Author: albertcht

src/console/src/ClosureCommand.php

@@ -47,10 +47,16 @@ public function handle(): int
             }
         }
 
-        return (int) $this->container->call(
-            $this->callback->bindTo($this, $this),
-            $parameters
-        );
+        try {
+            return (int) $this->container->call(
+                $this->callback->bindTo($this, $this),
+                $parameters
+            );
+        } catch (ManuallyFailedException $e) {
+            $this->components->error($e->getMessage());
+
+            return static::FAILURE;
+        }
     }
 
     /**

src/console/src/Command.php

@@ -41,6 +41,10 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                     $this->exitCode = $statusCode;
                 }
                 $this->eventDispatcher?->dispatch(new AfterHandle($this));
+            } catch (ManuallyFailedException $e) {
+                $this->components->error($e->getMessage());
+
+                return $this->exitCode = static::FAILURE;
             } catch (Throwable $exception) {
                 if (class_exists(ExitException::class) && $exception instanceof ExitException) {
                     return $this->exitCode = (int) $exception->getStatus();
@@ -79,4 +83,22 @@ protected function replaceOutput(): void
             $this->output = $this->app->get(OutputInterface::class);
         }
     }
+
+    /**
+     * Fail the command manually.
+     *
+     * @throws ManuallyFailedException|Throwable
+     */
+    public function fail(null|string|Throwable $exception = null): void
+    {
+        if (is_null($exception)) {
+            $exception = 'Command failed manually.';
+        }
+
+        if (is_string($exception)) {
+            $exception = new ManuallyFailedException($exception);
+        }
+
+        throw $exception;
+    }
 }

src/console/src/ManuallyFailedException.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hypervel\Console;
+
+use RuntimeException;
+
+class ManuallyFailedException extends RuntimeException
+{
+}