Add EmailRule with validation and tests, update DateRule

Introduce EmailRule for validating email addresses using regex, along with comprehensive unit tests. Update DateRule's validation messages for consistency and adjust corresponding test assertions.

Author: Fa-BRAIK

src/Validation/Rules/DateRule.php

@@ -55,7 +55,7 @@ public static function make(?array $parameters = null): self
     public function validationMessage(): string
     {
         return empty($this->formats) 
-            ? 'The :attribute must be a valid date.'
-            : 'The :attribute must be a valid date in one of the following formats: ' . implode(', ', $this->formats);
+            ? 'The :attribute field must be a valid date.'
+            : 'The :attribute field must be a valid date in one of the following formats: ' . implode(', ', $this->formats);
     }
 }

src/Validation/Rules/EmailRule.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Rules;
+
+use Nuxtifyts\PhpDto\Validation\Rules\ValidationRule;
+use Override;
+
+class EmailRule extends RegexRule
+{
+    public string $name {
+        get {
+            return 'email';
+        }
+    }
+
+    /**
+     * @param ?array<string, mixed> $parameters
+     */
+    #[Override]
+    public static function make(?array $parameters = null): self
+    {
+        $instance = new self();
+
+        $instance->pattern = '/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/';
+
+        return $instance;
+    }
+
+    #[Override]
+    public function validationMessage(): string
+    {
+        return 'The :attribute field must be a valid email address.';
+    }
+}

tests/Unit/Validation/Rules/DateRuleTest.php

@@ -19,11 +19,14 @@ final class DateRuleTest extends ValidationRuleTestCase
     #[Test]
     public function validate_validation_message(): void
     {
-        $rule = DateRule::make();
+        self::assertEquals(
+            'The :attribute field must be a valid date.',
+            DateRule::make()->validationMessage()
+        );
 
         self::assertEquals(
-            'The :attribute must be a valid date.',
-            $rule->validationMessage()
+            'The :attribute field must be a valid date in one of the following formats: Y/m-d H/m/s',
+            DateRule::make(['formats' => ['Y/m-d H/m/s']])->validationMessage()
         );
     }
 

tests/Unit/Validation/Rules/EmailRuleTest.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Tests\Unit\Validation\Rules;
+
+use Nuxtifyts\PhpDto\Exceptions\ValidationRuleException;
+use Nuxtifyts\PhpDto\Validation\Rules\EmailRule;
+use Nuxtifyts\PhpDto\Validation\Rules\ValidationRule;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use Throwable;
+
+#[CoversClass(EmailRule::class)]
+final class EmailRuleTest extends ValidationRuleTestCase
+{
+    /**
+     * @throws Throwable
+     */
+    #[Test]
+    public function validate_validation_message(): void
+    {
+        self::assertEquals(
+            'The :attribute field must be a valid email address.',
+            EmailRule::make()->validationMessage()
+        );
+    }
+
+    /**
+     * @return array<string, array{
+     *     validationRuleClassString: class-string<ValidationRule>,
+     *     makeParams: ?array<string, mixed>,
+     *     expectedMakeException: ?class-string<ValidationRuleException>,
+     *     valueToBeEvaluated: mixed,
+     *     expectedResult: bool
+     * }>
+     */
+    public static function data_provider(): array
+    {
+        return [
+            'Will evaluate false when value is not a string' => [
+                'validationRuleClassString' => EmailRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => 'test1234',
+                'expectedResult' => false
+            ],
+            'Will evaluate false when a string value is provided but it is not a valid email address' => [
+                'validationRuleClassString' => EmailRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => 'test',
+                'expectedResult' => false
+            ],
+            'Will evaluate true when a valid email address is provided' => [
+                'validationRuleClassString' => EmailRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => '[email protected]',
+                'expectedResult' => true,
+            ],
+        ];
+    }
+}