Refs #27807 -- Removed docs for User.username_validator.

The new override functionality claimed in refs #21379 doesn't work.
Forwardport of 714fdbaa70 from stable/1.10.x.
This commit is contained in:
Tim Graham 2017-02-11 13:39:35 -05:00
parent d0315584b5
commit c84b91b760
2 changed files with 5 additions and 25 deletions

View File

@ -38,8 +38,7 @@ Fields
usernames. Although it wasn't a deliberate choice, Unicode usernames. Although it wasn't a deliberate choice, Unicode
characters have always been accepted when using Python 3. Django characters have always been accepted when using Python 3. Django
1.10 officially added Unicode support in usernames, keeping the 1.10 officially added Unicode support in usernames, keeping the
ASCII-only behavior on Python 2, with the option to customize the ASCII-only behavior on Python 2.
behavior using :attr:`.User.username_validator`.
.. attribute:: first_name .. attribute:: first_name
@ -137,24 +136,6 @@ Attributes
:attr:`~django.contrib.auth.models.User.is_authenticated` to this :attr:`~django.contrib.auth.models.User.is_authenticated` to this
attribute. attribute.
.. attribute:: username_validator
Points to a validator instance used to validate usernames. Defaults to
:class:`validators.UnicodeUsernameValidator`.
To change the default username validator, you can subclass the ``User``
model and set this attribute to a different validator instance. For
example, to use ASCII usernames::
from django.contrib.auth.models import User
from django.contrib.auth.validators import ASCIIUsernameValidator
class CustomUser(User):
username_validator = ASCIIUsernameValidator()
class Meta:
proxy = True # If no new field is added.
Methods Methods
------- -------

View File

@ -60,12 +60,11 @@ wasn't a deliberate choice, Unicode characters have always been accepted when
using Python 3. using Python 3.
The username validator now explicitly accepts Unicode characters by The username validator now explicitly accepts Unicode characters by
default on Python 3 only. This default behavior can be overridden by changing default on Python 3 only.
the :attr:`~django.contrib.auth.models.User.username_validator` attribute of
the ``User`` model, or to any proxy of that model, using either Custom user models may use the new
:class:`~django.contrib.auth.validators.ASCIIUsernameValidator` or :class:`~django.contrib.auth.validators.ASCIIUsernameValidator` or
:class:`~django.contrib.auth.validators.UnicodeUsernameValidator`. Custom user :class:`~django.contrib.auth.validators.UnicodeUsernameValidator`.
models may also use those validators.
Minor features Minor features
-------------- --------------