Add dbgthrow() and dbgdie()

Author: fabacino

src/debug-functions.php

@@ -63,3 +63,31 @@ function dbglog($var, int $flags = null)
 {
     Debug::getInstance()->logValue($var, $flags);
 }
+
+/**
+ * Print debug value and die.
+ *
+ * @param mixed     $var    The variable to analyse.
+ * @param int|null  $flags  Flags for tweaking the output.
+ *
+ * @return void
+ * @codeCoverageIgnore
+ */
+function dbgdie($var, int $flags = null)
+{
+    dbg($var, $flags);
+    exit;
+}
+
+/**
+ * Throw exception with debug value.
+ *
+ * @param mixed     $var    The variable to analyse.
+ * @param int|null  $flags  Flags for tweaking the output.
+ *
+ * @return void
+ */
+function dbgthrow($var, int $flags = null)
+{
+    throw new \Exception(dbgr($var, $flags));
+}

tests/DbgThrowTest.php

@@ -0,0 +1,77 @@
+<?php
+/*
+ * © Fabian Wiget <fabacino@gmail.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Fabacino\Debug\Test;
+
+use Fabacino\Debug\Debug;
+
+/**
+ * Tests for function `dbgthrow`.
+ */
+class DbgThrowTest extends \PHPUnit\Framework\TestCase
+{
+    /**
+     * Test printing number.
+     *
+     * @return void
+     */
+    public function testThrowNumber()
+    {
+        $var = 123;
+        $this->assertEquals($var, $this->captureException($var));
+    }
+
+    /**
+     * Test printing string.
+     *
+     * @return void
+     */
+    public function testThrowString()
+    {
+        $var = 'some string';
+        $this->assertEquals($var, $this->captureException($var));
+    }
+
+    /**
+     * Test printing output.
+     *
+     * @return void
+     */
+    public function testPrintArray()
+    {
+        $var = ['first', 'second', 'third'];
+        $expected = <<<'EOT'
+Array
+(
+    [0] => first
+    [1] => second
+    [2] => third
+)
+
+EOT;
+        $this->assertEquals($expected, $this->captureException($var));
+    }
+
+    /**
+     * Capture and return output of function `dbg`.
+     *
+     * @param mixed  $var    The variable to analyse.
+     * @param int    $flags  Flags for tweaking the output.
+     *
+     * @return string|null
+     */
+    private function captureException($var, int $flags = null)
+    {
+        try {
+            dbgthrow($var, $flags);
+        } catch (\Exception $Exception) {
+            return $Exception->getMessage();
+        }
+        return null;
+    }
+}