Metadata-Version: 2.4
Name: ez-pil
Version: 0.5.0
Summary: An easy-to-use extension for PIL to edit and modify images.
Author: tibue99
License: MIT
Project-URL: GitHub, https://github.com/CookieAppTeam/ez-pil
Project-URL: Documentation, https://ez-pil.readthedocs.io/en/latest/
Keywords: easy-pil,ez-pil,pillow,pil
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp
Requires-Dist: Pillow
Requires-Dist: requests
Requires-Dist: typing_extensions
Provides-Extra: docs
Requires-Dist: furo; extra == "docs"
Requires-Dist: aiocache; extra == "docs"
Requires-Dist: aiohttp; extra == "docs"
Requires-Dist: Pillow; extra == "docs"
Requires-Dist: requests; extra == "docs"
Requires-Dist: typing_extensions; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Dynamic: license-file

# Ez PIL
[![](https://img.shields.io/pypi/v/ez-pil.svg?style=for-the-badge&logo=pypi&color=yellow&logoColor=white)](https://pypi.org/project/ez-pil/)
[![](https://img.shields.io/pypi/l/ez-pil?style=for-the-badge)](https://github.com/CookieAppTeam/ez-pil/blob/master/LICENSE)

An easy-to-use extension for [PIL](https://github.com/python-pillow/Pillow) to edit and modify images.

## Installation
Python 3.12 or higher is required.
```bash
pip install ez-pil
```

## Examples
Example for Discord Bot integration. For further information, see the [Documentation](https://ez-pil.readthedocs.io/).

```python
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:
```bash
pytest
pre-commit run -a
```

You can also run the documentation locally:
```bash
cd docs
make html
```
Now you can open `_build/html/index.html` in your browser.

## Credits
This repository is a fork of [easy-pil](https://github.com/shahriyardx/easy-pil), because the original repository is no longer maintained 👻
