Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apragacz/django-rest-registration
User-related REST API based on the awesome Django REST Framework
https://github.com/apragacz/django-rest-registration
auth authentication change-password django django-application django-rest-framework django-rest-registration drf login python-3 register registration reset-password rest-api sign-in sign-up signin signup
Last synced: 1 day ago
JSON representation
User-related REST API based on the awesome Django REST Framework
- Host: GitHub
- URL: https://github.com/apragacz/django-rest-registration
- Owner: apragacz
- License: mit
- Created: 2015-12-27T13:51:11.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-11-19T10:05:28.000Z (24 days ago)
- Last Synced: 2024-11-28T04:03:42.066Z (15 days ago)
- Topics: auth, authentication, change-password, django, django-application, django-rest-framework, django-rest-registration, drf, login, python-3, register, registration, reset-password, rest-api, sign-in, sign-up, signin, signup
- Language: Python
- Homepage: https://django-rest-registration.readthedocs.io/
- Size: 3.46 MB
- Stars: 549
- Watchers: 17
- Forks: 84
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-django-rest-framework - django-rest-registration
- awesome-translation - Django REST Registration
- awesome-django-rest-framework - django-rest-registration
README
# Django REST Registration
[](https://circleci.com/gh/apragacz/django-rest-registration)
[](https://codecov.io/github/apragacz/django-rest-registration?branch=master)
[](https://pypi.python.org/pypi/django-rest-registration/)
[](https://django-rest-registration.readthedocs.io/en/latest/?badge=latest)
User registration REST API, based on Django REST Framework.
## Documentation
Full documentation for the project is available at [https://django-rest-registration.readthedocs.io/](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](https://github.com/marcgibbons/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](https://docs.djangoproject.com/en/dev/topics/signing/) instead of profile models)
* Uses [password validation](https://docs.djangoproject.com/en/dev/topics/auth/passwords/#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](https://django-rest-registration.readthedocs.io/en/latest/cookbook/jwt.html)
or use Django REST Registration along libraries like
[django-rest-framework-simplejwt](https://github.com/davesque/django-rest-framework-simplejwt))
## Installation & Configuration
You can [install](https://django-rest-registration.readthedocs.io/en/latest/install.html)
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:
```python
INSTALLED_APPS=(
...
'rest_registration',
)
```
After that, you can use the urls in your urlconfig, for instance:
```python
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:
```python
REST_REGISTRATION = {
'REGISTER_VERIFICATION_ENABLED': False,
'RESET_PASSWORD_VERIFICATION_ENABLED': False,
'REGISTER_EMAIL_VERIFICATION_ENABLED': False,
}
```
However, the preferred base configuration would be:
```python
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': '[email protected]',
}
```
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](https://docs.djangoproject.com/en/dev/topics/email/).
You can read more about basic configuration
[here](https://django-rest-registration.readthedocs.io/en/latest/quickstart.html).
You can read more about detailed configuration
[here](https://django-rest-registration.readthedocs.io/en/latest/detailed_configuration/).
## Configuration options
You can find all `REST_REGISTRATION` configuration options
[here](https://django-rest-registration.readthedocs.io/en/latest/detailed_configuration/all_settings.html).
## Contributing
If you want to contribute, please refer to separate document [CONTRIBUTING.md](CONTRIBUTING.md).