drf-anonymous-login 1.2.1
Django rest framework module to allow login via token (without User instance).
License: MIT
Requires Python: >=3.10

## DRF Anonymous Login

[![PyPI version](https://img.shields.io/pypi/v/drf-anonymous-login.svg)](https://pypi.org/project/drf-anonymous-login/)
[![Run linter and tests](https://github.com/anexia/drf-anonymous-login/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/anexia/drf-anonymous-login/actions/workflows/test.yml)
[![Codecov](https://img.shields.io/codecov/c/gh/anexia/drf-anonymous-login)](https://codecov.io/gh/anexia/drf-anonymous-login)

Django rest framework module to allow login via token (without User instance). Any request with valid token in the
AUTH_HEADER (name configurable via `setting.py`, "HTTP_X_AUTHORIZATION_ANONYMOUS" by default) will be accepted.

### Installation

1. Install using pip:

```shell
pip install drf-anonymous-login
```

2. Integrate `drf_anonymous_login` into your `settings.py`

```python
INSTALLED_APPS = [
    # ...
    'drf_anonymous_login',
    # ...
]
```

### Usage

There are multiple ways to include the `AnonymousLogin` functionality to your endpoints. We recommend to use one of
the following approaches:

1. Inherit from the `AnonymousLoginAuthenticationModelViewSet` for any model that is supposed to be accessible via
valid token header. You'll find a simple exemplary usage scenario provided the [testapp](tests/testapp/views.py).

OR

2. Directly add the `AnonymousLoginAuthentication` and `IsAuthenticated` to your ViewSet's `authentication_classes` and
   `permission_classes` as implemented in the [AnonymousLoginAuthenticationModelViewSet](drf_anonymous_login/views.py).

3. Optionally add the `AnonymousLoginUserMixin` to your app's User model in order to access its `is_anonymous_login`
   and `anonymous_login` properties:
   ```
   # myapp.models.py

   class User(AnonymousLoginUserMixin, AbstractUser):
       pass
   ```

   ```
   # settings.py

   AUTH_USER_MODEL = "myapp.User"
   ```


#### Configure token expiration
The tokens will not expire by default (expiration_datetime remains `None`). You can  configure the
`ANONYMOUS_LOGIN_EXPIRATION` in your application's `settings.py` to define a default expiration in minutes, e.g.
to have any token only valid for 15 minutes, use:
```python
# settings.py

...
ANONYMOUS_LOGIN_EXPIRATION=15

```

## Auto-formatter setup
We use ruff (https://github.com/astral-sh/ruff) for local auto-formatting and for linting in the CI pipeline.
The pre-commit framework (https://pre-commit.com) provides GIT hooks for these tools, so they are automatically applied
before every commit.

Steps to activate:
* Install the pre-commit framework: `pip install pre-commit` (for alternative installation options see https://pre-commit.com/#install)
* Activate the framework (from the root directory of the repository): `pre-commit install`

Hint: You can also run the formatters manually at any time with the following command: `pre-commit run --all-files`

## Unit Tests

See folder [tests/](tests/). The provided tests cover these criteria:
* success:
  * access public endpoint without token
  * access private endpoint with valid token
  * cleanup task does not remove tokens before their expiration_datetime
  * cleanup task removes tokens after their expiration_datetime
* failure:
  * access private endpoint without token
  * access private endpoint with invalid token
  * access private endpoint with expired token

Follow below instructions to run the tests.
You may exchange the installed Django and DRF versions according to your requirements.
:warning: Depending on your local environment settings you might need to explicitly call `python3` instead of `python`.
```bash
# install dependencies
python -m pip install --upgrade pip
pip install -e ".[dev]"

# run tests
cd tests && python manage.py test
```

### Contributing

Contributions are welcomed! Read the [Contributing Guide](CONTRIBUTING.md) for more information.

### Licensing

See [LICENSE](LICENSE) for more information.