Surface Expr.reduce() in Python (#79)

* Surface Expr.reduce() in Python

Stumbled my way through this, would appreciate guidance on if there is a more idiomatic way to achieve the pyo3 logic.

* Update python/src/lib.rs

Co-authored-by: Kyle Barron <[email protected]>

* Update cql2.pyi

* Add example

---------

Co-authored-by: Kyle Barron <[email protected]>
Co-authored-by: Pete Gadomski <[email protected]>

Author: 3 people

cql2.pyi

@@ -87,6 +87,22 @@ class Expr:
             bool: True if the expression matches the item, False otherwise
         """
 
+    def reduce(self, item: dict[str, Any] | None = None) -> Expr:
+        """Reduces this expression against an item.
+
+        Args:
+            item (dict[str, Any] | None): The item to reduce against
+
+        Returns:
+            Expr: The reduced expression
+
+        Examples:
+            >>> from cql2 import Expr
+            >>> expr = Expr("true AND true").reduce()
+            >>> expr.to_text()
+            'true'
+        """
+
     def to_json(self) -> dict[str, Any]:
         """Converts this cql2 expression to a cql2-json dictionary.
 
@@ -128,7 +144,7 @@ class Expr:
             ['LC82030282019133LGN00']
         """
 
-    def __add__(self, other: "Expr") -> "Expr":
+    def __add__(self, other: Expr) -> Expr:
         """Combines two cql2 expressions using the AND operator.
 
         Args:

python/src/lib.rs

@@ -81,6 +81,16 @@ impl Expr {
         self.0.clone().matches(Some(&value)).map_err(Error::from)
     }
 
+    #[pyo3(signature = (item=None))]
+    fn reduce(&self, item: Option<Bound<'_, PyDict>>) -> Result<Expr> {
+        let value = item.map(|item| pythonize::depythonize(&item)).transpose()?;
+        self.0
+            .clone()
+            .reduce(value.as_ref())
+            .map(Expr)
+            .map_err(Error::from)
+    }
+
     fn to_json<'py>(&self, py: Python<'py>) -> Result<Bound<'py, PyAny>> {
         pythonize::pythonize(py, &self.0).map_err(Error::from)
     }