chubz/django-daguerre

On-the-fly image manipulation for Django.

README

Django Daguerre makes it easy to adjust images on-the-fly without slowing down your templates and without needing to generate everything ahead of time with a cron job. You don't need to make any changes to your models; it Just Works.

{% load daguerre %}
<img src="{% adjust my_model.image "fill" width=200 height=400 %}" />

{% adjust_bulk my_queryset "method.image" "fill" width=200 height=400 as adjusted_list %}
{% for my_model, image in adjusted_list %}
  <img src="{{ image }}" />
{% endfor %}

code:	http://github.com/littleweaver/django-daguerre
docs:	http://readthedocs.org/docs/django-daguerre/
build status:

Requirements

• Python 2.7+, 3.3+
• Pillow
• Django 1.7 – 1.11
• Six 1.10.0+

Daguerre may work with earlier or later versions of these packages, but they are not officially supported.

Installation

You can install the latest version of Daguerre using pip:

$ pip install django-daguerre

You can clone the repository yourself at https://github.com/littleweaver/django-daguerre.

Setup

Ensure that 'daguerre' is in your project's INSTALLED_APPS:

INSTALLED_APPS = (
    'daguerre',
    ...
)

Add the following or similar anywhere in your URLconf:

urlpatterns = patterns('',
    url(r'^daguerre/', include('daguerre.urls')),
    ...
)

Run the migration command to create the database models:

python manage.py migrate daguerre

Testing

We recommend running tox from the repository's root directory, but you can also run test_project/manage.py test daguerre.