ImagePRO-Python 1.0.4__tar.gz → 1.0.5__tar.gz

{imagepro_python-1.0.4/src/ImagePRO_Python.egg-info → imagepro_python-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.0.4
+Version: 1.0.5
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT

{imagepro_python-1.0.4 → imagepro_python-1.0.5}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "ImagePRO-Python"
-version = "1.0.4"
+version = "1.0.5"
 description = "Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration."
 readme = "README.md"
 requires-python = "==3.10.*"

{imagepro_python-1.0.4 → imagepro_python-1.0.5}/src/ImagePRO/utils/image.py

@@ -33,7 +33,7 @@ class Image:
 
     Example:
         >>> # Load from file (default BGR)
-        >>> img = Image.from_path('input.jpg')
+        >>> img = Image.from_path('input.jpg', colorspace="BGR")
         >>> print(img.shape)  # (H, W, 3)
         >>> 
         >>> # Or wrap a NumPy array
@@ -46,13 +46,19 @@ class Image:
     source_type: SourceType = "array"
 
     @classmethod
-    def from_path(cls, path: str | Path) -> Image:
+    def from_path(
+        cls, 
+        path: str | Path,
+        colorspace: Colorspace = "BGR"
+    ) -> Image:
         """
         Create an Image instance from a file path.
 
         Args:
             path (str | Path):
                 Path to the image file.
+            colorspace (Colorspace, optional):
+                Colorspace of the image array in that path ("BGR", "RGB", or "GRAY"). Defaults to "BGR".
 
         Returns:
             Image: New Image instance loaded from disk.
@@ -60,13 +66,16 @@ class Image:
         Raises:
             TypeError: If path is not str or Path.
             ValueError: If image cannot be loaded.
+            ValueError: If colorspace is invalid.
         """
         if not isinstance(path, (str, Path)):
             raise TypeError("'path' must be a string or pathlib.Path.")
         np_image = cv2.imread(str(path))
         if np_image is None:
             raise ValueError(f"Failed to load image from {path}")
-        return cls(_data=np_image, path=Path(path), colorspace="BGR", source_type="path")
+        if colorspace not in ("BGR", "RGB", "GRAY"):
+            raise ValueError("'colorspace' must be one of 'BGR', 'RGB', 'GRAY'.")
+        return cls(_data=np_image, path=Path(path), colorspace=colorspace, source_type="path")
 
     @classmethod
     def from_array(

{imagepro_python-1.0.4 → imagepro_python-1.0.5/src/ImagePRO_Python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.0.4
+Version: 1.0.5
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT