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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.3.0
+Version: 1.3.1
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -90,6 +90,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
@@ -176,6 +178,7 @@ 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
+- **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.3.1}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "ImagePRO-Python"
-version = "1.3.0"
+version = "1.3.1"
 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.3.1}/readme.md

@@ -41,6 +41,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
@@ -127,6 +129,7 @@ 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
+- **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.3.1}/src/ImagePRO/__init__.py

@@ -15,7 +15,7 @@ Features:
 - Real-time processing capabilities
 """
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 __author__ = "Parsa Safaie"
 __email__ = "parsasafaie.2568@proton.me"
 

imagepro_python-1.3.1/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.3.1}/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.3.1}/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.3.1/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.3.1}/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.3.1}/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.3.1}/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.3.1}/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.3.1}/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.3.1/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.3.1}/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.3.0 → imagepro_python-1.3.1}/src/ImagePRO/pre_processing/__init__.py

@@ -1,19 +1,18 @@
 # Pre-processing Module
 # Provides image manipulation, filtering, and enhancement capabilities
+#
+# dataset_generator uses the optional mediapipe dependency, imported
+# lazily inside its functions, so it is safe to import here regardless.
 
 from . import blur
 from . import contrast
 from . import crop
+from . import dataset_generator
 from . import grayscale
 from . import resize
 from . import rotate
 from . import sharpen
 
-try:  # dataset_generator needs the optional mediapipe dependency
-    from . import dataset_generator
-except ImportError:
-    dataset_generator = None
-
 __all__ = [
     "blur",
     "contrast",

{imagepro_python-1.3.0 → imagepro_python-1.3.1}/src/ImagePRO/pre_processing/dataset_generator.py

@@ -12,7 +12,6 @@ if str(_src_path) not in sys.path:
     sys.path.insert(0, str(_src_path))
 
 import cv2
-import mediapipe as mp
 
 from ImagePRO.human_analysis.face_analysis.face_detection import detect_faces
 from ImagePRO.pre_processing import blur, grayscale, resize, rotate, sharpen
@@ -95,6 +94,14 @@ def capture_bulk_pictures(
     if not isinstance(delay, (int, float)) or delay < 0:
         raise ValueError("'delay' must be a non-negative number")
 
+    try:
+        import mediapipe as mp
+    except ImportError as err:
+        raise ImportError(
+            "The optional 'mediapipe' dependency is required for dataset "
+            'generation. Install it with: pip install "ImagePRO-Python[mediapipe]"'
+        ) from err
+
     # Setup output directory structure
     base_dir = Path(folder_path)
     face_folder = base_dir / str(face_id)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.3.0
+Version: 1.3.1
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -90,6 +90,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
@@ -176,6 +178,7 @@ 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
+- **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.3.1}/tests/test_face_mesh_analysis.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
+import mediapipe as mp  # real package or the conftest stub
+
 import numpy as np
 import pytest
 
-from ImagePRO.human_analysis.face_analysis import face_mesh_analysis
 from ImagePRO.human_analysis.face_analysis.face_mesh_analysis import analyze_face_mesh
 
 from fakes import FakeFaceMesh, make_landmarks
@@ -23,7 +24,7 @@ def patch_facemesh(monkeypatch):
             instance_holder["instance"] = mesh
             return mesh
 
-        monkeypatch.setattr(face_mesh_analysis.mp_face_mesh, "FaceMesh", factory)
+        monkeypatch.setattr(mp.solutions.face_mesh, "FaceMesh", factory)
         return instance_holder
 
     return _patch
@@ -120,7 +121,7 @@ class TestAnalyzeFaceMeshWithDetection:
         patch_facemesh(result=SimpleNamespace(multi_face_landmarks=faces))
         calls = []
         monkeypatch.setattr(
-            face_mesh_analysis.mp_drawing_utils,
+            mp.solutions.drawing_utils,
             "draw_landmarks",
             lambda *args, **kwargs: calls.append(args),
         )
@@ -156,7 +157,7 @@ class TestAnalyzeFaceMeshConfiguration:
         )
         created = []
         monkeypatch.setattr(
-            face_mesh_analysis.mp_face_mesh,
+            mp.solutions.face_mesh,
             "FaceMesh",
             lambda **kwargs: created.append(kwargs),
         )

{imagepro_python-1.3.0 → imagepro_python-1.3.1}/tests/test_object_detection.py

@@ -84,9 +84,7 @@ class TestDetectObjectsModelSelection:
             def __call__(self, image):
                 return [self._result]
 
-        monkeypatch.setattr(
-            "ImagePRO.object_analysis.object_detection.YOLO", RecordingYOLO
-        )
+        monkeypatch.setattr("ultralytics.YOLO", RecordingYOLO)
         result = detect_objects(image=sample_bgr_image, accuracy_level=level)
         assert created["model"] == expected_model
         assert result.meta["model"] == expected_model

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

@@ -1,17 +0,0 @@
-# Body Analysis Module
-# Provides body pose estimation and hand tracking capabilities
-#
-# Both modules need the optional mediapipe dependency; they are imported
-# guardedly so the package stays importable without it.
-
-try:  # requires mediapipe
-    from . import body_pose_estimation
-except ImportError:
-    body_pose_estimation = None
-
-try:  # requires mediapipe
-    from . import hand_tracking
-except ImportError:
-    hand_tracking = None
-
-__all__ = ["body_pose_estimation", "hand_tracking"]

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

@@ -1,39 +0,0 @@
-# Face Analysis Module
-# Provides facial landmark detection, pose estimation, and eye status analysis
-#
-# The mediapipe-based modules and the insightface-based module are imported
-# guardedly so that importing the package works with only the dependencies
-# a caller actually needs; unavailable modules are set to None.
-
-try:  # requires mediapipe
-    from . import eye_status_analysis
-except ImportError:
-    eye_status_analysis = None
-
-try:  # requires insightface
-    from . import face_comparison
-except ImportError:
-    face_comparison = None
-
-try:  # requires mediapipe
-    from . import face_detection
-except ImportError:
-    face_detection = None
-
-try:  # requires mediapipe
-    from . import face_mesh_analysis
-except ImportError:
-    face_mesh_analysis = None
-
-try:  # requires mediapipe
-    from . import head_pose_estimation
-except ImportError:
-    head_pose_estimation = None
-
-__all__ = [
-    "eye_status_analysis",
-    "face_comparison",
-    "face_detection",
-    "face_mesh_analysis",
-    "head_pose_estimation"
-]

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

@@ -1,9 +0,0 @@
-# Object Analysis Module
-# Provides object detection capabilities using YOLO models
-
-try:  # object_detection needs the optional ultralytics dependency
-    from . import object_detection
-except ImportError:
-    object_detection = None
-
-__all__ = ["object_detection"]