Skip to main content

REST version of Django authentication system.

Project description

https://img.shields.io/pypi/v/djoser.svg https://img.shields.io/travis/sunscrapers/djoser/master.svg https://img.shields.io/codecov/c/github/sunscrapers/djoser.svg 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/FBTYjfDPUr99jxZqbLOZhh9Pd.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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for djoser, version 2.0.3
Filename, size File type Python version Upload date Hashes
Filename, size djoser-2.0.3-py3-none-any.whl (25.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size djoser-2.0.3.tar.gz (18.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page