snapforge 0.2.1__tar.gz → 1.2.0__tar.gz

{snapforge-0.2.1 → snapforge-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapforge
-Version: 0.2.1
+Version: 1.2.0
 Summary: Powerful and fast image editor! 😎
 Author: Ali
 Requires-Python: >=3.7
@@ -47,23 +47,27 @@ resized_img.convert("PNG").save("example_resized.png")
 
 print("Image processed successfully!")
 
-🧾 Feature Showcase (Full Reference)
-
+## 🧾 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")
+| 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

{snapforge-0.2.1 → snapforge-1.2.0}/README.md

@@ -38,23 +38,27 @@ resized_img.convert("PNG").save("example_resized.png")
 
 print("Image processed successfully!")
 
-🧾 Feature Showcase (Full Reference)
-
+## 🧾 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")
+| 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

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "snapforge"
-version = "0.2.1"
+version = "1.2.0"
 description = "Powerful and fast image editor! 😎"
 authors = [
   { name="Ali"},

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

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

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

@@ -1,11 +1,62 @@
 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:
-    """ 😎 Welcome to SnapForge! The ultimate tool to forge your images into greatness! 😎 """
+    __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}'")
         
@@ -13,7 +64,7 @@ class SnapForge:
             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
+            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}")
@@ -128,4 +179,45 @@ class SnapForge:
             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}")
+            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-0.2.1 → snapforge-1.2.0}/snapforge.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapforge
-Version: 0.2.1
+Version: 1.2.0
 Summary: Powerful and fast image editor! 😎
 Author: Ali
 Requires-Python: >=3.7
@@ -47,23 +47,27 @@ resized_img.convert("PNG").save("example_resized.png")
 
 print("Image processed successfully!")
 
-🧾 Feature Showcase (Full Reference)
-
+## 🧾 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")
+| 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