Django REST Registration

User registration REST API, based on Django REST Framework.

Documentation

Full documentation for the project is available at https://django-rest-registration.readthedocs.io/.

Requirements

Django (2.0+, 3.0+, 4.0+, 5.0+) and Django-REST-Framework (3.3+)
Python 3.7 or higher (no Python 2 support!)

Features

Supported views:
- registration (sign-up) with verification
- login/logout (sign-in), session- or token-based
- user profile (retrieving / updating)
- reset password
- change password
- register (change) e-mail
Views are compatible with django-rest-swagger
Views can be authenticated via session or auth token
Modeless (uses the user defined by settings.AUTH_USER_MODEL and also uses cryptographic signing instead of profile models)
Uses password validation
Heavily tested (Above 98% code coverage)

Current limitations

Supports only one email per user (as model field)
No JWT support (but you can easily implement one or use Django REST Registration along libraries like django-rest-framework-simplejwt)

Installation & Configuration

You can install Django REST Registration latest version via pip:

pip install django-rest-registration

Then, you should add it to the INSTALLED_APPS so the app templates for notification emails can be accessed:

INSTALLED_APPS=(
    ...

    'rest_registration',
)

After that, you can use the urls in your urlconfig, for instance:

api_urlpatterns = [
    ...

    path('accounts/', include('rest_registration.api.urls')),
]


urlpatterns = [
    ...

    path('api/v1/', include(api_urlpatterns)),
]

You can configure Django REST Registration using the REST_REGISTRATION setting in your Django settings (similarly to Django REST Framework).

Below is sample, minimal config you can provide in your django settings which will satisfy the system checks:

REST_REGISTRATION = {
    'REGISTER_VERIFICATION_ENABLED': False,
    'RESET_PASSWORD_VERIFICATION_ENABLED': False,
    'REGISTER_EMAIL_VERIFICATION_ENABLED': False,
}

However, the preferred base configuration would be:

REST_REGISTRATION = {
    'REGISTER_VERIFICATION_URL': 'https://frontend-host/verify-user/',
    'RESET_PASSWORD_VERIFICATION_URL': 'https://frontend-host/reset-password/',
    'REGISTER_EMAIL_VERIFICATION_URL': 'https://frontend-host/verify-email/',

    'VERIFICATION_FROM_EMAIL': 'no-reply@example.com',
}

The frontend urls are not provided by the library but should be provided by the user of the library, because Django REST Registration is frontend-agnostic. The frontend urls will receive parameters as GET query and should pass them to corresponding REST API views via HTTP POST request.

In case when any verification is enabled (which is the default!), your Django application needs to be properly configured so it can send e-mails.

You can read more about basic configuration here.

You can read more about detailed configuration here.

Configuration options

You can find all REST_REGISTRATION configuration options here.

Contributing

If you want to contribute, please refer to separate document CONTRIBUTING.md.

Release files for django-rest-registration 0.9.0

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

Source distribution (sdist)

Source distribution for django-rest-registration 0.9.0
File	Size	Uploaded
django_rest_registration-0.9.0.tar.gz	39.1 kB	Aug 31, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-rest-registration 0.9.0
File	Interpreter	ABI	Platform	Reset
django_rest_registration-0.9.0-py3-none-any.whl 60.0 kB Aug 31, 2024	Python 3	none	any	Details

Total release size: 99.1 kB

Release files / django_rest_registration-0.9.0.tar.gz

Download URL	django_rest_registration-0.9.0.tar.gz
Size	39.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`a8cb87b419cdafa434298c8fa492df81b26505412c50df43098bef8d16d0ad8a`
BLAKE2b-256 checksum How to use checksums	`72e0bab3cacb76c12b0a6beae5d532cc5feb4ce7f54c14a144027b22724ef118`
Upload date	Aug 31, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.1 CPython/3.10.14`

Release files / django_rest_registration-0.9.0-py3-none-any.whl

Download URL	django_rest_registration-0.9.0-py3-none-any.whl
Size	60.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3260b0bc53246866dd857d577605b9fe6daf7890ed25fe7658d5885a602db110`
BLAKE2b-256 checksum How to use checksums	`fffa265c5026e4a3a4d65a07e19d5e7ecc6970abe613ab3c946fde4e5e4a06a2`
Upload date	Aug 31, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.1 CPython/3.10.14`