Skip to main content

On-the-fly image manipulation for Django 1.7+.

Project description

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**.

.. code-block:: html+django

{% 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|

.. |build-image| image:: https://secure.travis-ci.org/littleweaver/django-daguerre.png?branch=master
:target: http://travis-ci.org/littleweaver/django-daguerre/branches

Requirements
------------

* Python 2.7+, 3.3+
* Pillow 2.3.0+
* Django 1.7+
* Six 1.5.2+

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

Upgrading from 1.0.X
--------------------

Daguerre 2.1 and up use native Django migrations. If you are
migrating from Daguerre 1.0, and you have manually created
data (for example Areas) that you want to preserve, you
*must* first upgrade to Daguerre 2.0, run the migrations
included in that version, and *then* upgrade to Daguerre
2.1.

This migration path would look as follows::

$ cd path/to/my/project
$ pip install django-daguerre==2.0.0
$ python manage.py migrate daguerre
$ pip install -U django-daguerre
$ python manage.py migrate daguerre 0001 --fake
$ python manage.py migrate daguerre

If you *don't* have any manual data to preserve, and if it
would not adversely affect your site, you can also use the
following migration path::

$ cd path/to/my/project
$ python manage.py migrate daguerre zero # Or manually delete the daguerre tables
$ pip install -U django-daguerre
$ python manage.py migrate daguerre
$ python manage.py daguerre clean

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.

.. highlight:: python

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')),
...
)

Testing
-------

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

.. _tox: http://tox.readthedocs.org/en/latest/

Project details


Release history Release notifications

History Node

2.2.3

History Node

2.2.2

History Node

2.2.1

History Node

2.2.0

History Node

2.1.4

History Node

2.1.3

This version
History Node

2.1.2

History Node

2.1.1

History Node

2.1.0

History Node

2.0.1

History Node

2.0.0

History Node

1.0.1

History Node

1.0.0

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-daguerre-2.1.2.tar.gz (579.7 kB) Copy SHA256 hash SHA256 Source None Sep 4, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page