Create All rule and all prefix

This rule behaves similarly to ``Each, but the difference is that it
presents the messages in a simpler manner. This allows users to have a
simpler message when validating all items in an array or iterable
value.

I’m also introducing the `all` prefix, making it easier for users to
apply the `All` rule in combination with other rules.

Author: henriquemoody

bin/create-mixin

@@ -8,6 +8,8 @@ require __DIR__ . '/../vendor/autoload.php';
 use Nette\PhpGenerator\InterfaceType;
 use Nette\PhpGenerator\PhpNamespace;
 use Nette\PhpGenerator\Printer;
+use Respect\Validation\Mixins\AllBuilder;
+use Respect\Validation\Mixins\AllChain;
 use Respect\Validation\Mixins\Chain;
 use Respect\Validation\Mixins\KeyBuilder;
 use Respect\Validation\Mixins\KeyChain;
@@ -168,6 +170,7 @@ function overwriteFile(string $content, string $basename): void
     ];
 
     $mixins = [
+        ['All', 'all', [], ['All', ...$structureRelatedRules]],
         ['Key', 'key', [], $structureRelatedRules],
         ['Length', 'length', $numberRelatedRules, []],
         ['Max', 'max', $numberRelatedRules, []],
@@ -207,6 +210,7 @@ function overwriteFile(string $content, string $basename): void
 
         if ($name === '') {
             $chainedInterface->addExtend(Rule::class);
+            $chainedInterface->addExtend(AllChain::class);
             $chainedInterface->addExtend(KeyChain::class);
             $chainedInterface->addExtend(LengthChain::class);
             $chainedInterface->addExtend(MaxChain::class);
@@ -217,6 +221,7 @@ function overwriteFile(string $content, string $basename): void
             $chainedInterface->addExtend(UndefOrChain::class);
             $chainedInterface->addComment('@mixin \\' . Validator::class);
 
+            $staticInterface->addExtend(AllBuilder::class);
             $staticInterface->addExtend(KeyBuilder::class);
             $staticInterface->addExtend(LengthBuilder::class);
             $staticInterface->addExtend(MaxBuilder::class);

docs/09-list-of-rules-by-category.md

@@ -43,6 +43,7 @@
 
 ## Comparisons
 
+- [All](rules/All.md)
 - [Between](rules/Between.md)
 - [BetweenExclusive](rules/BetweenExclusive.md)
 - [Equals](rules/Equals.md)
@@ -270,6 +271,7 @@
 
 ## Transformations
 
+- [All](rules/All.md)
 - [Call](rules/Call.md)
 - [Each](rules/Each.md)
 - [Length](rules/Length.md)
@@ -302,6 +304,7 @@
 
 ## Alphabetically
 
+- [All](rules/All.md)
 - [AllOf](rules/AllOf.md)
 - [Alnum](rules/Alnum.md)
 - [Alpha](rules/Alpha.md)

docs/rules/All.md

@@ -0,0 +1,55 @@
+# All
+
+- `All(Rule $rule)`
+
+Validates all items of the input against a given rule.
+
+```php
+v::all(v::intType())->isValid([1, 2, 3]); // true
+v::all(v::intType())->isValid([1, 2, '3']); // false
+```
+
+This rule is similar to [Each](Each.md), but as opposed to the former, it displays a single message when asserting an input.
+
+## Note
+
+This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally. If an input has no items, the validation will fail.
+
+## Templates
+
+### `All::TEMPLATE_STANDARD`
+
+| Mode       | Template     |
+| ---------- | ------------ |
+| `default`  | Every item in |
+| `inverted` | Every item in |
+
+This template serve as message prefixes.:
+
+```php
+v::all(v::floatType())->assert([1.5, 2]);
+// Message: Every item in `[1.5, 2]` must be float
+
+v::not(v::all(v::intType()))->assert([1, 2, -3]);
+// Message: Every item in `[1, 2, -3]` must not be an integer
+```
+
+## Categorization
+
+- Comparisons
+- Transformations
+
+## Changelog
+
+| Version | Description |
+| ------: | ----------- |
+|   3.0.0 | Created     |
+
+---
+
+See also:
+
+- [Each](Each.md)
+- [Length](Length.md)
+- [Max](Max.md)
+- [Min](Min.md)

docs/rules/Each.md

@@ -22,7 +22,7 @@ v::call('array_keys', v::each(v::stringType()))->isValid($releaseDates); // true
 
 ## Note
 
-This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally. If an input has no items, the validation will fail. 
+This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally. If an input has no items, the validation will fail.
 
 ## Templates
 
@@ -57,6 +57,7 @@ This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally
 
 See also:
 
+- [All](All.md)
 - [ArrayVal](ArrayVal.md)
 - [Call](Call.md)
 - [Falsy](Falsy.md)
@@ -65,5 +66,6 @@ See also:
 - [Key](Key.md)
 - [KeyExists](KeyExists.md)
 - [KeyOptional](KeyOptional.md)
+- [Length](Length.md)
 - [Min](Min.md)
 - [Unique](Unique.md)

docs/rules/Length.md

@@ -72,8 +72,10 @@ Used when it's impossible to get the length of the input.
 
 See also:
 
+- [All](All.md)
 - [Between](Between.md)
 - [BetweenExclusive](BetweenExclusive.md)
+- [Each](Each.md)
 - [GreaterThan](GreaterThan.md)
 - [GreaterThanOrEqual](GreaterThanOrEqual.md)
 - [LessThan](LessThan.md)

docs/rules/Max.md

@@ -52,6 +52,7 @@ This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally
 
 See also:
 
+- [All](All.md)
 - [Between](Between.md)
 - [BetweenExclusive](BetweenExclusive.md)
 - [DateTimeDiff](DateTimeDiff.md)

docs/rules/Min.md

@@ -52,6 +52,7 @@ This rule uses [Length](Length.md) with [GreaterThan][GreaterThan.md] internally
 
 See also:
 
+- [All](All.md)
 - [Between](Between.md)
 - [BetweenExclusive](BetweenExclusive.md)
 - [DateTimeDiff](DateTimeDiff.md)