Merge pull request #860 from devajmeireles/feature/add-dd-conditionally

Feature: Introducing The Ability to Dump Conditionally

src/Expectation.php

@@ -127,6 +127,32 @@ final class Expectation
         exit(1);
     }
 
+    /**
+     * Dump the expectation value when the result of the condition is truthy.
+     *
+     * @param  bool  $boolean
+     * @return never
+     */
+    public function ddWhen($boolean, mixed ...$arguments): void
+    {
+        if (! $boolean) {
+            return;
+        }
+
+        $this->dd($this->value, ...$arguments);
+    }
+
+    /**
+     * Dump the expectation value when the result of the condition is falsy.
+     *
+     * @param  bool  $boolean
+     * @return never
+     */
+    public function ddUnless($boolean, mixed ...$arguments): void
+    {
+        $this->ddWhen(! $boolean, ...$arguments);
+    }
+
     /**
      * Send the expectation value to Ray along with all given arguments.
      *