allow to customize the exit code send in cli context

docs/API Documentation.md

@@ -60,6 +60,10 @@ Run::register()
 Run::unregister()
  #=> Whoops\Run
 
+// Send a custom exit code in CLI context (default: 1)
+Run::sendExitCode($code = null)
+ #=> int
+
 // If true, allows Whoops to terminate script execution (default: true)
 Run::allowQuit($allowQuit = null)
  #=> bool

src/Whoops/Run.php

@@ -38,6 +38,11 @@ final class Run implements RunInterface
      */
     private $sendHttpCode    = 500;
 
+    /**
+     * @var integer|false
+     */
+    private $sendExitCode    = 1;
+
     /**
      * @var HandlerInterface[]
      */
@@ -288,6 +293,31 @@ public function sendHttpCode($code = null)
         return $this->sendHttpCode = $code;
     }
 
+    /**
+     * Should Whoops exit with a specific code on the CLI if possible?
+     * Whoops will exit with 1 by default, but you can specify something else.
+     *
+     * @param int $code
+     *
+     * @return int
+     *
+     * @throws InvalidArgumentException
+     */
+    public function sendExitCode($code = null)
+    {
+        if (func_num_args() == 0) {
+            return $this->sendExitCode;
+        }
+
+        if ($code < 0 || 255 <= $code) {
+            throw new InvalidArgumentException(
+                "Invalid status code '$code', must be between 0 and 254"
+            );
+        }
+
+        return $this->sendExitCode = (int) $code;
+    }
+
     /**
      * Should Whoops push output directly to the client?
      * If this is false, output will be returned by handleException.
@@ -380,7 +410,9 @@ public function handleException($exception)
             // HHVM fix for https://github.com/facebook/hhvm/issues/4055
             $this->system->flushOutputBuffer();
 
-            $this->system->stopExecution(1);
+            $this->system->stopExecution(
+                $this->sendExitCode()
+            );
         }
 
         return $output;

src/Whoops/RunInterface.php

@@ -90,6 +90,15 @@ public function silenceErrorsInPaths($patterns, $levels = 10240);
      */
     public function sendHttpCode($code = null);
 
+    /**
+     * Should Whoops exit with a specific code on the CLI if possible?
+     * Whoops will exit with 1 by default, but you can specify something else.
+     *
+     * @param int $code
+     * @return int
+     */
+    public function sendExitCode($code = null);
+
     /**
      * Should Whoops push output directly to the client?
      * If this is false, output will be returned by handleException

tests/Whoops/RunTest.php

@@ -503,4 +503,33 @@ public function testSendHttpCodeWrongCode()
 
         $this->getRunInstance()->sendHttpCode(1337);
     }
+
+    /**
+     * @covers Whoops\Run::sendHttpCode
+     */
+    public function testSendExitCode()
+    {
+        $run = $this->getRunInstance();
+        $run->sendExitCode(42);
+        $this->assertEquals(42, $run->sendExitCode());
+    }
+
+    /**
+     * @covers Whoops\Run::sendExitCode
+     */
+    public function testSendExitCodeDefaultCode()
+    {
+        $run = $this->getRunInstance();
+        $this->assertEquals(1, $run->sendExitCode());
+    }
+
+    /**
+     * @covers Whoops\Run::sendExitCode
+     */
+    public function testSendExitCodeWrongCode()
+    {
+        $this->expectExceptionOfType('InvalidArgumentException');
+
+        $this->getRunInstance()->sendExitCode(255);
+    }
 }