Ѯh-0JdZddlmZddlZddlmZddlmZmZdZ dZ dZ d Z d Z e d zZd Ze ezZej"d Zej"dZgdZdj+deDZej"eZddZddZddZddZeZddZGddeZy)zBUtilities for managing / converting field paths to / from strings.) annotationsN)abc)Iterablecastz!{!r} is not contained in the dataz2{!r} is not contained in the data for the key {!r}zGThe data at {!r} is not a dictionary, so it cannot contain the key {!r}.\`z^[_a-zA-Z][_a-zA-Z0-9]*$z ^[_a-zA-Z][_a-zA-Z0-9]*[~*/\[\]]))SIMPLEz[_a-zA-Z][_a-zA-Z0-9]*)QUOTEDz`(?:\\`|[^`])*?`)DOTz\.|c#:K|]}dj|yw)z (?P<{}>{})N)format).0pairs v/home/www/academy-backend.kofcorporation.com/venv/lib/python3.12/site-packages/google/cloud/firestore_v1/field_path.py r(sU-,--t4Usc#2Kd}tj}||}|Ktt|j}|j |}||j }|||}|K|t|k7rtdj|||dyw)zLex a field path into tokens (including dots). Args: path (str): field path to be lexed. Returns: List(str): tokens rNz!Path {} not consumed, residue: {}) TOKENS_REGEXmatchrstr lastgroupgroupendlen ValueErrorr)pathpos get_tokenrtype_values r_tokenize_field_pathr#,s C""I dOE  S%//* E" iik$$    c$i<CCD$st*UVVs A'B*-Bc|sgSg}d}t|D]X}|r"|dk7rtdj|d}'|dk(rtdj||j|d}Z|r|stdj||S)aSplit a field path into valid elements (without dots). Args: path (str): field path to be lexed. Returns: List(str): tokens Raises: ValueError: if the path does not match the elements-interspersed- with-dots pattern. FrzInvalid path: {}T)r#rrappend)relementswant_dotelements rsplit_field_pathr)As  HH'-  #~ !3!:!:4!@AA #~ !3!:!:4!@AA OOG $H  8+224899 Ocg}t|D]\}|ddk(rA|ddk(r9|dd}|jtt}|jtt }|j |^|S)a;Parse a **field path** from into a list of nested field names. See :func:`field_path` for more on **field paths**. Args: api_repr (str): The unique Firestore api representation which consists of either simple or UTF-8 field names. It cannot exceed 1500 bytes, and cannot be empty. Simple field names match ``'^[_a-zA-Z][_a-zA-Z0-9]*$'``. All other field names are escaped by surrounding them with backticks. Returns: List[str, ...]: The list of field names in the field path. rr )r)replace_ESCAPED_BACKTICK _BACKTICK_ESCAPED_BACKSLASH _BACKSLASHr%)api_repr field_names field_names rparse_field_pathr6ds|$K&x0' a=C JrNc$9#Ab)J#++,=yIJ#++,> KJ:& ' r*cZg}|D]}tj|}|r&|jd|k(r|j|@|j t t j tt}|jt|ztztj|S)aCCreate a **field path** from a list of nested field names. A **field path** is a ``.``-delimited concatenation of the field names. It is used to represent a nested field. For example, in the data .. code-block:: python data = { 'aa': { 'bb': { 'cc': 10, }, }, } the field path ``'aa.bb.cc'`` represents that data stored in ``data['aa']['bb']['cc']``. Args: field_names: The list of field names. Returns: str: The ``.``-delimited field path. r) _SIMPLE_FIELD_NAMErrr%r.r2r1r0r/_FIELD_PATH_DELIMITERjoin)r4resultr5rreplaceds rrender_field_pathr=s4F!< "((4 U[[^z1 MM* %!))*6HIQQ,H MM)h.: ;< ! % %f --r*ct|}|}t|D]\}}t|tjr^||vr||}*|dk(r t j |}t|t|d|}tj ||}t|t|d|}tj ||}t||S)aGet a (potentially nested) value from a dictionary. If the data is nested, for example: .. code-block:: python >>> data { 'top1': { 'middle2': { 'bottom3': 20, 'bottom4': 22, }, 'middle5': True, }, 'top6': b' foo', } a **field path** can be used to access the nested data. For example: .. code-block:: python >>> get_nested_value('top1', data) { 'middle2': { 'bottom3': 20, 'bottom4': 22, }, 'middle5': True, } >>> get_nested_value('top1.middle2', data) { 'bottom3': 20, 'bottom4': 22, } >>> get_nested_value('top1.middle2.bottom3', data) 20 See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for more information on **field paths**. Args: field_path (str): A field path (``.``-delimited list of field names). data (Dict[str, Any]): The (possibly nested) data. Returns: Any: (A copy of) the value stored for the ``field_path``. Raises: KeyError: If the ``field_path`` does not match nested data. rN) r6 enumerate isinstancerMapping_FIELD_PATH_MISSING_TOPrKeyErrorr=_FIELD_PATH_MISSING_KEY_FIELD_PATH_WRONG_TYPE) field_pathdatar4 nested_dataindexr5msgpartials rget_nested_valuerLsl#:.KK&{3 z k3;; /[()*5 A:188DC"3-'/ FU0CDG188WMC"3-'' FU(;>#MN N$X.//r*c |j|S#t$r_|jd}|D]>}|s tdtj |s&tdj |t |cYSwxYw)aFactory: create a FieldPath from a unicode string representation. This method splits on the character `.` and disallows the characters `~*/[]`. To create a FieldPath whose components have those characters, call the constructor. Args: path_string (str): A unicode string which cannot contain `~*/[]` characters, cannot exceed 1500 bytes, and cannot be empty. Returns: (:class:`FieldPath`) An instance parsed from ``path_string``. rz Empty elementz.Invalid char in element with leading alpha: {})rYrsplit_LEADING_ALPHA_INVALIDrrrN)rX path_stringr&r(s r from_stringzFieldPath.from_string"s ($$[1 1 ("((-H# $_55)//8$HOOPWX  h' ' (sAA;#A;:A;cjd}|jD] }|d|zdzz }|dd}dj|S)N'z',r,z FieldPath({}))rQr)rRpathsrSs r__repr__zFieldPath.__repr__>sIJJ 'D S4Z$& &E 'cr %%e,,r*c4t|jSN)hash to_api_reprrRs r__hash__zFieldPath.__hash__EsD$$&''r*c`t|tr|j|jk(StSrer@rNrQNotImplementedrRothers r__eq__zFieldPath.__eq__Hs% eY '::, ,r*c`t|tr|j|jkStSrerkrms r__lt__zFieldPath.__lt__Ms% eY ':: + +r*ct|tr!|j|jz}t|St|tr4|jtj |jz}t|St S)zAdds `other` field path to end of this field path. Args: other (~google.cloud.firestore_v1._helpers.FieldPath, str): The field path to add to the end of this `FieldPath`. )r@rNrQrr^rl)rRrnrQs r__add__zFieldPath.__add__Rse eY 'JJ,Ee$ $ s #JJ!6!6u!=!C!CCEe$ $! !r*c,t|jS)zRender a quoted string representation of the FieldPath Returns: (str) Quoted string representation of the path stored within this FieldPath. )r=rQrhs rrgzFieldPath.to_api_reprbs!,,r*c|jdt|j|jdt|jk(S)zCheck whether ``other`` is an ancestor. Returns: (bool) True IFF ``other`` is an ancestor or equal to ``self``, else False. N)rQrrms r eq_or_parentzFieldPath.eq_or_parentks8zz,C ,-=Ns4::1OOOr*ctdt|j}|Dchc]}t|jd|c}Scc}w)zVReturn field paths for all parents. Returns: Set[:class:`FieldPath`] r-N)rangerrQrN)rRindexesrIs rlineagezFieldPath.lineagets< 3tzz?+rsI" !=NM  !^  *RZZ :;#$GH UATUUrzz.) W* F:&.R#JZIIr*