django-authtools

A custom user model app for Django 1.11+ that features email as username and other things. It tries to stay true to the built-in user model for the most part.

The main differences between authtools's User and django.contrib.auth's are email as username and class-based auth views.

Read the django-authtools documentation.

Quickstart

Before you use this, you should probably read the documentation about custom User models.

1. Install the package:

   $ pip install django-authtools

2. Add authtools to your INSTALLED_APPS.

3. Add the following to your settings.py:

   AUTH_USER_MODEL = 'authtools.User'

4. Enjoy.