An example Django project showing how to implement custom users.
Python
Latest commit 7200992 Jan 19, 2016 @jonathanchu Merge pull request #6 from aniketmaithani/master
feat(tests/): Added simple test cases for `custom user model`

README.rst

Django Custom User Example

This is an example Django project that demonstrates the configurable User model available in Django 1.5. It is inspired by Dr. Russell Keith-Magee's talk at DjangoCon US 2013 Red User, Blue User, MyUser, auth.User.

Getting Started

Clone this repository:

$ git clone https://github.com/jonathanchu/django-custom-user-example.git
$ cd django-custom-user-example

Create a virtual environment for this project and install Django (1.5.4+ recommended):

$ mkvirtualenv customuser
(customuser) $ pip install django

Run syncdb or migrate (depending on your Django version) and create a superuser when prompted: (Django < 1.9)

(customuser) $ python manage.py syncdb
...

(Django 1.9+)

(customuser) $ python manage.py migrate
...
(customuser) $ python manage.py createsuperuser
...

Run runserver:

(customuser) $ python manage.py runserver

Finally, open up http://127.0.0.1:8000/admin in your browser and login with the superuser just created. You should see your custom user under "Accounts".

Screenshots

http://i.imgur.com/As2xDEg.png

http://i.imgur.com/uaG4qaH.png

Running Tests Locally

  • Tests have been added to this sample project. You can install these tests from

dev-requirements. - Py.Test has been integrated with the test suite. In order to run these tests just run the following command py.test

  • In case you want to see your test coverage, just run py.test --cov .

Comments/Feedback

Suggestions for any modifications, please feel free to fork and contribute!

Please file bugs at https://github.com/jonathanchu/django-custom-user-example/issues.