django-versatileimagefield

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

Click here for a quick overview of what it is, how it works and whether or not it\'s the right fit for your project.

Compatibility

• Python:
  • 3.6
  • 3.7
  • 3.8
  • 3.9
• Django:
  • 3.0.x
  • 3.1.x
  • 3.2.x
  • 4.0.x
  • 4.1.x
  • 5.0.x

NOTE: The 1.4 release dropped support for Django 1.5.x & 1.6.x.

NOTE: The 1.7 release dropped support for Django 1.7.x.

NOTE: The 2.1 release dropped support for Django 1.9.x.

NOTE: The 3.0 release dropped support for Django 2.x.

• Pillow >= 6.2.0
• Django REST Framework:
  • 3.14.x

Documentation

Full documentation available at Read the Docs.

Code

django-versatileimagefield is hosted on github.

Running Tests

If you\'re running tests on Mac OSX you\'ll need [libmagic]{.title-ref} installed. The recommended way to do this is with homebrew:

$ brew install libmagic

Note: Some systems may also be necessary to install the non-python Pillow build dependencies.

You\'ll also need tox:

$ pip install tox

To run the entire django-versatileimagefield test matrix, that is, run all tests on all supported combination of versions of python, django and djangorestframework:

$ tox

If you just want to run tests against a specific tox environment first, run this command to list all available environments:

$ tox -l

Then run this command, substituting {tox-env} with the environment you want to test:

$ tox -e {tox-env}