feat: added Rule for custom rules

Author: andrepimpao

src/ChainedValidatorInterface.php

@@ -3,6 +3,7 @@
 namespace ProgrammatorDev\YetAnotherPhpValidator;
 
 use ProgrammatorDev\YetAnotherPhpValidator\Exception\ValidationException;
+use ProgrammatorDev\YetAnotherPhpValidator\Rule\RuleInterface;
 
 interface ChainedValidatorInterface
 {
@@ -30,4 +31,6 @@ public function lessThanOrEqual(mixed $constraint, array $options = []): Chained
     public function notBlank(array $options = []): ChainedValidatorInterface;
 
     public function range(mixed $minConstraint, mixed $maxConstraint, array $options = []): ChainedValidatorInterface;
+
+    public function rule(RuleInterface $constraint): ChainedValidatorInterface;
 }

src/Rule/Rule.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace ProgrammatorDev\YetAnotherPhpValidator\Rule;
+
+class Rule extends AbstractRule implements RuleInterface
+{
+    public function __construct(private readonly RuleInterface $constraint) {}
+
+    public function assert(mixed $value, string $name): void
+    {
+        $this->constraint->assert($value, $name);
+    }
+}

src/StaticValidatorInterface.php

@@ -2,6 +2,8 @@
 
 namespace ProgrammatorDev\YetAnotherPhpValidator;
 
+use ProgrammatorDev\YetAnotherPhpValidator\Rule\RuleInterface;
+
 interface StaticValidatorInterface
 {
     public static function all(array $constraints, array $options = null): ChainedValidatorInterface;
@@ -19,4 +21,6 @@ public static function lessThanOrEqual(mixed $constraint, array $options = []):
     public static function notBlank(array $options = []): ChainedValidatorInterface;
 
     public static function range(mixed $minConstraint, mixed $maxConstraint, array $options = []): ChainedValidatorInterface;
+
+    public static function rule(RuleInterface $constraint): ChainedValidatorInterface;
 }

src/Test/Dummy/DummyRule.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace ProgrammatorDev\YetAnotherPhpValidator\Test\Fixture;
+
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\UnexpectedValueException;
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\ValidationException;
+use ProgrammatorDev\YetAnotherPhpValidator\Rule\AbstractRule;
+use ProgrammatorDev\YetAnotherPhpValidator\Rule\RuleInterface;
+
+class DummyRule extends AbstractRule implements RuleInterface
+{
+    public function assert(mixed $value, string $name): void
+    {
+        if (!\is_bool($value)) {
+            throw new UnexpectedValueException('Dummy unexpected value.');
+        }
+
+        if ($value === false) {
+            throw new ValidationException('Dummy exception.');
+        }
+    }
+}

src/Test/Fixture/DummyRule.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace ProgrammatorDev\YetAnotherPhpValidator\Test;
+
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\ValidationException;
+use ProgrammatorDev\YetAnotherPhpValidator\Rule\Rule;
+use ProgrammatorDev\YetAnotherPhpValidator\Test\Fixture\DummyRule;
+use ProgrammatorDev\YetAnotherPhpValidator\Test\Util\TestRuleFailureConditionTrait;
+use ProgrammatorDev\YetAnotherPhpValidator\Test\Util\TestRuleSuccessConditionTrait;
+use ProgrammatorDev\YetAnotherPhpValidator\Test\Util\TestRuleUnexpectedValueTrait;
+
+class RuleTest extends AbstractTest
+{
+    use TestRuleUnexpectedValueTrait;
+    use TestRuleFailureConditionTrait;
+    use TestRuleSuccessConditionTrait;
+
+    public static function provideRuleUnexpectedValueData(): \Generator
+    {
+        yield 'invalid value type' => [
+            new Rule(new DummyRule()),
+            'invalid',
+            '/Dummy unexpected value./'
+        ];
+    }
+
+    public static function provideRuleFailureConditionData(): \Generator
+    {
+        yield 'invalid value' => [
+            new Rule(new DummyRule()),
+            false,
+            ValidationException::class,
+            '/Dummy exception./'
+        ];
+    }
+
+    public static function provideRuleSuccessConditionData(): \Generator
+    {
+        yield 'valid value' => [
+            new Rule(new DummyRule()),
+            true
+        ];
+    }
+
+}