ImagePRO-Python 1.2.2__py3-none-any.whl → 1.3.1__py3-none-any.whl

{imagepro_python-1.2.2.dist-info → imagepro_python-1.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.2.2
+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
@@ -32,14 +32,19 @@ Provides-Extra: yolo
 Requires-Dist: ultralytics<9.0,>=8.2; extra == "yolo"
 Provides-Extra: mediapipe
 Requires-Dist: mediapipe<=0.10.11,>=0.10.0; extra == "mediapipe"
+Requires-Dist: numpy<2.0,>=1.24; extra == "mediapipe"
 Provides-Extra: insightface
 Requires-Dist: insightface<0.8,>=0.7; extra == "insightface"
 Requires-Dist: onnxruntime<2.0,>=1.16; extra == "insightface"
+Requires-Dist: numpy<2.0,>=1.24; extra == "insightface"
 Provides-Extra: full
 Requires-Dist: mediapipe<=0.10.11,>=0.10.0; extra == "full"
 Requires-Dist: ultralytics<9.0,>=8.2; extra == "full"
 Requires-Dist: insightface<0.8,>=0.7; extra == "full"
 Requires-Dist: onnxruntime<2.0,>=1.16; extra == "full"
+Requires-Dist: numpy<2.0,>=1.24; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest<9.0,>=8.0; extra == "dev"
 Dynamic: license-file
 
 # ImagePRO
@@ -50,11 +55,10 @@ Dynamic: license-file
 
 Whether you're working on computer vision pipelines, preprocessing images for AI models, or simply automating batch image edits — **ImagePRO** gives you powerful tools with minimal effort.
 
-## ✨ Features
+## Features
 
 ### **Image I/O & Management**
 - Flexible input/output handling (file paths or numpy arrays)
-- Batch processing capabilities
 - Multiple format support (JPEG, PNG, CSV, etc.)
 
 ### **Pre-processing & Enhancement**
@@ -71,15 +75,23 @@ Whether you're working on computer vision pipelines, preprocessing images for AI
 ### **Object Detection**
 - **YOLO Integration**: Multiple accuracy levels (nano to extra-large)
 - **Flexible Models**: Pre-trained or custom model support
-- **Batch Processing**: Efficient handling of multiple images
 
-## 🚀 Installation
+## Installation
 
 ### From PyPI
 ```bash
 pip install ImagePRO-Python
+
+# Or with optional extras:
+pip install "ImagePRO-Python[yolo]"         # YOLO object detection
+pip install "ImagePRO-Python[mediapipe]"    # MediaPipe human analysis
+pip install "ImagePRO-Python[insightface]"  # InsightFace face comparison
+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
@@ -109,7 +121,7 @@ pip install -r requirements/full.txt
 
 See the [Directory Structure](/PROJECT_STRUCTURE.md#directory-structure) section in [PROJECT_STRUCTURE.md](/PROJECT_STRUCTURE.md) for details on which modules need which requirements.
 
-## 📖 Quick Start
+## Quick Start
 
 ```python
 from ImagePRO.pre_processing.blur import apply_average_blur
@@ -126,9 +138,9 @@ image = Image.from_path("person_and_objects.jpg")
 blur_result = apply_average_blur(image=image)
 blur_result.save_as_img("blurred_output.jpg")
 
-# Analyze face mesh (468 landmarks)
+# Analyze face mesh (468 landmarks per detected face)
 face_mesh_result = analyze_face_mesh(image=image)
-print(f"Detected {len(face_mesh_result.data)} face landmarks")
+print(f"Detected {len(face_mesh_result.data)} face(s)")
 face_mesh_result.save_as_csv("face_landmarks.csv")
 
 # Detect body pose (33 landmarks)
@@ -138,8 +150,7 @@ print(f"Body pose data: {body_pose_result.data}")
 # Detect objects with YOLO
 object_detection_result = detect_objects(
     image=image,
-    accuracy_level=3,  # 1=nano, 2=small, 3=medium, 4=large, 5=extra-large
-    confidence=0.5
+    accuracy_level=3  # 1=nano, 2=small, 3=medium, 4=large, 5=extra-large
 )
 print(f"Detected {len(object_detection_result.data)} objects")
 object_detection_result.save_as_img("detections.jpg")
@@ -147,7 +158,7 @@ object_detection_result.save_as_img("detections.jpg")
 
 > **Note**: These are basic examples. Each module contains many more functions with extensive customization options. Explore the module-specific README files for detailed documentation.
 
-## 📚 Documentation
+## Documentation
 
 Each module includes comprehensive documentation with detailed examples:
 
@@ -160,24 +171,40 @@ Each module includes comprehensive documentation with detailed examples:
 
 For detailed project structure and development guidelines, see [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md).
 
-## 🏗️ Architecture
+## Architecture
 
 ImagePRO is built with a modular architecture designed for extensibility and maintainability:
 
 - **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
 
 ### Key Design Principles
-- **Immutable Design**: Image objects are immutable, operations return new instances
+- **Non-Destructive Operations**: Operations never write into the input image; they return results in new `Result` objects (note: `crop_image` returns a view into the source array)
 - **Functional Style**: Stateless functions that can be easily composed
 - **Result Objects**: Unified return type containing image, data, and metadata
 - **Keyword Arguments**: All optional parameters use keyword-only syntax
 
-## 🤝 Contributing
+## Testing
+
+The test suite uses pytest:
+
+```bash
+# Install with test tooling (editable install + dev extra)
+pip install -e ".[dev]"
+
+# Run the suite (optional heavy dependencies are mocked; base deps are enough)
+pytest
+
+# Include performance smoke guards
+pytest --run-performance
+```
+
+## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
@@ -185,9 +212,10 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 1. Fork the repository
 2. Create a virtual environment: `python -m venv .venv`
 3. Install dependencies: `pip install -r requirements/full.txt`
-4. Follow the coding standards outlined in [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)
-5. Add tests for new features
-6. Update documentation as needed
+4. Install for development with test tooling: `pip install -e ".[dev]"`
+5. Follow the coding standards outlined in [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)
+6. Add tests for new features and run `pytest`
+7. Update documentation as needed
 
 ### Reporting Issues
 If you encounter any bugs or have feature requests, please open an issue on the GitHub repository with:
@@ -196,5 +224,5 @@ If you encounter any bugs or have feature requests, please open an issue on the
 - Expected vs. actual behavior
 - Environment details (OS, Python version, etc.)
 
-## 📄 License 
+## License
 This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.

imagepro_python-1.3.1.dist-info/RECORD

@@ -0,0 +1,31 @@
+ImagePRO/__init__.py,sha256=pLFmqiQTtz76qzrm8r1jES8RHxXWZlnn9vILHBAKVVY,997
+ImagePRO/human_analysis/__init__.py,sha256=uSU0lM1p1HM6TNGv6u0nPHWy9QY505v43lqTkhClddM,190
+ImagePRO/human_analysis/body_analysis/__init__.py,sha256=uUWG5eOxLQjZoYddmNkRlF66l6vSVyJpUFz1wDddXkk,374
+ImagePRO/human_analysis/body_analysis/body_pose_estimation.py,sha256=yqEV18ZEZwV__Oqt1Hi72EGmbTNes-mrY068SBT9RbU,6245
+ImagePRO/human_analysis/body_analysis/hand_tracking.py,sha256=SpdIZNgvaHzINpWu7rgNawSHvuuawzFtQ7JiHHQ0fqA,7578
+ImagePRO/human_analysis/face_analysis/__init__.py,sha256=297IQuoO2Wb_PyigS_2NOuVnM7FpNPceu5jhJp6YdG0,604
+ImagePRO/human_analysis/face_analysis/eye_status_analysis.py,sha256=Q_EUNPpXoF7Vi-Kd0gURNxs9X3U5J4Yi3coL_6lkeb8,7773
+ImagePRO/human_analysis/face_analysis/face_comparison.py,sha256=lIr490PAf8R6C_Zhv-zBN1Un1EPiwxi4W7ahgkqXAVc,4724
+ImagePRO/human_analysis/face_analysis/face_detection.py,sha256=F3Bq_0rAcQklmNAu-JvxGBIxUnWmyM-SHuZawHXJeac,4009
+ImagePRO/human_analysis/face_analysis/face_mesh_analysis.py,sha256=rv08Mx_IBB-hjTh09bFaaPjaOm0tFbBs0brc4mE66mg,8723
+ImagePRO/human_analysis/face_analysis/head_pose_estimation.py,sha256=2_ZVpwavyIzCIH4x3d2bvCPvv-X5gpmSYxtk5jlgCYw,7688
+ImagePRO/object_analysis/__init__.py,sha256=eVQpYlHO89RYKT0CHjPfJjjif5X_Jx3AtAUpR5m0Yms,292
+ImagePRO/object_analysis/object_detection.py,sha256=1qPd3Xfo2Vi4JnBs5wD8-k3WR6ZkYNdT9tco2Ze1ICQ,3385
+ImagePRO/pre_processing/__init__.py,sha256=pw6-J5sdbkdBG4RlTxOzQKaspGnlPIGo3m_NXH2bVCE,559
+ImagePRO/pre_processing/blur.py,sha256=3zNTNpvLZPdrtRtBziB6X8ys8M7cIvyPDhojTqR63jo,7950
+ImagePRO/pre_processing/contrast.py,sha256=4UT78ggW1rh_iaEI8FObDB4kpEmRRFWjdJES60SnHDM,5064
+ImagePRO/pre_processing/crop.py,sha256=3Nwerzo57kx1sZPr9m355P-qf1NuZSZEA5iUn2Q1704,2406
+ImagePRO/pre_processing/dataset_generator.py,sha256=i7UM4o8hznFUfUgbYI6H01EkQJOqt4IsI9IrjzzN8gQ,7921
+ImagePRO/pre_processing/grayscale.py,sha256=MRCsFRIaL45sYVHzhuNyZBXsP7PF-yorn0Wt7xONvpY,1781
+ImagePRO/pre_processing/histogram.py,sha256=sNTWWZXr5VLpOrF_PTTJ6TD8yv1zR1l9cMyXHe7JFIM,2596
+ImagePRO/pre_processing/resize.py,sha256=Rnde8l_PXck5OWQBEMOHgLeW2YkTz9Xfr6fGmz0sdm8,1760
+ImagePRO/pre_processing/rotate.py,sha256=wQj3nQpN-ilM0HHwovN--UdGEJkPCY0BJ0zAdyBxv-o,4174
+ImagePRO/pre_processing/sharpen.py,sha256=hOkY7QhzgMp9LXQwt56AP4enn24ntXlmFLe57Bxssvw,3682
+ImagePRO/utils/__init__.py,sha256=McVd-o9KtKOpAVYbLi19KxsatPPFFF-Qbt0gdgY3Ln8,170
+ImagePRO/utils/image.py,sha256=Y64mD97rTiJb8_uNYlyG227VZodeb4U1aGezMkj7MnM,4025
+ImagePRO/utils/result.py,sha256=ToQaOmUlTtobJkC65BG0YO_6BkBleMBn-0Qydko7cZc,6138
+imagepro_python-1.3.1.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
+imagepro_python-1.3.1.dist-info/METADATA,sha256=-eudLbiwZ6DNW8smB4CwEXdeh-i7EtCvRQH_KS8dLqY,9999
+imagepro_python-1.3.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+imagepro_python-1.3.1.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
+imagepro_python-1.3.1.dist-info/RECORD,,

{imagepro_python-1.2.2.dist-info → imagepro_python-1.3.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

imagepro_python-1.2.2.dist-info/RECORD

@@ -1,31 +0,0 @@
-ImagePRO/__init__.py,sha256=LUqZaUWVUISpR6bm5K2cO6KjiVP3ZDPADZGZW051xGk,998
-ImagePRO/human_analysis/__init__.py,sha256=uSU0lM1p1HM6TNGv6u0nPHWy9QY505v43lqTkhClddM,190
-ImagePRO/human_analysis/body_analysis/__init__.py,sha256=czQoJJIrDAWz0UUY0h0mwxymSQ6L6CaZYYHhYFHyf4U,203
-ImagePRO/human_analysis/body_analysis/body_pose_estimation.py,sha256=69ybYkrbFl9EkuAc4ejCu2TW4m9TFLTn2Ae5fm_92lE,5549
-ImagePRO/human_analysis/body_analysis/hand_tracking.py,sha256=T7yM_VZN6mBZsDFJV6C-amCVzgklatvsZrtgcBrzVSg,6869
-ImagePRO/human_analysis/face_analysis/__init__.py,sha256=dKVZ6pq-0aQHL9vhMSt0BHs3WV_cTW65QPLJGnSiUgM,405
-ImagePRO/human_analysis/face_analysis/eye_status_analysis.py,sha256=9ydxEj4EhVCNf954gdFBQemS1uRNA-XGCMzyliI2AsQ,7126
-ImagePRO/human_analysis/face_analysis/face_comparison.py,sha256=RU-eSjFwpRIrV-QX8po8Mr-RhGwYEsCo3_Nt-IiA5Us,4315
-ImagePRO/human_analysis/face_analysis/face_detection.py,sha256=__s-lI6Egf-JgruncL_MfAkmwCq8Oe3F5Vvk9x9S_2Q,3897
-ImagePRO/human_analysis/face_analysis/face_mesh_analysis.py,sha256=8kLyEEnhMfdEALteltSHu2L2zbiFSNfzC73EuV0I5iQ,7964
-ImagePRO/human_analysis/face_analysis/head_pose_estimation.py,sha256=IidB4U0lQryw9T4J4_T-QmC-DgANUEgueto06RkKi2Q,7336
-ImagePRO/object_analysis/__init__.py,sha256=pj1vjY8uVUqeVONpaCacWufUzHF7rS5-nmy_C5IfI2w,148
-ImagePRO/object_analysis/object_detection.py,sha256=ZhxOpX5Zkiu-gq-2CRYPNzSo7ai1PRFZ3qopQeODIkQ,2890
-ImagePRO/pre_processing/__init__.py,sha256=nXUhE8RnDyW7T93fKsSDPfqzGHIW50OvgQvznY5UH0E,417
-ImagePRO/pre_processing/blur.py,sha256=zPWUKLEoKiL6kYwnZOtGRWBHM-dgEQ8WWdDt8_wGc0s,7961
-ImagePRO/pre_processing/contrast.py,sha256=XG69VsX3EKWIPDcQYm4D9qT7sA_BSP-sppSAa8qRUhA,5247
-ImagePRO/pre_processing/crop.py,sha256=p0esuZcn4-YsqcniDUmsVfPoWasxVH1OqzNBra8Pw4M,2442
-ImagePRO/pre_processing/dataset_generator.py,sha256=ekd_TnyflWKjJ6sYCiWc3vN2Q14cKiwZ1InOCslxoFM,7653
-ImagePRO/pre_processing/grayscale.py,sha256=MRCsFRIaL45sYVHzhuNyZBXsP7PF-yorn0Wt7xONvpY,1781
-ImagePRO/pre_processing/histogram.py,sha256=t1ykGUwB9ZbvO6J3bGPh4fDvrk4AJua1dN2BWzHIRIQ,2888
-ImagePRO/pre_processing/resize.py,sha256=GH3ObPe67ypPQG3a7ncrNR5WNDqGibXebAiuRXr6L10,1760
-ImagePRO/pre_processing/rotate.py,sha256=wqV2Qm7mIyvKTSFdwzr1tNAGnMG7rl5M3BRqC5m2oZE,4185
-ImagePRO/pre_processing/sharpen.py,sha256=C5AOxQNBL80JenkztlyRBV7yuCHqxG5dTGbRhtVRT9M,3544
-ImagePRO/utils/__init__.py,sha256=McVd-o9KtKOpAVYbLi19KxsatPPFFF-Qbt0gdgY3Ln8,170
-ImagePRO/utils/image.py,sha256=x93cBNycNOgET20a__TxZ9ZQo_2G84uB7QjXjBo9f8M,3973
-ImagePRO/utils/result.py,sha256=rGZX0FJ-dpA4v_m_GUO6ni0kCfcNJRnOjztbyRX9d88,6065
-imagepro_python-1.2.2.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
-imagepro_python-1.2.2.dist-info/METADATA,sha256=52iKwYAOFwjFavR0bvGF4ESCX-1NPdQb_kSRtv5TLuY,8513
-imagepro_python-1.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-imagepro_python-1.2.2.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
-imagepro_python-1.2.2.dist-info/RECORD,,