kaczuh/djoser

REST implementation of Django authentication system.

djoser

REST implementation of Django authentication system. Djoser library provides a set of Django Rest Framework views to handle basic actions such as registration, login, logout, password reset and account activation. It works with custom user model.

Instead of reusing Django code (e.g. PasswordResetForm), we reimplemented few things to fit better into Single Page App architecture.

Developed by SUNSCRAPERS with passion & patience.

Documentation

Documentation is available to study at http://djoser.readthedocs.io and in docs directory.

Contributing and development

To start developing on djoser, clone the repository:

$ git clone [email protected]:sunscrapers/djoser.git

If you are a pipenv user you can quickly setup testing environment by using Make commands:

$ make init
$ make test

You do not need to create virtualenv in this case -
it's automatically created for you.

Otherwise, if you cannot use Make commands, please create virtualenv and install requirements manually:

$ pip install django djangorestframework
$ pip install -r requirements.txt

If you are running djoser tests on Python 2.7 you also need to install mock library.

$ pip install mock # only on Python 2.7
$ cd testproject
$ ./manage.py test

If you need to run tests against all supported Python and Django versions then invoke:

$ pip install tox
$ tox

You can also play with test project by running following commands:

$ ./manage.py migrate
$ ./manage.py runserver

Similar projects

List of projects related to Django, REST and authentication:

• django-rest-auth
• django-rest-framework-digestauth
• django-oauth-toolkit
• doac
• django-rest-framework-jwt
• django-rest-framework-httpsignature
• hawkrest