Opinionated Django image transforms on models
Project description
django-simpleimages is an opinionated Django app which makes it very simple to deal transforming images on models, with extremely minimal configuration, as long as:
You want to define sizes in the model and not dynamically in the template
You provide your own storage backend
You want the transformation to happen when the model saves
If any of the above don’t hold true, then this library probably won’t work for you. That said, if all of the above do hold true for you, then this app will likely be the simplest and best way to apply tranformations to images.
Why don’t you just use _?
I started out using sorl-thumbnail. I ran into issues with cache and database access. Along with external file access. I think looked to django-imagekit. That project is much more advanced and allows a great flexibility on every bit of the image generation process. However, what I was looking for was a much simpler tool. Simpler in design, not simpler to implement on my project. I wanted to be able to understand exactly what the potential performance bottlenecks might be for using that image library. So this library fills only the simplest of needs. It will just create and save a new image, based on a field in the model, when the model saves, onto another field in the model. All caching and file access is left to the file storage API.
Installation
Installation is as easy as:
pip install django-simpleimages pip install pillow # or any other version of PIL
Note: django-simpleimages requires Django>=1.5 because it needs to use the update_fields argument for model saving, which was implemented in 1.5.
Then add simpleimages to your INSTALLED_APPS.
Usage
models.py
Here is an example model that will create transformed images on save.
from django.db import models
import simpleimages
class YourModel(models.Model):
image = models.ImageField(
upload_to='images/'
)
thumbnail_image = models.ImageField(
blank=True,
null=True,
editable=False,
upload_to='transformed_images/thumbnails/'
)
large_image = models.ImageField(
blank=True,
null=True,
editable=False,
upload_to='transformed_images/large/'
)
transformed_fields = {
'image': {
'thumbnail_image': simpleimages.transforms.scale(width=10),
'large_image': simpleimages.transforms.scale(width=200),
}
}
simpleimages.track_model(YourModel)simpleimages.track_model is called with the model to track.
The model should have a field called transformed_fields which is a dictionary mapping original image fields to transformed fields. Each of the original image keys maps to a dictionary which maps transformed fields to transformations. The transformations are function that take an image, from the file attribute of the original field, and return a transformed instance of django.core.files.File, not Python’s built-in file object.
Management Command
Since the images are only transformed on the save of the model, if you change a transform, all the models will not be updated until you resave them. If you want to retransform all the images in a model or app use the retransform command.
# re-transforms and saves all models. If an app is specified then only
# the models in that app will be re transformed. If a model is specified
# then only that model in that app will be retransformed. If a field is
# specified within that model, then that field will be recalculated.
# If the field is a transformed field, then it will resave that transformed
# field. If it is a regular field, it will save all the transformations
# for that field.
python manage.py retransform app.model.[field]Contributing
If you find issues or would like to see a feature suppored, head over to the issues section: and report it.
To contribute code in any form, fork the github repository: and clone it locally. Create a new branch for your feature:
git commit -b feature/whatever-you-like
Then make sure all the tests past (and write new ones for any new features):
pip install -e . pip install -r requirements-dev.txt python django-mini.py -a simpleimages -a simpleimages.test --test-runner 'discover_runner.DiscoverRunner' test
Check if the README.rst looks right:
restview -e 'python setup.py --long-description'
Then push the finished feature to github and open a pull request form the branch.
New Release
To create a new release:
Add changes to CHANGES.txt
Change version in setup.py
python setup.py register
python setup.py sdist upload
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
File details
Details for the file django-simpleimages-0.1.7.tar.gz.
File metadata
- Download URL: django-simpleimages-0.1.7.tar.gz
- Upload date:
- Size: 7.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d9a8a7141af0bca77a788b058fede2f11a4e6f39db12cb191fb0d8af6c7b8f50 |
|
| MD5 | 4e7e002d1c16f900e6d208c6b2fcd711 |
|
| BLAKE2b-256 | d86f2f1e7e9fb770c5a7a745b271504fd8ea88baac6c115b27eb60959106f542 |
