ImagePRO-Python 1.3.0__tar.gz → 1.4.0__tar.gz

{imagepro_python-1.3.0/src/ImagePRO_Python.egg-info → imagepro_python-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.3.0
+Version: 1.4.0
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -76,6 +76,11 @@ Whether you're working on computer vision pipelines, preprocessing images for AI
 - **YOLO Integration**: Multiple accuracy levels (nano to extra-large)
 - **Flexible Models**: Pre-trained or custom model support
 
+### **Pipelines**
+- **Reusable Operation Chains**: Define a sequence of functions once, then run it on any input (Image, NumPy array, or file path)
+- **Flexible Steps**: Any ImagePRO function or custom callable; per-step keyword arguments via `Step`
+- **Pipeline Metadata**: Every result lists the executed steps and each step's parameters
+
 ## Installation
 
 ### From PyPI
@@ -90,6 +95,8 @@ pip install "ImagePRO-Python[full]"         # Everything
 pip install "ImagePRO-Python[dev]"          # Test tooling (pytest)
 ```
 
+> **Note**: The base install is lightweight — AI backends (MediaPipe, Ultralytics, InsightFace) are optional and imported lazily, only when you call a function that actually needs them. `import ImagePRO` never loads these dependencies. If a backend is missing, the function you call raises an `ImportError` telling you exactly which extra to install.
+
 ### From Source
 ```bash
 git clone https://github.com/parsasafaie/ImagePRO.git
@@ -152,6 +159,22 @@ object_detection_result = detect_objects(
 )
 print(f"Detected {len(object_detection_result.data)} objects")
 object_detection_result.save_as_img("detections.jpg")
+
+# Chain operations into a reusable pipeline
+from ImagePRO.pipeline import Pipeline, Step
+from ImagePRO.pre_processing.grayscale import convert_to_grayscale
+from ImagePRO.pre_processing.resize import resize_image
+
+pipeline = Pipeline([
+    Step(apply_gaussian_blur, kernel_size=(7, 7)),
+    convert_to_grayscale,
+    Step(resize_image, new_size=(800, 600)),
+])
+
+# Run it on any input: an Image, a NumPy array, or a file path
+pipeline_result = pipeline.run("person_and_objects.jpg")
+pipeline_result.save_as_img("processed_output.jpg")
+print(pipeline_result.meta["steps"])  # Executed step names
 ```
 
 > **Note**: These are basic examples. Each module contains many more functions with extensive customization options. Explore the module-specific README files for detailed documentation.
@@ -165,6 +188,7 @@ Each module includes comprehensive documentation with detailed examples:
   - [Face Analysis](src/ImagePRO/human_analysis/face_analysis/README.md): Face mesh, pose estimation, eye status, comparison
   - [Body Analysis](src/ImagePRO/human_analysis/body_analysis/README.md): Body pose and hand tracking
 - **[Object Analysis](src/ImagePRO/object_analysis/README.md)**: YOLO-based object detection
+- **[Pipeline](src/ImagePRO/pipeline/README.md)**: Reusable chains of image processing operations
 - **[Utils](src/ImagePRO/utils/README.md)**: Shared utilities and I/O handling
 
 For detailed project structure and development guidelines, see [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md).
@@ -176,6 +200,8 @@ ImagePRO is built with a modular architecture designed for extensibility and mai
 - **Clean Separation of Concerns**: Each module handles a specific domain
 - **Consistent API Patterns**: All functions follow the same input/output conventions
 - **Shared Utilities**: Common `Image` and `Result` classes for unified I/O
+- **Reusable Pipelines**: Chain any operations into a `Pipeline` and run it on any input
+- **Lazy Optional Imports**: Heavy AI dependencies (MediaPipe, Ultralytics, InsightFace) are only imported inside the functions that use them, keeping `import ImagePRO` fast and independent of installed extras
 - **Professional Error Handling**: Comprehensive validation with clear error messages
 - **Type Safety**: Full type hints throughout the codebase
 - **Documentation**: Google-style docstrings for all functions

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "ImagePRO-Python"
-version = "1.3.0"
+version = "1.4.0"
 description = "Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration."
 readme = "readme.md"
 requires-python = ">=3.9,<3.13"

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/readme.md

@@ -27,6 +27,11 @@ Whether you're working on computer vision pipelines, preprocessing images for AI
 - **YOLO Integration**: Multiple accuracy levels (nano to extra-large)
 - **Flexible Models**: Pre-trained or custom model support
 
+### **Pipelines**
+- **Reusable Operation Chains**: Define a sequence of functions once, then run it on any input (Image, NumPy array, or file path)
+- **Flexible Steps**: Any ImagePRO function or custom callable; per-step keyword arguments via `Step`
+- **Pipeline Metadata**: Every result lists the executed steps and each step's parameters
+
 ## Installation
 
 ### From PyPI
@@ -41,6 +46,8 @@ pip install "ImagePRO-Python[full]"         # Everything
 pip install "ImagePRO-Python[dev]"          # Test tooling (pytest)
 ```
 
+> **Note**: The base install is lightweight — AI backends (MediaPipe, Ultralytics, InsightFace) are optional and imported lazily, only when you call a function that actually needs them. `import ImagePRO` never loads these dependencies. If a backend is missing, the function you call raises an `ImportError` telling you exactly which extra to install.
+
 ### From Source
 ```bash
 git clone https://github.com/parsasafaie/ImagePRO.git
@@ -103,6 +110,22 @@ object_detection_result = detect_objects(
 )
 print(f"Detected {len(object_detection_result.data)} objects")
 object_detection_result.save_as_img("detections.jpg")
+
+# Chain operations into a reusable pipeline
+from ImagePRO.pipeline import Pipeline, Step
+from ImagePRO.pre_processing.grayscale import convert_to_grayscale
+from ImagePRO.pre_processing.resize import resize_image
+
+pipeline = Pipeline([
+    Step(apply_gaussian_blur, kernel_size=(7, 7)),
+    convert_to_grayscale,
+    Step(resize_image, new_size=(800, 600)),
+])
+
+# Run it on any input: an Image, a NumPy array, or a file path
+pipeline_result = pipeline.run("person_and_objects.jpg")
+pipeline_result.save_as_img("processed_output.jpg")
+print(pipeline_result.meta["steps"])  # Executed step names
 ```
 
 > **Note**: These are basic examples. Each module contains many more functions with extensive customization options. Explore the module-specific README files for detailed documentation.
@@ -116,6 +139,7 @@ Each module includes comprehensive documentation with detailed examples:
   - [Face Analysis](src/ImagePRO/human_analysis/face_analysis/README.md): Face mesh, pose estimation, eye status, comparison
   - [Body Analysis](src/ImagePRO/human_analysis/body_analysis/README.md): Body pose and hand tracking
 - **[Object Analysis](src/ImagePRO/object_analysis/README.md)**: YOLO-based object detection
+- **[Pipeline](src/ImagePRO/pipeline/README.md)**: Reusable chains of image processing operations
 - **[Utils](src/ImagePRO/utils/README.md)**: Shared utilities and I/O handling
 
 For detailed project structure and development guidelines, see [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md).
@@ -127,6 +151,8 @@ ImagePRO is built with a modular architecture designed for extensibility and mai
 - **Clean Separation of Concerns**: Each module handles a specific domain
 - **Consistent API Patterns**: All functions follow the same input/output conventions
 - **Shared Utilities**: Common `Image` and `Result` classes for unified I/O
+- **Reusable Pipelines**: Chain any operations into a `Pipeline` and run it on any input
+- **Lazy Optional Imports**: Heavy AI dependencies (MediaPipe, Ultralytics, InsightFace) are only imported inside the functions that use them, keeping `import ImagePRO` fast and independent of installed extras
 - **Professional Error Handling**: Comprehensive validation with clear error messages
 - **Type Safety**: Full type hints throughout the codebase
 - **Documentation**: Google-style docstrings for all functions

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/__init__.py

@@ -12,10 +12,11 @@ Features:
 - Pre-processing: resize, crop, rotate, blur, sharpen, contrast enhancement
 - Human analysis: face mesh, pose estimation, hand tracking
 - Object detection with YOLO models
+- Reusable pipelines for chaining operations
 - Real-time processing capabilities
 """
 
-__version__ = "1.3.0"
+__version__ = "1.4.0"
 __author__ = "Parsa Safaie"
 __email__ = "parsasafaie.2568@proton.me"
 
@@ -24,10 +25,12 @@ from . import utils
 from . import pre_processing
 from . import human_analysis
 from . import object_analysis
+from . import pipeline
 
 __all__ = [
     "utils",
     "pre_processing",
     "human_analysis",
-    "object_analysis"
+    "object_analysis",
+    "pipeline"
 ]

imagepro_python-1.4.0/src/ImagePRO/human_analysis/body_analysis/__init__.py

@@ -0,0 +1,11 @@
+# Body Analysis Module
+# Provides body pose estimation and hand tracking capabilities
+#
+# The mediapipe dependency is optional and imported lazily inside the
+# functions that need it, so both submodules are safe to import without
+# any AI extras installed.
+
+from . import body_pose_estimation
+from . import hand_tracking
+
+__all__ = ["body_pose_estimation", "hand_tracking"]

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/body_analysis/body_pose_estimation.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -13,10 +14,11 @@ from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
 import cv2
-import mediapipe as mp
+
+if TYPE_CHECKING:  # mediapipe is imported lazily inside the functions
+    import mediapipe as mp
 
 # Constants
-mp_pose = mp.solutions.pose
 TOTAL_LANDMARKS = 33
 DEFAULT_CONFIDENCE = 0.7
 LANDMARK_RADIUS = 3
@@ -69,6 +71,16 @@ def detect_body_pose(
     ):
         raise TypeError("'landmarks_idx' must be a list of integers")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for body pose "
+            'detection. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
+    mp_pose = mp.solutions.pose
+
     # Initialize detector if needed
     if pose_obj is None:
         pose_obj = mp_pose.Pose(
@@ -133,13 +145,21 @@ def detect_body_pose_live() -> None:
     Raises:
         RuntimeError: If camera cannot be accessed
     """
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for body pose "
+            'detection. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Initialize camera
     cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
     if not cap.isOpened():
         raise RuntimeError("Cannot access webcam")
 
     # Initialize pose detector in tracking mode
-    pose_obj = mp_pose.Pose(
+    pose_obj = mp.solutions.pose.Pose(
         min_detection_confidence=DEFAULT_CONFIDENCE,
         static_image_mode=False
     )

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/body_analysis/hand_tracking.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -13,10 +14,11 @@ from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
 import cv2
-import mediapipe as mp
+
+if TYPE_CHECKING:  # mediapipe is imported lazily inside the functions
+    import mediapipe as mp
 
 # Constants
-mp_hands = mp.solutions.hands
 DEFAULT_MAX_HANDS = 2
 DEFAULT_MIN_CONFIDENCE = 0.7
 TOTAL_HAND_LANDMARKS = 21
@@ -79,6 +81,16 @@ def detect_hands(
     ):
         raise TypeError("'landmarks_idx' must be a list of integers")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for hand "
+            'tracking. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
+    mp_hands = mp.solutions.hands
+
     # Initialize detector if needed
     if hands_obj is None:
         hands_obj = mp_hands.Hands(
@@ -168,13 +180,21 @@ def detect_hands_live(
     if not isinstance(min_confidence, (int, float)) or not (0.0 <= min_confidence <= 1.0):
         raise ValueError("'min_confidence' must be between 0.0 and 1.0")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for hand "
+            'tracking. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Initialize camera
     cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
     if not cap.isOpened():
         raise RuntimeError("Cannot access webcam")
 
     # Initialize hand detector in tracking mode
-    hands_obj = mp_hands.Hands(
+    hands_obj = mp.solutions.hands.Hands(
         min_detection_confidence=min_confidence,
         max_num_hands=max_hands,
         static_image_mode=False

imagepro_python-1.4.0/src/ImagePRO/human_analysis/face_analysis/__init__.py

@@ -0,0 +1,20 @@
+# Face Analysis Module
+# Provides facial landmark detection, pose estimation, and eye status analysis
+#
+# The mediapipe and insightface dependencies are optional and imported
+# lazily inside the functions that need them, so every submodule is safe
+# to import regardless of which extras are installed.
+
+from . import eye_status_analysis
+from . import face_comparison
+from . import face_detection
+from . import face_mesh_analysis
+from . import head_pose_estimation
+
+__all__ = [
+    "eye_status_analysis",
+    "face_comparison",
+    "face_detection",
+    "face_mesh_analysis",
+    "head_pose_estimation"
+]

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/face_analysis/eye_status_analysis.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -14,10 +15,11 @@ from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
 import cv2
-import mediapipe as mp
+
+if TYPE_CHECKING:  # mediapipe is imported lazily inside the functions
+    import mediapipe as mp
 
 # Constants
-mp_face_mesh = mp.solutions.face_mesh
 DEFAULT_MIN_CONFIDENCE = 0.7
 DEFAULT_THRESHOLD = 0.2
 RIGHT_EYE_INDICES = [386, 374, 263, 362]  # MediaPipe right eye landmarks
@@ -65,12 +67,20 @@ def analyze_eye_status(
     if not 0 <= min_confidence <= 1:
         raise ValueError("'min_confidence' must be between 0 and 1")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for eye status "
+            'analysis. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Get image dimensions
     h, w = image.shape[:2]
 
     # Initialize detector if needed
     if face_mesh_obj is None:
-        face_mesh_obj = mp_face_mesh.FaceMesh(
+        face_mesh_obj = mp.solutions.face_mesh.FaceMesh(
             min_detection_confidence=min_confidence,
             refine_landmarks=True,
             static_image_mode=True
@@ -173,13 +183,21 @@ def analyze_eye_status_live(
     if not 0 <= min_confidence <= 1:
         raise ValueError("'min_confidence' must be between 0 and 1")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for eye status "
+            'analysis. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Initialize webcam
     cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
     if not cap.isOpened():
         raise RuntimeError("Failed to access webcam")
 
     # Initialize face mesh detector for video
-    face_mesh = mp_face_mesh.FaceMesh(
+    face_mesh = mp.solutions.face_mesh.FaceMesh(
         max_num_faces=1,
         min_detection_confidence=min_confidence,
         refine_landmarks=True,

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/face_analysis/face_comparison.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -13,11 +14,13 @@ import os
 
 import cv2
 import numpy as np
-from insightface.app import FaceAnalysis
 
 from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
+if TYPE_CHECKING:  # insightface is imported lazily inside the function
+    from insightface.app import FaceAnalysis
+
 # Constants
 DEFAULT_SIMILARITY_THRESHOLD = 0.5
 DEFAULT_MODEL_NAME = "buffalo_l"
@@ -62,6 +65,15 @@ def compare_faces(
     if not isinstance(image_2, Image):
         raise TypeError("'image_2' must be an Image instance")
 
+    try:
+        from insightface.app import FaceAnalysis
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'insightface' dependency is required for face "
+            'comparison. Install it with: pip install '
+            '"ImagePRO-Python[insightface]"'
+        ) from err
+
     # Initialize model if needed
     if app is None:
         app = FaceAnalysis(

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/face_analysis/face_detection.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -10,13 +11,15 @@ if str(_src_path) not in sys.path:
     sys.path.insert(0, str(_src_path))
 
 import cv2
-import mediapipe as mp
 import numpy as np
 
 from ImagePRO.human_analysis.face_analysis.face_mesh_analysis import analyze_face_mesh
 from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
+if TYPE_CHECKING:  # mediapipe is imported lazily inside analyze_face_mesh
+    import mediapipe as mp
+
 
 # Constants
 DEFAULT_MAX_FACES = 1

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/face_analysis/face_mesh_analysis.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -13,12 +14,11 @@ from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
 import cv2
-import mediapipe as mp
+
+if TYPE_CHECKING:  # mediapipe is imported lazily inside the functions
+    import mediapipe as mp
 
 # Constants
-mp_face_mesh = mp.solutions.face_mesh
-mp_drawing_utils = mp.solutions.drawing_utils
-mp_drawing_styles = mp.solutions.drawing_styles
 DEFAULT_MAX_FACES = 1
 DEFAULT_MIN_CONFIDENCE = 0.7
 TOTAL_FACE_LANDMARKS = 468
@@ -71,7 +71,6 @@ def analyze_face_mesh(
         - Coordinates are normalized [0,1]. Multiply by width/height for pixels
         - Full mesh (468 points) shows tessellation, specific points show dots
     """
-
     # Validate inputs
     if not isinstance(image, Image):
         raise TypeError("'image' must be an Image instance")
@@ -88,6 +87,18 @@ def analyze_face_mesh(
     ):
         raise TypeError("'landmarks_idx' must be a list of integers")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for face mesh "
+            'analysis. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
+    mp_face_mesh = mp.solutions.face_mesh
+    mp_drawing_utils = mp.solutions.drawing_utils
+    mp_drawing_styles = mp.solutions.drawing_styles
+
     # Initialize detector if needed
     if face_mesh_obj is None:
         face_mesh = mp_face_mesh.FaceMesh(
@@ -195,13 +206,21 @@ def analyze_face_mesh_live(
     if not isinstance(min_confidence, (int, float)) or not (0 <= min_confidence <= 1):
         raise ValueError("'min_confidence' must be between 0 and 1")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for face mesh "
+            'analysis. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Initialize camera
     cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
     if not cap.isOpened():
         raise RuntimeError("Cannot access webcam")
 
     # Initialize detector in tracking mode for better performance
-    face_mesh = mp_face_mesh.FaceMesh(
+    face_mesh = mp.solutions.face_mesh.FaceMesh(
         max_num_faces=max_faces,
         min_detection_confidence=min_confidence,
         refine_landmarks=True,

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/human_analysis/face_analysis/head_pose_estimation.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -14,10 +15,11 @@ from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
 import cv2
-import mediapipe as mp
+
+if TYPE_CHECKING:  # mediapipe is imported lazily inside the functions
+    import mediapipe as mp
 
 # Constants
-mp_face_mesh = mp.solutions.face_mesh
 DEFAULT_MAX_FACES = 1
 DEFAULT_MIN_CONFIDENCE = 0.7
 HEAD_POSE_INDICES = [1, 152, 33, 263, 168]  # nose_tip, chin, left_eye, right_eye, nasion
@@ -169,13 +171,21 @@ def estimate_head_pose_live(
     if not 0 <= min_confidence <= 1:
         raise ValueError("'min_confidence' must be between 0 and 1")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for head pose "
+            'estimation. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Initialize webcam
     cap = cv2.VideoCapture(0, cv2.CAP_DSHOW)
     if not cap.isOpened():
         raise RuntimeError("Failed to access webcam")
 
     # Initialize face mesh detector for video
-    face_mesh = mp_face_mesh.FaceMesh(
+    face_mesh = mp.solutions.face_mesh.FaceMesh(
         max_num_faces=max_faces,
         min_detection_confidence=min_confidence,
         refine_landmarks=True,

imagepro_python-1.4.0/src/ImagePRO/object_analysis/__init__.py

@@ -0,0 +1,9 @@
+# Object Analysis Module
+# Provides object detection capabilities using YOLO models
+#
+# The ultralytics dependency is optional and imported lazily inside the
+# functions that need it, so this package imports cleanly without it.
+
+from . import object_detection
+
+__all__ = ["object_detection"]

{imagepro_python-1.3.0 → imagepro_python-1.4.0}/src/ImagePRO/object_analysis/object_detection.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import sys
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 # Add src directory to path for absolute imports
 _file_path = Path(__file__).resolve()
@@ -9,11 +10,12 @@ _src_path = _file_path.parents[2]  # Go up to src directory
 if str(_src_path) not in sys.path:
     sys.path.insert(0, str(_src_path))
 
-from ultralytics import YOLO
-
 from ImagePRO.utils.image import Image
 from ImagePRO.utils.result import Result
 
+if TYPE_CHECKING:  # ultralytics is imported lazily inside the function
+    from ultralytics import YOLO
+
 # Constants
 DEFAULT_ACCURACY_LEVEL = 1
 MODEL_MAPPING = {
@@ -65,15 +67,24 @@ def detect_objects(
     if not isinstance(image, Image):
         raise TypeError("'image' must be an Image instance")
 
+    # accuracy_level only applies when no model is given
+    if model is None and accuracy_level not in MODEL_MAPPING:
+        raise ValueError(
+            f"'accuracy_level' must be in {list(MODEL_MAPPING.keys())}, "
+            f"got {accuracy_level}"
+        )
+
+    try:
+        from ultralytics import YOLO
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'ultralytics' dependency is required for object "
+            'detection. Install it with: pip install "ImagePRO-Python[yolo]"'
+        ) from err
+
     # Initialize model
     model_name = None
     if model is None:
-        if accuracy_level not in MODEL_MAPPING:
-            raise ValueError(
-                f"'accuracy_level' must be in {list(MODEL_MAPPING.keys())}, "
-                f"got {accuracy_level}"
-            )
-
         model_name = MODEL_MAPPING[accuracy_level]
         model = YOLO(model=model_name)
 

imagepro_python-1.4.0/src/ImagePRO/pipeline/__init__.py

@@ -0,0 +1,9 @@
+# Pipeline Module
+# Provides a reusable, ordered chain of image processing operations
+#
+# Uses only base dependencies (numpy); all operations handed to a Pipeline
+# may come from any module, including those with optional backends.
+
+from .pipeline import Pipeline, Step
+
+__all__ = ["Pipeline", "Step"]