image

1.5.33 verified Mon Apr 27 auth: no python

A Django application that provides cropping, resizing, thumbnailing, overlays and masking for images and videos with the ability to set the center of attention. Current version 1.5.33, released on PyPI with no specified release cadence. Frequently updated but with infrequent major releases.

pip install image

Common errors

error ImportError: cannot import name 'Image' from 'image' ↓

cause There is a naming conflict with the 'image' module from the standard library on some Python versions.

fix

Uninstall conflicting packages (like 'python-resize-image') and use 'pip install image' from PyPI. Then import as 'from image import Image'.

error ModuleNotFoundError: No module named 'image' ↓

cause The package is not installed or the environment is misconfigured.

fix

Run 'pip install image' to install the package.

error django.core.exceptions.ImproperlyConfigured: Requested setting INSTALLED_APPS, but settings are not configured. ↓

cause Quickstart code ran without Django settings.

fix

Configure Django settings before using the package: settings.configure(INSTALLED_APPS=['image', ...]).

Warnings

gotcha The 'image' package conflicts with the built-in Python 'imghdr' or 'Pillow' when using 'import Image'. Always use 'from image import Image'. ↓

fix Use explicit import: from image import Image.

deprecated The 'center_of_attention' feature may rely on deprecated JavaScript libraries (like jQuery) in older versions. Check version compatibility. ↓

fix Upgrade to latest version (>=1.5.0) for updated frontend dependencies.

Imports

Image
wrong
```
from PIL import Image
```
correct
```
from image import Image
```
PIL/Pillow's Image is different; import from the 'image' package for Django integration.
ImageSpec
```
from image import ImageSpec
```
Used for defining image specifications.

Quickstart

Basic usage: Create an Image instance, set its source, save, and retrieve its URL.

from image import Image
from django.conf import settings
settings.configure(INSTALLED_APPS=['image', 'django.contrib.contenttypes', 'django.contrib.auth'])

img = Image(name='example.jpg')
img.source = 'https://example.com/photo.jpg'
img.save()
print(img.url)