Metadata-Version: 1.1
Name: eximagination
Version: 0.4
Summary: Eximagination package for copying external images in tempalate tags and storing them locally.
Home-page: https://bitbucket.org/barseghyanartur/eximagination
Author: Artur Barseghyan
Author-email: artur.barseghyan@gmail.com
License: GPL 2.0/LGPL 2.1
Description: ===============
        eximagination
        ===============
        
        Description
        -----------------
        A Django template tag library which allows downloading of external images right from the template and save it into a
        desired context variable along with `width` and `height` of the image fetched. Caches the fetched images locally.
        
        License
        -----------------
        GPL 2.0/LGPL 2.1
        
        Installation
        -----------------
        * Latest stable version on PyPI:
            $ pip install eximagination
        * Latest development version:
            $ pip install -e hg+http://bitbucket.org/barseghyanartur/eximagination#egg=eximagination
        * Add 'eximagination' to `INSTALLED_APPS` of settings.py:
            >>> INSTALLED_APPS = (
            >>> # ...
            >>> 'eximagination',
            >>> # ...
            >>> )
        * Make sure to have the right path to media root defined in eximagination specific constants either in defaults.py:
            >>> # Example settings.py
            >>> import os
            >>> PROJECT_DIR = lambda s: os.path.abspath(os.path.join(os.path.dirname(__file__), s).replace('\\','/'))
            >>> EXIMAGINATION_MEDIA_ROOT = PROJECT_DIR('media/external_images/')
            >>> EXIMAGINATION_MEDIA_URL = '/media/external_images'
            >>> EXIMAGINATION_MEDIA_RELATIVE_ROOT = 'external_images/'
            >>> EXIMAGINATION_DEBUG = True
        * ...or or settings.py:
            >>> # Example defaults.py
            >>> import os
            >>> PROJECT_DIR = lambda s: os.path.abspath(os.path.join(os.path.dirname(__file__), s).replace('\\','/'))
            >>> DEBUG = False
            >>> MEDIA_ROOT = PROJECT_DIR('media/external_images')
            >>> MEDIA_URL = '/media/external_images/'
            >>> MEDIA_RELATIVE_ROOT = 'external_images/'
        
        Usage example (in a Django template)
        -------------------------------------
            >>> {% load eximaginate thumbnail %}
            >>> {% eximaginate 'http://www.google.com/intl/en/images/logo.gif' %}
        
            or
        
            >>> {% load eximaginate thumbnail %}
            >>> {% eximaginate 'http://www.google.com/intl/en/images/logo.gif' as original %}
            >>> {% thumbnail original 100x100 %}
        
            In both cases there are two additional context variables added:
                `ei_width` - Width of the image
                `ei_height` - Height of the image
        
        Author
        -----------------
        Artur Barseghyan <artur.barseghyan@gmail.com>
        
Keywords: eximagination,django,external images,app,python
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Programming Language :: Python
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
