Skip to main content

A Python image library that sits on top of Pillow, Wand and OpenCV

Project description

Willow image library

PyPI PyPI downloads Build Status

A wrapper that combines the functionality of multiple Python image libraries into one API.

Documentation

Overview

Willow is a simple image library that combines the APIs of Pillow, Wand and OpenCV. It converts the image between the libraries when necessary.

Willow currently has basic resize and crop operations, face and feature detection and animated GIF support. New operations and library integrations can also be easily implemented.

The library is written in pure Python and supports versions 3.9, 3.10, 3.11, 3.12, and 3.13.

Examples

Resizing an image

from willow.image import Image

f = open('test.png', 'rb')
img = Image.open(f)

# Resize the image to 100x100 pixels
img = img.resize((100, 100))

# Save it
with open('test_thumbnail.png', 'wb') as out:
   img.save_as_png(out)

This will open the image file with Pillow or Wand (if Pillow is unavailable).

It will then resize it to 100x100 pixels and save it back out as a PNG file.

Detecting faces

from willow.image import Image

f = open('photo.png', 'rb')
img = Image.open(f)

# Find faces
faces = img.detect_faces()

Like above, the image file will be loaded with either Pillow or Wand.

As neither Pillow nor Wand support detecting faces, Willow would automatically convert the image to OpenCV and use that to perform the detection.

Available operations

Documentation

Operation Pillow Wand OpenCV
get_size()
get_frame_count() ✓** ✓**
resize(size)
crop(rect)
rotate(angle)
set_background_color_rgb(color)
transform_colorspace_to_srgb(rendering_intent)
auto_orient()
save_as_jpeg(file, quality)
save_as_png(file)
save_as_gif(file)
save_as_webp(file, quality)
save_as_heic(file, quality, lossless) ✓⁺
save_as_avif(file, quality, lossless) ✓⁺ ✓⁺
save_as_ico(file)
has_alpha() ✓*
has_animation() ✓* ✓*
get_pillow_image()
get_wand_image()
detect_features()
detect_faces(cascade_filename)

* Always returns False

** Always returns 1

⁺ Requires the pillow-heif library

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

willow-1.9.0.tar.gz (113.4 kB view details)

Uploaded Source

Built Distribution

willow-1.9.0-py3-none-any.whl (119.2 kB view details)

Uploaded Python 3

File details

Details for the file willow-1.9.0.tar.gz.

File metadata

  • Download URL: willow-1.9.0.tar.gz
  • Upload date:
  • Size: 113.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for willow-1.9.0.tar.gz
Algorithm Hash digest
SHA256 ffac1406275ae30b60e7c6cbd1245f0bc359d1b5731002b18a712aaf424a5102
MD5 1f1b106c669921c52efd7a8e70dc6891
BLAKE2b-256 2b077937bb91ba3373133d903ec6c8a7a3fe0bec6ac964c7f2e532188e230c9b

See more details on using hashes here.

File details

Details for the file willow-1.9.0-py3-none-any.whl.

File metadata

  • Download URL: willow-1.9.0-py3-none-any.whl
  • Upload date:
  • Size: 119.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for willow-1.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 11a13097cffe501898cd434bb5761fb6cdbdb774a7853094cb56a4ba57cbbff7
MD5 1cace71ee1c1e42ca2f448e933d64ed0
BLAKE2b-256 ddc010a11f2dc0dc485a397bd3f66098805b6e39e7317f5acb72b415d1d7a559

See more details on using hashes here.

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