mongo-pipebuilder 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

mongo_pipebuilder/__init__.py

@@ -9,6 +9,6 @@ Author: seligoroff
 
 from mongo_pipebuilder.builder import PipelineBuilder
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 __all__ = ["PipelineBuilder"]
 

mongo_pipebuilder/builder.py

@@ -10,9 +10,9 @@ import copy
 import difflib
 import json
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Dict, Iterable, List, Optional, Union
 
-# For compatibility with Python < 3.11 and mypy with python_version 3.8
+# For compatibility with Python < 3.11 (Self is in typing from 3.11)
 from typing_extensions import Self
 
 
@@ -686,6 +686,35 @@ class PipelineBuilder:
             self._stages.append(stage)
         return self
 
+    def add_stages(self, stages: Iterable[Dict[str, Any]]) -> Self:
+        """
+        Add multiple pipeline stages at once (e.g. a subpipeline from another builder).
+
+        Empty dict stages are skipped, as with add_stage. Each element must be a
+        dictionary.
+
+        Args:
+            stages: Iterable of stage dictionaries (e.g. list, or result of .build()).
+
+        Returns:
+            Self for method chaining.
+
+        Raises:
+            TypeError: If stages is None or any element is not a dictionary.
+
+        Example:
+            >>> builder.add_stages([{"$match": {"x": 1}}, {"$limit": 10}])
+            >>> builder.add_stages(other_builder.build())
+        """
+        if stages is None:
+            raise TypeError("stages must not be None")
+        for stage in stages:
+            if not isinstance(stage, dict):
+                raise TypeError("All stages must be dictionaries")
+            if stage:
+                self._stages.append(stage)
+        return self
+
     def __len__(self) -> int:
         """
         Return the number of stages in the pipeline.

{mongo_pipebuilder-0.4.0.dist-info → mongo_pipebuilder-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mongo-pipebuilder
-Version: 0.4.0
+Version: 0.5.0
 Summary: Type-safe, fluent MongoDB aggregation pipeline builder
 Author-email: seligoroff <seligoroff@gmail.com>
 License-Expression: MIT
@@ -12,14 +12,13 @@ Keywords: mongodb,aggregation,pipeline,builder,query
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Database
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing_extensions>=4.0.0; python_version < "3.11"
@@ -28,7 +27,7 @@ Dynamic: license-file
 # mongo-pipebuilder
 
 [![PyPI version](https://badge.fury.io/py/mongo-pipebuilder.svg)](https://badge.fury.io/py/mongo-pipebuilder)
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Test Coverage](https://img.shields.io/badge/coverage-96%25-green.svg)](https://github.com/seligoroff/mongo-pipebuilder)
@@ -282,6 +281,19 @@ Adds a custom stage for advanced use cases.
 }})
 ```
 
+##### `add_stages(stages: Iterable[Dict[str, Any]]) -> Self`
+
+Adds multiple stages at once (e.g. a subpipeline from another builder). Empty dicts are skipped. Useful to avoid loops when inserting a ready-made list of stages.
+
+```python
+# From a list
+.add_stages([{"$match": {"level": "error"}}, {"$limit": 100}])
+
+# From another builder
+sub = PipelineBuilder().match({"source": "api"}).project({"name": 1})
+.add_stages(sub.build())
+```
+
 ##### `prepend(stage: Dict[str, Any]) -> Self`
 
 Adds a stage at the beginning of the pipeline.

mongo_pipebuilder-0.5.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+mongo_pipebuilder/__init__.py,sha256=cn4_tymz00r4iA4ES-qe6lP3k9K6TvuUsagf6_Ajaxc,336
+mongo_pipebuilder/builder.py,sha256=r_umLKj79j7dmBDKoauo5GC2h7ZFRrc1uYd3_aKcwO0,39834
+mongo_pipebuilder-0.5.0.dist-info/licenses/LICENSE,sha256=-ZkZpDLHDQAc-YBIojJ6eDsMwxwx5pRuQz3RHnl9Y8w,1104
+mongo_pipebuilder-0.5.0.dist-info/METADATA,sha256=aUjgx7ENKyXI3eNyv2gt3YmgL2HeRDpUCav-ucJGBFg,20389
+mongo_pipebuilder-0.5.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mongo_pipebuilder-0.5.0.dist-info/top_level.txt,sha256=wLn7H_v-qaNIws5FeBbKPZBCmYFYgFEhPaLjoCWcisc,18
+mongo_pipebuilder-0.5.0.dist-info/RECORD,,

mongo_pipebuilder-0.4.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-mongo_pipebuilder/__init__.py,sha256=3iWmQvRAT2QZHXURN9AHoMPn-7FjwH9ig8QyTUCVLh4,336
-mongo_pipebuilder/builder.py,sha256=_c-5uuNwWJigKzzIcOXXkPY9oD_UOC0lomhx03yJz9U,38834
-mongo_pipebuilder-0.4.0.dist-info/licenses/LICENSE,sha256=-ZkZpDLHDQAc-YBIojJ6eDsMwxwx5pRuQz3RHnl9Y8w,1104
-mongo_pipebuilder-0.4.0.dist-info/METADATA,sha256=IAtv0lDGEIiQ-OlFLn1LR6fDFtgC1xj_PSH3Ak31lE4,20002
-mongo_pipebuilder-0.4.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mongo_pipebuilder-0.4.0.dist-info/top_level.txt,sha256=wLn7H_v-qaNIws5FeBbKPZBCmYFYgFEhPaLjoCWcisc,18
-mongo_pipebuilder-0.4.0.dist-info/RECORD,,