Allow commands to return exit codes

composer.json

@@ -10,7 +10,7 @@
         }
     ],
     "require": {
-        "php": ">=7.3",
+        "php": ">=7.3||^8.0",
         "symfony/event-dispatcher": "^4.0"
 
     },

src/Console/src/Application/Application.php

@@ -118,14 +118,14 @@ public function section($name): Section
         return $this->root->get($this->root->getName().' '.$name);
     }
 
-    public function run(?array $argv = null): void
+    public function run(?array $argv = null): int
     {
         if ($argv === null) {
             global $argv;
             $argv[0] = $this->root->getName();
         }
 
-        $this->executor->run($this->root, $argv);
+        return $this->executor->run($this->root, $argv);
     }
 
     public function getRootSection(): Section

src/Console/src/Application/Executor.php

@@ -85,7 +85,7 @@ public function getActionCollection(): ActionCollection
         return $this->actions;
     }
 
-    public function run(Section $section, $argv = []): void
+    public function run(Section $section, $argv = []): int
     {
         $this->argv = $argv;
 
@@ -94,18 +94,18 @@ public function run(Section $section, $argv = []): void
 
         if ($this->matchedSection === null || $this->matchedInput === null) {
             $this->invalidUsage($argv);
-            return;
+            return 1;
         }
 
         if ($this->beforeAction()->isActionPrevented()) {
-            return;
+            return 0;
         }
 
         if (($action = $this->matchedSection->getAction()) === null) {
-            return;
+            return 0;
         }
 
-        $this->invokeAction($action);
+        return $this->invokeAction($action);
     }
 
     public function visit(Section $section): bool
@@ -193,12 +193,12 @@ private function beforeAction(): BeforeActionEvent
         return $event;
     }
 
-    private function invokeAction($action)
+    private function invokeAction($action): int
     {
         if (!is_callable($action)) {
             $action = $this->actions->get($action);
         }
 
-        $action($this->matchedInput);
+        return $action($this->matchedInput) ?? 0;
     }
 }

src/Console/tests/Test/Usage/Parser/UsageParserTest.php

@@ -19,7 +19,7 @@ public function an_argument_is_defined_as_an_alpha_numeric_string_between_angle_
     {
         $result = usage('<environment>', 'development');
 
-        $this->assertIsArray($result);
+        self::assertIsArray($result);
         $this->assertTrue(count($result) == 1);
     }
 
@@ -331,4 +331,4 @@ public function passed_options_must_be_part_of_usage_definition()
         $result = usage('[-hv] foo bar', '--unknown foo bar');
         $this->assertFalse($result);
     }
-}
+}

src/FSM/tests/Test/Runner/BacktrackingRunnerTest.php

@@ -55,4 +55,4 @@ public function it_must_end_on_a_terminal_state_to_return_result()
         $this->assertEquals(['S3', 'S5'], $this->fsm->input(['t1', 't2']));
         $this->assertEquals(false, $this->fsm->input(['t1']));
     }
-}
+}

src/FSM/tests/Test/Runner/SequenceRunnerTest.php

@@ -54,4 +54,4 @@ public function it_must_end_on_a_terminal_state_to_return_result()
         $this->assertEquals(['S2', 'S4'], $this->fsm->input(['t1', 't3']));
         $this->assertEquals(false, $this->fsm->input(['t1']));
     }
-}
+}