Skip to main content

djoser

https://img.shields.io/pypi/v/djoser.svg Build Status https://codecov.io/gh/sunscrapers/djoser/branch/master/graph/badge.svg https://img.shields.io/pypi/dm/djoser Docs

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 the following requirements:

  • Python>=3.8

  • Django>=3.0.0

  • Django REST Framework>=3.12

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

We use poetry as dependency management and packaging tool.

$ cd djoser
$ poetry install --all-extras

This will create a virtualenv with all development dependencies.

To run the test just type:

$ poetry run py.test testproject

We also prepared a convenient Makefile to automate commands above:

$ make init
$ make test

To activate the virtual environment run

$ poetry shell

Without poetry

New versions of pip can use pyproject.toml to build the package and install its dependencies.

$ pip install .[test]
$ cd testproject
$ ./manage.py test

Example project

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

$ make migrate
$ make runserver

Commiting your code

Before sending patches please make sure you have pre-commit activated in your local git repository:

$ pre-commit install

This will ensure that your code is cleaned before you commit it.

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.

Metadata

Release files for djoser-decacoaching 2.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for djoser-decacoaching 2.2.2
File Size Uploaded
djoser_decacoaching-2.2.2.tar.gz 27.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for djoser-decacoaching 2.2.2
File Interpreter ABI Platform
djoser_decacoaching-2.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 70.4 kB

Release files / djoser_decacoaching-2.2.2.tar.gz

Download URL djoser_decacoaching-2.2.2.tar.gz
Size 27.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a7e64adbadaee81d0b7a1fbc528cdde6449c04b8b938b484311c6fc368e8005f
BLAKE2b-256 checksum
How to use checksums
cfb97f8f9d53d60272c2695dc70ec045074f4050a1d4ba023c7f6ebe9f324d41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.7.1 CPython/3.11.3 Linux/6.5.0-27-generic

Release files / djoser_decacoaching-2.2.2-py3-none-any.whl

Download URL djoser_decacoaching-2.2.2-py3-none-any.whl
Size 43.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
062e97a01d3a2b0faf30d2d9d78d87ebec4fb505ceb90c9c607b9fc27a1273d7
BLAKE2b-256 checksum
How to use checksums
508b31ac420a412b35e0dca61dd89cafd1a47171f85ad96eb3c068cad3d48c47
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.7.1 CPython/3.11.3 Linux/6.5.0-27-generic

Release history Release notifications | RSS feed

This release

2.2.2 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page