snapforge 2.1.0__tar.gz → 3.0.0__tar.gz

snapforge-3.0.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: snapforge
+Version: 3.0.0
+Summary: Powerful and fast image editor! 😎
+Author: Ali.Shm
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=9.0.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: packaging>=20.0
+
+# 📸 SnapForge
+
+[![PyPI](https://img.shields.io/pypi/v/snapforge)](...)
+[![Python](https://img.shields.io/pypi/pyversions/snapforge)](...)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](...)
+[![Made with Pillow](https://img.shields.io/badge/Built%20With-Pillow-blue)](...)
+[![Status](https://img.shields.io/badge/status-active-success)](...)
+
+> **Forge your images with a single chain of commands.**
+
+A lightweight, fast and intuitive Python library for image processing built on top of Pillow.
+
+Perfect for resizing, filtering, enhancing and transforming images .
+
+## ✨ Features
+
+- 🚀 **Fast & Lightweight**: Minimal overhead for quick image tasks.
+
+- 🔄 **Format Conversion**: Easily switch between JPEG, PNG, BMP, TIFF 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.
+
+- 📷 **Powered by Pillow**: Uses the trusted Pillow library for reliable image processing.
+
+- ⚡ **Efficient Processing**: Designed for smooth and practical image manipulation workflows.
+
+- 🧾 **MIT License**: Open-source and free to use in personal and commercial projects.
+
+## 🔄 Professional Format Converter 🔄
+Our Storage.convert Supports **more** than **8 Formats** :
+JPEG, JPG , PNG, WEBP, GIF, TIFF, BMP, ICO and etc. 
+
+
+## 📦 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:
+```bash
+from snapforge import Storage , Geometry
+
+img=Storage.load(r"C:\Users\almahdilaptop\Pictures\sharp.png")
+img=Geometry.round_corners(img,40)
+img=Storage.save(img,r"C:\Users\almahdilaptop\Pictures\light.png")
+
+```
+
+# 📖 Available Modules
+
+SnapForge is now **fully modular** 🔧 — each module has a single responsibility and can be imported independently:
+
+```python
+from snapforge import Storage, Geometry, Effects, Overlays, Inspector, SnapForgeUpdater
+```
+
+- 📐 **Geometry** — resizing, cropping, rotating and transforming
+- 💾 **Storage** — loading, saving and format conversion
+- 🔍 **Inspector** — metadata, histogram and color analysis
+- 🎨 **Effects** — lighting and filters
+- 🖼️ **Overlays** — text, watermark, borders and blending
+- 🔄 **SnapForgeUpdater** — update checks and version comparison
+
+# 📦 Available Methods
+
+Here is the complete list of all available methods in each **snapforge** module:
+
+### 📐 Geometry
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Geometry.resize(img, w, h)` | Change image dimensions | `Geometry.resize(img, 800, 600)` |
+| `Geometry.thumbnail(img, w, h)` | Resize while keeping aspect ratio | `Geometry.thumbnail(img, 500, 500)` |
+| `Geometry.fit(img, w, h)` | Resize and crop to exact dimensions | `Geometry.fit(img, 1080, 1080)` |
+| `Geometry.crop(img, l, t, r, b)` | Crop image | `Geometry.crop(img, 0, 0, 100, 100)` |
+| `Geometry.rotate(img, a)` | Rotate image | `Geometry.rotate(img, 90)` |
+| `Geometry.flip(img, dir)` | Flip image | `Geometry.flip(img, "horizontal")` |
+| `Geometry.round_corners(img, radius)` | Round image corners | `Geometry.round_corners(img, 40)` |
+
+---
+
+### 💾 Storage
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Storage.load(path)` | Load image from file | `Storage.load("photo.jpg")` |
+| `Storage.save(img, name)` | Save image | `Storage.save(img, "result.jpg")` |
+| `Storage.convert(img, fmt)` | Change image format (PNG, JPG, WEBP…) | `Storage.convert(img, "PNG")` |
+| `Storage.optimize(img, q)` | Set JPEG quality | `Storage.optimize(img, 85)` |
+
+---
+
+### 🔍 Inspector
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Inspector.get_metadata(img)` | Extract detailed image metadata | `Inspector.get_metadata(img)` |
+| `Inspector.histogram(img)` | Generate histogram data | `Inspector.histogram(img)` |
+| `Inspector.compare(img)` | Display metadata and processing summary | `Inspector.compare(img)` |
+| `Inspector.extract_color_palette(img)` | Get dominant colors as Hex codes | `Inspector.extract_color_palette(img)` |
+
+---
+
+### 🎨 Effects (Lighting & Filters)
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Effects.apply_brightness(img, f)` | Adjust brightness | `Effects.apply_brightness(img, 1.2)` |
+| `Effects.apply_contrast(img, f)` | Adjust contrast | `Effects.apply_contrast(img, 1.5)` |
+| `Effects.adjust_gamma(img, g)` | Correct image gamma | `Effects.adjust_gamma(img, 1.3)` |
+| `Effects.auto_enhance(img)` | Improve brightness, contrast and sharpness | `Effects.auto_enhance(img)` |
+| `Effects.invert(img)` | Invert image colors | `Effects.invert(img)` |
+| `Effects.apply_sepia(img)` | Classic sepia effect | `Effects.apply_sepia(img)` |
+| `Effects.apply_grayscale(img, f)` | Convert to grayscale | `Effects.apply_grayscale(img, 1.0)` |
+| `Effects.apply_blur(img, r)` | Gaussian blur | `Effects.apply_blur(img, 5.0)` |
+| `Effects.apply_sharpen(img, f)` | Sharpen image | `Effects.apply_sharpen(img, 1.0)` |
+| `Effects.apply_camscanner(img)` | Document scanner effect | `Effects.apply_camscanner(img)` |
+| `Effects.apply_preset(img, name)` | Apply a professional preset | `Effects.apply_preset(img, "vintage")` |
+
+---
+
+### 🖼️ Overlays
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Overlays.add_watermark(img, path)` | Add watermark | `Overlays.add_watermark(img, "logo.png")` |
+| `Overlays.add_text(img, text, pos)` | Draw text | `Overlays.add_text(img, "Hello!", (50, 50))` |
+| `Overlays.add_border(img, size, color)` | Add border | `Overlays.add_border(img, 10, (0, 0, 0))` |
+| `Overlays.double_exposure(img, img2, mode)` | Blend with another image | `Overlays.double_exposure(img, "layer.png", "blend")` |
+
+---
+
+### 🔄 SnapForgeUpdater
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `SnapForgeUpdater.__init__(package_name, current_version)` | Initialize the updater with the package name and current version | `SnapForgeUpdater("snapforge", "3.0.0")` |
+| `SnapForgeUpdater._check_logic()` | Check PyPI in the background for a newer release | `updater._check_logic()` |
+| `SnapForgeUpdater._notify_user(latest_version, upload_time)` | Display a notification when a new version is available | `updater._notify_user("3.0.1", "2026-08-12 10:30:00")` |
+| `SnapForgeUpdater.start_check()` | Start the update check in a background daemon thread | `updater.start_check()` |
+
+
+## 🛠️ Requirements
+
+To use `SnapForge`, ensure you have the following installed:
+
+* **Python:** 3.7 or higher
+* **Dependencies:**
+    * `Pillow` (for image processing)
+    * `requests` (for automatic update checks)
+    * `packaging` (for version comparison logic)
+
+## 🤝 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.
+
+## 🌟 More Projects
+
+If you enjoy SnapForge, you might also like this project ,too:
+
+### PixSlim
+
+A Python image and ... compression library focused on reducing file size while preserving quality.
+
+
+## 📜 License
+
+Distributed under the MIT License.
+
+## ❤️ Support
+
+If you find SnapForge useful, your support means a lot!
+
+You can help by:
+
+- 📦 Installing the package and trying it in your projects
+- 📝 Sharing feedback and suggestions
+- 🐛 Reporting bugs and improvements
+- 🌟 Recommending SnapForge to other Python developers
+
+🧩 Every piece of feedback helps make SnapForge better. 🙏
+
+## 👤 Author
+
+### Ali.Shm
+
+**Project Maintainer**

snapforge-3.0.0/README.md

@@ -0,0 +1,195 @@
+# 📸 SnapForge
+
+[![PyPI](https://img.shields.io/pypi/v/snapforge)](...)
+[![Python](https://img.shields.io/pypi/pyversions/snapforge)](...)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](...)
+[![Made with Pillow](https://img.shields.io/badge/Built%20With-Pillow-blue)](...)
+[![Status](https://img.shields.io/badge/status-active-success)](...)
+
+> **Forge your images with a single chain of commands.**
+
+A lightweight, fast and intuitive Python library for image processing built on top of Pillow.
+
+Perfect for resizing, filtering, enhancing and transforming images .
+
+## ✨ Features
+
+- 🚀 **Fast & Lightweight**: Minimal overhead for quick image tasks.
+
+- 🔄 **Format Conversion**: Easily switch between JPEG, PNG, BMP, TIFF 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.
+
+- 📷 **Powered by Pillow**: Uses the trusted Pillow library for reliable image processing.
+
+- ⚡ **Efficient Processing**: Designed for smooth and practical image manipulation workflows.
+
+- 🧾 **MIT License**: Open-source and free to use in personal and commercial projects.
+
+## 🔄 Professional Format Converter 🔄
+Our Storage.convert Supports **more** than **8 Formats** :
+JPEG, JPG , PNG, WEBP, GIF, TIFF, BMP, ICO and etc. 
+
+
+## 📦 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:
+```bash
+from snapforge import Storage , Geometry
+
+img=Storage.load(r"C:\Users\almahdilaptop\Pictures\sharp.png")
+img=Geometry.round_corners(img,40)
+img=Storage.save(img,r"C:\Users\almahdilaptop\Pictures\light.png")
+
+```
+
+# 📖 Available Modules
+
+SnapForge is now **fully modular** 🔧 — each module has a single responsibility and can be imported independently:
+
+```python
+from snapforge import Storage, Geometry, Effects, Overlays, Inspector, SnapForgeUpdater
+```
+
+- 📐 **Geometry** — resizing, cropping, rotating and transforming
+- 💾 **Storage** — loading, saving and format conversion
+- 🔍 **Inspector** — metadata, histogram and color analysis
+- 🎨 **Effects** — lighting and filters
+- 🖼️ **Overlays** — text, watermark, borders and blending
+- 🔄 **SnapForgeUpdater** — update checks and version comparison
+
+# 📦 Available Methods
+
+Here is the complete list of all available methods in each **snapforge** module:
+
+### 📐 Geometry
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Geometry.resize(img, w, h)` | Change image dimensions | `Geometry.resize(img, 800, 600)` |
+| `Geometry.thumbnail(img, w, h)` | Resize while keeping aspect ratio | `Geometry.thumbnail(img, 500, 500)` |
+| `Geometry.fit(img, w, h)` | Resize and crop to exact dimensions | `Geometry.fit(img, 1080, 1080)` |
+| `Geometry.crop(img, l, t, r, b)` | Crop image | `Geometry.crop(img, 0, 0, 100, 100)` |
+| `Geometry.rotate(img, a)` | Rotate image | `Geometry.rotate(img, 90)` |
+| `Geometry.flip(img, dir)` | Flip image | `Geometry.flip(img, "horizontal")` |
+| `Geometry.round_corners(img, radius)` | Round image corners | `Geometry.round_corners(img, 40)` |
+
+---
+
+### 💾 Storage
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Storage.load(path)` | Load image from file | `Storage.load("photo.jpg")` |
+| `Storage.save(img, name)` | Save image | `Storage.save(img, "result.jpg")` |
+| `Storage.convert(img, fmt)` | Change image format (PNG, JPG, WEBP…) | `Storage.convert(img, "PNG")` |
+| `Storage.optimize(img, q)` | Set JPEG quality | `Storage.optimize(img, 85)` |
+
+---
+
+### 🔍 Inspector
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Inspector.get_metadata(img)` | Extract detailed image metadata | `Inspector.get_metadata(img)` |
+| `Inspector.histogram(img)` | Generate histogram data | `Inspector.histogram(img)` |
+| `Inspector.compare(img)` | Display metadata and processing summary | `Inspector.compare(img)` |
+| `Inspector.extract_color_palette(img)` | Get dominant colors as Hex codes | `Inspector.extract_color_palette(img)` |
+
+---
+
+### 🎨 Effects (Lighting & Filters)
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Effects.apply_brightness(img, f)` | Adjust brightness | `Effects.apply_brightness(img, 1.2)` |
+| `Effects.apply_contrast(img, f)` | Adjust contrast | `Effects.apply_contrast(img, 1.5)` |
+| `Effects.adjust_gamma(img, g)` | Correct image gamma | `Effects.adjust_gamma(img, 1.3)` |
+| `Effects.auto_enhance(img)` | Improve brightness, contrast and sharpness | `Effects.auto_enhance(img)` |
+| `Effects.invert(img)` | Invert image colors | `Effects.invert(img)` |
+| `Effects.apply_sepia(img)` | Classic sepia effect | `Effects.apply_sepia(img)` |
+| `Effects.apply_grayscale(img, f)` | Convert to grayscale | `Effects.apply_grayscale(img, 1.0)` |
+| `Effects.apply_blur(img, r)` | Gaussian blur | `Effects.apply_blur(img, 5.0)` |
+| `Effects.apply_sharpen(img, f)` | Sharpen image | `Effects.apply_sharpen(img, 1.0)` |
+| `Effects.apply_camscanner(img)` | Document scanner effect | `Effects.apply_camscanner(img)` |
+| `Effects.apply_preset(img, name)` | Apply a professional preset | `Effects.apply_preset(img, "vintage")` |
+
+---
+
+### 🖼️ Overlays
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Overlays.add_watermark(img, path)` | Add watermark | `Overlays.add_watermark(img, "logo.png")` |
+| `Overlays.add_text(img, text, pos)` | Draw text | `Overlays.add_text(img, "Hello!", (50, 50))` |
+| `Overlays.add_border(img, size, color)` | Add border | `Overlays.add_border(img, 10, (0, 0, 0))` |
+| `Overlays.double_exposure(img, img2, mode)` | Blend with another image | `Overlays.double_exposure(img, "layer.png", "blend")` |
+
+---
+
+### 🔄 SnapForgeUpdater
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `SnapForgeUpdater.__init__(package_name, current_version)` | Initialize the updater with the package name and current version | `SnapForgeUpdater("snapforge", "3.0.0")` |
+| `SnapForgeUpdater._check_logic()` | Check PyPI in the background for a newer release | `updater._check_logic()` |
+| `SnapForgeUpdater._notify_user(latest_version, upload_time)` | Display a notification when a new version is available | `updater._notify_user("3.0.1", "2026-08-12 10:30:00")` |
+| `SnapForgeUpdater.start_check()` | Start the update check in a background daemon thread | `updater.start_check()` |
+
+
+## 🛠️ Requirements
+
+To use `SnapForge`, ensure you have the following installed:
+
+* **Python:** 3.7 or higher
+* **Dependencies:**
+    * `Pillow` (for image processing)
+    * `requests` (for automatic update checks)
+    * `packaging` (for version comparison logic)
+
+## 🤝 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.
+
+## 🌟 More Projects
+
+If you enjoy SnapForge, you might also like this project ,too:
+
+### PixSlim
+
+A Python image and ... compression library focused on reducing file size while preserving quality.
+
+
+## 📜 License
+
+Distributed under the MIT License.
+
+## ❤️ Support
+
+If you find SnapForge useful, your support means a lot!
+
+You can help by:
+
+- 📦 Installing the package and trying it in your projects
+- 📝 Sharing feedback and suggestions
+- 🐛 Reporting bugs and improvements
+- 🌟 Recommending SnapForge to other Python developers
+
+🧩 Every piece of feedback helps make SnapForge better. 🙏
+
+## 👤 Author
+
+### Ali.Shm
+
+**Project Maintainer**

snapforge-3.0.0/dist_release/snapforge/__init__.py

@@ -0,0 +1,13 @@
+# snapforge/__init__.py
+
+from .modules.geometry import Geometry
+from .modules.effects import Effects
+from .modules.overlays import Overlays
+from .utils.storage import Storage
+from .utils.inspector import Inspector
+from .utils.updater import SnapForgeUpdater
+
+__version__ = "3.0.0"
+
+updater = SnapForgeUpdater("snapforge", __version__)
+updater.start_check()

snapforge-3.0.0/dist_release/snapforge/modules/__init__.py

@@ -0,0 +1,3 @@
+from .effects import Effects
+from .geometry import Geometry
+from .overlays import Overlays

snapforge-3.0.0/dist_release/snapforge/utils/__init__.py

@@ -0,0 +1,3 @@
+from .inspector import Inspector
+from .storage import Storage
+from .updater import SnapForgeUpdater

snapforge-3.0.0/dist_release/snapforge.egg-info/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: snapforge
+Version: 3.0.0
+Summary: Powerful and fast image editor! 😎
+Author: Ali.Shm
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=9.0.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: packaging>=20.0
+
+# 📸 SnapForge
+
+[![PyPI](https://img.shields.io/pypi/v/snapforge)](...)
+[![Python](https://img.shields.io/pypi/pyversions/snapforge)](...)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](...)
+[![Made with Pillow](https://img.shields.io/badge/Built%20With-Pillow-blue)](...)
+[![Status](https://img.shields.io/badge/status-active-success)](...)
+
+> **Forge your images with a single chain of commands.**
+
+A lightweight, fast and intuitive Python library for image processing built on top of Pillow.
+
+Perfect for resizing, filtering, enhancing and transforming images .
+
+## ✨ Features
+
+- 🚀 **Fast & Lightweight**: Minimal overhead for quick image tasks.
+
+- 🔄 **Format Conversion**: Easily switch between JPEG, PNG, BMP, TIFF 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.
+
+- 📷 **Powered by Pillow**: Uses the trusted Pillow library for reliable image processing.
+
+- ⚡ **Efficient Processing**: Designed for smooth and practical image manipulation workflows.
+
+- 🧾 **MIT License**: Open-source and free to use in personal and commercial projects.
+
+## 🔄 Professional Format Converter 🔄
+Our Storage.convert Supports **more** than **8 Formats** :
+JPEG, JPG , PNG, WEBP, GIF, TIFF, BMP, ICO and etc. 
+
+
+## 📦 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:
+```bash
+from snapforge import Storage , Geometry
+
+img=Storage.load(r"C:\Users\almahdilaptop\Pictures\sharp.png")
+img=Geometry.round_corners(img,40)
+img=Storage.save(img,r"C:\Users\almahdilaptop\Pictures\light.png")
+
+```
+
+# 📖 Available Modules
+
+SnapForge is now **fully modular** 🔧 — each module has a single responsibility and can be imported independently:
+
+```python
+from snapforge import Storage, Geometry, Effects, Overlays, Inspector, SnapForgeUpdater
+```
+
+- 📐 **Geometry** — resizing, cropping, rotating and transforming
+- 💾 **Storage** — loading, saving and format conversion
+- 🔍 **Inspector** — metadata, histogram and color analysis
+- 🎨 **Effects** — lighting and filters
+- 🖼️ **Overlays** — text, watermark, borders and blending
+- 🔄 **SnapForgeUpdater** — update checks and version comparison
+
+# 📦 Available Methods
+
+Here is the complete list of all available methods in each **snapforge** module:
+
+### 📐 Geometry
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Geometry.resize(img, w, h)` | Change image dimensions | `Geometry.resize(img, 800, 600)` |
+| `Geometry.thumbnail(img, w, h)` | Resize while keeping aspect ratio | `Geometry.thumbnail(img, 500, 500)` |
+| `Geometry.fit(img, w, h)` | Resize and crop to exact dimensions | `Geometry.fit(img, 1080, 1080)` |
+| `Geometry.crop(img, l, t, r, b)` | Crop image | `Geometry.crop(img, 0, 0, 100, 100)` |
+| `Geometry.rotate(img, a)` | Rotate image | `Geometry.rotate(img, 90)` |
+| `Geometry.flip(img, dir)` | Flip image | `Geometry.flip(img, "horizontal")` |
+| `Geometry.round_corners(img, radius)` | Round image corners | `Geometry.round_corners(img, 40)` |
+
+---
+
+### 💾 Storage
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Storage.load(path)` | Load image from file | `Storage.load("photo.jpg")` |
+| `Storage.save(img, name)` | Save image | `Storage.save(img, "result.jpg")` |
+| `Storage.convert(img, fmt)` | Change image format (PNG, JPG, WEBP…) | `Storage.convert(img, "PNG")` |
+| `Storage.optimize(img, q)` | Set JPEG quality | `Storage.optimize(img, 85)` |
+
+---
+
+### 🔍 Inspector
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Inspector.get_metadata(img)` | Extract detailed image metadata | `Inspector.get_metadata(img)` |
+| `Inspector.histogram(img)` | Generate histogram data | `Inspector.histogram(img)` |
+| `Inspector.compare(img)` | Display metadata and processing summary | `Inspector.compare(img)` |
+| `Inspector.extract_color_palette(img)` | Get dominant colors as Hex codes | `Inspector.extract_color_palette(img)` |
+
+---
+
+### 🎨 Effects (Lighting & Filters)
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Effects.apply_brightness(img, f)` | Adjust brightness | `Effects.apply_brightness(img, 1.2)` |
+| `Effects.apply_contrast(img, f)` | Adjust contrast | `Effects.apply_contrast(img, 1.5)` |
+| `Effects.adjust_gamma(img, g)` | Correct image gamma | `Effects.adjust_gamma(img, 1.3)` |
+| `Effects.auto_enhance(img)` | Improve brightness, contrast and sharpness | `Effects.auto_enhance(img)` |
+| `Effects.invert(img)` | Invert image colors | `Effects.invert(img)` |
+| `Effects.apply_sepia(img)` | Classic sepia effect | `Effects.apply_sepia(img)` |
+| `Effects.apply_grayscale(img, f)` | Convert to grayscale | `Effects.apply_grayscale(img, 1.0)` |
+| `Effects.apply_blur(img, r)` | Gaussian blur | `Effects.apply_blur(img, 5.0)` |
+| `Effects.apply_sharpen(img, f)` | Sharpen image | `Effects.apply_sharpen(img, 1.0)` |
+| `Effects.apply_camscanner(img)` | Document scanner effect | `Effects.apply_camscanner(img)` |
+| `Effects.apply_preset(img, name)` | Apply a professional preset | `Effects.apply_preset(img, "vintage")` |
+
+---
+
+### 🖼️ Overlays
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `Overlays.add_watermark(img, path)` | Add watermark | `Overlays.add_watermark(img, "logo.png")` |
+| `Overlays.add_text(img, text, pos)` | Draw text | `Overlays.add_text(img, "Hello!", (50, 50))` |
+| `Overlays.add_border(img, size, color)` | Add border | `Overlays.add_border(img, 10, (0, 0, 0))` |
+| `Overlays.double_exposure(img, img2, mode)` | Blend with another image | `Overlays.double_exposure(img, "layer.png", "blend")` |
+
+---
+
+### 🔄 SnapForgeUpdater
+
+| Method | Description | Example |
+| --- | --- | --- |
+| `SnapForgeUpdater.__init__(package_name, current_version)` | Initialize the updater with the package name and current version | `SnapForgeUpdater("snapforge", "3.0.0")` |
+| `SnapForgeUpdater._check_logic()` | Check PyPI in the background for a newer release | `updater._check_logic()` |
+| `SnapForgeUpdater._notify_user(latest_version, upload_time)` | Display a notification when a new version is available | `updater._notify_user("3.0.1", "2026-08-12 10:30:00")` |
+| `SnapForgeUpdater.start_check()` | Start the update check in a background daemon thread | `updater.start_check()` |
+
+
+## 🛠️ Requirements
+
+To use `SnapForge`, ensure you have the following installed:
+
+* **Python:** 3.7 or higher
+* **Dependencies:**
+    * `Pillow` (for image processing)
+    * `requests` (for automatic update checks)
+    * `packaging` (for version comparison logic)
+
+## 🤝 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.
+
+## 🌟 More Projects
+
+If you enjoy SnapForge, you might also like this project ,too:
+
+### PixSlim
+
+A Python image and ... compression library focused on reducing file size while preserving quality.
+
+
+## 📜 License
+
+Distributed under the MIT License.
+
+## ❤️ Support
+
+If you find SnapForge useful, your support means a lot!
+
+You can help by:
+
+- 📦 Installing the package and trying it in your projects
+- 📝 Sharing feedback and suggestions
+- 🐛 Reporting bugs and improvements
+- 🌟 Recommending SnapForge to other Python developers
+
+🧩 Every piece of feedback helps make SnapForge better. 🙏
+
+## 👤 Author
+
+### Ali.Shm
+
+**Project Maintainer**

snapforge-3.0.0/dist_release/snapforge.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+dist_release/snapforge/__init__.py
+dist_release/snapforge.egg-info/PKG-INFO
+dist_release/snapforge.egg-info/SOURCES.txt
+dist_release/snapforge.egg-info/dependency_links.txt
+dist_release/snapforge.egg-info/requires.txt
+dist_release/snapforge.egg-info/top_level.txt
+dist_release/snapforge/modules/__init__.py
+dist_release/snapforge/modules/effects.pyc
+dist_release/snapforge/modules/geometry.pyc
+dist_release/snapforge/modules/overlays.pyc
+dist_release/snapforge/utils/__init__.py
+dist_release/snapforge/utils/inspector.pyc
+dist_release/snapforge/utils/storage.pyc
+dist_release/snapforge/utils/updater.pyc

snapforge-3.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "snapforge"
+version = "3.0.0"
+description = "Powerful and fast image editor! 😎"
+authors = [{name = "Ali.Shm"}]
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "Pillow>=9.0.0",
+    "requests>=2.25.0",
+    "packaging>=20.0"
+]
+
+[tool.setuptools]
+package-dir = {"" = "dist_release"}
+
+[tool.setuptools.packages.find]
+where = ["dist_release"]
+
+[tool.setuptools.package-data]
+snapforge = ["*.pyc"]
+"snapforge.modules" = ["*.pyc"]
+"snapforge.utils" = ["*.pyc"]