Metadata-Version: 2.4
Name: snapforge
Version: 0.2.1
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)
	     .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()
Extras	 .add_watermark(p)	  Add a watermark image at a position	      .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
