Add GitHub action to check validator constructors

When we make changes to the code, renaming variables, or adding
parameters to a validator, it's easy to forget to update the
documentation.

This commit will create a console command that will automatically update
the headers of each validator documentation file, so it matches the
constructor of the validator itself.

With this change, we avoid having a disparity between the documentation
and the code.

Author: henriquemoody

.github/workflows/continuous-integration-docs.yml

@@ -31,3 +31,6 @@ jobs:
 
       - name: Validators' index
         run: bin/console docs:validators:index
+
+      - name: Validator headers
+        run: bin/console docs:validators:headers

bin/console

@@ -11,6 +11,7 @@ declare(strict_types=1);
 require __DIR__ . '/../vendor/autoload.php';
 
 use Respect\Dev\Commands\CreateMixinCommand;
+use Respect\Dev\Commands\DocsValidatorsHeadersCommand;
 use Respect\Dev\Commands\DocsValidatorsListCommand;
 use Respect\Dev\Commands\UpdateDomainSuffixesCommand;
 use Respect\Dev\Commands\UpdateDomainToplevelCommand;
@@ -25,6 +26,7 @@ return (static function () {
 
     $application = new Application('Respect/Validation', '3.0');
     $application->addCommand(new CreateMixinCommand());
+    $application->addCommand(new DocsValidatorsHeadersCommand($differ));
     $application->addCommand(new DocsValidatorsListCommand($differ));
     $application->addCommand(new UpdateDomainSuffixesCommand());
     $application->addCommand(new UpdateDomainToplevelCommand());

composer.json

@@ -72,13 +72,15 @@
         }
     },
     "scripts": {
+        "docs:validators:headers": "bin/console docs:validators:headers",
         "docs:validators:index": "bin/console docs:validators:index",
         "docheader": "vendor/bin/docheader check library/ tests/",
         "phpcs": "vendor/bin/phpcs",
         "phpstan": "vendor/bin/phpstan analyze",
         "phpunit": "vendor/bin/phpunit --testsuite=unit",
         "pest": "vendor/bin/pest --testsuite=feature --compact",
         "docs": [
+            "@docs:validators:headers",
             "@docs:validators:index"
         ],
         "qa": [

docs/validators/AllOf.md

@@ -1,6 +1,7 @@
 # AllOf
 
-- `AllOf(Validator $validator1, Validator $validator2, Validator ...$validator)`
+- `AllOf(Validator $validator1, Validator $validator2)`
+- `AllOf(Validator $validator1, Validator $validator2, Validator ...$validators)`
 
 Will validate if all inner validators validates.
 

docs/validators/AnyOf.md

@@ -1,6 +1,7 @@
 # AnyOf
 
-- `AnyOf(Validator $validator1, Validator $validator2, Validator ...$validator)`
+- `AnyOf(Validator $validator1, Validator $validator2)`
+- `AnyOf(Validator $validator1, Validator $validator2, Validator ...$validators)`
 
 This is a group validator that acts as an OR operator.
 

docs/validators/Base.md

@@ -1,6 +1,7 @@
 # Base
 
-- `Base(string $base)`
+- `Base(int $base)`
+- `Base(int $base, string $chars)`
 
 Validate numbers in any base, even with non regular bases.
 

docs/validators/Between.md

@@ -1,6 +1,6 @@
 # Between
 
-- `Between(mixed $minimum, mixed $maximum)`
+- `Between(mixed $minValue, mixed $maxValue)`
 
 Validates whether the input is between two other values.
 

docs/validators/Callback.md

@@ -1,6 +1,7 @@
 # Callback
 
 - `Callback(callable $callback)`
+- `Callback(callable $callback, mixed ...$arguments)`
 
 Validates the input using the return of a given callable.
 

docs/validators/Charset.md

@@ -1,6 +1,7 @@
 # Charset
 
-- `Charset(string ...$charset)`
+- `Charset(string $charset)`
+- `Charset(string $charset, string ...$charsets)`
 
 Validates if a string is in a specific charset.
 

docs/validators/Circuit.md

@@ -1,6 +1,7 @@
 # Circuit
 
-- `Circuit(Validator $validator1, Validator $validator2, Validator ...$validator)`
+- `Circuit(Validator $validator1, Validator $validator2)`
+- `Circuit(Validator $validator1, Validator $validator2, Validator ...$validators)`
 
 Validates the input against a series of validators until the first fails.