feat: add dd() and d()

Author: kenjis

src/DebugHelper.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kenjis\PhpUnitHelper;
+
+require_once __DIR__ . '/functions.php';
+
+trait DebugHelper
+{
+}

src/functions.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * Helper Functions
+ */
+
+declare(strict_types=1);
+
+/**
+ * @SuppressWarnings(PHPMD.ExitExpression)
+ * Does not work if I move to the function annotation
+ * See https://github.com/phpmd/phpmd/issues/337
+ */
+if (! function_exists('dd')) {
+    /**
+     * Alias of var_dump() and exit()
+     *
+     * @param mixed ...$vars
+     *
+     * @psalm-suppress ForbiddenCode Unsafe var_dump
+     * @codeCoverageIgnore
+     */
+    function dd(...$vars): void
+    {
+        var_dump(...$vars);
+        exit;
+    }
+}
+
+if (! function_exists('d')) {
+    /**
+     * Alias of var_dump()
+     *
+     * @param mixed ...$vars
+     *
+     * @psalm-suppress ForbiddenCode Unsafe var_dump
+     */
+    function d(...$vars): void
+    {
+        var_dump(...$vars);
+    }
+}

tests/DebugHelperTest.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kenjis\PhpUnitHelper;
+
+use PHPUnit\Framework\TestCase;
+
+class DebugHelperTest extends TestCase
+{
+    use DebugHelper;
+
+    public function test_d(): void
+    {
+        $this->expectOutputRegex(
+            '/string\(4\) "var1"\n.*\nint\(100\)\n/'
+        );
+
+        $var1 = 'var1';
+        $var2 = 100;
+        d($var1, $var2);
+    }
+}