Django custom storage for Thumbor backend.
Project description
A Django custom storage for Thumbor backend.
This app provide 2 classes ThumborStorage and ThumborMigrationStorage. The last one is a storage you can use for Imagefield initialy using a FileSystemStorage you want to migrate to Thumbor without batch-moving all of them. That way, Django continues to serve them from the file system until you change the image on that field.
Install
pip install django-thumborstorage
Dependencies
Python 2.7
Django-1.5+
Recommended:
Django-thumbor (to manage thumbnails).
Usage
settings.py
Add django_thumborstorage in your INSTALLED_APPS.
And set the following:
THUMBOR_SERVER = 'http://localhost:8888'
THUMBOR_SECURITY_KEY = 'MY_SECURE_KEY'
# This may be a different host than THUMBOR_SERVER
# only reachable by your Django server.
THUMBOR_RW_SERVER = 'http://localhost:8888'
models.py
Just set the storage parameter in the ImageField you want to manage with Thumbor:
from django_thumborstorage.storages import ThumborStorage
class Stuff(models.Model):
def upload_path(instance, filename):
return 'stuffs/%s' % filename
photo = models.ImageField(upload_to=upload_path,
storage=ThumborStorage(),
height_field='photo_height',
width_field='photo_width')
photo_height = models.IntegerField(blank=True, null=True)
photo_width = models.IntegerField(blank=True, null=True)
In the code
You can get the Thumbor uuid from the <ImageField> instance using:
my_stuff.photo.storage.key(my_stuff.photo.name)
This is useful to generate_url() with Django-thumbor when original files are stored on Thumbor. Thus, you can pass the key as url parameter.
CHANGELOG
0.91.6
Add storages.readonly_to_rw_url(), a function to convert a read-only thumbor url in a rw url.
0.91.5
Use THUMBOR_SERVER to generate the original file url.
Backward imcompatibilities
THUMBOR_SERVER and THUMBOR_SECURITY_KEY are required in settings.
0.91.4
Add ThumborStorage.key(name) to retrieve the Thumbor uuid from the name.
0.91.3
Backward imcompatibilities
THUMBOR_WRITABLE_SERVER setting is replaced by THUMBOR_RW_SERVER since it is now used to retrieve the original file.
TODO
PUT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-thumborstorage-0.91.8.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff3966487ff4db407a415a3ad5d3846d1dc9103c9ab9e394447e4e7b21741aa3 |
|
MD5 | 8eb4a592a17b7db81aaf0519c96acfec |
|
BLAKE2b-256 | 38e6e12711720b335349d4e3025fd6e72ce32e68bf17f3e0144e16d737920b01 |