Invert the behaviour of NoWhitespace

Since we have the ability to use `not` as a prefix, having rules that
validate negative behavior makes them a bit inflexible, verbose, and
harder to understand.

This commit will refactor the `NoWhitespace` rule by inverting its
behaviour and renaming it to `Spaced`. Although this is a breaking
change, users will still be able to have a similar behavior with the
prefix `not` + `Spaced`.

Author: henriquemoody

docs/06-concrete-api.md

@@ -7,22 +7,25 @@ or magic methods. We'll use a traditional dependency injection approach.
 ```php
 use Respect\Validation\Validator as v;
 
-$usernameValidator = v::alnum()->noWhitespace()->length(1, 15);
+$usernameValidator = v::alnum()->notSpaced()->length(1, 15);
 $usernameValidator->isValid('alganet'); // true
 ```
 
 If you `var_dump($usernameValidator)`, you'll see a composite of objects with
-`Respect\Validation\Rules\Alnum`, `Respect\Validation\Rules\NoWhitespace` and
+`Respect\Validation\Rules\Alnum`, `Respect\Validation\Rules\Spaced` wrapped in `Respect\Validation\Rules\Not` and
 `Respect\Validation\Rules\Length`. There is a specific object for each rule, and
 the chain only builds the structure. You can build it by yourself:
 
 ```php
 use Respect\Validation\Rules;
+use Respect\Validation\Validator;
 
-$usernameValidator = new Rules\AllOf(
+$usernameValidator = Validator::create(
     new Rules\Alnum(),
-    new Rules\NoWhitespace(),
-    new Rules\Length(1, 15)
+    new Rules\Not(
+        new Rules\Spaced(),
+    ),
+    new Rules\Length(1, 15),
 );
 $usernameValidator->isValid('alganet'); // true
 ```
@@ -33,12 +36,18 @@ container or test it in the way you want. Nesting is still possible:
 ```php
 use Respect\Validation\Rules;
 
-$usernameValidator = new Rules\AllOf(
-    new Rules\Alnum(),
-    new Rules\NoWhitespace(),
-    new Rules\Length(1, 15)
+$usernameValidator = Validator::create(
+    new Rules\Key(
+        'name',
+        new Rules\AllOf(
+            new Rules\Alnum(),
+            new Rules\Not(
+                new Rules\Spaced(),
+            ),
+            new Rules\Length(1, 15),
+        )
+    )
 );
-$userValidator = new Rules\Key('name', $usernameValidator);
 $userValidator->isValid(['name' => 'alganet']); // true
 ```
 
@@ -63,7 +72,7 @@ something complex and returns for you.
 
 > I really don't like static calls, can I avoid it?
 
-Yes. Just use `$validator = new Validator();` each time you want a new validator,
+Yes. Just use `$validator = Validator::create();` each time you want a new validator,
 and continue from there.
 
 > Do you have a static method for each rule?

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

@@ -236,7 +236,6 @@
 - [Json](rules/Json.md)
 - [Lowercase](rules/Lowercase.md)
 - [NotEmoji](rules/NotEmoji.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [Phone](rules/Phone.md)
 - [PhpLabel](rules/PhpLabel.md)
 - [PostalCode](rules/PostalCode.md)
@@ -246,6 +245,7 @@
 - [Slug](rules/Slug.md)
 - [Sorted](rules/Sorted.md)
 - [Space](rules/Space.md)
+- [Spaced](rules/Spaced.md)
 - [StartsWith](rules/StartsWith.md)
 - [StringType](rules/StringType.md)
 - [StringVal](rules/StringVal.md)
@@ -406,7 +406,6 @@
 - [Not](rules/Not.md)
 - [NotEmoji](rules/NotEmoji.md)
 - [NotEmpty](rules/NotEmpty.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [NullOr](rules/NullOr.md)
 - [NullType](rules/NullType.md)
 - [Number](rules/Number.md)
@@ -439,6 +438,7 @@
 - [Slug](rules/Slug.md)
 - [Sorted](rules/Sorted.md)
 - [Space](rules/Space.md)
+- [Spaced](rules/Spaced.md)
 - [StartsWith](rules/StartsWith.md)
 - [StringType](rules/StringType.md)
 - [StringVal](rules/StringVal.md)

docs/rules/Alnum.md

@@ -72,8 +72,8 @@ See also:
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
 - [NotEmoji](NotEmoji.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)
 - [StringType](StringType.md)
 - [StringVal](StringVal.md)
 - [Uppercase](Uppercase.md)

docs/rules/Alpha.md

@@ -66,7 +66,7 @@ See also:
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
 - [NotEmoji](NotEmoji.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)
 - [Uppercase](Uppercase.md)
 - [Vowel](Vowel.md)

docs/rules/Blank.md

@@ -56,8 +56,8 @@ It's similar to [NotEmpty](NotEmpty.md), but way stricter.
 See also:
 
 - [NotEmpty](NotEmpty.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [Undef](Undef.md)
 - [UndefOr](UndefOr.md)

docs/rules/CreditCard.md

@@ -30,7 +30,7 @@ The current supported brands are:
 - RuPay (`'RuPay'` or `CreditCard::RUPAY`)
 
 It ignores any non-numeric characters, use [Digit](Digit.md),
-[NoWhitespace](NoWhitespace.md), or [Regex](Regex.md) when appropriate.
+[Spaced](Spaced.md), or [Regex](Regex.md) when appropriate.
 
 ```php
 v::digit()->creditCard()->isValid('5376747397208720'); // true
@@ -79,5 +79,5 @@ See also:
 - [Digit](Digit.md)
 - [Iban](Iban.md)
 - [Luhn](Luhn.md)
-- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
+- [Spaced](Spaced.md)

docs/rules/NoWhitespace.md

@@ -3,7 +3,7 @@
 - `NotEmpty()`
 
 Validates wether the given input is not empty. This function also takes whitespace
-into account, use `noWhitespace()` if no spaces or linebreaks and other
+into account, use `notSpaced()` if no spaces or linebreaks and other
 whitespace anywhere in the input is desired.
 
 ```php
@@ -68,8 +68,8 @@ See also:
 - [Each](Each.md)
 - [Max](Max.md)
 - [Min](Min.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [Undef](Undef.md)
 - [UndefOr](UndefOr.md)

docs/rules/NotEmpty.md

@@ -0,0 +1,55 @@
+# Spaced
+
+- `Spaced()`
+
+Validates if a string contains at least one whitespace (spaces, tabs, or line breaks);
+
+```php
+v::spaced()->isValid('foo bar'); // true
+v::spaced()->isValid("foo\nbar"); // true
+```
+
+This is most useful when inverting the validator as `notSpaced()`, and chaining with other validators such as [Alnum](Alnum.md) or [Alpha](Alpha.md) to ensure that a string contains no whitespace characters:
+
+```php
+v::notSpaced()->alnum()->isValid('username'); // true
+v::notSpaced()->alnum()->isValid('user name'); // false
+```
+
+## Templates
+
+### `Spaced::TEMPLATE_STANDARD`
+
+| Mode       | Template                                         |
+| ---------- | ------------------------------------------------ |
+| `default`  | {{subject}} must contain at least one whitespace |
+| `inverted` | {{subject}} must not contain whitespaces         |
+
+## Template placeholders
+
+| Placeholder | Description                                                      |
+| ----------- | ---------------------------------------------------------------- |
+| `subject`   | The validated input or the custom validator name (if specified). |
+
+## Categorization
+
+- Strings
+
+## Changelog
+
+| Version | Description                                  |
+| ------: | -------------------------------------------- |
+|   3.0.0 | Renamed to `Spaced` and changed the behavior |
+|   0.3.9 | Created as `NoWhitespace`                    |
+
+---
+
+See also:
+
+- [Alnum](Alnum.md)
+- [Alpha](Alpha.md)
+- [Blank](Blank.md)
+- [CreditCard](CreditCard.md)
+- [NotEmpty](NotEmpty.md)
+- [Undef](Undef.md)
+- [UndefOr](UndefOr.md)

docs/rules/Spaced.md

@@ -59,7 +59,7 @@ See also:
 
 - [Blank](Blank.md)
 - [NotEmpty](NotEmpty.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NullType](NullType.md)
 - [Number](Number.md)
+- [Spaced](Spaced.md)
 - [UndefOr](UndefOr.md)