ImageMagick imaging engine for Thumbor.
Project description
thumbor-wand-engine
thumbor-wand-engine is an ImageMagick imaging engine for thumbor.
Installation
You can install the package from PyPI with pip
:
$ pip install thumbor-wand-engine
Requirements
- Python 3.6 or higher
- MagickWand library
libmagickwand-dev
for APT on Debian/UbuntuImageMagick-devel
for Yum on CentOSimagemagick
for MacPorts/Homebrew on Mac
Why another engine
Thumbor ships with a builtin engine, however with thumbor-wand-engine you get:
- Smaller images ⏳ 💲
- Better image quality 🤩
- Support to animated WEBP ⏳ 💲
- Support to AVIF and HEIC 🖼
- IPTC/XMP data preservation 📜
- Smoother blur ✨
- Sharper resizing 📐
- Better watermarking 🏷
Usage
To use this engine with thumbor, define thumbor_wand_engine
as the imaging
engine in thumbor.conf
:
# imaging engine to use to process images
ENGINE = "thumbor_wand_engine"
Development
Requirements
- Python 3.6 or higher
- An activated virtual environment
- pre-commit
Create a development environment
-
Start by creating a new Python virtual environment with the tool of your choice (we recommend pyenv)
-
Install pre-commit (we recommend installing it not as part of the virtual environment — use your system's package manager)
-
Install wand-engine in editable mode with all required dependencies:
$ make setup
Run tests
Once you have a working development environment:
-
Code!
🤓 🤔 💡 ⚡️ 🖼
-
Run tests
$ make test
-
Check code coverage
$ make coverage-html $ open htmlcov/index.html
-
Lint the code:
$ make lint
-
Repeat!
Have fun!
License
Code in this repository is distributed under the terms of the MIT License.
See LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for thumbor_wand_engine-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9de27a9eddee46556af7c28f4b985a236a61b0a0521f019c2087785cadb0f974 |
|
MD5 | 499afe7a095107f4de041394d63d75e9 |
|
BLAKE2b-256 | ab5a5ca1b1480defa868945426ed54481c30d5f2b4858c5e8b3c67522350bb23 |
Hashes for thumbor_wand_engine-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ad14150412ebc47743947c22834d116813d1fbb6c52a77cafeee85e021d9a644 |
|
MD5 | 1542f3a6cd0cd14976d66f599b97846f |
|
BLAKE2b-256 | 4d29c89b122ab5d55a9f14a467ecc6eab2918365783473e1520d90c22c09b18e |