o }l~i0@sdZddlmZddlZddlmZddlmZmZm Z m Z dZ dZ dZ d Zd Zed Zd ZeeZed ZedZgdZdddeDZeeZd(ddZd)ddZd*ddZd+dd ZeZd,d$d%ZGd&d'd'e Z!dS)-zBUtilities for managing / converting field paths to / from strings.) annotationsN)abc)AnyIterablecastMutableMappingz!{!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\.|ccs|]}dj|VqdS)z (?P<{}>{})N)format).0pairrk/var/www/newdalilibackend/backend/venv/lib/python3.10/site-packages/google/cloud/firestore_v1/field_path.py (srpathstrccszd}tj}||}|dur)tt|j}||}|V|}|||}|dus|t|kr;td |||ddS)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_REGEXmatchrr lastgroupgroupendlen ValueErrorr)rpos get_tokenrtype_valuerrr_tokenize_field_path,s    r# str | NonecCs||sgSg}d}t|D]$}|r|dkrtd|d}q |dkr)td|||d}q |r5|s>> 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) r4 enumerate isinstancerMapping_FIELD_PATH_MISSING_TOPrKeyErrorr;_FIELD_PATH_MISSING_KEY_FIELD_PATH_WRONG_TYPE)r<r=r2 nested_dataindexr3msgpartialrrrget_nested_values 6     rJc@seZdZdZd#ddZed$d d Zed%d d ZddZddZ ddZ ddZ ddZ d&ddZ d'ddZd(ddZed&d d!Zd"S)) FieldPathaField Path object for client use. A field path is a sequence of element keys, separated by periods. Each element key can be either a simple identifier, or a full unicode string. In the string representation of a field path, non-identifier elements must be quoted using backticks, with internal backticks and backslashes escaped with a backslash. Args: parts: (one or more strings) Indicating path of the key to be used. partsrcGs2|D]}t|tr |sd}t|qt||_dS)Nz3One or more components is not a string or is empty.)r@rrtuplerL)selfrLparterrorrrr__init__ s zFieldPath.__init__r*return 'FieldPath'cCs |}|s td|t|S)aFactory: create a FieldPath from the string formatted per the API. Args: api_repr (str): a string path, with non-identifier elements quoted It cannot exceed 1500 characters, and cannot be empty. Returns: (:class:`FieldPath`) An instance parsed from ``api_repr``. Raises: ValueError if the parsing fails z.Field path API representation cannot be empty.)striprr4)clsr*rrr from_api_reprs  zFieldPath.from_api_repr path_stringcCs`z||WSty/|d}|D]}|stdt|r(td|qt|YSw)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: {})rVrsplit_LEADING_ALPHA_INVALIDrrrK)rUrWr&r(rrr from_string"s     zFieldPath.from_stringcCs6d}|jD] }|d|d7}q|dd}d|S)N'z',r+z FieldPath({}))rLr)rNpathsrOrrr__repr__>s    zFieldPath.__repr__cCs t|SN)hash to_api_reprrNrrr__hash__Es zFieldPath.__hash__cCst|tr |j|jkStSr_r@rKrLNotImplementedrNotherrrr__eq__H  zFieldPath.__eq__cCst|tr |j|jkStSr_rdrfrrr__lt__MrizFieldPath.__lt__cCsFt|tr|j|j}t|St|tr!|jt|j}t|StS)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@rKrLrrZre)rNrgrLrrr__add__Rs   zFieldPath.__add__cCs t|jS)zRender a quoted string representation of the FieldPath Returns: (str) Quoted string representation of the path stored within this FieldPath. )r;rLrbrrrrabs zFieldPath.to_api_reprboolcCs(|jdt|j|jdt|jkS)zCheck whether ``other`` is an ancestor. Returns: (bool) True IFF ``other`` is an ancestor or equal to ``self``, else False. N)rLrrfrrr eq_or_parentks(zFieldPath.eq_or_parentset['FieldPath']cs"tdtj}fdd|DS)zVReturn field paths for all parents. Returns: Set[:class:`FieldPath`] r,csh|] }tjd|qSr_)rKrL)rrGrbrr zsz$FieldPath.lineage..)rangerrL)rNindexesrrbrlineagetszFieldPath.lineagecCsdS)zA special FieldPath value to refer to the ID of a document. It can be used in queries to sort or filter by the document ID. Returns: A special sentinel value to refer to the ID of a document. __name__rrrrr document_id|szFieldPath.document_idN)rLr)r*rrRrS)rWrrRrS)rRr)rRrl)rRrn)rs __module__ __qualname____doc__rQ classmethodrVrZr^rcrhrjrkrarmrr staticmethodrtrrrrrKs"     rK)rr)rr$)r*r)r2r5)r<rr=r>)"rw __future__rre collectionsrtypingrrrrrBrDrEr7r1r0r/r.compiler6rYPATH_ELEMENT_TOKENSr8TOKENS_PATTERNrr#r)r4r;get_field_pathrJobjectrKrrrrs4        # ) M