snapforge 0.1.1__tar.gz

snapforge-0.1.1/PKG-INFO

@@ -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/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "snapforge"
+version = "0.1.1"
+description = "A powerful and fast image forging tool! 😎"
+authors = [
+  { name="Ali"},
+]
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "Pillow>=9.0.0",
+]

snapforge-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

snapforge-0.1.1/snapforge/__init__.py

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

snapforge-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/snapforge.egg-info/PKG-INFO

@@ -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/snapforge.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+snapforge/__init__.py
+snapforge/forge.py
+snapforge.egg-info/PKG-INFO
+snapforge.egg-info/SOURCES.txt
+snapforge.egg-info/dependency_links.txt
+snapforge.egg-info/requires.txt
+snapforge.egg-info/top_level.txt

snapforge-0.1.1/snapforge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

snapforge-0.1.1/snapforge.egg-info/requires.txt

@@ -0,0 +1 @@
+Pillow>=9.0.0

snapforge-0.1.1/snapforge.egg-info/top_level.txt

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