On-the-fly image manipulation for Django.
Python JavaScript CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
daguerre
docs
test_project
.gitignore
.travis.yml
AUTHORS.md
LICENSE
MANIFEST.in
README.rst
setup.py
tox.ini

README.rst

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:build-image

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.