django-emailuser

django-emailuser provides a User model for use with django.contrib.auth that is identified by email address. The emailuser.User model also omits the first & last name fields altogether. Otherwise the provided User works just like the contrib.auth User model, using the extension mechanisms available in Django 1.5+.

Install

Install django-emailuser into your Python environment as you would any other Python package.

$ python setup.py install

Convert an existing project

If you have an existing project you want to convert to use django-emailuser, you can in several easy steps.

Add the emailuser app to your project.

 # settings.py

 INSTALLED_APPS = (
     'django.contrib.auth',
     'emailuser',
     'django.contrib.contenttypes',
     'django.contrib.sessions',
     # ...
 )

Run syncdb to create the emailuser.User tables.

 $ python manage.py syncdb
 Syncing...
 Creating tables ...
 Creating table emailuser_user_groups
 Creating table emailuser_user_user_permissions
 Creating table emailuser_user
 ...
 $

Run the converttoemailuser management command to convert your existing user model records to emailuser.User records.
```
 $ python manage.py converttoemailuser
 Converted 2 django.contrib.auth.models.User models into emailuser.User models
 $
```
If you have user records with blank or duplicate email addresses, the conversion will abort with an error to that effect. Change your existing user models (using the shell or web admin) to uniquely identify each user with a valid email address before converting.
Set the AUTH_USER_MODEL setting to use the emailuser.User model.
```
 # settings.py

 AUTH_USER_MODEL = 'emailuser.User'
```
If your project contains models that use generic foreign keys to the user model, update those records to use the emailuser.User model's content type instead.

If you were using Django's auth.User model, run syncdb to remove the stale content type model record for the swapped-out user model. (As with other inactive models, this won't remove the auth_user or other previous user model's table, only the django_content_type record referring to that model.)

 $ python manage.py syncdb
 Syncing...
 Creating tables ...
 The following content types are stale and need to be deleted:

     auth | user

 Any objects related to these content types by a foreign key will also
 be deleted. Are you sure you want to delete these content types?
 If you're unsure, answer 'no'.

     Type 'yes' to continue, or 'no' to cancel: yes
 Installing custom SQL ...
 ...
 $

Use in a new project

For a new Django project with no user records, before you syncdb, add the emailuser app to your INSTALLED_APPS setting and set AUTH_USER_MODEL to emailuser.User:

INSTALLED_APPS = (
    'django.contrib.auth',
    'emailuser',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    # ...
)

AUTH_USER_MODEL = 'emailuser.User'

Then use syncdb to create the database tables and continue as normal.

markpasc/django-emailuser

django-emailuser

Install

Convert an existing project

Use in a new project