An example Django project showing how to implement custom users.
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
customuser
tests
.coveragerc
.gitignore
AUTHORS
LICENSE
README.rst
dev-requirements.txt
manage.py
requirements.txt
setup.cfg

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.