feat(expectations): add toMatchRegEx

src/Expectation.php

@@ -505,6 +505,16 @@ final class Expectation
         return $this;
     }
 
+    /**
+     * Asserts that the value matches a regular expression.
+     */
+    public function toMatchRegEx(string $expression): Expectation
+    {
+        Assert::assertMatchesRegularExpression($expression, $this->value);
+
+        return $this;
+    }
+
     /**
      * Asserts that the value matches a constraint.
      */

tests/Expect/toMatchRegEx.php

@@ -0,0 +1,15 @@
+<?php
+
+use PHPUnit\Framework\ExpectationFailedException;
+
+test('pass', function () {
+    expect('Hello World')->toMatchRegEx('/^hello wo.*$/i');
+});
+
+test('failures', function () {
+    expect('Hello World')->toMatchRegEx('/^hello$/i');
+})->throws(ExpectationFailedException::class);
+
+test('not failures', function () {
+    expect('Hello World')->not->toMatchRegEx('/^hello wo.*$/i');
+})->throws(ExpectationFailedException::class);