added beta labels to search/dml

Author: daniel-sanche

packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py

@@ -402,6 +402,9 @@ def search(
         """
         Adds a search stage to the pipeline.
 
+        .. note::
+            This feature is currently in beta and is subject to change.
+
         This stage filters documents based on the provided query expression.
 
         Example:
@@ -712,6 +715,9 @@ def delete(self) -> "_BasePipeline":
         """
         Deletes the documents from the current pipeline stage.
 
+        .. note::
+            This feature is currently in beta and is subject to change.
+
         Example:
             >>> from google.cloud.firestore_v1.pipeline_expressions import Field
             >>> pipeline = client.pipeline().collection("logs")
@@ -728,6 +734,9 @@ def update(self, *transformed_fields: "Selectable") -> "_BasePipeline":
         """
         Performs an update operation using documents from previous stages.
 
+        .. note::
+            This feature is currently in beta and is subject to change.
+
         If called without `transformed_fields`, this method updates the documents in
         place based on the data flowing through the pipeline.
 

packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py

@@ -629,6 +629,8 @@ def geo_distance(
         """Evaluates to the distance in meters between the location in the specified
         field and the query location.
 
+        .. note::
+            This feature is currently in beta and is subject to change.
         Note: This Expression can only be used within a `Search` stage.
 
         Example:
@@ -2840,6 +2842,9 @@ class Score(FunctionExpression):
     in the search query. If `SearchOptions.query` is not set or does not contain
     any text predicates, then this topicality score will always be `0`.
 
+    .. note::
+        This feature is currently in beta and is subject to change.
+
     Note: This Expression can only be used within a `Search` stage.
 
     Example:
@@ -2861,6 +2866,9 @@ def __init__(self):
 class DocumentMatches(BooleanExpression):
     """Creates a boolean expression for a document match query.
 
+    .. note::
+        This feature is currently in beta and is subject to change.
+
     Note: This Expression can only be used within a `Search` stage.
 
     Example:

packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_stages.py

@@ -343,7 +343,11 @@ def _pb_args(self):
 
 
 class Search(Stage):
-    """Search stage."""
+    """Search stage.
+
+    .. note::
+        This feature is currently in beta and is subject to change.
+    """
 
     def __init__(self, query_or_options: str | BooleanExpression | SearchOptions):
         super().__init__("search")
@@ -434,7 +438,11 @@ def _pb_args(self):
 
 
 class Delete(Stage):
-    """Deletes documents matching the pipeline criteria."""
+    """Deletes documents matching the pipeline criteria.
+
+    .. note::
+        This feature is currently in beta and is subject to change.
+    """
 
     def __init__(self):
         super().__init__("delete")
@@ -444,7 +452,11 @@ def _pb_args(self) -> list[Value]:
 
 
 class Update(Stage):
-    """Updates documents with transformed fields."""
+    """Updates documents with transformed fields.
+
+    .. note::
+        This feature is currently in beta and is subject to change.
+    """
 
     def __init__(self, *transformed_fields: Selectable):
         super().__init__("update")

packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_types.py

@@ -228,7 +228,11 @@ def percentage(value: float):
 
 
 class SearchOptions:
-    """Options for configuring the `Search` pipeline stage."""
+    """Options for configuring the `Search` pipeline stage.
+
+    .. note::
+        This feature is currently in beta and is subject to change.
+    """
 
     def __init__(
         self,