django-queued-storage¶
This storage backend enables having a local and a remote storage backend. It will save any file locally and queue a task to transfer it somewhere else using Celery.
If the file is accessed before it’s transferred, the local copy is returned.
Installation¶
pip install django-queued-storage
Configuration¶
- Follow the configuration instructions for django-celery
- Set up a caching backend
- Add 'queued_storage' to your INSTALLED_APPS setting
Usage¶
The QueuedStorage can be used as a drop-in replacement wherever using django.core.files.storage.Storage might otherwise be required.
This example is using django-storages for the remote backend:
from django.db import models
from queued_storage.backends import QueuedStorage
from storages.backends.s3boto import S3BotoStorage
queued_s3storage = QueuedStorage(
'django.core.files.storage.FileSystemStorage',
'storages.backends.s3boto.S3BotoStorage')
class MyModel(models.Model):
image = ImageField(storage=queued_s3storage)
Settings¶
- queued_storage.conf.settings.QUEUED_STORAGE_CACHE_PREFIX¶
Default : 'queued_storage' The cache key prefix to use when caching the storage backends.
- queued_storage.conf.settings.QUEUED_STORAGE_RETRIES¶
Default : 5 How many retries should be attempted before aborting.
- queued_storage.conf.settings.QUEUED_STORAGE_RETRY_DELAY¶
Default : 60 The delay between retries in seconds.
Reference¶
For further details see the reference documentation:
Issues¶
For any bug reports and feature requests, please use the Github issue tracker.