Metadata-Version: 1.1
Name: django-image-proxy
Version: 0.0.4
Summary: Simple Django Image Proxy especially for Horizon Openstack Dashboard.
Home-page: https://github.com/michaelkuty/django_image_proxy
Author: Michael Kuty
Author-email: mail@majklk.cz
License: UNKNOWN
Description: ==================
        Django Image Proxy
        ==================
        
        Simple django app which provide images from remote hosts. Supports custom sizes and simple caching for less API calls.
        
        Aims to simplicity and compatibility with Openstack Horizon Dashboard, where is main place for usage.
        
        Installation
        ------------
        
        .. code-block:: bash
        
            pip install django_image_proxy
        
        local_settings.py
        
        .. code-block:: python
        
            INSTALLED_APPS += ('image_proxy',)
        
            IMAGE_PROXY_URL = 'localhost:9753/images'
        
        urls.py
        
        .. code-block:: python
        
            urlpatterns = patterns('',
                ...
                url(r'^images/', include('image_proxy.urls')),
                ...
            )
        
        Usage
        -----
        
        .. code-block:: html
            
            <img src="{% url 'proxy_image' '/media/anotherdjangoapp.png' %}"/>
            <img src="{% url 'proxy_image_preview' '/media/anotherdjangoapp.png' %}"/>
            <img src="{% url 'proxy_image' 'my_image_name' '100x100' %}"/>
            <img src="{% url 'proxy_image' 'my_image_id' '100x100' 'scale' %}"/>
        
            or 
            {% load thumnail %}
            {% thumbnail product.image '400x400' 'crop' %}
        
        Custom size and method
        
        .. code-block:: python
        
            http://<hostname>/<path_to_source_file>/<size>/<method>/
        
        
        For easily using Django Rest Framework should do this
        
        local_settings.py
        
        .. code-block:: python
        
            IMAGE_PROXY_URL = 'localhost:9753'
        
        note: this url is for another django located on the address
        
        .. code-block:: python
        
            # simple using Django Rest Framework Serializer
            # for image paths return something like this
            images = ["/media/image.jpg", "/media/image01.jpg"]
            
            for image in images:
        
                print reverse("proxy_image", args=[image])
                /images/image/media/image.jpg # this url download image from original url and returns it !        
        
        
        Usage with Openstack Horizon Dashboard
        --------------------------------------
        
        Requires installed horizon.
        
        Image in modal dialog.
        
        .. code-block:: python
            
            <a href="{% url 'proxy_image_preview' image %}" class="ajax-modal">
              <img src="{% thumbnail product.image '100x100' 'crop' %}" class="center-block" width="100px" />
            </a>
        
        Override
        --------
        
        .. code-block:: python
        
            from image_proxy.views import ThumbnailView
        
            class MyThumbnailView(ThumbnailView)
        
                def get(self, request, *args, **kwargs):
        
                    response = http.HttpResponse(self.image, content_type=self.content_type)
        
                    return response
        
        
        Contribution
        ------------
        
        * Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
        * Fork https://github.com/michaelkuty/django_image_proxy on GitHub to start making your changes to the **master** branch.
        * Send a pull request
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: System :: Software Distribution
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Operating System :: OS Independent
