B ˆuf30ã@sìdZddlmZddlZddlmZdZdZdZdZ d Z e d Z d Z e e Z e d ¡Ze d ¡ZdddgZd dd„eDƒ¡Ze e¡Zedœdd„Zedœdd„Zedœdd„Zeedœdd„ZeZeedœd d!„ZGd"d#„d#eƒZdS)$zBUtilities for managing / converting field paths to / from strings.é)ÚabcN)ÚIterablez!{!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]*[^_a-zA-Z0-9])ÚSIMPLEz[_a-zA-Z][_a-zA-Z0-9]*)ZQUOTEDz`(?:\\`|[^`])*?`)ÚDOTz\.ú|ccs|]}dj|ŽVqdS)z (?P<{}>{})N)Úformat)Ú.0Úpair©rúf/home/ankuromar296_gmail_com/myenv/lib/python3.7/site-packages/google/cloud/firestore_v1/field_path.pyú *sr)Úpathccspd}tj}||ƒ}x4|dk rF|j}| |¡}|V| ¡}|||ƒ}qW|t|ƒkrltd |||d…¡ƒ‚dS)z‘Lex 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_REGEXÚmatchÚ lastgroupÚgroupÚendÚlenÚ ValueErrorr )rÚposÚ get_tokenrÚtype_ÚvaluerrrÚ_tokenize_field_path.s   rcCs‚|sgSg}d}xVt|ƒD]J}|r@|dkr:td |¡ƒ‚qdd}q|dkrVtd |¡ƒ‚| |¡d}qW|rp|s~td |¡ƒ‚|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)rrr Úappend)rÚelementsZwant_dotÚelementrrrÚsplit_field_pathCs  r!)Úapi_reprcCs`g}xVt|ƒD]J}|ddkrN|ddkrN|dd…}| tt¡}| tt¡}| |¡qW|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)r"Ú field_namesÚ field_namerrrÚparse_field_pathfs   r,)r*cCsjg}xZ|D]R}t |¡}|r6| d¡|kr6| |¡q | tt¡ tt¡}| t|t¡q Wt   |¡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_NAMErrrr%r)r(r'r&Ú_FIELD_PATH_DELIMITERÚjoin)r*Úresultr+rZreplacedrrrÚrender_field_pathƒs    r1)Ú field_pathÚdatacCsªt|ƒ}|}x˜t|ƒD]Œ\}}t|tjƒr~||kr<||}q¢|dkrXt |¡}t|ƒ‚q¢t|d|…ƒ}t  ||¡}t|ƒ‚qt|d|…ƒ}t  ||¡}t|ƒ‚qW|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) r,Ú enumerateÚ isinstancerÚMappingÚ_FIELD_PATH_MISSING_TOPr ÚKeyErrorr1Ú_FIELD_PATH_MISSING_KEYÚ_FIELD_PATH_WRONG_TYPE)r2r3r*Z nested_dataÚindexr+ÚmsgÚpartialrrrÚget_nested_value¯s 6        r>c@sˆeZdZdZdd„Zeedœdd„ƒZeedœdd „ƒZd d „Z d d „Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zedd„ƒZdS)Ú FieldPathaÛField 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. cGs6x&|D]}t|tƒr|sd}t|ƒ‚qWt|ƒ|_dS)Nz3One or more components is not a string or is empty.)r5ÚstrrÚtupleÚparts)ÚselfrBÚpartÚerrorrrrÚ__init__ s   zFieldPath.__init__)r"cCs | ¡}|stdƒ‚|t|ƒŽS)a€Factory: 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.)Ústriprr,)Úclsr"rrrÚ from_api_reprs zFieldPath.from_api_repr)Ú path_stringcCsdy | |¡Stk r^| d¡}x0|D](}|s:tdƒ‚t |¡r*td |¡ƒ‚q*Wt|ŽSXdS)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 elementz3Non-alphanum char in element with leading alpha: {}N)rIrÚsplitÚ_LEADING_ALPHA_INVALIDrr r?)rHrJrr rrrÚ from_string$s     zFieldPath.from_stringcCs:d}x|jD]}|d|d7}q W|dd…}d |¡S)NÚú'z',r#z FieldPath({}))rBr )rCÚpathsrDrrrÚ__repr__Bs   zFieldPath.__repr__cCs t| ¡ƒS)N)ÚhashÚ to_api_repr)rCrrrÚ__hash__IszFieldPath.__hash__cCst|tƒr|j|jkStS)N)r5r?rBÚNotImplemented)rCÚotherrrrÚ__eq__Ls  zFieldPath.__eq__cCst|tƒr|j|jkStS)N)r5r?rBrU)rCrVrrrÚ__lt__Qs  zFieldPath.__lt__cCsJt|tƒr|j|j}t|ŽSt|tƒrB|jt |¡j}t|ŽStSdS)zØAdds `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`. N)r5r?rBr@rMrU)rCrVrBrrrÚ__add__Vs   zFieldPath.__add__cCs t|jƒS)z¶Render a quoted string representation of the FieldPath Returns: (str) Quoted string representation of the path stored within this FieldPath. )r1rB)rCrrrrSfszFieldPath.to_api_reprcCs(|jdt|jƒ…|jdt|jƒ…kS)z¥Check whether ``other`` is an ancestor. Returns: (bool) True IFF ``other`` is an ancestor or equal to ``self``, else False. N)rBr)rCrVrrrÚ eq_or_parentoszFieldPath.eq_or_parentcs"tdtˆjƒƒ}‡fdd„|DƒS)zVReturn field paths for all parents. Returns: Set[:class:`FieldPath`] r$csh|]}tˆjd|…Ž’qS)N)r?rB)r r;)rCrrú ~sz$FieldPath.lineage..)ÚrangerrB)rCZindexesr)rCrÚlineagexszFieldPath.lineagecCsdS)zÜA 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)r^Ú __module__Ú __qualname__Ú__doc__rFÚ classmethodr@rIrMrQrTrWrXrYrSrZr]Ú staticmethodr_rrrrr?üs  r?)rbÚ collectionsrÚreÚtypingrr7r9r:r.r)r(r'r&Úcompiler-rLZPATH_ELEMENT_TOKENSr/ZTOKENS_PATTERNrr@rr!r,r1Zget_field_pathÚdictr>Úobjectr?rrrrÚs2     #)M