django-admin-resumable-js

django-admin-resumable-js

.. image:: https://api.travis-ci.org/jonatron/django-admin-resumable-js.svg?branch=master :target: https://travis-ci.org/jonatron/django-admin-resumable-js

django-admin-resumable-js is a django app to allow you to upload large files from within the django admin site.

Screenshot

.. image:: https://github.com/jonatron/django-admin-resumable-js/raw/master/screenshot.png?raw=true

Installation

• pip install django-admin-resumable-js
• Add admin_resumable to your INSTALLED_APPS
• Add url(r'^admin_resumable/', include('admin_resumable.urls')), to your urls.py
• Add a model field eg: from admin_resumable.fields import ModelAdminResumableFileField

::

class Foo(models.Model):
    bar = models.CharField(max_length=200)
    foo = ModelAdminResumableFileField()

Optionally:

• Set ADMIN_RESUMABLE_SUBDIR, default is 'admin_uploaded'
• Use upload_to instead of ADMIN_RESUMABLE_SUBDIR
• Set ADMIN_RESUMABLE_CHUNKSIZE, default is "1*1024*1024"
• Set ADMIN_RESUMABLE_STORAGE, default is 'django.core.files.storage.FileSystemStorage' (must be a subclass of django.core.files.storage.FileSystemStorage, or accept the location init parameter). 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.

Versions

1.0: First PyPI release

1.1: Bug fix [1]

1.2: Django 1.9 Compatibility

2.0: Added upload_to

[1] Django silently truncates incomplete chunks, due to the way the multipart parser works: https://github.com/django/django/blob/master/django/http/multipartparser.py This could result in a file being unable to be uploaded, or a corrupt file, depending on the situation.

Compatibility

1.2: {py27,py32,py33,py34,py35}-django{1.6,1.7,1.8,1.9}. python 3.2 and 3.3 supported up to django 1.8.

2.0: {py27,py34,py35}-django{1.8,1.9,1.10,1.11}

3.0: {py27,py35,py36,py37}-django{1.11,2.0,2.1} python 2.7 supported up to django 1.11

Running Tests Locally

Incomplete notes [on ubuntu]

sudo apt-get install python3-venv
python3 -m venv venv
source venv/bin/activate
pip install pytest
pip install tox
tox

Thanks to

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

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