mongo-pipebuilder 0.4.0__tar.gz → 0.5.0__tar.gz

{mongo_pipebuilder-0.4.0/src/mongo_pipebuilder.egg-info → mongo_pipebuilder-0.5.0}/PKG-INFO

@@ -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.4.0 → mongo_pipebuilder-0.5.0}/README.md

@@ -1,7 +1,7 @@
 # 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)
@@ -255,6 +255,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.4.0 → mongo_pipebuilder-0.5.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mongo-pipebuilder"
-version = "0.4.0"
+version = "0.5.0"
 description = "Type-safe, fluent MongoDB aggregation pipeline builder"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = [
     "typing_extensions>=4.0.0; python_version<'3.11'",
 ]
@@ -20,7 +20,6 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -84,7 +83,7 @@ skip_empty = true
 directory = "tests/htmlcov"
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = false

{mongo_pipebuilder-0.4.0 → mongo_pipebuilder-0.5.0}/src/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-0.4.0 → mongo_pipebuilder-0.5.0}/src/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 → mongo_pipebuilder-0.5.0/src/mongo_pipebuilder.egg-info}/PKG-INFO

@@ -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.4.0 → mongo_pipebuilder-0.5.0}/src/mongo_pipebuilder.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ src/mongo_pipebuilder.egg-info/dependency_links.txt
 src/mongo_pipebuilder.egg-info/requires.txt
 src/mongo_pipebuilder.egg-info/top_level.txt
 tests/test_builder.py
+tests/test_builder_add_stages.py
 tests/test_builder_debug.py
 tests/test_builder_insert.py
 tests/test_builder_lookup_let.py

mongo_pipebuilder-0.5.0/tests/test_builder_add_stages.py

@@ -0,0 +1,95 @@
+"""
+Tests for PipelineBuilder.add_stages (add multiple stages at once).
+
+Author: seligoroff
+"""
+import pytest
+
+from mongo_pipebuilder import PipelineBuilder
+
+
+class TestAddStages:
+    """Tests for add_stages method."""
+
+    def test_add_stages_empty_list_adds_nothing(self):
+        """add_stages([]) adds no stages."""
+        builder = PipelineBuilder()
+        builder.match({"x": 1}).add_stages([])
+        pipeline = builder.build()
+        assert len(pipeline) == 1
+        assert pipeline[0] == {"$match": {"x": 1}}
+
+    def test_add_stages_one_stage(self):
+        """add_stages([stage]) adds one stage."""
+        builder = PipelineBuilder()
+        builder.add_stages([{"$match": {"x": 1}}])
+        pipeline = builder.build()
+        assert len(pipeline) == 1
+        assert pipeline[0] == {"$match": {"x": 1}}
+
+    def test_add_stages_two_stages(self):
+        """add_stages([s1, s2]) adds two stages in order."""
+        builder = PipelineBuilder()
+        builder.add_stages([{"$match": {"a": 1}}, {"$limit": 10}])
+        pipeline = builder.build()
+        assert len(pipeline) == 2
+        assert pipeline[0] == {"$match": {"a": 1}}
+        assert pipeline[1] == {"$limit": 10}
+
+    def test_add_stages_skips_empty_dict_stages(self):
+        """add_stages([{}, stage, ...]) skips empty dicts, adds only non-empty stages."""
+        builder = PipelineBuilder()
+        builder.add_stages([{}, {"$match": {"x": 1}}])
+        pipeline = builder.build()
+        assert len(pipeline) == 1
+        assert pipeline[0] == {"$match": {"x": 1}}
+
+    def test_add_stages_from_other_builder_build(self):
+        """add_stages(other_builder.build()) appends subpipeline; order and content preserved."""
+        sub = PipelineBuilder().match({"source": "api"}).project({"name": 1, "_id": 0})
+        builder = PipelineBuilder()
+        builder.match({"status": "active"}).add_stages(sub.build())
+        pipeline = builder.build()
+        assert len(pipeline) == 3
+        assert pipeline[0] == {"$match": {"status": "active"}}
+        assert pipeline[1] == {"$match": {"source": "api"}}
+        assert pipeline[2] == {"$project": {"name": 1, "_id": 0}}
+        assert len(sub) == 2
+
+    def test_add_stages_none_raises(self):
+        """add_stages(None) raises TypeError."""
+        builder = PipelineBuilder()
+        with pytest.raises(TypeError, match="stages must not be None"):
+            builder.add_stages(None)
+
+    def test_add_stages_non_dict_element_raises(self):
+        """add_stages(iterable with non-dict element) raises TypeError."""
+        builder = PipelineBuilder()
+        with pytest.raises(TypeError, match="All stages must be dictionaries"):
+            builder.add_stages([{"$match": {}}, "not a stage"])
+
+    def test_add_stages_chaining(self):
+        """add_stages returns self; can chain with match, limit, etc."""
+        builder = PipelineBuilder()
+        pipeline = (
+            builder.add_stages([{"$match": {"source": "api"}}])
+            .match({"status": "active"})
+            .limit(10)
+            .build()
+        )
+        assert len(pipeline) == 3
+        assert pipeline[0] == {"$match": {"source": "api"}}
+        assert pipeline[1] == {"$match": {"status": "active"}}
+        assert pipeline[2] == {"$limit": 10}
+
+    def test_add_stages_copy_independent(self):
+        """copy() after add_stages yields independent builder; modifying copy does not change original."""
+        builder = PipelineBuilder()
+        builder.add_stages([{"$match": {"x": 1}}])
+        c = builder.copy()
+        c.limit(5)
+        assert len(builder) == 1
+        assert len(c) == 2
+        assert builder.build()[0] == {"$match": {"x": 1}}
+        assert c.build()[0] == {"$match": {"x": 1}}
+        assert c.build()[1] == {"$limit": 5}