Deprecate all exception classes

It won't be possible to catch specific exceptions; users will need to
catch `ValidationException`. The `NestedValidationException` will be
removed in the next major version, but there's no alternative to it
right now, so I didn't deprecate it.

CONTRIBUTING.md

@@ -79,44 +79,6 @@ final class HelloWorld extends AbstractRule
 }
 ```
 
-### Creating the rule exception
-
-Just that and we're done with the rule code. The Exception requires you to
-declare messages used by `assert()` and `check()`. Messages are declared in
-affirmative and negative moods, so if anyone calls `v::not(v::helloWorld())` the
-library will show the appropriate message.
-
-```php
-<?php
-
-/*
- * Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
- * SPDX-License-Identifier: MIT
- */
-
-declare(strict_types=1);
-
-namespace Respect\Validation\Exceptions;
-
-/**
- * @author Your Name <youremail@yourdomain.tld>
- */
-final class HelloWorldException extends ValidationException
-{
-    /**
-     * {@inheritDoc}
-     */
-    protected $defaultTemplates = [
-        self::MODE_DEFAULT => [
-            self::STANDARD => '{{name}} must be a Hello World',
-        ],
-        self::MODE_NEGATIVE => [
-            self::STANDARD => '{{name}} must not be a Hello World',
-        ]
-    ];
-}
-```
-
 ### Creating unit tests
 
 Finally, we need to test if everything is running smooth. We have `RuleTestCase`

library/Exceptions/AllOfException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see NestedValidationException} instead.
  */
 class AllOfException extends GroupedValidationException
 {

library/Exceptions/AlnumException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AlnumException extends FilteredValidationException
 {

library/Exceptions/AlphaException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AlphaException extends FilteredValidationException
 {

library/Exceptions/AlwaysInvalidException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AlwaysInvalidException extends ValidationException
 {

library/Exceptions/AlwaysValidException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AlwaysValidException extends ValidationException
 {

library/Exceptions/AnyOfException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AnyOfException extends NestedValidationException
 {

library/Exceptions/ArrayTypeException.php

@@ -14,6 +14,7 @@
  * @author Emmerson Siqueira <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author João Torquato <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ArrayTypeException extends ValidationException
 {

library/Exceptions/ArrayValException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Emmerson Siqueira <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ArrayValException extends ValidationException
 {

library/Exceptions/AttributeException.php

@@ -15,6 +15,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Emmerson Siqueira <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class AttributeException extends NestedValidationException implements NonOmissibleException
 {

library/Exceptions/Base64Exception.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Jens Segers <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class Base64Exception extends ValidationException
 {

library/Exceptions/BaseException.php

@@ -13,6 +13,7 @@
  * @author Carlos André Ferrari <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class BaseException extends ValidationException
 {

library/Exceptions/BetweenException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class BetweenException extends NestedValidationException
 {

library/Exceptions/BoolTypeException.php

@@ -14,6 +14,7 @@
  *
  * @author Devin Torres <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class BoolTypeException extends ValidationException
 {

library/Exceptions/BoolValException.php

@@ -13,6 +13,7 @@
  * @author Emmerson Siqueira <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class BoolValException extends ValidationException
 {

library/Exceptions/BsnException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Ronald Drenth <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class BsnException extends ValidationException
 {

library/Exceptions/CallException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CallException extends NestedValidationException
 {

library/Exceptions/CallableTypeException.php

@@ -13,6 +13,7 @@
  * Exception class for CallableType rule.
  *
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CallableTypeException extends ValidationException
 {

library/Exceptions/CallbackException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CallbackException extends NestedValidationException
 {

library/Exceptions/CharsetException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CharsetException extends ValidationException
 {

library/Exceptions/CnhException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Kinn Coelho Julião <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CnhException extends ValidationException
 {

library/Exceptions/CnpjException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Leonn Leite <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CnpjException extends ValidationException
 {

library/Exceptions/ConsonantException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Danilo Correa <[email protected]>
  * @author Kleber Hamada Sato <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ConsonantException extends FilteredValidationException
 {

library/Exceptions/ContainsAnyException.php

@@ -11,6 +11,7 @@
 
 /**
  * @author Kirill Dlussky <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ContainsAnyException extends ValidationException
 {

library/Exceptions/ContainsException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ContainsException extends ValidationException
 {

library/Exceptions/ControlException.php

@@ -13,6 +13,7 @@
  * @author Andre Ramaciotti <[email protected]>
  * @author Danilo Correa <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ControlException extends FilteredValidationException
 {

library/Exceptions/CountableException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author João Torquato <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CountableException extends ValidationException
 {

library/Exceptions/CountryCodeException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CountryCodeException extends ValidationException
 {

library/Exceptions/CpfException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Jair Henrique <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CpfException extends ValidationException
 {

library/Exceptions/CreditCardException.php

@@ -15,6 +15,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Jean Pimentel <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CreditCardException extends ValidationException
 {

library/Exceptions/CurrencyCodeException.php

@@ -13,6 +13,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Justin Hook <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class CurrencyCodeException extends ValidationException
 {

library/Exceptions/DateException.php

@@ -12,6 +12,7 @@
 /**
  * @author Bruno Luiz da Silva <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DateException extends ValidationException
 {

library/Exceptions/DateTimeException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DateTimeException extends ValidationException
 {

library/Exceptions/DecimalException.php

@@ -11,6 +11,7 @@
 
 /**
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DecimalException extends ValidationException
 {

library/Exceptions/DigitException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DigitException extends FilteredValidationException
 {

library/Exceptions/DirectoryException.php

@@ -12,6 +12,7 @@
 /**
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DirectoryException extends ValidationException
 {

library/Exceptions/DomainException.php

@@ -12,6 +12,7 @@
 /**
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class DomainException extends NestedValidationException
 {

library/Exceptions/EachException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EachException extends NestedValidationException
 {

library/Exceptions/EmailException.php

@@ -17,6 +17,7 @@
  * @author Eduardo Gulias Davis <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author Paul Karikari <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EmailException extends ValidationException
 {

library/Exceptions/EndsWithException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EndsWithException extends ValidationException
 {

library/Exceptions/EqualsException.php

@@ -13,6 +13,7 @@
  * @author Alexandre Gomes Gaigalas <[email protected]>
  * @author Henrique Moody <[email protected]>
  * @author Ian Nisbet <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EqualsException extends ValidationException
 {

library/Exceptions/EquivalentException.php

@@ -11,6 +11,7 @@
 
 /**
  * @author Henrique Moody <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EquivalentException extends ValidationException
 {

library/Exceptions/EvenException.php

@@ -15,6 +15,7 @@
  * @author Henrique Moody <[email protected]>
  * @author Jean Pimentel <[email protected]>
  * @author Paul Karikari <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class EvenException extends ValidationException
 {

library/Exceptions/ExecutableException.php

@@ -12,6 +12,7 @@
 /**
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ExecutableException extends ValidationException
 {

library/Exceptions/ExistsException.php

@@ -12,6 +12,7 @@
 /**
  * @author Henrique Moody <[email protected]>
  * @author William Espindola <[email protected]>
+ * @deprecated Using rule exceptions directly is deprecated, and will be removed in the next major version. Please use {@see ValidationException} instead.
  */
 final class ExistsException extends ValidationException
 {