Skip to main content

Upload large files to Django in multiple chunks, with the ability to resume if the upload is interrupted.

Project description

This simple django app enables users to upload large files to Django in multiple chunks, with the ability to resume if the upload is interrupted.

This app is intented to work with JQuery-File-Upload by Sebastian Tschan (documentation).

License: MIT-Zero.

Demo

If you want to see a very simple Django demo project using this module, please take a look at django-chunked-upload-demo.

Installation

Install via pip:

pip install django-chunked-upload

And then add it to your Django INSTALLED_APPS:

INSTALLED_APPS = (
    # ...
    'chunked_upload',
)

Typical usage

  1. An initial POST request is sent to the url linked to ChunkedUploadView (or any subclass) with the first chunk of the file. The name of the chunk file can be overriden in the view (class attribute field_name). Example:

{"my_file": <File>}
  1. In return, server with response with the upload_id, the current offset and the when will the upload expire (expires). Example:

{
    "upload_id": "5230ec1f59d1485d9d7974b853802e31",
    "offset": 10000,
    "expires": "2013-07-18T17:56:22.186Z"
}
  1. Repeatedly POST subsequent chunks using the upload_id to identify the upload to the url linked to ChunkedUploadView (or any subclass). Example:

{
    "upload_id": "5230ec1f59d1485d9d7974b853802e31",
    "my_file": <File>
}
  1. Server will continue responding with the upload_id, the current offset and the expiration date (expires).

  2. Finally, when upload is completed, a POST request is sent to the url linked to ChunkedUploadCompleteView (or any subclass). This request must include the upload_id and the md5 checksum (hex). Example:

{
    "upload_id": "5230ec1f59d1485d9d7974b853802e31",
    "md5": "fc3ff98e8c6a0d3087d515c0473f8677"
}
  1. If everything is OK, server will response with status code 200 and the data returned in the method get_response_data (if any).

Possible error responses:

  • User is not authenticated. Server responds 403 (Forbidden).

  • Upload has expired. Server responds 410 (Gone).

  • upload_id does not match any upload. Server responds 404 (Not found).

  • No chunk file is found in the indicated key. Server responds 400 (Bad request).

  • Request does not contain Content-Range header. Server responds 400 (Bad request).

  • Size of file exceeds limit (if specified). Server responds 400 (Bad request).

  • Offsets does not match. Server responds 400 (Bad request).

  • md5 checksums does not match. Server responds 400 (Bad request).

Settings

Add any of these variables into your project settings to override them.

CHUNKED_UPLOAD_EXPIRATION_DELTA

  • How long after creation the upload will expire.

  • Default: datetime.timedelta(days=1)

CHUNKED_UPLOAD_PATH

  • Path where uploading files will be stored until completion.

  • Default: 'chunked_uploads/%Y/%m/%d'

CHUNKED_UPLOAD_TO

  • upload_to to be used in the Model’s FileField.

  • Default: CHUNKED_UPLOAD_PATH + '/{{ instance.upload_id }}.part'

CHUNKED_UPLOAD_STORAGE_CLASS

  • Storage system (should be a class).

  • Default: None (use default storage system)

CHUNKED_UPLOAD_ENCODER

  • Function used to encode response data. Receives a dict and returns a string.

  • Default: DjangoJSONEncoder().encode

CHUNKED_UPLOAD_CONTENT_TYPE

  • Content-Type for the response data.

  • Default: 'application/json'

CHUNKED_UPLOAD_MAX_BYTES

  • Max amount of data (in bytes) that can be uploaded. None means no limit.

  • Default: None

CHUNKED_UPLOAD_MODEL_USER_FIELD_NULL

  • Value of null option in user field of ChunkedUpload model

  • Default: True

CHUNKED_UPLOAD_MODEL_USER_FIELD_BLANK

  • Value of blank option in user field of ChunkedUpload model

  • Default: True

Support

If you find any bug or you want to propose a new feature, please use the issues tracker. I’ll be happy to help you! :-)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-chunked-upload-2.0.0.tar.gz (23.3 kB view details)

Uploaded Source

Built Distribution

django_chunked_upload-2.0.0-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file django-chunked-upload-2.0.0.tar.gz.

File metadata

  • Download URL: django-chunked-upload-2.0.0.tar.gz
  • Upload date:
  • Size: 23.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.20.1 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.6.8

File hashes

Hashes for django-chunked-upload-2.0.0.tar.gz
Algorithm Hash digest
SHA256 fb8961029d6a9febb974fb24f529c7773c61a9e6467825db861aae29e1f0c978
MD5 2919074e9261f5febaabe093716897ab
BLAKE2b-256 95cfbdfbbdefa3c33ffffcbf0229d1496bb9a8497d76dfd5f312ed6e76e14291

See more details on using hashes here.

File details

Details for the file django_chunked_upload-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: django_chunked_upload-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 12.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.20.1 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.6.8

File hashes

Hashes for django_chunked_upload-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f81ce8d7a5df87c75c971b31dd15961712e729f8fbb38a9398c85cc01f89316d
MD5 170f678dea6337d8bb922d3357bb520d
BLAKE2b-256 c274694075d93d4ed7637af92a62ef13370758c3b86c8d9559ab9507679aad4b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page