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.6 or 2.7
Django-1.5.x
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.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7b3beea79f285969910e8326ca0ea813786763875912790642c820666a810284 |
|
MD5 | 1a302da802a49efe13c7b61192656d1f |
|
BLAKE2b-256 | 26bbb6f6e30c3d6dc1f20d808dd4c80f501c50f8b06b60f34a1d981e876c4178 |