Metadata-Version: 2.4
Name: snapforge
Version: 1.2.0
Summary: Powerful and fast image editor! 😎
Author: Ali
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=9.0.0

# 📸 SnapForge

[![PyPI version](https://img.shields.io/pypi/v/snapforge.svg)](https://pypi.org/project/snapforge/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/snapforge.svg)](https://pypi.org/project/snapforge/)

**SnapForge** is a lightweight, fast, and intuitive Python library designed for easy image processing tasks. Whether you need to resize, convert, or manipulate images, SnapForge makes it a breeze!

## ✨ Features

- 🚀 **Fast & Lightweight**: Minimal overhead for quick image tasks.
- 🔄 **Format Conversion**: Easily switch between JPEG, PNG, BMP, and more.
- 📏 **Smart Resizing**: High-quality scaling and resizing capabilities.
- 🛠️ **Easy API**: Designed with developer experience in mind—simple commands for complex tasks.
- 🐍 **Pythonic**: Follows Python's best practices for a seamless integration.

## 📦 Installation

You can install SnapForge directly from PyPI using `pip`:
```bash
pip install snapforge


🚀 Quick Start

Here is a quick example to get you started with SnapForge:

import snapforge

# Load an image
img = snapforge.Snapforge("example.jpg")

# Resize the image
resized_img = img.resize(800,600)

# Convert and save the image
resized_img.convert("PNG").save("example_resized.png")

print("Image processed successfully!")

## 🧾 Feature Showcase (Full Reference)

Here is the complete list of all available methods in SnapForge:

| Category | Method | Description | Example |
| :--- | :--- | :--- | :--- |
| **Core** | `.convert(fmt)` | Change image format (e.g., PNG, JPG) | `.convert("PNG")` |
| | `.resize(w, h)` | Change image dimensions | `.resize(800, 600)` |
| | `.crop(l, t, r, b)` | Crop image to specific boundaries | `.crop(0, 0, 100, 100)` |
| | `.rotate(a)` | Rotate image by angle | `.rotate(90)` |
| | `.optimize(q)` | Set compression quality (1-100) | `.optimize(85)` |
| | `.save(name)` | Save the final forged image | `.save("result.jpg")` |
| **Lighting** | `.apply_brightness(f)` | Adjust brightness (factor > 1.0 is brighter) | `.apply_brightness(1.2)` |
| | `.apply_contrast(f)` | Adjust contrast (factor > 1.0 is higher) | `.apply_contrast(1.5)` |
| **Filters** | `.apply_sepia()` | Apply a classic vintage sepia effect | `.apply_sepia()` |
| | `.apply_grayscale(f)` | Convert to black & white (0.0 to 1.0) | `.apply_grayscale(1.0)` |
| | `.apply_blur(r)` | Apply Gaussian blur with radius r | `.apply_blur(5.0)` |
| | `.apply_sharpen()` | Enhance image sharpness/clarity | `.apply_sharpen()` |
| | `.apply_camscanner()`| Apply document scanner effect (B&W/Threshold) | `.apply_camscanner()` |
| **Extras** | `.flip(dir)` | Flip image (horizontal or vertical) | `.flip("horizontal")` |
| | `.add_watermark(p)` | Add a watermark image | `.add_watermark("logo.png")` |


🛠️ Requirements

    Python: 3.7 or higher
    Dependencies: Pillow

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

📜 License

Distributed under the MIT License.

👤 Author

Ali.Shm
Project Maintainer
