diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst index 0d4fc9aeba7..9d4e39033bc 100644 --- a/reference/constraints/Bic.rst +++ b/reference/constraints/Bic.rst @@ -83,6 +83,8 @@ will contain a Business Identifier Code (BIC). } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Available Options ----------------- diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst index 51707f864fd..30757d82dc5 100644 --- a/reference/constraints/CardScheme.rst +++ b/reference/constraints/CardScheme.rst @@ -96,6 +96,8 @@ on an object that will contain a credit card number. } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Available Options ----------------- diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst index b38220b57a0..6217986b960 100644 --- a/reference/constraints/Country.rst +++ b/reference/constraints/Country.rst @@ -73,6 +73,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst index 7349ce51f8a..730be9464d1 100644 --- a/reference/constraints/Currency.rst +++ b/reference/constraints/Currency.rst @@ -79,6 +79,8 @@ a valid currency, you could do the following: } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst index 8d3a7e26e99..bac94f4f5d4 100644 --- a/reference/constraints/Date.rst +++ b/reference/constraints/Date.rst @@ -75,6 +75,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst index 5eeddff77c4..ee557ecbfbe 100644 --- a/reference/constraints/DateTime.rst +++ b/reference/constraints/DateTime.rst @@ -75,6 +75,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst index d9ec28c0334..945f9204d9e 100644 --- a/reference/constraints/Email.rst +++ b/reference/constraints/Email.rst @@ -88,6 +88,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst index 57c229e4b20..bc183a7fe42 100644 --- a/reference/constraints/File.rst +++ b/reference/constraints/File.rst @@ -150,6 +150,8 @@ The ``bioFile`` property is validated to guarantee that it is a real file. Its size and mime type are also validated because the appropriate options have been specified. +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst index 9cc754c7cbb..aa34b771a0b 100644 --- a/reference/constraints/Iban.rst +++ b/reference/constraints/Iban.rst @@ -93,6 +93,8 @@ will contain an International Bank Account Number. } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Available Options ----------------- diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst index c48b57d95d1..988cf96ca64 100644 --- a/reference/constraints/Ip.rst +++ b/reference/constraints/Ip.rst @@ -76,6 +76,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst index f653dfe4ab3..2ffe81ae31b 100644 --- a/reference/constraints/Isbn.rst +++ b/reference/constraints/Isbn.rst @@ -104,6 +104,8 @@ on an object that will contain an ISBN. } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Available Options ----------------- diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst index a57832bd698..fc58a4ec722 100644 --- a/reference/constraints/Issn.rst +++ b/reference/constraints/Issn.rst @@ -79,6 +79,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst index c1ae7bbf561..d1489b5ac18 100644 --- a/reference/constraints/Language.rst +++ b/reference/constraints/Language.rst @@ -74,6 +74,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst index d4f46feb587..9083f4625da 100644 --- a/reference/constraints/Length.rst +++ b/reference/constraints/Length.rst @@ -110,6 +110,8 @@ and "50", you might add the following: } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst index e4728a9d293..a3ca75dcd81 100644 --- a/reference/constraints/Locale.rst +++ b/reference/constraints/Locale.rst @@ -78,6 +78,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst index fe9c09d8407..8a4473fe2e7 100644 --- a/reference/constraints/Luhn.rst +++ b/reference/constraints/Luhn.rst @@ -85,6 +85,8 @@ will contain a credit card number. } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Available Options ----------------- diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst index 458cf93e139..69cbc651ecd 100644 --- a/reference/constraints/Regex.rst +++ b/reference/constraints/Regex.rst @@ -161,6 +161,8 @@ it a custom message: } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst index 64acb618abe..ab40f76d808 100644 --- a/reference/constraints/Time.rst +++ b/reference/constraints/Time.rst @@ -78,6 +78,8 @@ of the day when the event starts: } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst index 14380b00f94..09cd73eeaaa 100644 --- a/reference/constraints/Url.rst +++ b/reference/constraints/Url.rst @@ -76,6 +76,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst index deefad99a7e..9e6d3caaac6 100644 --- a/reference/constraints/Uuid.rst +++ b/reference/constraints/Uuid.rst @@ -78,6 +78,8 @@ Basic Usage } } +.. include:: /reference/constraints/_empty-values-are-valid.rst.inc + Options ------- diff --git a/reference/constraints/_empty-values-are-valid.rst.inc b/reference/constraints/_empty-values-are-valid.rst.inc new file mode 100644 index 00000000000..30c84729f84 --- /dev/null +++ b/reference/constraints/_empty-values-are-valid.rst.inc @@ -0,0 +1,7 @@ +.. note:: + + As with most of the other constraints, ``null`` values and empty strings + are considered valid values. Otherwise, in addition to validating this value, + you would also be requiring it, making it impossible to be optional. That's + why it's common to combine this constraint with + :doc:`NotBlank `.