A Tus (tus.io) library for Django Rest Framework
Project description
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 (or MIDDLEWARE_CLASSES for Django < 1.10)
MIDDLEWARE = (
...
'rest_framework_tus.middleware.TusMiddleware',
...
)
Add drf-tus’s URL patterns:
urlpatterns = [
...
url(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:
History
1.18 (2018-02-08)
Make the metadata ‘filename’ key a setting. (https://github.com/dirkmoors/drf-tus/pull/2)
Switch from (Positive)IntegerField to BigIntegerField for the upload_length and upload_offset fields (https://github.com/dirkmoors/drf-tus/pull/3)
Increase Django version support up to 1.11 (https://github.com/dirkmoors/drf-tus/pull/4)
Fix unicode errors (https://github.com/dirkmoors/drf-tus/pull/5)
Updated travis configuration
1.17 (2017-05-10)
Exchanged use of base64.encodebytes to base64.b64encode.
1.16 (2017-05-04)
Implemented validate_filename handler in TusCreateMixin.
1.15 (2017-04-06)
Added missing migration and changed max_length to 255 for model Upload’s attribute uploaded_file
1.14 (2017-03-30)
Updated default behaviour of the get_header handler in TusMiddleware.
1.13 (2017-03-30)
Implemented handler for retrieving request headers in TusMiddleware.
1.12 (2017-03-10)
Updated validate_chunk signature
1.11 (2017-03-10)
Implemented validate_chunk handler method in TusPatchMixin
Implemented validate_success_headers handler method in TusCreateMixin
1.10 (2017-03-09)
Disabled chunk writing to disk
1.9 (2017-03-09)
Introduced TusUploadStreamParser
1.8 (2017-03-09)
Introduced setting to include serializer data in respons body
1.7 (2017-03-09)
Bugfixes
1.6 (2017-03-09)
Bugfixes
1.5 (2017-03-09)
Updated middleware, removed required header (bug!)
1.4 (2017-03-09)
Initial migration
1.3 (2017-03-09)
Renamed some parameters / classes
1.2 (2017-03-09)
Cleanup repository.
1.1 (2017-03-09)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for drf_tus-1.18-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a94704e3576d4056ba8959ff7e8bc32c92a31c90137d59c2002b29f881625b39 |
|
MD5 | 7f2731be6156a23dfcc5fa29c67a2513 |
|
BLAKE2b-256 | 0bbf55c99f7443181031fae20a48aaef76eceefe87456965a81397d60fc3e771 |