django-drf-filepond is a Django app that provides a filepond server-side implementation for Django/Django REST Framework projects. The app can be easily added to your Django projects to provide a server-side API for the filepond file upload library.
Further documentation and a tutorial are available at https://django-drf-filepond.readthedocs.io.
The app can be installed from PyPi:
pip install django-drf-filepond
or add it to your list of dependencies in a requirements.txt file.
There are three key configuration updates to make within your Django application to set up django-drf-filepond:
Add 'django-drf-filepond' to INSTALLED_APPS in your Django settings file (e.g. settings.py):
...
INSTALLED_APPS = [
...,
'django_drf_filepond'
]
...Set the location where you want django-drf-filepond to store temporary file uploads by adding the DJANGO_DRF_FILEPOND_UPLOAD_TMP configuration variable to your settings file, e.g.:
import os
...
DJANGO_DRF_FILEPOND_UPLOAD_TMP = os.path.join(BASE_DIR, 'filepond-temp-uploads')
...Add the URL mappings for django-drf-filepond to your URL configuration in urls.py:
from django.conf.urls import url, include
urlpatterns = [
...
url(r'^fp/', include('django_drf_filepond.urls')),
]On the client side, you need to set the endpoints of the process, revert, fetch, load and restore functions to match the endpoint used in your path statement above. For example if the first parameter to url is fp/ then the endpoint for the process function will be /fp/process/.
If you wish to let django-drf-filepond manage the permanent storage of file uploads (note that this is required if you wish to use the load method), you need to set DJANGO_DRF_FILEPOND_FILE_STORE_PATH in your application settings file, e.g.
...
DJANGO_DRF_FILEPOND_FILE_STORE_PATH = os.path.join(BASE_DIR, 'stored_uploads')
...See "Working with file uploads" below for more information on how to move temporary uploads to django-drf-filepond-managed permanent storage.
When a file is uploaded from a filepond client, the file is placed into a uniquely named directory within the temporary upload directory specified by the DJANGO_DRF_FILEPOND_UPLOAD_TMP parameter. As per the filepond server spec, the server returns a unique identifier for the file upload. In this case, the identifier is a 22-character unique ID generated using the shortuuid library. This ID is the name used for the directory created under DJANGO_DRF_FILEPOND_UPLOAD_TMP into which the file is placed. At present, the file also has a separate unique identifier which hides the original name of the file on the server filesystem. The original filename is stored within the django-drf-filepond app's database.
When/if the client subsequently submits the form associated with the filepond instance that triggered the upload, the unique directory ID will be passed and this can be used to look up the temporary file.
There are two different approaches for handling files that need to be stored permanently on a server after being uploaded from a filepond client via django-drf-filepond. These two approaches are not mutually exclusive and you can choose to use one approach for some files and the other approach for other files if you wish.
Using this approach, you move the file initially stored as a temporary upload by django-drf-filepond to a storage location of your choice and the file then becomes independent of django-drf-filepond. The following example shows how to lookup a temporary upload given its unique upload ID and move it to a permanent storage location. The temporary upload record is then deleted and django-drf-filepond no longer has any awareness of the file:
import os
from django_drf_filepond.models import TemporaryUpload
# Get the temporary upload record
tu = TemporaryUpload.objects.get(upload_id='<22-char unique ID>')
# Move the file somewhere for permanent storage
# The file will be saved with its original name
os.rename(tu.get_file_path(), '/path/to/permanent/location/%s' % tu.upload_name)
# Delete the temporary upload record and the temporary directory
tu.delete()Note: You must use this approach for storing any files that you subsequently want to access using filepond's load function.
Using this approach, the file is stored to a location under the django-drf-filepond file storage directory as set by the DJANGO_DRF_FILEPOND_FILE_STORE_PATH setting.
from django_drf_filepond.api import store_upload
# Given a variable upload_id containing a 22-character unique file upload ID:
su = store_upload(upload_id, destination_file_path='target_dir/filename.ext')
# destination_file_path is a relative path (including target filename.
# The path will created under the file store directory and the original
# temporary upload will be deleted.The destination_file_path parameter passed to store_upload should be relative to the base upload location as defined by DJANGO_DRF_FILEPOND_FILE_STORE_PATH. If you pass a path that begins with /, the leading / will be removed and the path will be interpreted as being relative to DJANGO_DRF_FILEPOND_FILE_STORE_PATH. The path that you provide should include the filename that you would like the file stored as.
This repository is licensed under a BSD 3-Clause license. Please see the LICENSE file in the root of the repository.
Thanks to pqina for producing the filepond file upload library that this Django app provides server-side support for.
The django-drf-filepond app has been built as part of work that is being supported by UK Research and Innovation (Engineering and Phsycial Sciences Research Council) under grant EP/R025460/1.