ImagePRO-Python 1.0.4__py3-none-any.whl → 1.0.5__py3-none-any.whl

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.dist-info → imagepro_python-1.0.5.dist-info}/METADATA

@@ -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.dist-info → imagepro_python-1.0.5.dist-info}/RECORD

@@ -21,10 +21,10 @@ ImagePRO/pre_processing/resize.py,sha256=BGGLGao_1uc8B1kZFa5MVYcTzaeeP1qkjFei6M_
 ImagePRO/pre_processing/rotate.py,sha256=kdauqCpn71Yube351o1tmQFyxcj2cjTs0ZJflxsoet8,3926
 ImagePRO/pre_processing/sharpen.py,sha256=kW9KVXvQ77qezBfUWH7loqstQqJ2QvK7s0gtwoxR4EI,3285
 ImagePRO/utils/__init__.py,sha256=McVd-o9KtKOpAVYbLi19KxsatPPFFF-Qbt0gdgY3Ln8,170
-ImagePRO/utils/image.py,sha256=ofzJ5TevUrq8pRwIW7i7zYR4a9IByWPwec1YT4xft3A,3550
+ImagePRO/utils/image.py,sha256=x93cBNycNOgET20a__TxZ9ZQo_2G84uB7QjXjBo9f8M,3973
 ImagePRO/utils/result.py,sha256=DAFaFZ5jZZ7C2YrhRs6h2PAei6Mbv1Mu8xX_2NQ7c6Y,5605
-imagepro_python-1.0.4.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
-imagepro_python-1.0.4.dist-info/METADATA,sha256=PnmPiwygL84z6eC7CrwSlRbQDhGkjklj_0wcCKSZMRM,1618
-imagepro_python-1.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-imagepro_python-1.0.4.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
-imagepro_python-1.0.4.dist-info/RECORD,,
+imagepro_python-1.0.5.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
+imagepro_python-1.0.5.dist-info/METADATA,sha256=Qgg5IKxIMyNAbMJ8JBzB5UHx-YPVo-Ibox93zXZFxvE,1618
+imagepro_python-1.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+imagepro_python-1.0.5.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
+imagepro_python-1.0.5.dist-info/RECORD,,