o }l~iz  @sdZddlmZddlmZmZmZmZddlm Z ddlm Z ddl m Z ddl Z ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZedeeeee j eeed ZGdddZGddde Z Gddde eeZ!Gddde Z"Gddde"Z#Gddde Z$ede dZ%Gddde$ee%Z&Gdd d e$Z'Gd!d"d"e"Z(Gd#d$d$e"Z)Gd%d&d&e"Z*Gd'd(d(e(Z+Gd)d*d*e(Z,Gd+d,d,e(Z-Gd-d.d.e(Z.Gd/d0d0e(Z/Gd1d2d2e#Z0Gd3d4d4e"Z1dS)5z .. warning:: **Preview API**: Firestore Pipelines is currently in preview and is subject to potential breaking changes in future releases. ) annotations)AnyGenericTypeVarSequence)ABC)abstractmethod)EnumNValue)StructuredQuery)Vector)GeoPoint) encode_value) decode_value CONSTANT_TYPEc@sBeZdZdZGdddeZejfdddZdd Zdd d Z dS)Orderingz;Represents the direction for sorting results in a pipeline.c@seZdZdZdZdS)zOrdering.Direction ascending descendingN)__name__ __module__ __qualname__ ASCENDING DESCENDINGrru/var/www/newdalilibackend/backend/venv/lib/python3.10/site-packages/google/cloud/firestore_v1/pipeline_expressions.py Direction7sr order_dirDirection | strcCsBt|tr|nt||_t|trtj||_ dS||_ dS)aF Initializes an Ordering instance Args: expr (Expression | str): The expression or field path string to sort by. If a string is provided, it's treated as a field path. order_dir (Direction | str): The direction to sort in. Defaults to ascending N) isinstance ExpressionFieldofexprstrrrupperr)selfr#rrrr__init__;s  zOrdering.__init__cCs&|jtjjur d}nd}|j|S)Nz .ascending()z .descending())rrrrr#)r& order_strrrr__repr__LszOrdering.__repr__returnr cCs$tdt|jjd|jdidS)Nfields) string_value) direction expression map_value)r rvaluer#_to_pbr&rrrr2Ss zOrdering._to_pbN)rrr*r ) rrr__doc__r rrr'r)r2rrrrr4s rc@seZdZdZddZedddZe ddd d ZGdddZ e dddZ e dddZ e dddZ e dddZ e dddZe dddZe dddZe dd d!Ze dd"d#Ze dd$d%Ze dd'd(Ze dd)d*Ze dd,d-Ze dd.d/Ze dd0d1Ze dd4d5Ze dd6d7Ze dd9d:Ze dd;d<Ze dd=d>Ze dd?d@Ze ddAdBZe ddCdDZ e ddGdHZ!e ddJdKZ"e ddOdPZ#e ddRdSZ$e ddUdVZ%e ddWdXZ&e ddYdZZ'e dd[d\Z(e dd^d_Z)e dd`daZ*e ddbdcZ+e ddddeZ,e ddgdhZ-e didjZ.e ddldmZ/e ddndoZ0e ddpdqZ1e ddrdsZ2e ddtduZ3e ddvdwZ4e ddxdyZ5e ddzd{Z6e dd|d}Z7e dd~dZ8e dddZ9e dddZ:e dddZ;e dddZe dddZ?e dddZ@e dddZAe dddZBe dddZCe dddZDe ddddZEe dddZFe dddZGe dddZHe dddZIe dddZJe dddZKe dddZLe dddZMe dddZNe dddZOe dddZPe dddZQe dddÄZRe dddńZSe dddɄZTe ddd˄ZUe dd̈́ZVe ddτZWddd҄ZXdddԄZYdddلZZdS)r aRepresents an expression that can be evaluated to a value within the execution of a pipeline. Expressionessions are the building blocks for creating complex queries and transformations in Firestore pipelines. They can represent: - **Field references:** Access values from document fields. - **Literals:** Represent constant values (strings, numbers, booleans). - **FunctionExpression calls:** Apply functions to one or more expressions. - **Aggregations:** Calculate aggregate values (e.g., sum, average) over a set of documents. The `Expression` class provides a fluent API for building expressions. You can chain together method calls to create complex expressions. cCs|jjdS)N()) __class__rr3rrrr)nzExpression.__repr__r*r cCtNNotImplementedErrorr3rrrr2qszExpression._to_pbFor 'Expression'cCs\t|tr|St|trt|St|tr*|r&tdd|Dr&tt|St|St|S)z*Convert arbitrary object to an Expression.cSsg|] }t|ttfqSr)rfloatint).0irrr zCExpression._cast_to_expr_or_convert_to_constant..) rr dictMaplistallConstantr Array)r=include_vectorrrr$_cast_to_expr_or_convert_to_constantus    z/Expression._cast_to_expr_or_convert_to_constantc@s(eZdZdZddZddZddZdS) zExpression.expose_as_staticaG Decorator to mark instance methods to be exposed as static methods as well as instance methods. When called statically, the first argument is converted to a Field expression if needed. Example: >>> Field.of("test").add(5) >>> FunctionExpression.add("test", 5) cC ||_dSr:) instance_func)r&rNrrrr' z$Expression.expose_as_static.__init__cOs\t|ttfstd|jjdt|dt|ts t|n|}|j|g|Ri|S)N'zH' must be called on an Expression or a string representing a field. got .) rr r$ TypeErrorrNrtyper!r")r& first_arg other_argskwargs first_exprrrr static_funcs z'Expression.expose_as_static.static_funccCs|dur|jS|j||Sr:)rXrN__get__)r&instanceownerrrrrYsz#Expression.expose_as_static.__get__N)rrrr5r'rXrYrrrrexpose_as_statics   r\otherExpression | floatcCtd|||gS)aCreates an expression that adds this expression to another expression or constant. Example: >>> # Add the value of the 'quantity' field and the 'reserve' field. >>> Field.of("quantity").add(Field.of("reserve")) >>> # Add 5 to the value of the 'age' field >>> Field.of("age").add(5) Args: other: The expression or constant value to add to this expression. Returns: A new `Expression` representing the addition operation. addFunctionExpressionrLr&r]rrrr`zExpression.addcCr_)a+Creates an expression that subtracts another expression or constant from this expression. Example: >>> # Subtract the 'discount' field from the 'price' field >>> Field.of("price").subtract(Field.of("discount")) >>> # Subtract 20 from the value of the 'total' field >>> Field.of("total").subtract(20) Args: other: The expression or constant value to subtract from this expression. Returns: A new `Expression` representing the subtraction operation. subtractrarcrrrrerdzExpression.subtractcCr_)aCreates an expression that multiplies this expression by another expression or constant. Example: >>> # Multiply the 'quantity' field by the 'price' field >>> Field.of("quantity").multiply(Field.of("price")) >>> # Multiply the 'value' field by 2 >>> Field.of("value").multiply(2) Args: other: The expression or constant value to multiply by. Returns: A new `Expression` representing the multiplication operation. multiplyrarcrrrrfrdzExpression.multiplycCr_)aCreates an expression that divides this expression by another expression or constant. Example: >>> # Divide the 'total' field by the 'count' field >>> Field.of("total").divide(Field.of("count")) >>> # Divide the 'value' field by 10 >>> Field.of("value").divide(10) Args: other: The expression or constant value to divide by. Returns: A new `Expression` representing the division operation. dividerarcrrrrgrdzExpression.dividecCr_)a"Creates an expression that calculates the modulo (remainder) to another expression or constant. Example: >>> # Calculate the remainder of dividing the 'value' field by field 'divisor'. >>> Field.of("value").mod(Field.of("divisor")) >>> # Calculate the remainder of dividing the 'value' field by 5. >>> Field.of("value").mod(5) Args: other: The divisor expression or constant. Returns: A new `Expression` representing the modulo operation. modrarcrrrrhrdzExpression.modcC td|gS)a"Creates an expression that calculates the absolute value of this expression. Example: >>> # Get the absolute value of the 'change' field. >>> Field.of("change").abs() Returns: A new `Expression` representing the absolute value. absrbr3rrrrj  zExpression.abscCri)aCreates an expression that calculates the ceiling of this expression. Example: >>> # Get the ceiling of the 'value' field. >>> Field.of("value").ceil() Returns: A new `Expression` representing the ceiling value. ceilrkr3rrrrmrlzExpression.ceilcCri)aCreates an expression that computes e to the power of this expression. Example: >>> # Compute e to the power of the 'value' field >>> Field.of("value").exp() Returns: A new `Expression` representing the exponential value. exprkr3rrrrn$rlzExpression.expcCri)a Creates an expression that calculates the floor of this expression. Example: >>> # Get the floor of the 'value' field. >>> Field.of("value").floor() Returns: A new `Expression` representing the floor value. floorrkr3rrrro1rlzExpression.floorcCri)a(Creates an expression that calculates the natural logarithm of this expression. Example: >>> # Get the natural logarithm of the 'value' field. >>> Field.of("value").ln() Returns: A new `Expression` representing the natural logarithm. lnrkr3rrrrp>rlz Expression.lnbasecCr_)aCreates an expression that calculates the logarithm of this expression with a given base. Example: >>> # Get the logarithm of 'value' with base 2. >>> Field.of("value").log(2) >>> # Get the logarithm of 'value' with base from 'base_field'. >>> Field.of("value").log(Field.of("base_field")) Args: base: The base of the logarithm. Returns: A new `Expression` representing the logarithm. logra)r&rqrrrrrKrdzExpression.logcCri)zCreates an expression that calculates the base 10 logarithm of this expression. Example: >>> Field.of("value").log10() Returns: A new `Expression` representing the logarithm. log10rkr3rrrrs_s zExpression.log10exponentcCr_)aCreates an expression that calculates this expression raised to the power of the exponent. Example: >>> # Raise 'base_val' to the power of 2. >>> Field.of("base_val").pow(2) >>> # Raise 'base_val' to the power of 'exponent_val'. >>> Field.of("base_val").pow(Field.of("exponent_val")) Args: exponent: The exponent. Returns: A new `Expression` representing the power operation. powra)r&rtrrrrukrdzExpression.powcCri)a Creates an expression that rounds this expression to the nearest integer. Example: >>> # Round the 'value' field. >>> Field.of("value").round() Returns: A new `Expression` representing the rounded value. roundrkr3rrrrvrlzExpression.roundcCri)aCreates an expression that calculates the square root of this expression. Example: >>> # Get the square root of the 'area' field. >>> Field.of("area").sqrt() Returns: A new `Expression` representing the square root. sqrtrkr3rrrrwrlzExpression.sqrtothersExpression | CONSTANT_TYPEc"tdgfdd|DddS)a=Creates an expression that returns the larger value between this expression and another expression or constant, based on Firestore's value type ordering. Firestore's value type ordering is described here: https://cloud.google.com/firestore/docs/concepts/data-types#value_type_ordering Example: >>> # Returns the larger value between the 'discount' field and the 'cap' field. >>> Field.of("discount").logical_maximum(Field.of("cap")) >>> # Returns the larger value between the 'value' field and some ints >>> Field.of("value").logical_maximum(10, 20, 30) Args: others: The other expression or constant values to compare with. Returns: A new `Expression` representing the logical maximum operation. maximumcg|]}|qSrrLrAr=r3rrrCz.Expression.logical_maximum..logical_maximuminfix_name_overriderkr&rxrr3rr zExpression.logical_maximumcrz)aDCreates an expression that returns the smaller value between this expression and another expression or constant, based on Firestore's value type ordering. Firestore's value type ordering is described here: https://cloud.google.com/firestore/docs/concepts/data-types#value_type_ordering Example: >>> # Returns the smaller value between the 'discount' field and the 'floor' field. >>> Field.of("discount").logical_minimum(Field.of("floor")) >>> # Returns the smaller value between the 'value' field and some ints >>> Field.of("value").logical_minimum(10, 20, 30) Args: others: The other expression or constant values to compare with. Returns: A new `Expression` representing the logical minimum operation. minimumcr|rr}r~r3rrrCrz.Expression.logical_minimum..logical_minimumrrkrrr3rrrzExpression.logical_minimum'BooleanExpression'cCr_)aCreates an expression that checks if this expression is equal to another expression or constant value. Example: >>> # Check if the 'age' field is equal to 21 >>> Field.of("age").equal(21) >>> # Check if the 'city' field is equal to "London" >>> Field.of("city").equal("London") Args: other: The expression or constant value to compare for equality. Returns: A new `Expression` representing the equality comparison. equalBooleanExpressionrLrcrrrrzExpression.equalcCr_)aBCreates an expression that checks if this expression is not equal to another expression or constant value. Example: >>> # Check if the 'status' field is not equal to "completed" >>> Field.of("status").not_equal("completed") >>> # Check if the 'country' field is not equal to "USA" >>> Field.of("country").not_equal("USA") Args: other: The expression or constant value to compare for inequality. Returns: A new `Expression` representing the inequality comparison. not_equalrrcrrrrrzExpression.not_equalcCr_)aJCreates an expression that checks if this expression is greater than another expression or constant value. Example: >>> # Check if the 'age' field is greater than the 'limit' field >>> Field.of("age").greater_than(Field.of("limit")) >>> # Check if the 'price' field is greater than 100 >>> Field.of("price").greater_than(100) Args: other: The expression or constant value to compare for greater than. Returns: A new `Expression` representing the greater than comparison. greater_thanrrcrrrrrzExpression.greater_thancCr_)aCreates an expression that checks if this expression is greater than or equal to another expression or constant value. Example: >>> # Check if the 'quantity' field is greater than or equal to field 'requirement' plus 1 >>> Field.of("quantity").greater_than_or_equal(Field.of('requirement').add(1)) >>> # Check if the 'score' field is greater than or equal to 80 >>> Field.of("score").greater_than_or_equal(80) Args: other: The expression or constant value to compare for greater than or equal to. Returns: A new `Expression` representing the greater than or equal to comparison. greater_than_or_equalrrcrrrr  z Expression.greater_than_or_equalcCr_)a)Creates an expression that checks if this expression is less than another expression or constant value. Example: >>> # Check if the 'age' field is less than 'limit' >>> Field.of("age").less_than(Field.of('limit')) >>> # Check if the 'price' field is less than 50 >>> Field.of("price").less_than(50) Args: other: The expression or constant value to compare for less than. Returns: A new `Expression` representing the less than comparison. less_thanrrcrrrr$rzExpression.less_thancCr_)azCreates an expression that checks if this expression is less than or equal to another expression or constant value. Example: >>> # Check if the 'quantity' field is less than or equal to 20 >>> Field.of("quantity").less_than_or_equal(Constant.of(20)) >>> # Check if the 'score' field is less than or equal to 70 >>> Field.of("score").less_than_or_equal(70) Args: other: The expression or constant value to compare for less than or equal to. Returns: A new `Expression` representing the less than or equal to comparison. less_than_or_equalrrcrrrr9rzExpression.less_than_or_equalarray9Array | Sequence[Expression | CONSTANT_TYPE] | ExpressioncCr_)aCreates an expression that checks if this expression is equal to any of the provided values or expressions. Example: >>> # Check if the 'category' field is either "Electronics" or value of field 'primaryType' >>> Field.of("category").equal_any(["Electronics", Field.of("primaryType")]) Args: array: The values or expressions to check against. Returns: A new `Expression` representing the 'IN' comparison. equal_anyrr&rrrrrQ zExpression.equal_any5Array | list[Expression | CONSTANT_TYPE] | ExpressioncCr_)aCreates an expression that checks if this expression is not equal to any of the provided values or expressions. Example: >>> # Check if the 'status' field is neither "pending" nor "cancelled" >>> Field.of("status").not_equal_any(["pending", "cancelled"]) Args: array: The values or expressions to check against. Returns: A new `Expression` representing the 'NOT IN' comparison. not_equal_anyrrrrrrjrzExpression.not_equal_anyoffsetExpression | int'FunctionExpression'cCr_)a Creates an expression that indexes into an array from the beginning or end and returns the element. A negative offset starts from the end. Example: >>> Array([1,2,3]).array_get(0) Args: offset: the index of the element to return Returns: A new `Expression` representing the `array_get` operation. array_getra)r&rrrrrzExpression.array_getelementcCr_)aQCreates an expression that checks if an array contains a specific element or value. Example: >>> # Check if the 'sizes' array contains the value from the 'selectedSize' field >>> Field.of("sizes").array_contains(Field.of("selectedSize")) >>> # Check if the 'colors' array contains "red" >>> Field.of("colors").array_contains("red") Args: element: The element (expression or constant) to search for in the array. Returns: A new `Expression` representing the 'array_contains' comparison. array_containsr)r&rrrrrszExpression.array_containselementscCr_)aCreates an expression that checks if an array contains all the specified elements. Example: >>> # Check if the 'tags' array contains both "news" and "sports" >>> Field.of("tags").array_contains_all(["news", "sports"]) >>> # Check if the 'tags' array contains both of the values from field 'tag1' and "tag2" >>> Field.of("tags").array_contains_all([Field.of("tag1"), "tag2"]) Args: elements: The list of elements (expressions or constants) to check for in the array. Returns: A new `Expression` representing the 'array_contains_all' comparison. array_contains_allrr&rrrrrs zExpression.array_contains_allcCr_)aCreates an expression that checks if an array contains any of the specified elements. Example: >>> # Check if the 'categories' array contains either values from field "cate1" or "cate2" >>> Field.of("categories").array_contains_any([Field.of("cate1"), Field.of("cate2")]) >>> # Check if the 'groups' array contains either the value from the 'userGroup' field >>> # or the value "guest" >>> Field.of("groups").array_contains_any([Field.of("userGroup"), "guest"]) Args: elements: The list of elements (expressions or constants) to check for in the array. Returns: A new `Expression` representing the 'array_contains_any' comparison. array_contains_anyrrrrrrs zExpression.array_contains_anycCri)aCreates an expression that calculates the length of an array. Example: >>> # Get the number of items in the 'cart' array >>> Field.of("cart").array_length() Returns: A new `Expression` representing the length of the array. array_lengthrkr3rrrrrlzExpression.array_lengthcCri)a*Creates an expression that returns the reversed content of an array. Example: >>> # Get the 'preferences' array in reversed order. >>> Field.of("preferences").array_reverse() Returns: A new `Expression` representing the reversed array. array_reverserkr3rrrrrlzExpression.array_reverse other_arraysctdgfdd|DS)aCreates an expression that concatenates an array expression with another array. Example: >>> # Combine the 'tags' array with a new array and an array field >>> Field.of("tags").array_concat(["newTag1", "newTag2", Field.of("otherTag")]) Args: array: The list of constants or expressions to concat with. Returns: A new `Expression` representing the concatenated array. array_concatcr|rr})rAarrr3rrrCrz+Expression.array_concat..rk)r&rrr3rrs zExpression.array_concatcr)zCreates an expression that concatenates expressions together Args: *others: The expressions to concatenate. Returns: A new `Expression` representing the concatenated value. concatcr|rr}r~r3rrrCrz%Expression.concat..rkrrr3rrs zExpression.concatcCri)aJ Creates an expression that calculates the length of the expression if it is a string, array, map, or blob. Example: >>> # Get the length of the 'name' field. >>> Field.of("name").length() Returns: A new `Expression` representing the length of the expression. lengthrkr3rrrr" zExpression.lengthcCri)a]Creates an expression that returns true if a value is absent. Otherwise, returns false even if the value is null. Example: >>> # Check if the 'email' field is absent. >>> Field.of("email").is_absent() Returns: A new `BooleanExpressionession` representing the isAbsent operation. is_absentrr3rrrr0rzExpression.is_absent default_valuecCr_)aCreates an expression that returns a default value if an expression evaluates to an absent value. Example: >>> # Return the value of the 'email' field, or "N/A" if it's absent. >>> Field.of("email").if_absent("N/A") Args: default_value: The expression or constant value to return if this expression is absent. Returns: A new `Expression` representing the ifAbsent operation. if_absentra)r&rrrrr>s zExpression.if_absentcCri)a=Creates an expression that checks if a given expression produces an error Example: >>> # Resolves to True if an expression produces an error >>> Field.of("value").divide("string").is_error() Returns: A new `Expression` representing the isError operation. is_errorrkr3rrrrQrlzExpression.is_error then_valuecCr_)aCreates an expression that returns ``then_value`` if this expression evaluates to an error. Otherwise, returns the value of this expression. Example: >>> # Resolves to 0 if an expression produces an error >>> Field.of("value").divide("string").if_error(0) Args: then_value: The value to return if this expression evaluates to an error. Returns: A new `Expression` representing the ifError operation. if_errorra)r&rrrrr^rzExpression.if_errorcCri)a*Creates an expression that checks if a field exists in the document. Example: >>> # Check if the document has a field named "phoneNumber" >>> Field.of("phoneNumber").exists() Returns: A new `Expression` representing the 'exists' check. existsrr3rrrrqrlzExpression.existscCri)a[Creates an aggregation that calculates the sum of a numeric field across multiple stage inputs. Example: >>> # Calculate the total revenue from a set of orders >>> Field.of("orderAmount").sum().as_("totalRevenue") Returns: A new `AggregateFunction` representing the 'sum' aggregation. sumAggregateFunctionr3rrrr~rlzExpression.sumcCri)aZCreates an aggregation that calculates the average (mean) of a numeric field across multiple stage inputs. Example: >>> # Calculate the average age of users >>> Field.of("age").average().as_("averageAge") Returns: A new `AggregateFunction` representing the 'avg' aggregation. averagerr3rrrrrzExpression.averagecCri)aiCreates an aggregation that counts the number of stage inputs with valid evaluations of the expression or field. Example: >>> # Count the total number of products >>> Field.of("productId").count().as_("totalProducts") Returns: A new `AggregateFunction` representing the 'count' aggregation. countrr3rrrrrzExpression.countcCri)asCreates an aggregation that counts the number of values of the provided field or expression that evaluate to True. Example: >>> # Count the number of adults >>> Field.of("age").greater_than(18).count_if().as_("totalAdults") Returns: A new `AggregateFunction` representing the 'count_if' aggregation. count_ifrr3rrrrs zExpression.count_ifcCri)a|Creates an aggregation that counts the number of distinct values of the provided field or expression. Example: >>> # Count the total number of countries in the data >>> Field.of("country").count_distinct().as_("totalCountries") Returns: A new `AggregateFunction` representing the 'count_distinct' aggregation. count_distinctrr3rrrrrzExpression.count_distinctcCri)aNCreates an aggregation that finds the minimum value of a field across multiple stage inputs. Example: >>> # Find the lowest price of all products >>> Field.of("price").minimum().as_("lowestPrice") Returns: A new `AggregateFunction` representing the 'minimum' aggregation. rrr3rrrrrlzExpression.minimumcCri)aQCreates an aggregation that finds the maximum value of a field across multiple stage inputs. Example: >>> # Find the highest score in a leaderboard >>> Field.of("score").maximum().as_("highestScore") Returns: A new `AggregateFunction` representing the 'maximum' aggregation. r{rr3rrrr{rlzExpression.maximumcCri)a(Creates an expression that calculates the character length of a string. Example: >>> # Get the character length of the 'name' field >>> Field.of("name").char_length() Returns: A new `Expression` representing the length of the string. char_lengthrkr3rrrrrlzExpression.char_lengthcCri)a5Creates an expression that calculates the byte length of a string in its UTF-8 form. Example: >>> # Get the byte length of the 'name' field >>> Field.of("name").byte_length() Returns: A new `Expression` representing the byte length of the string. byte_lengthrkr3rrrrrlzExpression.byte_lengthpatternExpression | strcCr_)a[Creates an expression that performs a case-sensitive string comparison. Example: >>> # Check if the 'title' field contains the word "guide" (case-sensitive) >>> Field.of("title").like("%guide%") >>> # Check if the 'title' field matches the pattern specified in field 'pattern'. >>> Field.of("title").like(Field.of("pattern")) Args: pattern: The pattern (string or expression) to search for. You can use "%" as a wildcard character. Returns: A new `Expression` representing the 'like' comparison. liker)r&rrrrrrdzExpression.likeregexcCr_)aCreates an expression that checks if a string contains a specified regular expression as a substring. Example: >>> # Check if the 'description' field contains "example" (case-insensitive) >>> Field.of("description").regex_contains("(?i)example") >>> # Check if the 'description' field contains the regular expression stored in field 'regex' >>> Field.of("description").regex_contains(Field.of("regex")) Args: regex: The regular expression (string or expression) to use for the search. Returns: A new `Expression` representing the 'contains' comparison. regex_containsrr&rrrrr rzExpression.regex_containscCr_)aCreates an expression that checks if a string matches a specified regular expression. Example: >>> # Check if the 'email' field matches a valid email pattern >>> Field.of("email").regex_match("[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}") >>> # Check if the 'email' field matches a regular expression stored in field 'regex' >>> Field.of("email").regex_match(Field.of("regex")) Args: regex: The regular expression (string or expression) to use for the match. Returns: A new `Expression` representing the regular expression match. regex_matchrrrrrr!rdzExpression.regex_match substringcCr_)afCreates an expression that checks if this string expression contains a specified substring. Example: >>> # Check if the 'description' field contains "example". >>> Field.of("description").string_contains("example") >>> # Check if the 'description' field contains the value of the 'keyword' field. >>> Field.of("description").string_contains(Field.of("keyword")) Args: substring: The substring (string or expression) to use for the search. Returns: A new `Expression` representing the 'contains' comparison. string_containsr)r&rrrrr5s zExpression.string_containsprefixcCr_)a,Creates an expression that checks if a string starts with a given prefix. Example: >>> # Check if the 'name' field starts with "Mr." >>> Field.of("name").starts_with("Mr.") >>> # Check if the 'fullName' field starts with the value of the 'firstName' field >>> Field.of("fullName").starts_with(Field.of("firstName")) Args: prefix: The prefix (string or expression) to check for. Returns: A new `Expression` representing the 'starts with' comparison. starts_withr)r&rrrrrJrdzExpression.starts_withpostfixcCr_)a#Creates an expression that checks if a string ends with a given postfix. Example: >>> # Check if the 'filename' field ends with ".txt" >>> Field.of("filename").ends_with(".txt") >>> # Check if the 'url' field ends with the value of the 'extension' field >>> Field.of("url").ends_with(Field.of("extension")) Args: postfix: The postfix (string or expression) to check for. Returns: A new `Expression` representing the 'ends with' comparison. ends_withr)r&rrrrr^rdzExpression.ends_withcr)aCreates an expression that concatenates string expressions, fields or constants together. Example: >>> # Combine the 'firstName', " ", and 'lastName' fields into a single string >>> Field.of("firstName").string_concat(" ", Field.of("lastName")) Args: *elements: The expressions or constants (typically strings) to concatenate. Returns: A new `Expression` representing the concatenated string. string_concatcr|rr}rAelr3rrrCrz,Expression.string_concat..rkrrr3rrrszExpression.string_concatcCri)a Creates an expression that converts a string to lowercase. Example: >>> # Convert the 'name' field to lowercase >>> Field.of("name").to_lower() Returns: A new `Expression` representing the lowercase string. to_lowerrkr3rrrrrlzExpression.to_lowercCri)aCreates an expression that converts a string to uppercase. Example: >>> # Convert the 'title' field to uppercase >>> Field.of("title").to_upper() Returns: A new `Expression` representing the uppercase string. to_upperrkr3rrrrrlzExpression.to_uppercCri)a(Creates an expression that removes leading and trailing whitespace from a string. Example: >>> # Trim whitespace from the 'userInput' field >>> Field.of("userInput").trim() Returns: A new `Expression` representing the trimmed string. trimrkr3rrrrrlzExpression.trimcCri)zCreates an expression that reverses a string. Example: >>> # Reverse the 'userInput' field >>> Field.of("userInput").reverse() Returns: A new `Expression` representing the reversed string. string_reverserkr3rrrrrlzExpression.string_reverseNpositionrExpression | int | NonecCs0|||g}|dur|||td|S)a Creates an expression that returns a substring of the results of this expression. Example: >>> Field.of("description").substring(5, 10) >>> Field.of("description").substring(5) Args: position: the index of the first character of the substring. length: the length of the substring. If not provided the substring will end at the end of the input. Returns: A new `Expression` representing the extracted substring. Nr)rLappendrb)r&rrargsrrrrs zExpression.substring delimetercCr_)a>Creates an expression that joins the elements of an array into a string Example: >>> Field.of("tags").join(", ") Args: delimiter: The delimiter to add between the elements of the array. Returns: A new `Expression` representing the joined string. joinra)r&rrrrrzExpression.joinkeystr | Constant[str]cCr_)a|Accesses a value from the map produced by evaluating this expression. Example: >>> Map({"city": "London"}).map_get("city") >>> Field.of("address").map_get("city") Args: key: The key to access in the map. Returns: A new `Expression` representing the value associated with the given key in the map. map_getrar&rrrrrrzExpression.map_getcCr_)afRemove a key from a the map produced by evaluating this expression. Example: >>> Map({"city": "London"}).map_remove("city") >>> Field.of("address").map_remove("city") Args: key: The key to remove in the map. Returns: A new `Expression` representing the map_remove operation. map_removerarrrrrrzExpression.map_remove other_mapsHMap | dict[str | Constant[str], Expression | CONSTANT_TYPE] | Expressioncr)aCreates an expression that merges one or more dicts into a single map. Example: >>> Map({"city": "London"}).map_merge({"country": "UK"}, {"isCapital": True}) >>> Field.of("settings").map_merge({"enabled":True}, FunctionExpression.conditional(Field.of('isAdmin'), {"admin":True}, {}}) Args: *other_maps: Sequence of maps to merge into the resulting map. Returns: A new `Expression` representing the value associated with the given key in the map. map_mergecr|rr}rAmr3rrrCrz(Expression.map_merge..rk)r&rrr3rrszExpression.map_merge!Expression | list[float] | VectorcCtd||j|ddgS)aCalculates the cosine distance between two vectors. Example: >>> # Calculate the cosine distance between the 'userVector' field and the 'itemVector' field >>> Field.of("userVector").cosine_distance(Field.of("itemVector")) >>> # Calculate the Cosine distance between the 'location' field and a target location >>> Field.of("location").cosine_distance([37.7749, -122.4194]) Args: other: The other vector (represented as an Expression, list of floats, or Vector) to compare against. Returns: A new `Expression` representing the cosine distance between the two vectors. cosine_distanceTrKrarcrrrr  zExpression.cosine_distancecCr)aCalculates the Euclidean distance between two vectors. Example: >>> # Calculate the Euclidean distance between the 'location' field and a target location >>> Field.of("location").euclidean_distance([37.7749, -122.4194]) >>> # Calculate the Euclidean distance between two vector fields: 'pointA' and 'pointB' >>> Field.of("pointA").euclidean_distance(Field.of("pointB")) Args: other: The other vector (represented as an Expression, list of floats, or Vector) to compare against. Returns: A new `Expression` representing the Euclidean distance between the two vectors. euclidean_distanceTrrarcrrrr7s  zExpression.euclidean_distancecCr)aCalculates the dot product between two vectors. Example: >>> # Calculate the dot product between a feature vector and a target vector >>> Field.of("features").dot_product([0.5, 0.8, 0.2]) >>> # Calculate the dot product between two document vectors: 'docVector1' and 'docVector2' >>> Field.of("docVector1").dot_product(Field.of("docVector2")) Args: other: The other vector (represented as an Expression, list of floats, or Vector) to calculate dot product with. Returns: A new `Expression` representing the dot product between the two vectors. dot_productTrrarcrrrrQrzExpression.dot_productcCri)aJCreates an expression that calculates the length (dimension) of a Firestore Vector. Example: >>> # Get the vector length (dimension) of the field 'embedding'. >>> Field.of("embedding").vector_length() Returns: A new `Expression` representing the length of the vector. vector_lengthrkr3rrrrirlzExpression.vector_lengthcCri)aCreates an expression that converts a timestamp to the number of microseconds since the epoch (1970-01-01 00:00:00 UTC). Truncates higher levels of precision by rounding down to the beginning of the microsecond. Example: >>> # Convert the 'timestamp' field to microseconds since the epoch. >>> Field.of("timestamp").timestamp_to_unix_micros() Returns: A new `Expression` representing the number of microseconds since the epoch. timestamp_to_unix_microsrkr3rrrrv z#Expression.timestamp_to_unix_microscCri)amCreates an expression that converts a number of microseconds since the epoch (1970-01-01 00:00:00 UTC) to a timestamp. Example: >>> # Convert the 'microseconds' field to a timestamp. >>> Field.of("microseconds").unix_micros_to_timestamp() Returns: A new `Expression` representing the timestamp. unix_micros_to_timestamprkr3rrrrrz#Expression.unix_micros_to_timestampcCri)aCreates an expression that converts a timestamp to the number of milliseconds since the epoch (1970-01-01 00:00:00 UTC). Truncates higher levels of precision by rounding down to the beginning of the millisecond. Example: >>> # Convert the 'timestamp' field to milliseconds since the epoch. >>> Field.of("timestamp").timestamp_to_unix_millis() Returns: A new `Expression` representing the number of milliseconds since the epoch. timestamp_to_unix_millisrkr3rrrrrz#Expression.timestamp_to_unix_milliscCri)amCreates an expression that converts a number of milliseconds since the epoch (1970-01-01 00:00:00 UTC) to a timestamp. Example: >>> # Convert the 'milliseconds' field to a timestamp. >>> Field.of("milliseconds").unix_millis_to_timestamp() Returns: A new `Expression` representing the timestamp. unix_millis_to_timestamprkr3rrrrrz#Expression.unix_millis_to_timestampcCri)aCreates an expression that converts a timestamp to the number of seconds since the epoch (1970-01-01 00:00:00 UTC). Truncates higher levels of precision by rounding down to the beginning of the second. Example: >>> # Convert the 'timestamp' field to seconds since the epoch. >>> Field.of("timestamp").timestamp_to_unix_seconds() Returns: A new `Expression` representing the number of seconds since the epoch. timestamp_to_unix_secondsrkr3rrrrrz$Expression.timestamp_to_unix_secondscCri)a_Creates an expression that converts a number of seconds since the epoch (1970-01-01 00:00:00 UTC) to a timestamp. Example: >>> # Convert the 'seconds' field to a timestamp. >>> Field.of("seconds").unix_seconds_to_timestamp() Returns: A new `Expression` representing the timestamp. unix_seconds_to_timestamprkr3rrrrrz$Expression.unix_seconds_to_timestampunitamountcCtd|||||gS)aCreates an expression that adds a specified amount of time to this timestamp expression. Example: >>> # Add a duration specified by the 'unit' and 'amount' fields to the 'timestamp' field. >>> Field.of("timestamp").timestamp_add(Field.of("unit"), Field.of("amount")) >>> # Add 1.5 days to the 'timestamp' field. >>> Field.of("timestamp").timestamp_add("day", 1.5) Args: unit: The expression or string evaluating to the unit of time to add, must be one of 'microsecond', 'millisecond', 'second', 'minute', 'hour', 'day'. amount: The expression or float representing the amount of time to add. Returns: A new `Expression` representing the resulting timestamp. timestamp_addrar&rrrrrrzExpression.timestamp_addcCr)aFCreates an expression that subtracts a specified amount of time from this timestamp expression. Example: >>> # Subtract a duration specified by the 'unit' and 'amount' fields from the 'timestamp' field. >>> Field.of("timestamp").timestamp_subtract(Field.of("unit"), Field.of("amount")) >>> # Subtract 2.5 hours from the 'timestamp' field. >>> Field.of("timestamp").timestamp_subtract("hour", 2.5) Args: unit: The expression or string evaluating to the unit of time to subtract, must be one of 'microsecond', 'millisecond', 'second', 'minute', 'hour', 'day'. amount: The expression or float representing the amount of time to subtract. Returns: A new `Expression` representing the resulting timestamp. timestamp_subtractrarrrrrrzExpression.timestamp_subtractcCri)aCreates an expression that returns the collection ID from a path. Example: >>> # Get the collection ID from a path. >>> Field.of("__name__").collection_id() Returns: A new `Expression` representing the collection ID. collection_idrkr3rrrr rlzExpression.collection_idcCri)aCreates an expression that returns the document ID from a path. Example: >>> # Get the document ID from a path. >>> Field.of("__name__").document_id() Returns: A new `Expression` representing the document ID. document_idrkr3rrrrrlzExpression.document_idrcCt|tjjS)aYCreates an `Ordering` that sorts documents in ascending order based on this expression. Example: >>> # Sort documents by the 'name' field in ascending order >>> client.pipeline().collection("users").sort(Field.of("name").ascending()) Returns: A new `Ordering` for ascending sorting. )rrrr3rrrr$ zExpression.ascendingcCr)agCreates an `Ordering` that sorts documents in descending order based on this expression. Example: >>> # Sort documents by the 'createdAt' field in descending order >>> client.pipeline().collection("users").sort(Field.of("createdAt").descending()) Returns: A new `Ordering` for descending sorting. )rrrr3rrrr0rzExpression.descendingaliasr$'AliasedExpression'cCs t||S)aAssigns an alias to this expression. Aliases are useful for renaming fields in the output of a stage or for giving meaningful names to calculated values. Example: >>> # Calculate the total price and assign it the alias "totalPrice" and add it to the output. >>> client.pipeline().collection("items").add_fields( ... Field.of("price").multiply(Field.of("quantity")).as_("totalPrice") ... ) Args: alias: The alias to assign to this expression. Returns: A new `Selectable` (typically an `AliasedExpression`) that wraps this expression and associates it with the provided alias. )AliasedExpression)r&rrrras_<s zExpression.as_r4)F)r=rr*r>)r]r^r*r>)r*r>)rqr^r*r>)rtr^r*r>)rxryr*r>)r]ryr*r)rrr*r)rrr*r)rrr*r)rryr*r)rrr*r)rrr*r>)r*r)rryr*r>)rryr*r>)rrr*r)rrr*r)rrr*r)rrr*r)rrr*r)rryr*r>r:)rrrrr*r>)rrr*r>)rrr*r>)rrr*r>)r]rr*r>)rrrr^r*r>)r*r)rr$r*r)[rrrr5r)rr2 staticmethodrLr\r`rerfrgrhrjrmrnrorprrrsrurvrwrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr{rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr ^sR !                                                                                r c@sJeZdZdZdddZddZedd d Zd d ZddZ dddZ dS)rIz5Represents a constant literal value in an expression.r1rcCrMr:r1)r&r1rrrr'UrOzConstant.__init__cCs t|ts ||jkS|j|jkSr:rrIr1rcrrr__eq__Xs   zConstant.__eq__r*Constant[CONSTANT_TYPE]cCt|S)z2Creates a constant expression from a Python value.)rIrrrrr"^sz Constant.ofcCs.t|j}t|jtr|dkrd}d|dS)Nnanzmath.nanz Constant.of())reprr1rr?)r& value_strrrrr)cs  zConstant.__repr__cC t|jSr:)hashr1r3rrr__hash__irOzConstant.__hash__r cCr r:)rr1r3rrrr2lrOzConstant._to_pbN)r1r)r1rr*rr4) rrrr5r'rrr"r)r r2rrrrrIRs  rIc@s:eZdZdZddddd dZddZddZddZdS)rbz;A base class for expressions that represent function calls.TN)use_infix_reprrnamer$paramsSequence[Expression]rboolr str | NonecCs ||_t||_||_||_dSr:)rrGr_use_infix_repr_infix_name_override)r&rrrrrrrr'ss  zFunctionExpression.__init__c Cs|jrN|jp|j}t|jdkr|jdd|dSt|jdkr3|jdd|d|jddS|jdd|ddd d |jdd DdS|jjddd d |jDdS) z Most FunctionExpressions can be triggered infix. Eg: Field.of('age').greater_than(18). Display them this way in the repr string where possible rrQr6(rz, cSg|]}t|qSrr rAprrrrCz/FunctionExpression.__repr__..NcSrrrrrrrrCr)rrrlenrrr7r)r& infix_namerrrr)s "6&zFunctionExpression.__repr__cCs&t|tsdS|j|jko|j|jkSNF)rrbrrrcrrrrs zFunctionExpression.__eq__cCst|jdd|jDddS)NcSg|]}|qSr)r2rrrrrCrz-FunctionExpression._to_pb..)rr)function_value)r rrr3rrrr2s zFunctionExpression._to_pb)rr$rrrrrr)rrrr5r'r)rr2rrrrrbps  rbc@seZdZdZdS)rzKA base class for aggregation functions that operate across multiple inputs.N)rrrr5rrrrrsrc@sBeZdZdZddZedddZedd d Ze dddZ dS) SelectablezPBase class for expressions that can be selected or aliased in projection stages.cCs"t|t|s dS||kSr )rrS_to_maprcrrrrszSelectable.__eq__r*tuple[str, Value]cCr9)zG Returns a str: Value representation of the Selectable r;r3rrrr$szSelectable._to_map selectablesr cGs"tddddd|DDidS)zC Returns a Value representing a map of Selectables r+cSi|] }|d|dqSrrrrrrr rDz6Selectable._value_from_selectables..cSr!rr$)rAsrrrrCrz6Selectable._value_from_selectables..r/r )clsr&rrr_value_from_selectablessz"Selectable._value_from_selectables field_listSequence[Selectable]cCs"tddddd|DDidS)Nr+cSr'r(rrrrrr)rDz(Selectable._to_value..cSr!rr*rAfrrrrCrz(Selectable._to_value..r/r )r.rrr _to_valueszSelectable._to_valueN)r*r%)r&r#r*r )r.r/r*r ) rrrr5rrr$ classmethodr-rr2rrrrr#s   r#T)boundc@s2eZdZdZdddZdd Zd d Zd d ZdS)rz"Wraps an expression with an alias.r#r4rr$cCs||_||_dSr:r#r)r&r#rrrrr's zAliasedExpression.__init__cCs|j|jfSr:)rr#r2r3rrrr$szAliasedExpression._to_mapcCs|jd|jdS)Nz.as_('z')r6r3rrrr)szAliasedExpression.__repr__cCstd|j|jiidS)Nr+r/)r rr#r2r3rrrr2szAliasedExpression._to_pbN)r#r4rr$)rrrr5r'r$r)r2rrrrrs   rc@sDeZdZdZdZdddZedddZd d Zd d Z d dZ dS)r!z4Represents a reference to a field within a document.rpathr$cCs ||_dS)zInitializes a Field reference. Args: path: The dot-separated path to the field (e.g., "address.city"). Use Field.DOCUMENT_ID for the document ID. Nr7)r&r7rrrr's zField.__init__cCr)zCreates a Field reference. Args: path: The dot-separated path to the field (e.g., "address.city"). Use Field.DOCUMENT_ID for the document ID. Returns: A new Field instance. )r!r8rrrr"s zField.ofcCs|j|fSr:)r7r2r3rrrr$r8z Field._to_mapcCsd|jdS)Nz Field.of(rr8r3rrrr)r8zField.__repr__cCs t|jdS)N)field_reference_value)r r7r3rrrr2s z Field._to_pbN)r7r$) rrrr5 DOCUMENT_IDr'rr"r$r)r2rrrrr!s    r!c@seZdZdZeddZdS)rz#Filters the given data in some way.cst|tjr0fdd|jD}|jtjjjkrt|S|jtjjjkr(t |St d|jt|tj rt |jj}|jtj jjkrQt ||tdS|jtj jjkrgt |t|tdS|jtj jjkryt ||dS|jtj jjkrt |t|dSt d|jt|tjrkt |jj}t|j}|jtjjjkrt |||S|jtjjjkrt |||S|jtjjjkrt || |S|jtjjj!krt ||"|S|jtjjj#krt |||S|jtjjj$krt ||%|S|jtjjj&kr*t ||'|S|jtjjj(kr=t ||)|S|jtjjj*krPt ||+|S|jtjjj,krct ||-|St d|jt|tj.r|j/p||j0p||j1}t23|St dt4|)Ncsg|]}t|qSr)r_from_query_filter_pbr0clientrrrCs z;BooleanExpression._from_query_filter_pb..z*Unexpected CompositeFilter operator type: rz&Unexpected UnaryFilter operator type: z&Unexpected FieldFilter operator type: zUnexpected filter type: )5rQuery_pbCompositeFilterfiltersopOperatorOROrANDAndrR UnaryFilterr!r"field field_pathIS_NANrrr? IS_NOT_NANNotIS_NULL IS_NOT_NULL FieldFilterrr1 LESS_THANrLESS_THAN_OR_EQUALr GREATER_THANrGREATER_THAN_OR_EQUALrEQUAL NOT_EQUALrARRAY_CONTAINSrARRAY_CONTAINS_ANYrINrNOT_INrFiltercomposite_filter field_filter unary_filterrr;rS) filter_pbr= sub_filtersrHr1r1rr<rr;sl      z'BooleanExpression._from_query_filter_pbN)rrrr5rr;rrrrrsrc*eZdZdZdfdd ZddZZS) rJz Creates an expression that creates a Firestore array value from an input list. Example: >>> Array(["bar", Field.of("baz")]) Args: elements: The input list to evaluate in the expression r list[Expression | CONSTANT_TYPE]cs6t|ts tdfdd|D}td|dS)Nz%Array must be constructed with a listcr|rr}rr3rrrCQs z"Array.__init__..r)rrGrRsuperr')r&rconverted_elementsr7r3rr'Ns  zArray.__init__cCsd|jdS)NzArray(r)rr3rrrr)Vr8zArray.__repr__)rrarrrr5r'r) __classcell__rrrdrrJCs rJcr`) rFz Creates an expression that creates a Firestore map value from an input dict. Example: >>> Expression.map({"foo": "bar", "baz": Field.of("baz")}) Args: elements: The input dict to evaluate in the expression r5dict[str | Constant[str], Expression | CONSTANT_TYPE]csHg}|D]\}}||||||qtd|dS)Nmap)itemsrrLrbr')r&r element_listkvrdrrr'es z Map.__init__cCsDdd|jD}ddt|ddd|dddD}d|dS) NcSs g|] }t|tr |jn|qSrr)rAarrrrCmsz Map.__repr__..cSsi|]\}}||qSrr)rArmbrrrr)prz Map.__repr__..rrzMap(r)rzip)r&formatted_paramsdrrrr)ls ( z Map.__repr__)rrgrerrrdrrFZs rFc"eZdZdZdfdd ZZS)rFa Represents an expression that performs a logical 'AND' operation on multiple filter conditions. Example: >>> # Check if the 'age' field is greater than 18 AND the 'city' field is "London" AND >>> # the 'status' field is "active" >>> And(Field.of("age").greater_than(18), Field.of("city").equal("London"), Field.of("status").equal("active")) Args: *conditions: The filter conditions to 'AND' together. conditionsrctjd|dddS)NandFrrbr'r&rsrdrrr'z And.__init__rsrrrrr5r'rfrrrdrrFt rFcrr)rLa Represents an expression that negates a filter condition. Example: >>> # Find documents where the 'completed' field is NOT true >>> Not(Field.of("completed").equal(True)) Args: condition: The filter condition to negate. conditionrcstjd|gdddS)NnotFrvrw)r&r}rdrrr'sz Not.__init__)r}rr{rrrdrrLs rLcrr)rDa Represents expression that performs a logical 'OR' operation on multiple filter conditions. Example: >>> # Check if the 'age' field is greater than 18 OR the 'city' field is "London" OR >>> # the 'status' field is "active" >>> Or(Field.of("age").greater_than(18), Field.of("city").equal("London"), Field.of("status").equal("active")) Args: *conditions: The filter conditions to 'OR' together. rsrcrt)NorFrvrwrxrdrrr'ryz Or.__init__rzr{rrrdrrDr|rDcrr)Xora Represents an expression that performs a logical 'XOR' (exclusive OR) operation on multiple filter conditions. Example: >>> # Check if only one of the conditions is true: 'age' greater than 18, 'city' is "London", >>> # or 'status' is "active". >>> Xor(Field.of("age").greater_than(18), Field.of("city").equal("London"), Field.of("status").equal("active")) Args: *conditions: The filter conditions to 'XOR' together. rsSequence['BooleanExpression']crt)NxorFrvrwrxrdrrr'ryz Xor.__init__)rsrr{rrrdrrr|rcs"eZdZdZd fdd ZZS) Conditionala2 Represents a conditional expression that evaluates to a 'then' expression if a condition is true and an 'else' expression if the condition is false. Example: >>> # If 'age' is greater than 18, return "Adult"; otherwise, return "Minor". >>> Conditional(Field.of("age").greater_than(18), Constant.of("Adult"), Constant.of("Minor")); Args: condition: The condition to evaluate. then_expr: The expression to return if the condition is true. else_expr: The expression to return if the condition is false r}r then_exprr else_exprcstjd|||gdddS)N conditionalFrvrw)r&r}rrrdrrr's  zConditional.__init__)r}rrr rr r{rrrdrrsrcs$eZdZdZddfdd ZZS) Counta Represents an aggregation that counts the number of stage inputs with valid evaluations of the expression or field. Example: >>> # Count the total number of products >>> Field.of("productId").count().as_("totalProducts") >>> Count(Field.of("productId")) >>> Count().as_("count") Args: expression: The expression or field to count. If None, counts all stage inputs. Nr.Expression | Nonecs(|r|gng}tjd|t|ddS)Nrrv)rbr'r)r&r.expression_listrdrrr'szCount.__init__r:)r.rr{rrrdrrsrcs eZdZdZfddZZS)CurrentTimestampzCreates an expression that returns the current timestamp Returns: A new `Expression` representing the current timestamp. cstjdgdddS)Ncurrent_timestampFrvrwr3rdrrr'ryzCurrentTimestamp.__init__r{rrrdrrsr)2r5 __future__rtypingrrrrabcrrenumr datetime(google.cloud.firestore_v1.types.documentr %google.cloud.firestore_v1.types.queryr r> google.cloud.firestore_v1.vectorr "google.cloud.firestore_v1._helpersrrrr$r@r?rbytesrrr rIrbrr#r4rr!rrJrFrFrLrDrrrrrrrrsn          */ $%C