Add DateRule validation and corresponding tests; refactor validation test cases

Author: Fa-BRAIK

clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1736375439">
-  <project timestamp="1736375439">
+<coverage generated="1736423484">
+  <project timestamp="1736423484">
     <package name="Nuxtifyts\PhpDto\Attributes\Class">
       <file name="/Users/faroukbraik/Dev/php-dto/src/Attributes/Class/MapName.php">
         <class name="Nuxtifyts\PhpDto\Attributes\Class\MapName" namespace="Nuxtifyts\PhpDto\Attributes\Class">
@@ -1727,6 +1727,18 @@
         <line num="85" type="stmt" count="1"/>
         <metrics loc="89" ncloc="79" classes="1" methods="3" coveredmethods="3" conditionals="0" coveredconditionals="0" statements="33" coveredstatements="33" elements="36" coveredelements="36"/>
       </file>
+      <file name="/Users/faroukbraik/Dev/php-dto/src/Validation/Rules/DateRule.php">
+        <class name="Nuxtifyts\PhpDto\Validation\Rules\DateRule" namespace="Nuxtifyts\PhpDto\Validation\Rules">
+          <metrics complexity="4" methods="3" coveredmethods="3" conditionals="0" coveredconditionals="0" statements="3" coveredstatements="3" elements="6" coveredelements="6"/>
+        </class>
+        <line num="13" type="method" name="evaluate" visibility="public" complexity="2" crap="2" count="4"/>
+        <line num="15" type="stmt" count="4"/>
+        <line num="21" type="method" name="make" visibility="public" complexity="1" crap="1" count="5"/>
+        <line num="23" type="stmt" count="5"/>
+        <line num="26" type="method" name="validationMessage" visibility="public" complexity="1" crap="1" count="1"/>
+        <line num="28" type="stmt" count="1"/>
+        <metrics loc="31" ncloc="28" classes="1" methods="3" coveredmethods="3" conditionals="0" coveredconditionals="0" statements="3" coveredstatements="3" elements="6" coveredelements="6"/>
+      </file>
       <file name="/Users/faroukbraik/Dev/php-dto/src/Validation/Rules/NullableRule.php">
         <class name="Nuxtifyts\PhpDto\Validation\Rules\NullableRule" namespace="Nuxtifyts\PhpDto\Validation\Rules">
           <metrics complexity="3" methods="3" coveredmethods="3" conditionals="0" coveredconditionals="0" statements="3" coveredstatements="3" elements="6" coveredelements="6"/>
@@ -1763,6 +1775,6 @@
         <metrics loc="9" ncloc="9" classes="0" methods="0" coveredmethods="0" conditionals="0" coveredconditionals="0" statements="0" coveredstatements="0" elements="0" coveredelements="0"/>
       </file>
     </package>
-    <metrics files="83" loc="4250" ncloc="3605" classes="65" methods="176" coveredmethods="145" conditionals="0" coveredconditionals="0" statements="1079" coveredstatements="993" elements="1255" coveredelements="1138"/>
+    <metrics files="84" loc="4281" ncloc="3633" classes="66" methods="179" coveredmethods="148" conditionals="0" coveredconditionals="0" statements="1082" coveredstatements="996" elements="1261" coveredelements="1144"/>
   </project>
 </coverage>

src/Validation/Rules/DateRule.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Validation\Rules;
+
+class DateRule implements ValidationRule
+{
+    public string $name {
+        get {
+            return 'date';
+        }
+    }
+
+    public function evaluate(mixed $value): bool
+    {
+        return is_string($value) && strtotime($value) !== false;
+    }
+
+    /** 
+     *  @param ?array<string, mixed> $parameters
+     */
+    public static function make(?array $parameters = null): self
+    {
+        return new self();
+    }
+
+    public function validationMessage(): string
+    {
+        return 'The :attribute must be a valid date.';
+    }
+}

tests/Unit/Validation/BackedEnumRuleTest.php

@@ -16,7 +16,7 @@
 #[CoversClass(ValidationRuleException::class)]
 #[UsesClass(YesNoBackedEnum::class)]
 #[UsesClass(YesNoEnum::class)]
-final class BackedEnumRuleTest extends ValidationRuleUnitCase
+final class BackedEnumRuleTest extends ValidationRuleTestCase
 {
     /** 
      *  @throws Throwable

tests/Unit/Validation/DateRuleTest.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Tests\Unit\Validation;
+
+use Nuxtifyts\PhpDto\Validation\Rules\DateRule;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use Throwable;
+
+#[CoversClass(DateRule::class)]
+final class DateRuleTest extends ValidationRuleTestCase
+{
+    /** 
+     *  @throws Throwable
+     */
+    #[Test]
+    public function validate_validation_message(): void
+    {
+        $rule = DateRule::make();
+
+        self::assertEquals(
+            'The :attribute must be a valid date.',
+            $rule->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 valid datetime string' => [
+                'validationRuleClassString' => DateRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => 'not-a-valid-datetime-string',
+                'expectedResult' => false
+            ],
+            'Will evaluate true when a valid datetime string is provided (Y-m-d)' => [
+                'validationRuleClassString' => DateRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => '2021-01-01',
+                'expectedResult' => true
+            ],
+            'Will evaluate true when a valid datetime string is provided (ATOM)' => [
+                'validationRuleClassString' => DateRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => '2021-01-01T00:00:00+00:00',
+                'expectedResult' => true
+            ],
+            'Will evaluate true when a valid datetime string is provided (Y-m-d H:m:s)' => [
+                'validationRuleClassString' => DateRule::class,
+                'makeParams' => null,
+                'expectedMakeException' => null,
+                'valueToBeEvaluated' => '2021-01-01 00:00:00',
+                'expectedResult' => true
+            ],
+        ];
+    }
+}

tests/Unit/Validation/NullableRuleTest.php

@@ -10,7 +10,7 @@
 use Throwable;
 
 #[CoversClass(NullableRule::class)]
-final class NullableRuleTest extends ValidationRuleUnitCase
+final class NullableRuleTest extends ValidationRuleTestCase
 {
     /** 
      *  @throws Throwable

tests/Unit/Validation/RequiredRuleTest.php

@@ -10,7 +10,7 @@
 use Throwable;
 
 #[CoversClass(RequiredRule::class)]
-final class RequiredRuleTest extends ValidationRuleUnitCase
+final class RequiredRuleTest extends ValidationRuleTestCase
 {
     /** 
      *  @throws Throwable

tests/Unit/Validation/ValidationRuleUnitCase.php renamed to tests/Unit/Validation/ValidationRuleTestCase.php

@@ -9,7 +9,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use Throwable;
 
-abstract class ValidationRuleUnitCase extends UnitCase
+abstract class ValidationRuleTestCase extends UnitCase
 {
     abstract function validate_validation_message(): void;