Skip to main content

A drop-in replacement for django's ImageField that provides a flexible, intuitive and easily-extensible interface for quickly creating new images from the one assigned to your field.

Project description

Downloads Latest Version

A drop-in replacement for django’s ImageField that provides a flexible, intuitive and easily-extensible interface for quickly creating new images from the one assigned to your field.

Documentation

Full documentation available at Read the Docs.

In A Nutshell

  • Creates images anywhere you need them: not just in templates.

  • Non-destructive: Your original image is never modified.

  • Sizer and Filter framework: enables you to quickly add new – or modify existing – ways to create new images:

    • Sizers create images with new sizes and/or aspect ratios

    • Filters change the appearance of an image

  • Sizers can be chained onto Filters: Use case: give me a black-and-white, 400px by 400px square crop of this image.

  • Primary Point of Interest (PPOI) support: provides a way to specify where the ‘primary point of interest’ of each individual image is – a value which is available to all Sizers and Filters. Use case: sometimes you want the ‘crop centerpoint’ to be somewhere other than the center of an image. Includes a user-friendly formfield/widget for selecting PPOI in the admin (or anywhere else you use ModelForms).

  • Works with any storage: Stores the images it creates within the same storage class as your field (just like django’s FileField & ImageField). Works great with a local filesystem or external storage (like Amazon S3).

  • Fully interchangeable with ImageField: you can easily remove VersatileImageField from your project’s models whenever you’d like.

  • Integrated caching: References to created images are stored in the cache, keeping your application running quickly and efficiently.

TODO for v0.2

  • Tests!

  • Placeholder docs

  • Programmatically delete images created by VersatileImageField (including clearing their connected cache keys)

  • Management command for auto-generating sets of images (and pre-warming the cache)

  • Templatetags for sizing/filtering static images

Project details


Download files

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

Source Distribution

django-versatileimagefield-0.1.3.tar.gz (19.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page