snapforge 0.1.1__py3-none-any.whl

snapforge/__init__.py

@@ -0,0 +1,3 @@
+from .forge import SnapForge
+
+__version__ = "0.1.1"

snapforge/forge.py

@@ -0,0 +1,89 @@
+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.1.dist-info/METADATA

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

snapforge-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+snapforge/__init__.py,sha256=I2xel16FM40Fc9aWFJRrtJL5ZjQ5IAoTgFyB5gFbV8A,53
+snapforge/forge.py,sha256=-XZ8AVLRWNZnDa7yKP-xWnjt9zU_7wXZThpEcXhMkoc,4261
+snapforge-0.1.1.dist-info/METADATA,sha256=UQ-1_88WsoK4-dJKpKQsxyErEk1CAYx_4RtRhE_PhqQ,219
+snapforge-0.1.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+snapforge-0.1.1.dist-info/top_level.txt,sha256=U5q4WCK4d1sn94Rg2dafi2gckV5id8Wt0C5PHysj5a0,10
+snapforge-0.1.1.dist-info/RECORD,,

snapforge-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

snapforge-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+snapforge