Skip to main content

ImageMagick imaging engine for Thumbor

Project description

thumbor-wand-engine

Build Status Coverage Status Code Quality Maintainability

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.7 or higher
  • MagickWand library
    • libmagickwand-dev for APT on Debian/Ubuntu
    • ImageMagick-devel for Yum on CentOS
    • imagemagick 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

  1. Start by creating a new Python virtual environment with the tool of your choice (we recommend pyenv)

  2. Install pre-commit (we recommend installing it not as part of the virtual environment — use your system's package manager)

  3. Install thumbor-wand-engine in editable mode with all required dependencies:

    $ make setup
    

Run tests

Once you have a working development environment:

  1. Code!

    🤓 🤔 💡 ⚡️ 🖼
    
  2. Run tests

    $ make test
    
  3. Check code coverage

    $ make coverage-html
    $ open htmlcov/index.html
    
  4. Lint the code:

    $ make lint
    
  5. Repeat!

Have fun!

License

Code in this repository is distributed under the terms of the MIT License.

See LICENSE for details.

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

thumbor_wand_engine-0.1.1.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

thumbor_wand_engine-0.1.1-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file thumbor_wand_engine-0.1.1.tar.gz.

File metadata

  • Download URL: thumbor_wand_engine-0.1.1.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for thumbor_wand_engine-0.1.1.tar.gz
Algorithm Hash digest
SHA256 21e49e3171b17e27a666c5d6ddafda110bcc12996c51525dd98c775f0fee3c22
MD5 0893e4fb449d4bc2f849348b6bc2f28d
BLAKE2b-256 65f4802579a04f9c028489b39e019f965aa74742d41c95f95e8e9627b0451494

See more details on using hashes here.

File details

Details for the file thumbor_wand_engine-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: thumbor_wand_engine-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for thumbor_wand_engine-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bb96ba573acf6d9308e5ffd6e0753b7bd6db9d1902fa7ac202b8edc84dc48140
MD5 c371d176a81ab42f9653f004f647cc2f
BLAKE2b-256 f0c89cb6f98d6b403f7d0054a3e6173b0939c87ae7dbaac0eda8552822e57204

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