jonathanchu / django-custom-user-example

An example Django project showing how to implement custom users.

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

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.