just-work / drf-tus

A Tus (tus.io) library for Django Rest Framework

drf-tus

A Tus (tus.io) library for Django Rest Framework

Documentation

The full documentation is at https://drf-tus.readthedocs.io.

Quickstart

Install drf-tus:

pip install drf-tus

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    "rest_framework_tus",
    ...
)

Add the middleware to MIDDLEWARE:

MIDDLEWARE = (
    ...
    "rest_framework_tus.middleware.TusMiddleware",
    ...
)

Add URL patterns for drf-tus:

urlpatterns = [
    ...
    path(r"^", include("rest_framework_tus.urls", namespace="rest_framework_tus")),
    ...
]

Features

This library implements the following TUS API v1.0.0 protocols:

• Core Protocol (http://tus.io/protocols/resumable-upload.html#core-protocol)
• Creation Protocol (http://tus.io/protocols/resumable-upload.html#creation)
• Expiration Protocol (http://tus.io/protocols/resumable-upload.html#expiration)
• Checksum Protocol (http://tus.io/protocols/resumable-upload.html#checksum)
• Termination Protocol (http://tus.io/protocols/resumable-upload.html#termination)

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Credits

Tools used in rendering this package:

• Cookiecutter
• cookiecutter-djangopackage