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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.4.0
+Version: 1.6.0
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -81,6 +81,12 @@ Whether you're working on computer vision pipelines, preprocessing images for AI
 - **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
 
+### **Batch Processing**
+- **Many Images at Once**: Run any function, `Step`, or `Pipeline` over a folder, a glob pattern, or a list of images
+- **Ordered Results**: One result per input, in input order, with per-input failure reporting
+- **Optional Output Saving**: Mirror results into an output directory with collision-safe names
+- **Progress Reporting**: Optional progress callback; optional worker threads
+
 ## Installation
 
 ### From PyPI
@@ -175,6 +181,12 @@ pipeline = Pipeline([
 pipeline_result = pipeline.run("person_and_objects.jpg")
 pipeline_result.save_as_img("processed_output.jpg")
 print(pipeline_result.meta["steps"])  # Executed step names
+
+# Or run the same pipeline over a whole folder at once
+from ImagePRO.batch import batch_process
+
+batch = batch_process("photos/", pipeline, output_dir="processed/")
+print(batch.meta["succeeded"], "images processed")
 ```
 
 > **Note**: These are basic examples. Each module contains many more functions with extensive customization options. Explore the module-specific README files for detailed documentation.
@@ -189,6 +201,7 @@ Each module includes comprehensive documentation with detailed examples:
   - [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
+- **[Batch Processing](src/ImagePRO/batch/README.md)**: Run any operation over many images at once
 - **[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).
@@ -201,13 +214,14 @@ ImagePRO is built with a modular architecture designed for extensibility and mai
 - **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
+- **Batch Processing**: Run any operation or pipeline over many images at once, with ordered per-input results
 - **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
-- **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)
+- **Non-Destructive Operations**: Operations never write into the input image; they return results in new `Result` objects
 - **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

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

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "ImagePRO-Python"
-version = "1.4.0"
+version = "1.6.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.4.0 → imagepro_python-1.6.0}/readme.md

@@ -32,6 +32,12 @@ Whether you're working on computer vision pipelines, preprocessing images for AI
 - **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
 
+### **Batch Processing**
+- **Many Images at Once**: Run any function, `Step`, or `Pipeline` over a folder, a glob pattern, or a list of images
+- **Ordered Results**: One result per input, in input order, with per-input failure reporting
+- **Optional Output Saving**: Mirror results into an output directory with collision-safe names
+- **Progress Reporting**: Optional progress callback; optional worker threads
+
 ## Installation
 
 ### From PyPI
@@ -126,6 +132,12 @@ pipeline = Pipeline([
 pipeline_result = pipeline.run("person_and_objects.jpg")
 pipeline_result.save_as_img("processed_output.jpg")
 print(pipeline_result.meta["steps"])  # Executed step names
+
+# Or run the same pipeline over a whole folder at once
+from ImagePRO.batch import batch_process
+
+batch = batch_process("photos/", pipeline, output_dir="processed/")
+print(batch.meta["succeeded"], "images processed")
 ```
 
 > **Note**: These are basic examples. Each module contains many more functions with extensive customization options. Explore the module-specific README files for detailed documentation.
@@ -140,6 +152,7 @@ Each module includes comprehensive documentation with detailed examples:
   - [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
+- **[Batch Processing](src/ImagePRO/batch/README.md)**: Run any operation over many images at once
 - **[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).
@@ -152,13 +165,14 @@ ImagePRO is built with a modular architecture designed for extensibility and mai
 - **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
+- **Batch Processing**: Run any operation or pipeline over many images at once, with ordered per-input results
 - **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
-- **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)
+- **Non-Destructive Operations**: Operations never write into the input image; they return results in new `Result` objects
 - **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

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

@@ -13,10 +13,11 @@ Features:
 - Human analysis: face mesh, pose estimation, hand tracking
 - Object detection with YOLO models
 - Reusable pipelines for chaining operations
+- Batch processing: run any operation over many images at once
 - Real-time processing capabilities
 """
 
-__version__ = "1.4.0"
+__version__ = "1.6.0"
 __author__ = "Parsa Safaie"
 __email__ = "parsasafaie.2568@proton.me"
 
@@ -26,11 +27,13 @@ from . import pre_processing
 from . import human_analysis
 from . import object_analysis
 from . import pipeline
+from . import batch
 
 __all__ = [
     "utils",
     "pre_processing",
     "human_analysis",
     "object_analysis",
-    "pipeline"
+    "pipeline",
+    "batch"
 ]

imagepro_python-1.6.0/src/ImagePRO/batch/__init__.py

@@ -0,0 +1,14 @@
+# Batch Module
+# Runs a single operation over many inputs at once
+#
+# Uses only base dependencies (numpy); the operation handed to
+# batch_process may come from any module, including those with optional
+# backends (mediapipe, ultralytics, insightface).
+
+from .batch import BatchFailure, BatchResult, batch_process
+
+__all__ = [
+    "BatchFailure",
+    "BatchResult",
+    "batch_process"
+]