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
History
1.21.2 (2018-09-04)
- Fixed Django compatibility
1.21.1 (2018-08-01)
- Fixed failing travis build
1.21 (2018-08-01)
- Updated Django dependency and dropped support for Python 3.3.x (https://github.com/dirkmoors/drf-tus/pull/9)
1.20 (2018-02-12)
- Implemented per-view max file size setting (https://github.com/dirkmoors/drf-tus/pull/8)
1.19 (2018-02-08)
- Fixed bug that occured when pausing uploads (https://github.com/dirkmoors/drf-tus/pull/7)
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
drf-tus-1.21.2.tar.gz
(17.8 kB
view hashes)
Built Distribution
Close
Hashes for drf_tus-1.21.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a312e22af4d1e2a3cbf31ef319ff6de44ac1346e7d015ff491fbaa6e7c363a9a |
|
MD5 | 2674debd86957617b0c84e9f6f896b44 |
|
BLAKE2-256 | 78b098e8df4c7c8277864747f81a8644191f19da0f3e531ff48437832261bb8e |