Skip to content
REST implementation of Django authentication system.
Python HTML Makefile
Branch: master
Clone or download

Latest commit

dekoza Merge pull request #493 from darshkpatel/patch-1
Add urls.py config documentation for social auth
Latest commit 786edc2 May 18, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
djoser Merge pull request #492 from gone/rotate_session_pass_change May 18, 2020
docs Add urls.py config May 7, 2020
testproject Merge pull request #492 from gone/rotate_session_pass_change May 18, 2020
.gitignore Add config for codacy Jul 24, 2019
.pre-commit-config.yaml
.travis.yml Fix codacy upload only on push Jul 23, 2019
CHANGELOG.rst Fix login validation Aug 24, 2019
CREDITS.rst Add CREDITS file May 25, 2017
LICENSE Fix permission logic, add more tests, add HIDE_USERS setting Jul 22, 2019
MANIFEST.in Translate messages to the most important languages Jan 29, 2019
Makefile Update README and requirements.txt Jul 16, 2019
Pipfile use six directly instead of django.utils.six for Django 3.0 compatibi… Apr 7, 2020
Pipfile.lock use six directly instead of django.utils.six for Django 3.0 compatibi… Apr 7, 2020
README.rst Merge pull request #464 from vlavorini/master Mar 18, 2020
pyproject.toml update dependencies Aug 15, 2019
pytest.ini Add django-2.0 to tox matrix, update requirements, bump version Jul 18, 2018
requirements.txt Code cleanup, fix test suite, adjust supported versions Jul 22, 2019
setup.cfg Translate messages to the most important languages Jan 29, 2019
setup.py Fix login validation Aug 24, 2019
tox.ini Tested all the permission schemas Sep 17, 2019

README.rst

djoser

Codacy Badge

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.

https://asciinema.org/a/94J4eG2tSBD2iEfF30a6vGtXw.png

Requirements

To be able to run djoser you have to meet following requirements:

  • Python (3.5, 3.6, 3.7, 3.8)
  • Django (1.11, 2.2)
  • Django REST Framework (3.9, 3.10)

If you need to support other versions, please use djoser<2.

Installation

Simply install using pip:

$ pip install djoser

And continue with the steps described at configuration guide.

Documentation

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

Contributing and development

To start developing on djoser, clone the repository:

$ git clone git@github.com:sunscrapers/djoser.git

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

$ make init
$ make test

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

$ pip install django djangorestframework
$ pip install -r requirements.txt
$ cd testproject
$ ./manage.py test

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

$ pip install tox
$ tox -p all

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:

  • Please, keep in mind that while using custom authentication and TokenCreateSerializer

validation, there is a path that ignores intentional return of None from authenticate() and try to find User using parameters. Probably, that will be changed in the future.

You can’t perform that action at this time.