Metadata-Version: 2.4
Name: iloveimg
Version: 1.0.0
Summary: iLoveIMG Python API
Author-email: ilovepdf <info@ilovepdf.com>
License-Expression: MIT
Project-URL: Documentation, https://developer.ilovepdf.com/docs
Project-URL: Homepage, https://ilovepdf.com/
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: <=3.12.12,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: pyjwt>=2.4.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# iLoveIMG API - Python Library

A Python library for [iLoveIMG API](https://developer.iloveimg.com) to automate image processing tasks such as compressing, resizing, converting, cropping, watermarking, removing backgrounds, and more.

You can sign up for an iLoveIMG account at https://developer.iloveimg.com

Develop and automate image processing tasks like Compress, Convert, Crop, Resize, Rotate, Watermark, Remove Background, and Upscale. Each task supports several settings to get your desired results.

---

## Requirements

- Python 3.9 to 3.12

---

## Installation

Install from PyPI:

```bash
pip install iloveimg
```

Or install the latest version from source:

```bash
pip install -U git+https://github.com/iloveimg/iloveimg-python.git@main#egg=iloveimg
```

---

## Getting Started

Simple usage looks like:

```python
from iloveimg import CompressTask

task = CompressTask(public_key="your_public_key", secret_key="your_secret_key")
task.add_file("input.jpg")
task.execute()
task.download("output_folder")
```

---

## Project Structure & Documentation

- Core library: [`iloveimg/`](iloveimg/README.md)
- Example scripts: [`samples/`](samples/README.md)
- Unit & integration tests: [`tests/`](tests/README.md)
- Docker & environment setup: [`.docker/`](.docker/README.md)

For detailed API documentation, visit the [official iLoveIMG API docs](https://developer.iloveimg.com/docs).

---
