/django-async-upload

Async file uploads for django-admin. Supports admin inlines and django-storages

Primary LanguageJavaScriptMIT LicenseMIT

django-async-upload

django-async-upload is a django app to allow you to upload large files from within the django admin site asynchrously, that means that you can add any number of files on the admin page (e.g. through inline models) and continue editing other fields while files are uploading.

django-async-upload is compatible with django-storages (tested with S3Storage)

Installation

  • pip install django-async-upload
  • Add admin_async_upload to your INSTALLED_APPS
  • Add url(r'^admin_async_upload/', include('admin_async_upload.urls')), to your urls.py
  • Add a model field eg: from admin_resumable.models import ResumableFileField
class Foo(models.Model):
    bar = models.CharField(max_length=200)
    foo = AsyncFileField()

Optionally:

  • Set ADMIN_RESUMABLE_CHUNKSIZE, default is "1*1024*1024"
  • Set ADMIN_RESUMABLE_STORAGE, default is setting of DEFAULT_FILE_STORAGE and ultimately 'django.core.files.storage.FileSystemStorage'. If you don't want the default FileSystemStorage behaviour of creating new files on the server with filenames appended with _1, _2, etc for consecutive uploads of the same file, then you could use this to set your storage class to something like https://djangosnippets.org/snippets/976/
  • Set ADMIN_RESUMABLE_CHUNK_STORAGE, default is 'django.core.files.storage.FileSystemStorage' . If you don't want the default FileSystemStorage behaviour of creating new files on the server with filenames appended with _1, _2, etc for consecutive uploads of the same file, then you could use this to set your storage class to something like https://djangosnippets.org/snippets/976/
  • Set ADMIN_RESUMABLE_SHOW_THUMB, default is False. Shows a thumbnail next to the "Currently:" link.
  • Set ADMIN_SIMULTANEOUS_UPLOADS to limit number of simulteneous uploads, dedaults to 3. If you have broken pipe issues in local development environment, set this value to 1.

Versions

4.0.0 - inital fork of django-admin-async-upload 3.0.4 with support for Django 4 and later

Compatibility

Tested on Django 4.2 running on python 3.11

Thanks to

original django-admin-resumable-js by jonatron https://github.com/jonatron/django-admin-resumable-js

django-admin-resumable-js fork by roxel https://github.com/roxel/django-admin-resumable-js

django-admin-async-upload fork by DataGreed https://github.com/DataGreed/django-admin-async-upload

Resumable.js https://github.com/23/resumable.js

django-resumable https://github.com/jeanphix/django-resumable