Ez PIL

An easy-to-use extension for PIL to edit and modify images.

Installation

Python 3.12 or higher is required.

pip install ez-pil

Examples

Example for Discord Bot integration. For further information, see the Documentation.

import discord
import ezcord
from ez_pil import Editor, load_image_async

bot = ezcord.Bot()

@bot.slash_command()
async def circle(ctx):
    # Load the image using `load_image_async` method
    image = await load_image_async(ctx.author.display_avatar.url)

    # Initialize the editor and pass image as a parameter
    editor = Editor(image).circle_image()

    # Creating File object from image_bytes from editor
    file = discord.File(fp=editor.image_bytes, filename='circle.png')

    await ctx.respond(file=file)

bot.run("TOKEN")

Contributing

If you want to contribute, follow the steps below:

1. Fork the repository and clone it to your local machine.
2. Install the dependencies using pip install -r requirements-dev.txt.
3. Run pre-commit install to set up pre-commit hooks.
4. Make your changes and create a pull request.

You can run tests locally:

pytest
pre-commit run -a

You can also run the documentation locally:

cd docs
make html

Now you can open _build/html/index.html in your browser.

Credits

This repository is a fork of easy-pil, because the original repository is no longer maintained 👻