===============
Easy Thumbnails
===============
.. image:: https://img.shields.io/pypi/v/easy-thumbnails.svg
:target: https://pypi.python.org/pypi/easy-thumbnails/
.. image:: https://github.com/SmileyChris/easy-thumbnails/actions/workflows/python.yml/badge.svg
:alt: Build Status
:target: https://github.com/SmileyChris/easy-thumbnails/actions/workflows/python.yml
A powerful, yet easy to implement thumbnailing application for Django 2.2+
Below is a quick summary of usage. For more comprehensive information, view the
`full documentation`__ online or the peruse the project's ``docs`` directory.
__ http://easy-thumbnails.readthedocs.org/en/latest/index.html
Breaking News
=============
Version 2.8.0 adds support for thumbnailing SVG images when installed with the ``[svg]`` extra.
Of course it doesn't make sense to thumbnail SVG images, because being in vector format they can
scale to any size without quality of loss. However, users of easy-thumbnails may want to upload and
use SVG images just as if they would be PNG, GIF or JPEG. They don't necessarily care about the
format and definitely don't want to convert them to a pixel based format. What they want is to reuse
their templates with the templatetag thumbnail and scale and crop the images to whatever their
`<img src="..." width="..." height="...">` has been prepared for.
This is done by adding an emulation layer named VIL, which aims to be compatible with the
`PIL <https://python-pillow.org/>`_ library. All thumbnailing operations, such as scaling and
cropping behave like pixel based images. The final filesize of such thumbnailed SVG images doesn't
of course change, but their width/height and bounding box may be adjusted to reflect the desired
size of the thumbnailed image.
.. note:: This feature is new and experimental, hence feedback about its proper functioning in
third parts applications is highly appreciated.
Installation
============
Run ``pip install easy-thumbnails``.
Add ``easy_thumbnails`` to your ``INSTALLED_APPS`` setting:
.. code-block:: python
INSTALLED_APPS = (
...
'easy_thumbnails',
)
Run ``manage.py migrate easy_thumbnails``.
Example usage
=============
Thumbnail options can be predefined in ``settings.THUMBNAIL_ALIASES`` or just
specified in the template or Python code when run.
Using a predefined alias
------------------------
Given the following setting:
.. code-block:: python
THUMBNAIL_ALIASES = {
'': {
'avatar': {'size': (50, 50), 'crop': True},
},
}
Template:
.. code-block:: html+django
{% load thumbnail %}
<img src="{{ profile.photo|thumbnail_url:'avatar' }}" alt="" />
Python:
.. code-block:: python
from easy_thumbnails.files import get_thumbnailer
thumb_url = get_thumbnailer(profile.photo)['avatar'].url
Manually specifying size / options
----------------------------------
Template:
.. code-block:: html+django
{% load thumbnail %}
<img src="{% thumbnail profile.photo 50x50 crop %}" alt="" />
Python:
.. code-block:: python
from easy_thumbnails.files import get_thumbnailer
options = {'size': (100, 100), 'crop': True}
thumb_url = get_thumbnailer(profile.photo).get_thumbnail(options).url
Using in combination with other thumbnailers
--------------------------------------------
Alternatively, you load the templatetags by {% load easy_thumbnails_tags %}
instead of traditional {% load thumbnail %}. It's especially useful in
projects that do make use of multiple thumbnailer libraries that use the
same name (`thumbnail`) for the templatetag module:
.. code-block:: html+django
{% load easy_thumbnails_tags %}
<img src="{% thumbnail profile.photo 50x50 crop %}" alt="" />
Fields
======
You can use ``ThumbnailerImageField`` (or ``ThumbnailerField``) for easier
access to retrieve or generate thumbnail images.
For example:
.. code-block:: python
from easy_thumbnails.fields import ThumbnailerImageField
class Profile(models.Model):
user = models.OneToOneField('auth.User')
photo = ThumbnailerImageField(upload_to='photos', blank=True)
Accessing the field's predefined alias in a template:
.. code-block:: html+django
{% load thumbnail %}
<img src="{{ profile.photo.avatar.url }}" alt="" />
Accessing the field's predefined alias in Python code:
.. code-block:: python
thumb_url = profile.photo['avatar'].url
Thumbnail options
=================
``crop``
--------
Before scaling the image down to fit within the ``size`` bounds, it first cuts
the edges of the image to match the requested aspect ratio.
Use ``crop="smart"`` to try to keep the most interesting part of the image,
Use ``crop="0,10"`` to crop from the left edge and a 10% offset from the
top edge. Crop from a single edge by leaving dimension empty (e.g.
``crop=",0"``). Offset from the right / bottom by using negative numbers
(e.g., crop="-0,-10").
Often used with the ``upscale`` option, which will allow enlarging of the image
during scaling.
``quality=XX``
--------------
Changes the quality of the output JPEG thumbnail. Defaults to ``85``.
In Python code, this is given as a separate option to the ``get_thumbnail``
method rather than just alter the other.
``keep_icc_profile``
--------------------
If `True`, when saving a thumbnail with the alias that defines this option, the
ICC profile of the image will be preserved in the thumbnail, if present in the first place.
Other options
-------------
Valid thumbnail options are determined by the "thumbnail processors" installed.
See the `reference documentation`__ for a complete list of options provided by
the default thumbnail processors.
__ http://easy-thumbnails.readthedocs.org/en/latest/ref/processors/
Changes
=======
2.10 (2024-09-11)
-----------------
* Drop support for Python-3.8.
* Drop support for Django-4.1 and earlier.
* Add support for Django-5.1.
* Experimental support for animated image formats. See documentation for more infos.
* Fix #642: Do not scale images (SVG) without size information.
* Fix #366: Keep ICC profile when saving image, if present.
2.9 (2024-07-25)
----------------
* Add support for Django 4.2 storages (mandatory in Django 5.1).
2.8.5 (2023-01-09)
------------------
* Fix regression introduced in version 2.8.4. Argument ``quality`` is not removed for images
of type ``.webp``.
2.8.4 (2022-12-19)
------------------
* Fix problem when thumbnailing images of type TIFF. PIL's ``TiffImagePlugin`` doesn't
like argument ``quality``.
* Replace deprecated Pillow constants against newer counterparts. Check
https://pillow.readthedocs.io/en/stable/releasenotes/9.1.0.html#deprecations for details.
2.8.3 (2022-08-02)
------------------
* Fix regression in library detection introduced in version 2.8.2.
2.8.2 (2022-07-31)
------------------
* Installation of easy-thumbnails now optionally depends on the reportlab library.
2.8.1 (2022-01-20)
------------------
* Add support for Django 4.
* New ``THUMBNAIL_IMAGE_SAVE_OPTIONS`` setting.
* Fix #587: Uploading SVG Images to S3 storage.
2.8.0 (2021-11-03)
------------------
* Add support for thumbnailing SVG images. This is done by adding an emulation layer named VIL,
which aims to be compatible with PIL. All thumbnailing operations, such as scaling and cropping
behave like pixel images.
* Remove configuration directives ``THUMBNAIL_HIGH_RESOLUTION`` and ``THUMBNAIL_HIGHRES_INFIX``
from easy-thumbnails setting directives.
2.7.2 (2021-10-17)
------------------
* Add support for Django 3.2 and Python-3.10.
* Fix #563: Do not close image after loading content.
* In management command ``thumbnail_cleanup``, replace ``print``-statements
against ``stdout.write``.
* Use Python format strings whereever possible.
2.7.1 (2020-11-23)
------------------
* Add support for Django 3.1
2.7.0 (2019-12-15)
------------------
* Add support for Django 3.0
* Drop support for Python 2
* Drop support for Django < 1.11
* Drop support for Django 2.0, 2.1
2.6.0 (2019-02-03)
------------------
* Added testing for Django 2.2 (no code changes required).
2.5.0 (2017-10-31)
------------------
* Support Django versions up to 1.11. Version 2.0 is in beta.
* Fix: Pickle/unpickle machine. The ThumbnailerField fields no longer
generated thumbnails.
* Removed all references to South migrations.
2.4.2 (2017-09-14)
------------------
* Supported Django versions are now 1.8 or 1.10+, Python 2.7 minimum.
* Fix IOError saving JPEG files with transparency on Pillow 4.2+.
* Fix #450, #473: fixed int/string is not a callable in management command.
* Fix #456: Delete method of ThumbnailerFieldFile is called twice.
2.4.1 (2017-04-05)
------------------
* New minimum requirement of Django 1.4 or 1.7+.
* Fix EXIF orientation to use transpose.
* Upgrades to avoid deprecation warnings.
* Fix app settings not working in Django 1.11.
* Fix a bad conditional check causing incorrect behaviour in autocropping
transparent images.
* Django 1.8+ compatibility for ``thumbnail_cleanup`` command.
* Add ``easy_thumbnails_tags`` template tag mirror to allow multiple
thumbnailer libraries to coexist happily.
* Limit pillow to its final compatible version when on Python 2.6
* Fix tests.
2.3 (2015-12-11)
----------------
* New ``Alias`` namer.
* Avoid a potential concurrency issue with creating the cache.
* Fix incorrect use of select_related for source thumbnail model.
* Removed some vestigal processor arguments.
* Allow ``HIGH_RESOLUTION`` argument on thumbnail template tag.
* Add logic to correctly handle thumbnail images on deferred models (e.g. when
using ``.only()``).
* Add a ``data_uri`` filter to allow rendering of an image inline as a data
uri.
2.2.1 (2014-12-30)
------------------
* Fixed: Option ``zoom`` can also be used by itself, without combining it with
``crop``.
2.2 (2014-10-04)
----------------
* Fix migrations for Django 1.7 final.
* Fix contain bad image EXIFs being able to still raise an exception.
2.1 (2014-08-13)
----------------
* Fix Python 3.4 installation issue.
* Avoid an OverflowError due to invalid EXIF data.
* Fix bug causing JPEG images to be saved without optimization :(
* JPEG files can now be saved with progressive encoding. By default, any image
with a dimension larger than 100px will be saved progressively. Configured
with the ``THUMBNAILER_PROGRESSIVE`` setting.
2.0.1 (2014-04-26)
------------------
* Fix packaging issue with old south migrations.
2.0 (2014-04-25)
----------------
* Use Django 1.7 migrations. Thanks Trey Hunner.
**Note**: if using South, read the installation docs for required settings
changes.
* Make ThumbnailerImageField.resize_source reflect change in extension.
* Add ``target`` option to the scale_and_crop processor, allowing for image
focal points when cropping (or zooming) an image.
* Add a THUMBNAIL_NAMER option which takes a function used to customize
the thumbnail filename.
* New ``subsampling`` option to reduce color subsampling of JPEG images,
providing sharper color borders for a small increase in file size.
* Reimplementation of the ``thumbnail_cleanup`` command. Thanks Jørgen
Abrahamsen
* More efficient thumbnail default storage. Thanks Sandip Agarwal.
1.5 (2014-03-05)
----------------
* Better support for multiple source generators.
* Update method used to check for modification dates of source and thumbnail
images. Thanks Ben Roberts.
* Better thumbnail_high_resolution handling, including the ability to switch on
and off explicitly with a ``HIGH_RESOLUTION`` thumbnail option.
* Added configuration option to specify the infix used for high resolution
image handling.
* Optional postprocessor for image optimization. Thanks Jacob Rief!
* More remote storages optimization
* Thumbnail dimensions can now optionally be cached. Thanks David Novakovic.
* New ``zoom`` option to generate a thumbnail of a source image with a
percentage clipped off each side.
* New ``background`` source processor that can add a border color to ensure
scaled images fit within the exact dimensions given.
1.4 (2013-09-23)
----------------
* Considerable speed up for remote storages by reducing queries.
Brent O'Connor spent a lot of time debugging this, so thank you epicserve!
* Allow the ``{% thumbnail %}`` tag to also accept aliases. Thanks Simon Meers!
* Make ``replace_alpha`` actually work correctly.
* Fixes exception being raised when image exists in cache but is doesn't
actually exist in the storage.
* Fixes Python 2.5 compatibility.
1.3 (2013-06-17)
----------------
* Some more Django 1.5 fixes.
* Fix an issue with ``Thumbnail.url`` not working correctly.
* Add the ability to generate retina quality thumbnails in addition to the
standard ones (off by default).
1.2 (2013-01-23)
----------------
* Django 1.5 compatibility.
* Fixed a problem with the ``ImageClearableFileInput`` widget.
1.1 (2012-08-29)
----------------
* Added a way to avoid generating thumbnails if they don't exist already (with
a signal to deal with them elsewhere).
* Added a ``thumbnailer_passive`` filter to allow templates to use the
non-generating thumbnails functionality when dealing with aliases.
1.0.3 (2012-05-30)
------------------
* Changed the exception to catch from 1.0.2 to IOError.
1.0.2 (2012-05-29)
------------------
* Catch an OSError exception when trying to get the EXIF data of a touchy
image.
1.0.1 (2012-05-23)
------------------
* Fix a Django 1.2 backwards incompatibility in ``easy_thumbnails.conf``
* Introduced a ``thumbnail_created`` signal.
1.0 (2012-05-07)
----------------
* Introduction of aliased thumbnails.
* Start of sane versioning numbers.
Raw data
{
"_id": null,
"home_page": "http://github.com/SmileyChris/easy-thumbnails",
"name": "easy-thumbnails",
"maintainer": null,
"docs_url": "https://pythonhosted.org/easy-thumbnails/",
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Chris Beaven",
"author_email": "smileychris@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/86/3b/5fe5c2c20cb08a34759cbd1ca9b8394b121785ebcb033c010a4b27b65a7a/easy_thumbnails-2.10.tar.gz",
"platform": "any",
"description": "===============\nEasy Thumbnails\n===============\n\n.. image:: https://img.shields.io/pypi/v/easy-thumbnails.svg\n :target: https://pypi.python.org/pypi/easy-thumbnails/\n\n.. image:: https://github.com/SmileyChris/easy-thumbnails/actions/workflows/python.yml/badge.svg\n :alt: Build Status\n :target: https://github.com/SmileyChris/easy-thumbnails/actions/workflows/python.yml\n\n\nA powerful, yet easy to implement thumbnailing application for Django 2.2+\n\nBelow is a quick summary of usage. For more comprehensive information, view the\n`full documentation`__ online or the peruse the project's ``docs`` directory.\n\n__ http://easy-thumbnails.readthedocs.org/en/latest/index.html\n\n\nBreaking News\n=============\n\nVersion 2.8.0 adds support for thumbnailing SVG images when installed with the ``[svg]`` extra.\n\nOf course it doesn't make sense to thumbnail SVG images, because being in vector format they can\nscale to any size without quality of loss. However, users of easy-thumbnails may want to upload and\nuse SVG images just as if they would be PNG, GIF or JPEG. They don't necessarily care about the\nformat and definitely don't want to convert them to a pixel based format. What they want is to reuse\ntheir templates with the templatetag thumbnail and scale and crop the images to whatever their\n`<img src=\"...\" width=\"...\" height=\"...\">` has been prepared for.\n\nThis is done by adding an emulation layer named VIL, which aims to be compatible with the\n`PIL <https://python-pillow.org/>`_ library. All thumbnailing operations, such as scaling and\ncropping behave like pixel based images. The final filesize of such thumbnailed SVG images doesn't\nof course change, but their width/height and bounding box may be adjusted to reflect the desired\nsize of the thumbnailed image.\n\n.. note:: This feature is new and experimental, hence feedback about its proper functioning in\n third parts applications is highly appreciated.\n\n\nInstallation\n============\n\nRun ``pip install easy-thumbnails``.\n\nAdd ``easy_thumbnails`` to your ``INSTALLED_APPS`` setting:\n\n.. code-block:: python\n\n INSTALLED_APPS = (\n ...\n 'easy_thumbnails',\n )\n\nRun ``manage.py migrate easy_thumbnails``.\n\n\nExample usage\n=============\n\nThumbnail options can be predefined in ``settings.THUMBNAIL_ALIASES`` or just\nspecified in the template or Python code when run.\n\nUsing a predefined alias\n------------------------\n\nGiven the following setting:\n\n.. code-block:: python\n\n THUMBNAIL_ALIASES = {\n '': {\n 'avatar': {'size': (50, 50), 'crop': True},\n },\n }\n\nTemplate:\n\n.. code-block:: html+django\n\n {% load thumbnail %}\n <img src=\"{{ profile.photo|thumbnail_url:'avatar' }}\" alt=\"\" />\n\nPython:\n\n.. code-block:: python\n\n from easy_thumbnails.files import get_thumbnailer\n thumb_url = get_thumbnailer(profile.photo)['avatar'].url\n\nManually specifying size / options\n----------------------------------\n\nTemplate:\n\n.. code-block:: html+django\n\n {% load thumbnail %}\n <img src=\"{% thumbnail profile.photo 50x50 crop %}\" alt=\"\" />\n\nPython:\n\n.. code-block:: python\n\n from easy_thumbnails.files import get_thumbnailer\n options = {'size': (100, 100), 'crop': True}\n thumb_url = get_thumbnailer(profile.photo).get_thumbnail(options).url\n\nUsing in combination with other thumbnailers\n--------------------------------------------\n\nAlternatively, you load the templatetags by {% load easy_thumbnails_tags %} \ninstead of traditional {% load thumbnail %}. It's especially useful in \nprojects that do make use of multiple thumbnailer libraries that use the \nsame name (`thumbnail`) for the templatetag module:\n\n.. code-block:: html+django\n\n {% load easy_thumbnails_tags %}\n <img src=\"{% thumbnail profile.photo 50x50 crop %}\" alt=\"\" />\n\nFields\n======\n\nYou can use ``ThumbnailerImageField`` (or ``ThumbnailerField``) for easier\naccess to retrieve or generate thumbnail images.\n\nFor example:\n\n.. code-block:: python\n\n from easy_thumbnails.fields import ThumbnailerImageField\n\n class Profile(models.Model):\n user = models.OneToOneField('auth.User')\n photo = ThumbnailerImageField(upload_to='photos', blank=True)\n\nAccessing the field's predefined alias in a template:\n\n.. code-block:: html+django\n\n {% load thumbnail %}\n <img src=\"{{ profile.photo.avatar.url }}\" alt=\"\" />\n\nAccessing the field's predefined alias in Python code:\n\n.. code-block:: python\n\n thumb_url = profile.photo['avatar'].url\n\n\nThumbnail options\n=================\n\n``crop``\n--------\n\nBefore scaling the image down to fit within the ``size`` bounds, it first cuts\nthe edges of the image to match the requested aspect ratio.\n\nUse ``crop=\"smart\"`` to try to keep the most interesting part of the image,\n\nUse ``crop=\"0,10\"`` to crop from the left edge and a 10% offset from the\ntop edge. Crop from a single edge by leaving dimension empty (e.g.\n``crop=\",0\"``). Offset from the right / bottom by using negative numbers\n(e.g., crop=\"-0,-10\").\n\nOften used with the ``upscale`` option, which will allow enlarging of the image\nduring scaling.\n\n``quality=XX``\n--------------\n\nChanges the quality of the output JPEG thumbnail. Defaults to ``85``.\n\nIn Python code, this is given as a separate option to the ``get_thumbnail``\nmethod rather than just alter the other.\n\n``keep_icc_profile``\n--------------------\n\nIf `True`, when saving a thumbnail with the alias that defines this option, the\nICC profile of the image will be preserved in the thumbnail, if present in the first place.\n\n\nOther options\n-------------\n\nValid thumbnail options are determined by the \"thumbnail processors\" installed.\n\nSee the `reference documentation`__ for a complete list of options provided by\nthe default thumbnail processors.\n\n__ http://easy-thumbnails.readthedocs.org/en/latest/ref/processors/\n\n\nChanges\n=======\n\n2.10 (2024-09-11)\n-----------------\n* Drop support for Python-3.8.\n* Drop support for Django-4.1 and earlier.\n* Add support for Django-5.1.\n* Experimental support for animated image formats. See documentation for more infos.\n* Fix #642: Do not scale images (SVG) without size information.\n* Fix #366: Keep ICC profile when saving image, if present.\n\n\n2.9 (2024-07-25)\n----------------\n* Add support for Django 4.2 storages (mandatory in Django 5.1).\n\n\n2.8.5 (2023-01-09)\n------------------\n* Fix regression introduced in version 2.8.4. Argument ``quality`` is not removed for images\n of type ``.webp``.\n\n\n2.8.4 (2022-12-19)\n------------------\n* Fix problem when thumbnailing images of type TIFF. PIL's ``TiffImagePlugin`` doesn't\n like argument ``quality``.\n* Replace deprecated Pillow constants against newer counterparts. Check\n https://pillow.readthedocs.io/en/stable/releasenotes/9.1.0.html#deprecations for details.\n\n\n2.8.3 (2022-08-02)\n------------------\n* Fix regression in library detection introduced in version 2.8.2.\n\n\n2.8.2 (2022-07-31)\n------------------\n* Installation of easy-thumbnails now optionally depends on the reportlab library.\n\n\n2.8.1 (2022-01-20)\n------------------\n\n* Add support for Django 4.\n* New ``THUMBNAIL_IMAGE_SAVE_OPTIONS`` setting.\n* Fix #587: Uploading SVG Images to S3 storage.\n\n\n2.8.0 (2021-11-03)\n------------------\n\n* Add support for thumbnailing SVG images. This is done by adding an emulation layer named VIL,\n which aims to be compatible with PIL. All thumbnailing operations, such as scaling and cropping\n behave like pixel images.\n* Remove configuration directives ``THUMBNAIL_HIGH_RESOLUTION`` and ``THUMBNAIL_HIGHRES_INFIX``\n from easy-thumbnails setting directives.\n\n\n2.7.2 (2021-10-17)\n------------------\n\n* Add support for Django 3.2 and Python-3.10.\n* Fix #563: Do not close image after loading content.\n* In management command ``thumbnail_cleanup``, replace ``print``-statements\n against ``stdout.write``.\n* Use Python format strings whereever possible.\n\n\n2.7.1 (2020-11-23)\n------------------\n\n* Add support for Django 3.1\n\n\n2.7.0 (2019-12-15)\n------------------\n\n* Add support for Django 3.0\n* Drop support for Python 2\n* Drop support for Django < 1.11\n* Drop support for Django 2.0, 2.1\n\n\n2.6.0 (2019-02-03)\n------------------\n\n* Added testing for Django 2.2 (no code changes required).\n\n\n2.5.0 (2017-10-31)\n------------------\n\n* Support Django versions up to 1.11. Version 2.0 is in beta.\n\n* Fix: Pickle/unpickle machine. The ThumbnailerField fields no longer\n generated thumbnails.\n\n* Removed all references to South migrations.\n\n\n2.4.2 (2017-09-14)\n------------------\n\n* Supported Django versions are now 1.8 or 1.10+, Python 2.7 minimum.\n\n* Fix IOError saving JPEG files with transparency on Pillow 4.2+.\n\n* Fix #450, #473: fixed int/string is not a callable in management command.\n\n* Fix #456: Delete method of ThumbnailerFieldFile is called twice.\n\n\n2.4.1 (2017-04-05)\n------------------\n\n* New minimum requirement of Django 1.4 or 1.7+.\n\n* Fix EXIF orientation to use transpose.\n\n* Upgrades to avoid deprecation warnings.\n\n* Fix app settings not working in Django 1.11.\n\n* Fix a bad conditional check causing incorrect behaviour in autocropping\n transparent images.\n\n* Django 1.8+ compatibility for ``thumbnail_cleanup`` command.\n\n* Add ``easy_thumbnails_tags`` template tag mirror to allow multiple\n thumbnailer libraries to coexist happily.\n\n* Limit pillow to its final compatible version when on Python 2.6\n\n* Fix tests.\n\n2.3 (2015-12-11)\n----------------\n\n* New ``Alias`` namer.\n\n* Avoid a potential concurrency issue with creating the cache.\n\n* Fix incorrect use of select_related for source thumbnail model.\n\n* Removed some vestigal processor arguments.\n\n* Allow ``HIGH_RESOLUTION`` argument on thumbnail template tag.\n\n* Add logic to correctly handle thumbnail images on deferred models (e.g. when\n using ``.only()``).\n\n* Add a ``data_uri`` filter to allow rendering of an image inline as a data\n uri.\n\n2.2.1 (2014-12-30)\n------------------\n\n* Fixed: Option ``zoom`` can also be used by itself, without combining it with\n ``crop``.\n\n2.2 (2014-10-04)\n----------------\n\n* Fix migrations for Django 1.7 final.\n\n* Fix contain bad image EXIFs being able to still raise an exception.\n\n2.1 (2014-08-13)\n----------------\n\n* Fix Python 3.4 installation issue.\n\n* Avoid an OverflowError due to invalid EXIF data.\n\n* Fix bug causing JPEG images to be saved without optimization :(\n\n* JPEG files can now be saved with progressive encoding. By default, any image\n with a dimension larger than 100px will be saved progressively. Configured\n with the ``THUMBNAILER_PROGRESSIVE`` setting.\n\n2.0.1 (2014-04-26)\n------------------\n\n* Fix packaging issue with old south migrations.\n\n2.0 (2014-04-25)\n----------------\n\n* Use Django 1.7 migrations. Thanks Trey Hunner.\n **Note**: if using South, read the installation docs for required settings\n changes.\n\n* Make ThumbnailerImageField.resize_source reflect change in extension.\n\n* Add ``target`` option to the scale_and_crop processor, allowing for image\n focal points when cropping (or zooming) an image.\n\n* Add a THUMBNAIL_NAMER option which takes a function used to customize\n the thumbnail filename.\n\n* New ``subsampling`` option to reduce color subsampling of JPEG images,\n providing sharper color borders for a small increase in file size.\n\n* Reimplementation of the ``thumbnail_cleanup`` command. Thanks J\u00f8rgen\n Abrahamsen\n\n* More efficient thumbnail default storage. Thanks Sandip Agarwal.\n\n1.5 (2014-03-05)\n----------------\n\n* Better support for multiple source generators.\n\n* Update method used to check for modification dates of source and thumbnail\n images. Thanks Ben Roberts.\n\n* Better thumbnail_high_resolution handling, including the ability to switch on\n and off explicitly with a ``HIGH_RESOLUTION`` thumbnail option.\n\n* Added configuration option to specify the infix used for high resolution\n image handling.\n\n* Optional postprocessor for image optimization. Thanks Jacob Rief!\n\n* More remote storages optimization\n\n* Thumbnail dimensions can now optionally be cached. Thanks David Novakovic.\n\n* New ``zoom`` option to generate a thumbnail of a source image with a\n percentage clipped off each side.\n\n* New ``background`` source processor that can add a border color to ensure\n scaled images fit within the exact dimensions given.\n\n1.4 (2013-09-23)\n----------------\n\n* Considerable speed up for remote storages by reducing queries.\n Brent O'Connor spent a lot of time debugging this, so thank you epicserve!\n\n* Allow the ``{% thumbnail %}`` tag to also accept aliases. Thanks Simon Meers!\n\n* Make ``replace_alpha`` actually work correctly.\n\n* Fixes exception being raised when image exists in cache but is doesn't\n actually exist in the storage.\n\n* Fixes Python 2.5 compatibility.\n\n1.3 (2013-06-17)\n----------------\n\n* Some more Django 1.5 fixes.\n\n* Fix an issue with ``Thumbnail.url`` not working correctly.\n\n* Add the ability to generate retina quality thumbnails in addition to the\n standard ones (off by default).\n\n1.2 (2013-01-23)\n----------------\n\n* Django 1.5 compatibility.\n\n* Fixed a problem with the ``ImageClearableFileInput`` widget.\n\n1.1 (2012-08-29)\n----------------\n\n* Added a way to avoid generating thumbnails if they don't exist already (with\n a signal to deal with them elsewhere).\n\n* Added a ``thumbnailer_passive`` filter to allow templates to use the\n non-generating thumbnails functionality when dealing with aliases.\n\n1.0.3 (2012-05-30)\n------------------\n\n* Changed the exception to catch from 1.0.2 to IOError.\n\n1.0.2 (2012-05-29)\n------------------\n\n* Catch an OSError exception when trying to get the EXIF data of a touchy\n image.\n\n1.0.1 (2012-05-23)\n------------------\n\n* Fix a Django 1.2 backwards incompatibility in ``easy_thumbnails.conf``\n\n* Introduced a ``thumbnail_created`` signal.\n\n1.0 (2012-05-07)\n----------------\n\n* Introduction of aliased thumbnails.\n\n* Start of sane versioning numbers.\n",
"bugtrack_url": null,
"license": null,
"summary": "Easy thumbnails for Django",
"version": "2.10",
"project_urls": {
"Homepage": "http://github.com/SmileyChris/easy-thumbnails"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "22efde1f3a7421d7a9ce2314ee7bc0d37a8264a50872e2cd5af1240798b0bbba",
"md5": "b89c3c0cf1ffcd7e309d68b66135dd31",
"sha256": "9e446fb9da1ca0cbc99bdd1fe8fdd5c38784323d64393a37e16d13cd736980b2"
},
"downloads": -1,
"filename": "easy_thumbnails-2.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b89c3c0cf1ffcd7e309d68b66135dd31",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 78939,
"upload_time": "2024-09-12T12:40:59",
"upload_time_iso_8601": "2024-09-12T12:40:59.135215Z",
"url": "https://files.pythonhosted.org/packages/22/ef/de1f3a7421d7a9ce2314ee7bc0d37a8264a50872e2cd5af1240798b0bbba/easy_thumbnails-2.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "863b5fe5c2c20cb08a34759cbd1ca9b8394b121785ebcb033c010a4b27b65a7a",
"md5": "dbeaafc0089910359b8573bcb254ae63",
"sha256": "d009462fcd791edf2496e5ed46d044712e1a06b7d4600e4cf2812002e9904ef5"
},
"downloads": -1,
"filename": "easy_thumbnails-2.10.tar.gz",
"has_sig": false,
"md5_digest": "dbeaafc0089910359b8573bcb254ae63",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 80721,
"upload_time": "2024-09-12T12:41:00",
"upload_time_iso_8601": "2024-09-12T12:41:00.361541Z",
"url": "https://files.pythonhosted.org/packages/86/3b/5fe5c2c20cb08a34759cbd1ca9b8394b121785ebcb033c010a4b27b65a7a/easy_thumbnails-2.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-12 12:41:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SmileyChris",
"github_project": "easy-thumbnails",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "easy-thumbnails"
}
JSON
