snapforge 0.1.2__tar.gz → 0.2.1__tar.gz

snapforge-0.2.1/PKG-INFO

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

snapforge-0.2.1/README.md

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

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

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "snapforge"
-version = "0.1.2"
+version = "0.2.1"
 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-0.2.1}/snapforge/__init__.py

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

{snapforge-0.1.2 → snapforge-0.2.1}/snapforge/forge.py

@@ -1,4 +1,4 @@
-from PIL import Image, ImageEnhance, ImageOps
+from PIL import Image, ImageEnhance, ImageOps, ImageFilter
 import os
 
 class SnapForge:
@@ -10,9 +10,10 @@ class SnapForge:
             raise FileNotFoundError(f"❌ Error: The specified file path does not exist: '{image_path}'")
         
         try:
-            self.image = Image.open(image_path).convert("RGB") # تبدیل به RGB برای سازگاری بهتر
+            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 # Default quality
             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}")
@@ -39,21 +40,62 @@ class SnapForge:
         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)
+    # --- 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")
-        
-        # ترکیب تصویر اصلی با تصویر سیاه و سفید بر اساس فاکتور
-        # فرمول: 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
 
@@ -80,7 +122,7 @@ class SnapForge:
             
             save_kwargs = {"optimize": True}
             if self.target_format in ["JPEG", "JPG"]:
-                save_kwargs["quality"] = getattr(self, 'quality', 85)
+                save_kwargs["quality"] = self.quality
 
             self.image.save(output_name, **save_kwargs)
             print(f"🎉 Success: Image forged and saved as '{output_name}' 🎉")

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

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

{snapforge-0.1.2 → snapforge-0.2.1}/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.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