Merge pull request tempestphp#72 from aidan-casey/add-regex-rule

Adds regex validation rule

src/Validation/Rules/Regex.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Validation\Rules;
+
+use Attribute;
+use Tempest\Interface\Rule;
+
+#[Attribute]
+final readonly class Regex implements Rule
+{
+    public function __construct(private string $pattern)
+    {
+    }
+
+    public function isValid(mixed $value): bool
+    {
+        return preg_match($this->pattern, $value) === 1;
+    }
+
+    public function message(): string
+    {
+        return "The value must match the regular expression pattern: $this->pattern";
+    }
+}

tests/Validation/Rules/RegexTest.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Validation\Rules;
+
+use PHPUnit\Framework\TestCase;
+use Tempest\Validation\Rules\Regex;
+
+class RegexTest extends TestCase
+{
+    public function test_regex_rule()
+    {
+        $rule = new Regex('/^[aA][bB]$/');
+
+        $this->assertSame(
+            'The value must match the regular expression pattern: /^[aA][bB]$/',
+            $rule->message()
+        );
+
+        $this->assertFalse($rule->isValid('cd'));
+        $this->assertFalse($rule->isValid('za'));
+
+        $this->assertTrue($rule->isValid('ab'));
+        $this->assertTrue($rule->isValid('AB'));
+        $this->assertTrue($rule->isValid('Ab'));
+    }
+}