Fixed #26401 -- Added BaseAuthConfig to use auth without migrations.

This commit is contained in:
Jon Dufresne 2016-09-10 16:38:05 -07:00 committed by GitHub
parent 0368d63a78
commit 1ec1633cb2
5 changed files with 121 additions and 2 deletions

View file

@ -645,3 +645,20 @@ The following backends are available in :mod:`django.contrib.auth.backends`:
Same as :class:`RemoteUserBackend` except that it doesn't reject inactive
users because :attr:`~RemoteUserBackend.user_can_authenticate` always
returns ``True``.
``AppConfig`` classes
=====================
.. module:: django.contrib.auth.apps
:synopsis: AppConfigs for contrib.auth.
.. class:: AuthConfig
The default :class:`~django.apps.AppConfig`.
.. class:: BaseAuthConfig
.. versionadded:: 1.11
An :class:`~django.apps.AppConfig` for use if you :ref:`aren't using
<using-auth-without-models>` any of the built-in ``contrib.auth`` models.

View file

@ -109,6 +109,10 @@ Minor features
* Added password validators ``help_text`` to
:class:`~django.contrib.auth.forms.UserCreationForm`.
* The new :class:`~django.contrib.auth.apps.BaseAuthConfig` ``AppConfig``
allows using the authentication system :ref:`without any of the built-in
models <using-auth-without-models>`.
:mod:`django.contrib.contenttypes`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View file

@ -1133,3 +1133,28 @@ Finally, specify the custom model as the default user model for your project
using the :setting:`AUTH_USER_MODEL` setting in your ``settings.py``::
AUTH_USER_MODEL = 'customauth.MyUser'
.. _using-auth-without-models:
Using ``contrib.auth`` without the built-in models
==================================================
The models shipped with ``contrib.auth`` may not be required. For example, if
you :ref:`customize the user model <auth-custom-user>` and don't use the
:class:`~django.contrib.auth.models.Permission` and
:class:`~django.contrib.auth.models.Group` models, then the ``auth`` tables
may be unused. To avoid creating these tables, modify the
:setting:`MIGRATION_MODULES` setting and disable the migrations for the
``auth`` app::
MIGRATION_MODULES = {'auth': None}
To prevent creation of the default permissions, change ``'django.contrib.auth'``
in :setting:`INSTALLED_APPS` to
:class:`django.contrib.auth.apps.BaseAuthConfig`::
INSTALLED_APPS = [
...
'django.contrib.auth.apps.BaseAuthConfig',
...
]