Django/django
11
0
Fork 0
Code Pull Requests Projects Releases Activity

[1.11.x] Refs #27807 -- Removed docs for User.username_validator.

Browse Source 
The new override functionality claimed in refs #21379 doesn't work.
Forwardport of 714fdbaa7048c2321f6238d9421137c33d9af7cc from stable/1.10.x.
This commit is contained in:
Tim Graham 2017-02-11 13:39:35 -05:00
parent d13490c18a
commit 331d765281
2 changed files with 5 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/ref/contrib/auth.txt
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`.
.. versionchanged:: 1.10 .. versionchanged:: 1.10
@ -167,27 +166,6 @@ Attributes
In older versions, this was a method. Backwards-compatibility In older versions, this was a method. Backwards-compatibility
support for using it as a method will be removed in Django 2.0. support for using it as a method will be removed in Django 2.0.
.. attribute:: username_validator
.. versionadded:: 1.10
Points to a validator instance used to validate usernames. Defaults to
:class:`validators.UnicodeUsernameValidator` on Python 3 and
:class:`validators.ASCIIUsernameValidator` on Python 2.
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 on Python 3::
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
------- -------

9
docs/releases/1.10.txt
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
-------------- --------------