Added factory class. Updated all tests to not crash due to factory class integration changes. Updated README to reflect factory class addition

Author: GuylianGilsing

README.md

@@ -11,6 +11,7 @@ A simple validation library that allows you to write custom validators for your
     - [Installation](#installation)
     - [Usage](#usage)
         - [Obtaining a validator](#obtaining-a-validator)
+            - [Through a factory](#through-a-factory)
         - [Configuring array field validation](#configuring-array-field-validation)
         - [Configuring custom error messages](#configuring-custom-error-messages)
         - [Using the validator](#using-the-validator)
@@ -112,8 +113,10 @@ A validator can be obtained through the `ValidatorBuilder` class:
 
 ```php
 use PHPValidation\Builders\ValidatorBuilder;
+use PHPValidation\Strategies\DefaultValidationStrategy;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 // Your configuration logic here...
 
@@ -129,7 +132,8 @@ use PHPValidation\Validator;
 
 use function PHPValidation\Functions\required;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 // Configures the field validators for each array field
 $builder->setValidators([
@@ -144,7 +148,8 @@ $builder->setErrorMessages([
 ]);
 
 // Passes a new validation handler/strategy to the actual validator
-$builder->setStrategy(new DefaultValidationStrategy());
+$newStrategy = // Your custom strategy here...
+$builder->setStrategy($newStrategy);
 
 // Registers a new validator class that will be returned when you build the validator
 $builder->setValidatorClassName(Validator::class);
@@ -154,6 +159,18 @@ $validator = $builder->build();
 
 **Note**: The builder already comes preconfigured with a strategy and validator class name, the example above just lists all possible configuration options.
 
+#### Through a factory
+A validator can also be obtained through the default factory:
+
+```php
+namespace PHPValidation\Factories\ValidatorFactory;
+
+$factory = new ValidatorFactory();
+$validator = $factory->createDefaultValidator();
+```
+
+**Note**: Adding more methods to this default factory class is possible by inheriting it.
+
 ### Configuring array field validation
 Within the validation builder, an array must be set that defines how a given array should be validated. This uses the following structure:
 
@@ -190,8 +207,10 @@ Once you have configured the validator builder, the validator can be built by us
 
 ```php
 use PHPValidation\Builders\ValidatorBuilder;
+use PHPValidation\Strategies\DefaultValidationStrategy;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 // Your configuration logic here...
 
@@ -202,10 +221,12 @@ The validator can then be used to validate an array:
 
 ```php
 use PHPValidation\Builders\ValidatorBuilder;
+use PHPValidation\Strategies\DefaultValidationStrategy;
 
 use function PHPValidation\Functions\required;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 $builder->setValidators([
     'field1' => [required()],
@@ -276,7 +297,8 @@ use PHPValidation\Builders\ValidatorBuilder;
 use PHPValidation\Strategies\DefaultValidationStrategy;
 use PHPValidation\Validator;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 $builder->setValidators([
     'field1' => [new RequiredField(), new CustomValidator()],
@@ -294,7 +316,8 @@ use PHPValidation\Validator;
 
 use function PHPValidation\Functions\required;
 
-$builder = new ValidatorBuilder();
+$strategy = new DefaultValidationStrategy();
+$builder = new ValidatorBuilder($strategy);
 
 $builder->setValidators([
     'field1' => [required(), custom_validator()],

phpinsights.php

@@ -96,6 +96,16 @@
             'absoluteLineLimit' => 120,
             'ignoreComments' => true,
         ],
+        \NunoMaduro\PhpInsights\Domain\Insights\ForbiddenNormalClasses::class => [
+            'exclude' => [
+                './src/Factories/ValidatorFactory.php',
+            ],
+        ],
+        \SlevomatCodingStandard\Sniffs\Operators\DisallowEqualOperatorsSniff::class => [
+            'exclude' => [
+                './src/Fields/EqualsField.php',
+            ],
+        ],
     ],
 
     /*

src/Builders/ValidatorBuilder.php

@@ -5,7 +5,6 @@
 namespace PHPValidation\Builders;
 
 use ErrorException;
-use PHPValidation\Strategies\DefaultValidationStrategy;
 use PHPValidation\Strategies\ValidationStrategyInterface;
 use PHPValidation\Validator;
 use PHPValidation\ValidatorInterface;
@@ -27,9 +26,9 @@ final class ValidatorBuilder
      */
     private array $errorMessages = [];
 
-    public function __construct()
+    public function __construct(ValidationStrategyInterface $strategy)
     {
-        $this->strategy = new DefaultValidationStrategy();
+        $this->strategy = $strategy;
     }
 
     /**

src/Factories/ValidatorFactory.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPValidation\Factories;
+
+use PHPValidation\Builders\ValidatorBuilder;
+use PHPValidation\Strategies\DefaultValidationStrategy;
+use PHPValidation\ValidatorInterface;
+
+class ValidatorFactory
+{
+    /**
+     * @param array<string, FieldValidatorInterface|array<string, mixed>> $validators An infinite associative array
+     * where each level has a key => FieldValidatorInterface pair.
+     * ```
+     * [
+     *     'field1' => [required(), notEmpty(), minLength(6), maxLength(32)],
+     *     'nestedField' => [
+     *         'field1' => [isNumber(), between(4, 21)],
+     *     ],
+     * ]
+     * ```
+     *
+     * @param array<string, string|array<string, mixed>> $errorMessages An infinite associative array
+     * where each field has a key => string pair that displays a custom error message.
+     * ```
+     * [
+     *     'field1' => [
+     *         'required' => "Field1 is required",
+     *         'notEmpty' => "Field1 must be filled in",
+     *         'minLength' => "Field1 must be at least 6 characters long",
+     *         'maxLength' => "Field1 cannot be longer than 32 characters",
+     *     ],
+     *     'nestedField' => [
+     *         'field1' => [
+     *             'isNumber' => "Field1 must be a number",
+     *             'between' => "Field1 must be between 4 and 21",
+     *         ],
+     *     ],
+     * ]
+     * ```
+     */
+    public function createDefaultValidator(array $validators, array $errorMessages): ValidatorInterface
+    {
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
+
+        $builder->setValidators($validators);
+        $builder->setErrorMessages($errorMessages);
+
+        return $builder->build();
+    }
+}

tests/integration/Fields/BetweenFieldTest.php

@@ -6,6 +6,7 @@
 
 use PHPUnit\Framework\TestCase;
 use PHPValidation\Builders\ValidatorBuilder;
+use PHPValidation\Strategies\DefaultValidationStrategy;
 use stdClass;
 
 use function PHPValidation\Functions\between;
@@ -15,7 +16,7 @@ final class BetweenFieldTest extends TestCase
     public function testIfIntegerBetweenMinMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -36,7 +37,7 @@ public function testIfIntegerBetweenMinMaxIsValid(): void
     public function testIfIntegerMinIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -57,7 +58,7 @@ public function testIfIntegerMinIsValid(): void
     public function testIfIntegerMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -78,7 +79,7 @@ public function testIfIntegerMaxIsValid(): void
     public function testIfIntegerUnderMinIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -109,7 +110,7 @@ public function testIfIntegerUnderMinIsInvalid(): void
     public function testIfIntegerOverMaxIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -140,7 +141,7 @@ public function testIfIntegerOverMaxIsInvalid(): void
     public function testIfFloatBetweenMinMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -161,7 +162,7 @@ public function testIfFloatBetweenMinMaxIsValid(): void
     public function testIfFloatMinIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -182,7 +183,7 @@ public function testIfFloatMinIsValid(): void
     public function testIfFloatMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -203,7 +204,7 @@ public function testIfFloatMaxIsValid(): void
     public function testIfFloatUnderMinIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -234,7 +235,7 @@ public function testIfFloatUnderMinIsInvalid(): void
     public function testIfFloatOverMaxIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -265,7 +266,7 @@ public function testIfFloatOverMaxIsInvalid(): void
     public function testIfStringBetweenMinMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -286,7 +287,7 @@ public function testIfStringBetweenMinMaxIsValid(): void
     public function testIfStringMinIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -307,7 +308,7 @@ public function testIfStringMinIsValid(): void
     public function testIfStringMaxIsValid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $builder->setValidators([
             'field' => [between(0, 100)],
@@ -328,7 +329,7 @@ public function testIfStringMaxIsValid(): void
     public function testIfStringUnderMinIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -359,7 +360,7 @@ public function testIfStringUnderMinIsInvalid(): void
     public function testIfStringOverMaxIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -390,7 +391,7 @@ public function testIfStringOverMaxIsInvalid(): void
     public function testIfNonNumericStringFieldIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -421,7 +422,7 @@ public function testIfNonNumericStringFieldIsInvalid(): void
     public function testIfNonNumericStringWithNumbersFieldIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -452,7 +453,7 @@ public function testIfNonNumericStringWithNumbersFieldIsInvalid(): void
     public function testIfArrayValueIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);
 
@@ -483,7 +484,7 @@ public function testIfArrayValueIsInvalid(): void
     public function testIfObjectValueIsInvalid(): void
     {
         // Arrange
-        $builder = new ValidatorBuilder();
+        $builder = new ValidatorBuilder(new DefaultValidationStrategy());
 
         $fieldValidator = between(0, 100);