Metadata-Version: 1.1
Name: async-thumbnail
Version: 2.2
Summary: Offload sorl thumbnail rendering to a render view.
Home-page: https://gitlab.com/mediamoose/async-thumbnail/tree/v2.2
Author: Sven Groot (Mediamoose)
Author-email: sven@mediamoose.nl
License: MIT
Download-URL: https://gitlab.com/mediamoose/async-thumbnail/repository/v2.2/archive.tar.gz
Description: ***************
        Async thumbnail
        ***************
        
        .. image:: https://badge.fury.io/py/async-thumbnail.png
            :target: https://badge.fury.io/py/async-thumbnail
        
        Offload sorl thumbnail rendering to a render view.
        
        Installation
        ============
        
        .. code-block:: sh
        
            pip install async-thumbnail
        
        
        Usage
        =====
        
        .. note:: Make sure you have `sorl thumbnails <https://github.com/jazzband/sorl-thumbnail>`_ configured.
        
        .. code-block:: python
        
                # settings.py
                INSTALLED_APPS = (
                    # ...
                    'async_thumbnail',
                    # ...
                )
        
                # urls.py
                urlpatterns = [
                    # ...
                    path('', include('async_thumbnail.urls')),
                    # ...
                ]
        
        
        .. code-block:: html
        
            {% load async_thumbnail %}
        
            <!-- Default -->
            <img src="{% async_thumbnail object.image "900x600" crop="center" %}">
        
            <!-- Save as var -->
            {% async_thumbnail object.image "900x600" crop="center" as im %}
            <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
        
        
        FetchFromCacheMiddleware
        ------------------------
        
        When you use the default full page caching middleware, it may be a good idea
        to replace it with this middleware. This prevents cache from being updated when
        the content contains a render URL.
        
        .. warning:: In case you're using things like `source sets <https://www.w3schools.com/tags/att_source_srcset.asp>`_
            or lazy loading techniques this may be a bad idea.
        
        .. code-block:: python
        
            # settings.py
            MIDDLEWARE = (
                'django.middleware.cache.UpdateCacheMiddleware',
                # ...
                'async_thumbnail.middleware.FetchFromCacheMiddleware',
            )
        
        
        Settings
        ========
        
        ``ASYNC_THUMBNAIL_ENDPOINT``
        ----------------------------
        
        - Default: ``''``
        
        Optional setting to determine an absolute path for rendering.
        
        
        ``ASYNC_THUMBNAIL_PATTERN_NAME``
        --------------------------------
        
        - Default: ``'async_thumbnail:render'``
        
        Pattern name for render URL's.
        
        
Keywords: async,asynchronous,thumbnail,sorl,django
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
