Browse files

Fixed #13341 -- Clarified the arguments to RegexValidators. Thanks to…

… DrMeers for the report, and David Fischer for the draft text.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 3341f39 commit 2f279ec5950a30dece20615759b28fecada55580 @freakboy3742 freakboy3742 committed May 9, 2010
Showing with 10 additions and 7 deletions.
  1. +10 −7 docs/ref/validators.txt
@@ -16,7 +16,7 @@ for re-using validation logic between different types of fields.
For example, here's a validator that only allows even numbers::
from django.core.exceptions import ValidationError
def validate_even(value):
if value % 2 != 0:
raise ValidationError(u'%s is not an even number' % value)
@@ -63,16 +63,19 @@ methods.
.. attribute:: regex=None
-The regular expression to search for the provided ``value``. Raises a
-``ValidationError`` if no match was found.
+The regular expression pattern to search for the provided ``value``. Raises a
+``ValidationError`` with ``message`` and ``code`` if no match is found. If
+no regex is specified, an empty string is used.
-.. attribute:: code='invalid'
+.. attribute:: message=None
-The error code to use if validation fails. Defaults to ``'invalid'``.
+The error message used by ``ValidationError`` if validation fails. If no
+``message`` is specified, a generic ``"Enter a valid value"`` message is used.
-.. attribute:: message=None
+.. attribute:: code=None
-The error message to use if ``regex`` doesn't match the provided ``value``.
+The error code used by ``ValidationError`` if validation fails. If ``code``
+is not specified, ``"invalid"`` is used.

0 comments on commit 2f279ec

Please sign in to comment.