snapforge 0.1.2__tar.gz → 1.2.0__tar.gz

snapforge-1.2.0/PKG-INFO

@@ -0,0 +1,89 @@
+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

snapforge-1.2.0/README.md

@@ -0,0 +1,80 @@
+# 📸 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

{snapforge-0.1.2 → snapforge-1.2.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "snapforge"
-version = "0.1.2"
+version = "1.2.0"
 description = "Powerful and fast image editor! 😎"
 authors = [
   { name="Ali"},
 ]
-readme = "README.md"
+readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.7"
 dependencies = [
     "Pillow>=9.0.0",

{snapforge-0.1.2 → snapforge-1.2.0}/snapforge/__init__.py

@@ -1,3 +1,3 @@
 from .forge import SnapForge
 
-__version__ = "0.1.2"
+__version__ = "1.2.0"

snapforge-1.2.0/snapforge/forge.py

@@ -0,0 +1,223 @@
+from PIL import Image, ImageEnhance, ImageOps, ImageFilter
+import os
+import requests
+import threading
+from datetime import datetime
+from packaging import version
+
+class SnapForgeUpdater:
+    def __init__(self, package_name: str, current_version: str):
+        self.package_name = package_name
+        self.current_version = current_version
+        self.api_url = f"https://pypi.org/pypi/{package_name}/json"
+
+    def _check_logic(self):
+        """Perform the update check in the background."""
+        try:
+            response = requests.get(self.api_url, timeout=5)
+            if response.status_code != 200:
+                return
+
+            data = response.json()
+            latest_version = data["info"]["version"]
+
+            if version.parse(latest_version) > version.parse(self.current_version):
+                latest_release_data = data["releases"][latest_version][0]
+                iso_time = latest_release_data["upload_time_iso_8601"]
+                
+                dt_object = datetime.fromisoformat(iso_time.replace('Z', '+00:00'))
+                formatted_time = dt_object.strftime('%Y-%m-%d %H:%M:%S')
+
+                self._notify_user(latest_version, formatted_time)
+
+        except Exception:
+            pass
+
+    def _notify_user(self, latest_version, upload_time):
+        """Display the update notification to the user."""
+        print("\n" + "="*50)
+        print(f"🚀 [SnapForge] NEW UPDATE AVAILABLE!")
+        print(f"✨ Latest Version: {latest_version}")
+        print(f"📅 Released on: {upload_time} (UTC)")
+        print(f"🛠️ Your Version: {self.current_version}")
+        print(f"👉 Run: pip install --upgrade {self.package_name}")
+        print("="*50 + "\n")
+
+    def start_check(self):
+        """Initialize the update check in a separate thread."""
+        thread = threading.Thread(target=self._check_logic, daemon=True)
+        thread.start()
+
+class SnapForge:
+    __version__ = "1.2.0"
+
+    def __init__(self, image_path: str):
+        """ 😎 Load your image and get ready for the magic! 😎 """
+        updater = SnapForgeUpdater("snapforge", self.__version__)
+        updater.start_check()
+        
+        print(f"📸 SnapForge initialized (v{self.__version__})")
+        if not os.path.exists(image_path):
+            raise FileNotFoundError(f"❌ Error: The specified file path does not exist: '{image_path}'")
+        
+        try:
+            self.image = Image.open(image_path).convert("RGB")
+            self.original_format = self.image.format
+            self.target_format = self.original_format if self.original_format else "JPEG"
+            self.quality = 85 
+            print(f"🚀 Success: Image loaded successfully. Original format: {self.target_format}")
+        except Exception as e:
+            raise IOError(f"❌ Error: Failed to open the image. Details: {e}")
+
+    def convert(self, new_format: str):
+        """ 😎 Change the format! 😎 """
+        self.target_format = new_format.upper()
+        print(f"🔄 Format set to: {self.target_format}")
+        return self
+
+    def resize(self, width: int, height: int):
+        """ 😎 Shrink it or expand it! 😎 """
+        if width <= 0 or height <= 0:
+            raise ValueError("❌ Error: Width and height must be positive integers.")
+        self.image = self.image.resize((width, height), Image.Resampling.LANCZOS)
+        print(f"📏 Success: Image resized to {width}x{height}")
+        return self
+
+    def optimize(self, quality: int = 85):
+        """ 😎 Make it lightweight! 😎 """
+        if not (1 <= quality <= 100):
+            raise ValueError("❌ Error: Quality must be between 1 and 100.")
+        self.quality = quality
+        print(f"✨ Success: Optimization mode enabled (Quality: {quality}%)")
+        return self
+
+    # --- NEW FEATURES ADDED BELOW ---
+
+    def apply_brightness(self, factor: float):
+        """ 😎 Light it up or dim it down! 😎 
+        factor: 1.0 is original, < 1.0 is darker, > 1.0 is brighter
+        """
+        enhancer = ImageEnhance.Brightness(self.image)
+        self.image = enhancer.enhance(factor)
+        print(f"☀️ Success: Brightness adjusted by factor {factor}")
+        return self
+
+    def apply_contrast(self, factor: float):
+        """ 😎 Pop those colors! 😎 
+        factor: 1.0 is original, < 1.0 is lower contrast, > 1.0 is higher contrast
+        """
+        enhancer = ImageEnhance.Contrast(self.image)
+        self.image = enhancer.enhance(factor)
+        print(f"🌗 Success: Contrast adjusted by factor {factor}")
+        return self
+
+    def apply_sepia(self):
+        """ 😎 Just like old cameras! (Sepia Filter) 😎 """
+        # Applying sepia via color transformation
+        width, height = self.image.size
+        pixels = self.image.load()
+        for py in range(height):
+            for px in range(width):
+                r, g, b = pixels[px, py]
+                # Standard Sepia formula
+                tr = int(0.393 * r + 0.769 * g + 0.189 * b)
+                tg = int(0.349 * r + 0.686 * g + 0.168 * b)
+                tb = int(0.272 * r + 0.534 * g + 0.131 * b)
+                pixels[px, py] = (min(tr, 255), min(tg, 255), min(tb, 255))
+        print(f"📜 Success: Sepia effect applied!")
+        return self
+
+    def apply_blur(self, radius: float):
+        """ 😎 Make it dreamy! 😎 """
+        self.image = self.image.filter(ImageFilter.GaussianBlur(radius))
+        print(f"☁️ Success: Blur applied with radius {radius}")
+        return self
+
+    def apply_sharpen(self):
+        """ 😎 Make it crisp! 😎 """
+        self.image = self.image.filter(ImageFilter.SHARPEN)
+        print(f"🎯 Success: Image sharpened!")
+        return self
+
+    # --- END OF NEW FEATURES ---
+
+    def apply_grayscale(self, factor: float = 1.0):
+        """ 😎 Make it moody! 😎 """
+        if not (0.0 <= factor <= 1.0):
+            raise ValueError("❌ Error: Factor must be between 0.0 and 1.0")
+        grayscale_image = ImageOps.grayscale(self.image).convert("RGB")
+        self.image = Image.blend(self.image, grayscale_image, factor)
+        print(f"🌑 Success: Grayscale effect applied with factor {factor}")
+        return self
+
+    def add_watermark(self, watermark_path: str, position: tuple = (0, 0), opacity: float = 0.5):
+        """ 😎 Put your signature! 😎 """
+        if not os.path.exists(watermark_path):
+            raise FileNotFoundError(f"❌ Error: Watermark file not found at: '{watermark_path}'")
+        try:
+            watermark = Image.open(watermark_path).convert("RGBA")
+            alpha = watermark.split()[3]
+            alpha = ImageEnhance.Brightness(alpha).enhance(opacity)
+            watermark.putalpha(alpha)
+            self.image.paste(watermark, position, watermark)
+            print(f"🛡️ Success: Watermark applied at position {position}")
+        except Exception as e:
+            raise RuntimeError(f"❌ Error: Failed to apply watermark. Details: {e}")
+        return self
+
+    def save(self, output_name: str):
+        """ 😎 The moment of truth! 😎 """
+        try:
+            if not output_name.lower().endswith(f".{self.target_format.lower()}"):
+                output_name = f"{output_name}.{self.target_format.lower()}"
+            
+            save_kwargs = {"optimize": True}
+            if self.target_format in ["JPEG", "JPG"]:
+                save_kwargs["quality"] = self.quality
+
+            self.image.save(output_name, **save_kwargs)
+            print(f"🎉 Success: Image forged and saved as '{output_name}' 🎉")
+            return output_name
+        except Exception as e:
+            raise IOError(f"❌ Error: Failed to save the image. Details: {e}")
+    
+    def flip(self, direction: str = "horizontal"):
+        """ 😎 Flip the image! direction: 'horizontal' or 'vertical' 😎 """
+        if direction.lower() == "horizontal":
+            self.image = self.image.transpose(Image.FLIP_LEFT_RIGHT)
+        elif direction.lower() == "vertical":
+            self.image = self.image.transpose(Image.FLIP_TOP_BOTTOM)
+        else:
+            raise ValueError("❌ Error: Direction must be 'horizontal' or 'vertical'.")
+        print(f"🔄 Success: Image flipped {direction}ly")
+        return self
+
+    def apply_camscanner(self):
+        """ 😎 Make it look like a scanned document! 😎 """
+        
+        self.image = self.image.convert("L")
+        
+        threshold = 150
+        self.image = self.image.point(lambda p: 255 if p > threshold else 0)
+        
+        self.image = self.image.convert("RGB")
+        
+        print(f"📄 Success: CamScanner effect applied!")
+        return self
+    
+    def rotate(self, angle: float, expand: bool = True):
+        """ 😎 Rotate the image by any angle! 😎 
+        angle: degrees (positive is counter-clockwise)
+        expand: If True, expands the output image to fit the rotated image.
+        """
+        self.image = self.image.rotate(angle, expand=expand)
+        print(f"🔄 Success: Image rotated by {angle} degrees")
+        return self
+
+    def crop(self, left: int, top: int, right: int, bottom: int):
+        """ 😎 Cut out the unwanted parts! 😎 
+        Arguments define the box to keep.
+        """
+        self.image = self.image.crop((left, top, right, bottom))
+        print(f"✂️ Success: Image cropped to ({left}, {top}, {right}, {bottom})")
+        return self

snapforge-1.2.0/snapforge.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+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

{snapforge-0.1.2 → snapforge-1.2.0}/snapforge.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+README.md
 pyproject.toml
 snapforge/__init__.py
 snapforge/forge.py

snapforge-0.1.2/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: snapforge
-Version: 0.1.2
-Summary: Powerful and fast image editor! 😎
-Author: Ali
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: Pillow>=9.0.0

snapforge-0.1.2/snapforge/forge.py

@@ -1,89 +0,0 @@
-from PIL import Image, ImageEnhance, ImageOps
-import os
-
-class SnapForge:
-    """ 😎 Welcome to SnapForge! The ultimate tool to forge your images into greatness! 😎 """
-
-    def __init__(self, image_path: str):
-        """ 😎 Load your image and get ready for the magic! 😎 """
-        if not os.path.exists(image_path):
-            raise FileNotFoundError(f"❌ Error: The specified file path does not exist: '{image_path}'")
-        
-        try:
-            self.image = Image.open(image_path).convert("RGB") # تبدیل به RGB برای سازگاری بهتر
-            self.original_format = self.image.format
-            self.target_format = self.original_format if self.original_format else "JPEG"
-            print(f"🚀 Success: Image loaded successfully. Original format: {self.target_format}")
-        except Exception as e:
-            raise IOError(f"❌ Error: Failed to open the image. Details: {e}")
-
-    def convert(self, new_format: str):
-        """ 😎 Change the format! 😎 """
-        self.target_format = new_format.upper()
-        print(f"🔄 Format set to: {self.target_format}")
-        return self
-
-    def resize(self, width: int, height: int):
-        """ 😎 Shrink it or expand it! 😎 """
-        if width <= 0 or height <= 0:
-            raise ValueError("❌ Error: Width and height must be positive integers.")
-        self.image = self.image.resize((width, height), Image.Resampling.LANCZOS)
-        print(f"📏 Success: Image resized to {width}x{height}")
-        return self
-
-    def optimize(self, quality: int = 85):
-        """ 😎 Make it lightweight! 😎 """
-        if not (1 <= quality <= 100):
-            raise ValueError("❌ Error: Quality must be between 1 and 100.")
-        self.quality = quality
-        print(f"✨ Success: Optimization mode enabled (Quality: {quality}%)")
-        return self
-
-    def apply_grayscale(self, factor: float = 1.0):
-        """ 
-        😎 Make it moody! 😎
-        factor: 0.0 (full color) to 1.0 (full black & white)
-        """
-        if not (0.0 <= factor <= 1.0):
-            raise ValueError("❌ Error: Factor must be between 0.0 and 1.0")
-        
-        # ایجاد نسخه سیاه و سفید
-        grayscale_image = ImageOps.grayscale(self.image).convert("RGB")
-        
-        # ترکیب تصویر اصلی با تصویر سیاه و سفید بر اساس فاکتور
-        # فرمول: Result = Image * (1 - factor) + Grayscale * factor
-        self.image = Image.blend(self.image, grayscale_image, factor)
-        
-        print(f"🌑 Success: Grayscale effect applied with factor {factor}")
-        return self
-
-    def add_watermark(self, watermark_path: str, position: tuple = (0, 0), opacity: float = 0.5):
-        """ 😎 Put your signature! 😎 """
-        if not os.path.exists(watermark_path):
-            raise FileNotFoundError(f"❌ Error: Watermark file not found at: '{watermark_path}'")
-        try:
-            watermark = Image.open(watermark_path).convert("RGBA")
-            alpha = watermark.split()[3]
-            alpha = ImageEnhance.Brightness(alpha).enhance(opacity)
-            watermark.putalpha(alpha)
-            self.image.paste(watermark, position, watermark)
-            print(f"🛡️ Success: Watermark applied at position {position}")
-        except Exception as e:
-            raise RuntimeError(f"❌ Error: Failed to apply watermark. Details: {e}")
-        return self
-
-    def save(self, output_name: str):
-        """ 😎 The moment of truth! 😎 """
-        try:
-            if not output_name.lower().endswith(f".{self.target_format.lower()}"):
-                output_name = f"{output_name}.{self.target_format.lower()}"
-            
-            save_kwargs = {"optimize": True}
-            if self.target_format in ["JPEG", "JPG"]:
-                save_kwargs["quality"] = getattr(self, 'quality', 85)
-
-            self.image.save(output_name, **save_kwargs)
-            print(f"🎉 Success: Image forged and saved as '{output_name}' 🎉")
-            return output_name
-        except Exception as e:
-            raise IOError(f"❌ Error: Failed to save the image. Details: {e}")

snapforge-0.1.2/snapforge.egg-info/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: snapforge
-Version: 0.1.2
-Summary: Powerful and fast image editor! 😎
-Author: Ali
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: Pillow>=9.0.0