U ~fht<@s UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m ZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-dd l.m/Z/dd l0m1Z1m2Z2m3Z3m4Z4dd l5m6Z6m7Z7m8Z8m9Z9m:Z:dd l;mZ>ddl?m@Z@mAZAmBZBddlCmDZDddlEmFZFddlGmHZHddlImJZJddlKmLZLddlMmNZNmOZOddlPmQZQddlRmSZSerddlTmUZUddlVmWZWmXZXzddlYmZZZdZ[Wne\k rdZ[YnXddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWgeejeiZiZeD]"ZeeŐd reeeej< qeddԄeDZȐdYddrdddddڐdddZdrdrdddڐdddZʐdZdrddddڐddd Ze[ r0eZjZe̐d!Zde1fd"dddڐd#d$dNZe$d[d%d&d'd(d)dOZe$d%ddϐd(d*dOZϐd\d%d+d,d(d-dOZϐd%dΐd.dМd/d0Ze[ reZjZe$d]d%d&d1d(d2dPZe$d%dΐd.d(d3dPZѐd^d%d+d4d(d5dPZdrdrddϐd6d7d8ZҐd9ddtd:d;Ze[ r~eZjZdrd&d<d=d>Zdrddrd.d?d@dAZe$d_dڐd&dBd(dCdQZe$ddΐdDd(dEdQZ֐d`dڐd+dFd(dGdQZe$dadHd&dBdIdJdRZe$dHdΐdDdIdKdRZאdbdHd+dFdIdLdRZdddMdNdSZGdOdTdTeZddלdPdUZڐd&dלdQdRZeedS rejeېdTdS(cav BSON (Binary JSON) encoding and decoding. The mapping from Python types to BSON types is as follows: ======================================= ============= =================== Python Type BSON Type Supported Direction ======================================= ============= =================== None null both bool boolean both int [#int]_ int32 / int64 py -> bson :class:`bson.int64.Int64` int64 both float number (real) both str string both list array both dict object both :class:`~bson.son.SON` object both :py:class:`~collections.abc.Mapping` object py -> bson :class:`~bson.raw_bson.RawBSONDocument` object both [#raw]_ datetime.datetime [#dt]_ [#dt2]_ UTC datetime both :class:`~bson.datetime_ms.DatetimeMS` UTC datetime both [#dt3]_ :class:`~bson.regex.Regex` regex both compiled re [#re]_ regex py -> bson :class:`~bson.binary.Binary` binary both :py:class:`uuid.UUID` [#uuid]_ binary both :class:`~bson.objectid.ObjectId` oid both :class:`~bson.dbref.DBRef` dbref both :class:`~bson.dbref.DBRef` dbpointer bson -> py None undefined bson -> py :class:`~bson.code.Code` code both str symbol bson -> py bytes [#bytes]_ binary both :class:`~bson.timestamp.Timestamp` timestamp both :class:`~bson.decimal128.Decimal128` decimal128 both :class:`~bson.min_key.MinKey` min key both :class:`~bson.max_key.MaxKey` max key both ======================================= ============= =================== .. [#int] A Python int will be saved as a BSON int32 or BSON int64 depending on its size. A BSON int32 will always decode to a Python int. A BSON int64 will always decode to a :class:`~bson.int64.Int64`. .. [#raw] Decoding a bson object to :class:`~bson.raw_bson.RawBSONDocument` can be optionally configured via :attr:`~bson.codec_options.CodecOptions.document_class`. .. [#dt] datetime.datetime instances are encoded with millisecond precision so the microsecond field is truncated. .. [#dt2] all datetime.datetime instances are encoded as UTC. By default, they are decoded as *naive* but timezone aware datetimes are also supported. See :doc:`/examples/datetimes` for examples. .. [#dt3] To enable decoding a bson UTC datetime to a :class:`~bson.datetime_ms.DatetimeMS` instance see :ref:`handling-out-of-range-datetimes`. .. [#uuid] For :py:class:`uuid.UUID` encoding and decoding behavior see :doc:`/examples/uuid`. .. [#re] :class:`~bson.regex.Regex` instances and regular expression objects from ``re.compile()`` are both saved as BSON regular expressions. BSON regular expressions are decoded as :class:`~bson.regex.Regex` instances. .. [#bytes] The bytes type is encoded as BSON binary with subtype 0. It will be decoded back to bytes. ) annotationsN) utf_8_decode) utf_8_encode)abc)IO TYPE_CHECKINGAnyBinaryIOCallable GeneratorIteratorMappingMutableMappingNoReturnOptionalSequenceTupleTypeTypeVarUnioncastoverload)ALL_UUID_SUBTYPES CSHARP_LEGACY JAVA_LEGACYOLD_UUID_SUBTYPESTANDARD UUID_SUBTYPEBinaryUuidRepresentation)Code)DEFAULT_CODEC_OPTIONS CodecOptionsDatetimeConversion_raw_document_class) EPOCH_AWARE EPOCH_NAIVE DatetimeMS_datetime_to_millis_millis_to_datetime)DBRef) Decimal128) InvalidBSONInvalidDocumentInvalidStringData)Int64MaxKeyMinKeyObjectId)Regex)RE_TYPESON) Timestamp)utcRawBSONDocument) _DocumentType_ReadableBuffer)_cbsonTFrrrrrrrrr r!r"r*r+r,r-r.r/r1r3r5r6r7r8r9r:r%r&BSONNUMBSONSTRBSONOBJBSONARRBSONBINBSONUNDBSONOIDBSONBOOBSONDATBSONNULBSONRGXBSONREFBSONCODBSONSYMBSONCWSBSONINTBSONTIMBSONLONBSONDECBSONMINBSONMAXget_data_and_view gen_list_nameencodedecode decode_all decode_iterdecode_file_iteris_validBSONhas_cr#r'     zrcCsd|fSrvr}rr}r}r~rrcCs t|fSrvr2rr}r}r~rrcCs t|fSrvr0rr}r}r~rrz)dict[int, Callable[..., Tuple[Any, int]]]rboolTuple[str, Any, int])rtr|rrr raw_arrayruc Cstdt|||||S)Nr)rr?_element_to_dict)rtr|rrrrr}r}r~rsrc Cs||}|d7}t||||\}}|r`|ttkr`t||t|\}} |||| d| dfSzt|||||||\} }Wntk rt||YnX|jj r|jj t | } | dk r| | } || |fS)z Decode a single key, value pair.rN) rordrCrlenrrrrrrr) rtr|rrrrrr_rrrr}r}r~r's,  _T)boundzCodecOptions[RawBSONDocument])rtrrrrrruc Cs(t|\}}ttt|||||||dS)Nr)rUrrr)rtrrrrrr|r}r}r~ _raw_to_dictHs  r)rtr|rrrrrruc CsX|dkr|}|d}||krDt||||||d\}} }| ||<q||krTtd|S)z#Decode a BSON document into result.Nrrbad object or element length)rrr,) rtr|rrrrrrkeyrr}r}r~rVs   rzCodecOptions[_DocumentType]r=)rtrrucCst|\}}zDt|jr&|||WSt|dt|\}}tdt||d||WStk rfYn6tk rt \}}}tt | |dYnXdS)z'Decode a BSON string to document_class.rr=rN) rUr$rrrrrr, Exceptionsysexc_inforwith_traceback)rtrr|rr exc_valueexc_tbr}r}r~ _bson_to_dictms  rccs |]}t|ddVqdS)utf8N)rrW).0ir}r}r~ srzGenerator[bytes, None, None])ruccs2tEdHtd}tt|ddVqdS)zGenerate "keys" for encoded lists in the sequence b"0", b"1", b"2", ... The first 1000 keys are returned from a pre-built cache. All subsequent keys are generated on the fly. Nrrr) _LIST_NAMES itertoolscountrnextrW)counterr}r}r~rVs  zUnion[str, bytes]rx)stringrucCszt|trVd|krtdzt|dd|dWStk rRtd|dYqvXn d|krftdt|ddSdS)z8Make a 'C' string, checking for embedded NUL characters.rz;BSON keys / regex patterns must not contain a NUL characterNT,strings in documents must be valid UTF-8: %rrr)rwrxr-r UnicodeErrorr. _utf_8_encoderr}r}r~_make_c_string_checks    rcCsZt|trFzt|dd|dWStk rBtd|dYqVXnt|ddSdS)zMake a 'C' string.NTrrr)rwrxrrr.rrr}r}r~_make_c_strings    rcCs d|krtdt|ddS)z*Make a 'C' string suitable for a BSON key.rz*BSON keys must not contain a NUL characterrr)r-rrr}r}r~ _make_namesrfloat)namerrrrucCsd|t|S)zEncode a float.r_) _PACK_FLOATrrrrr}r}r~ _encode_floatsrcCsd|tt|d|S)zEncode a python bytes.rcr) _PACK_INTrrr}r}r~ _encode_bytessr )rr check_keysrrucsZt|rd|tt|jSdfdd|D}d|tt|d|dS)zEncode a mapping type.rarcsg|]\}}t||qSr})_element_to_bson)rrvalr rr}r~ sz#_encode_mapping..rr)r$rrxrawjoinitemsr rrrr rrtr}rr~_encode_mappingsrcCstd|d}t|d}|td|j||7}|td|j||7}|jdk rb|td|j||7}|jD]\}}|t||||7}ql|d7}t t|||||d<t |S) zEncode bson.dbref.DBRef.rasrs$refs$idNs$dbr) ryr_name_value_to_bsonridZdatabaseZ_DBRef__kwargsrr r rx)rrr rbufbeginrr r}r}r~ _encode_dbrefs  rz Sequence[Any]csBtdfdd|D}d|tt|d|dS)zEncode a list/tuple.rcsg|]}tt|qSr})rr)ritemr lnamerr}r~rsz _encode_list..rbrr)rVrr rrr}rr~ _encode_listsrcCs,t|d}d|tt|d|dS)zEncode a python str.rr`rr)rr r)rrrrZbvaluer}r}r~ _encode_texts rcCs8|j}|dkrtt||}d|tt|||S)zEncode bson.binary.Binary.rrc)rr r_PACK_LENGTH_SUBTYPE)rrrrrr}r}r~_encode_binarysr z uuid.UUID)rrrrrucCs"|j}tj||d}t||||S)zEncode uuid.UUID.)r)rrZ from_uuidr )rrrrrZbinvalr}r}r~ _encode_uuidsr!)rrrrrucCsd||jS)zEncode bson.objectid.ObjectId.re)binary)rrrrr}r}r~_encode_objectidsr#cCsd||rdpdS)z%Encode a python boolean (True/False).rfr_rr}rr}r}r~ _encode_boolsr$zdatetime.datetimecCst|}d|t|SzEncode datetime.datetime.rg)r( _PACK_LONGrrrrZmillisr}r}r~_encode_datetime sr(cCst|}d|t|Sr%)rr&r'r}r}r~_encode_datetime_mssr))rrrrrucCsd|S)zEncode python None.rhr}rrrrr}r}r~ _encode_nonesr+z Regex[Any]cCs|j}|tjkr&d|t|jdS|dkrDd|t|jdSd}|tj@rZ|d7}|tj@rl|d7}|tj@r~|d7}|tj@r|d 7}|tj@r|d 7}|tj @r|d 7}|d7}d|t|j|Sd S) z*Encode a python regex or bson.regex.Regex.risurrrilmsuxN) flagsreUNICODErr IGNORECASELOCALE MULTILINEDOTALLVERBOSE)rrrrr2Zsflagsr}r}r~ _encode_regexs(       r:cCsnt|}t|}|jdkr.d|t||St|jd|d}td|t|}d||t|||S)zEncode bson.code.Code.NrkFrrm)rrrr  _dict_to_bson)rrrrZcstringZcstrlenrZ full_lengthr}r}r~ _encode_code5s r<cCs`d|krdkr(nnd|t|Szd|t|WStjk rZtddYnXdS)zEncode a python int.iirnrp&BSON can only handle up to 8-byte intsN)r r&rr OverflowErrorrr}r}r~ _encode_int@s r?cCsd|t|j|jS)z Encode bson.timestamp.Timestamp.ro)_PACK_TIMESTAMPrtimerr}r}r~_encode_timestampKsrBcCs8zd|t|WStjk r2tddYnXdS)zEncode a bson.int64.Int64.rpr=N)r&rrr>rr}r}r~ _encode_longPsrCcCsd||jS)z"Encode bson.decimal128.Decimal128.rq)bidrr}r}r~_encode_decimal128XsrEcCsd|S)zEncode bson.min_key.MinKey.rrr}r*r}r}r~_encode_minkey]srFcCsd|S)zEncode bson.max_key.MaxKey.rsr}r*r}r}r~_encode_maxkeybsrG _type_markerccs|] }|VqdSrvr})rtr}r}r~rs)rrr rin_custom_callin_fallback_callruc Csfd}ztt|||||WStk r0Yn$tk rRt|tsJd}YnXt|dd}t|tr|tkrt|}|tt|<|||||S|s|jj r|jj t|} | dk rt || |||ddSt D]8} |st|| rt| }|tt|<|||||Sq|jj } |s<| dk rrwrgetattr_MARKERSrZ _encoder_maprr_BUILT_IN_TYPESZ_fallback_encoderr-) rrr rrJrKZwas_integer_overflowmarkerfuncZcustom_encoderbaseZfallback_encoderr}r}r~rsR       r)rrr rrucCsdt|tstd||rN|dr6td|dd|krNtd|dt|}t||||S)z Encode a single key, value pair.z.documents must have only string keys, key was $zkey z must not start with '$'.z must not contain '.')rwrr- startswithrr)rrr rrr}r}r~r s  r )docr r top_levelrucCst|rtt|jSz^g}|r>d|kr>|td|d|||D](\}}|rZ|dkrF|t||||qFWn$tk rt d|dYnXd |}t t |d|dS)zEncode a document to BSON.Z_ids_idz)encoder expected a mapping type but got: Nrrr) r$rrxrrrrr AttributeError TypeErrorrr r)rVr rrWelementsrrencodedr}r}r~r;s    r;z1codec_options must be an instance of CodecOptionsMapping[str, Any])documentr  codec_optionsrucCst|tstt|||S)aEncode a document to BSON. A document can be any mapping type (like :class:`dict`). Raises :class:`TypeError` if `document` is not a mapping type, or contains keys that are not instances of :class:`str`. Raises :class:`~bson.errors.InvalidDocument` if `document` cannot be converted to :class:`BSON`. :param document: mapping type representing a document :param check_keys: check if keys start with '$' or contain '.', raising :class:`~bson.errors.InvalidDocument` in either case :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionadded:: 3.9 )rwr"_CODEC_OPTIONS_TYPE_ERRORr;)r]r r^r}r}r~rWs r>Nonedict[str, Any])rtr^rucCsdSrvr}rtr^r}r}r~rXscCsdSrvr}rbr}r}r~rX"sz%Optional[CodecOptions[_DocumentType]]$Union[dict[str, Any], _DocumentType]cCs&|pt}t|tsttdt||S)aDecode BSON to a document. By default, returns a BSON document represented as a Python :class:`dict`. To use a different :class:`MutableMapping` class, configure a :class:`~bson.codec_options.CodecOptions`:: >>> import collections # From Python standard library. >>> import bson >>> from bson.codec_options import CodecOptions >>> data = bson.encode({'a': 1}) >>> decoded_doc = bson.decode(data) >>> options = CodecOptions(document_class=collections.OrderedDict) >>> decoded_doc = bson.decode(data, codec_options=options) >>> type(decoded_doc) :param data: the BSON to decode. Any bytes-like object that implements the buffer protocol. :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionadded:: 3.9 rc)r!rwr"r_rr)rtr^rr}r}r~rX's zlist[_DocumentType]c Cst|\}}t|}g}d}|d}t|j}z||krt||d}|||krZtd||d} || dkrztd|r||||| d|n|t|||d| |||7}q0|WStk rYn8tk rt \} } } tt |  | dYnXdS)z)Decode a BSON data to multiple documents.rrzinvalid object sizerrN) rUrr$rrr,rrrrrrr) rtrr|Zdata_lenZdocsrrZuse_rawrrrrrr}r}r~ _decode_allIs0       rdzlist[dict[str, Any]]cCsdSrvr}rbr}r}r~rYkscCsdSrvr}rbr}r}r~rYpsz0Union[list[dict[str, Any]], list[_DocumentType]]cCs*|dkrt|tSt|ts tt||S)a+Decode BSON data to multiple documents. `data` must be a bytes-like object implementing the buffer protocol that provides concatenated, valid, BSON-encoded documents. :param data: BSON data :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionchanged:: 3.9 Supports bytes-like objects that implement the buffer protocol. .. versionchanged:: 3.0 Removed `compile_re` option: PyMongo now always represents BSON regular expressions as :class:`~bson.regex.Regex` objects. Use :meth:`~bson.regex.Regex.try_compile` to attempt to convert from a BSON regular expression to a Python regular expression object. Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with `codec_options`. N)rdr!rwr"r_rbr}r}r~rYws   )rawdocfieldsr^rucCsvt|jri}n|}|D]P\}}||krh||dkrRt|j||||<qpt||||||<q |||<q |S)Nr)r$rrrr_decode_selective)rerfr^rVrrr}r}r~rgs    rgzUnion[memoryview, bytes]cCsd}t|}t||t|\}}|d7}g}|j}||dkr||dkrT|d7}q>|d7}t|||\}}|||||||7}q2||krtdd|S)Nrrrrr)rzrrrr,r)rtrr|rrbuffersrrr}r}r~_array_of_documents_to_buffers     ri)r]rucCsP|d}|sdSdD]4}||}|s*qt|}|rB|g||<qg||<qdS)z=Convert raw array of documents to a stream of BSON documents.cursorN)Z firstBatchZ nextBatch)rri)r]rjrbatchrtr}r}r~&_convert_raw_document_lists_to_streamss   rl)rtr^rfrucCsZ|jjst||S|s(t||jddSddlm}|j|dd}t||}t|||gS)aWDecode BSON data to a single document while using user-provided custom decoding logic. `data` must be a string representing a valid, BSON-encoded document. :param data: BSON data :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions` with user-specified type decoders. If no decoders are found, this method is the same as ``decode_all``. :param fields: Map of document namespaces where data that needs to be custom decoded lives or None. For example, to custom decode a list of objects in 'field1.subfield1', the specified value should be ``{'field1': {'subfield1': 1}}``. If ``fields`` is an empty map or None, this method is the same as ``decode_all``. :return: Single-member list containing the decoded document. .. versionadded:: 3.8 N)rrr;)rr)rrrYZ with_options bson.raw_bsonr<rrg)rtr^rfr<Zinternal_codec_options_docr}r}r~_decode_all_selectives    rozIterator[dict[str, Any]]cCsdSrvr}rbr}r}r~rZszIterator[_DocumentType]cCsdSrvr}rbr}r}r~rZ sz8Union[Iterator[dict[str, Any]], Iterator[_DocumentType]]ccsf|pt}t|tstd}t|d}||krbt||d}||||}||7}t||Vq&dS)aDecode BSON data to multiple documents as a generator. Works similarly to the decode_all function, but yields one document at a time. `data` must be a string of concatenated, valid, BSON-encoded documents. :param data: BSON data :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionchanged:: 3.0 Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with `codec_options`. .. versionadded:: 2.8 rrN)r!rwr"r_rrr)rtr^rrrrrZr}r}r~rZs  zUnion[BinaryIO, IO[bytes]])file_objr^rucCsdSrvr}rpr^r}r}r~r[2scCsdSrvr}rqr}r}r~r[9sccsf|pt}|d}|sqbnt|dkr.tdt|ddd}||td|}t||VqdS)aDecode bson data from a file to multiple documents as a generator. Works similarly to the decode_all function, but reads from the file object in chunks and parses bson in chunks, yielding one document at a time. :param file_obj: A file object containing BSON data. :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionchanged:: 3.0 Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with `codec_options`. .. versionadded:: 2.8 rzcut off in middle of objsizerN)r!readrr,rmaxr)rpr^rZ size_datarrZr}r}r~r[@s  )bsonrucCs>t|tstdzt|tWdStk r8YdSXdS)aCheck that the given string represents valid :class:`BSON` data. Raises :class:`TypeError` if `bson` is not an instance of :class:`bytes`. Returns ``True`` if `bson` is valid :class:`BSON`, ``False`` otherwise. :param bson: the data to be validated z4BSON data must be an instance of a subclass of bytesTFN)rwrxrYrr!r)rtr}r}r~r\`s  c@sDeZdZdZedefdddddddd Zefdd d d d ZdS)r]zBSON (Binary JSON) data. .. warning:: Using this class to encode and decode BSON adds a performance cost. For better performance use the module level functions :func:`encode` and :func:`decode` instead. Fz Type[BSON]r\rr)clsr]r r^rucCs|t|||S)aEncode a document to a new :class:`BSON` instance. A document can be any mapping type (like :class:`dict`). Raises :class:`TypeError` if `document` is not a mapping type, or contains keys that are not instances of :class:`str'. Raises :class:`~bson.errors.InvalidDocument` if `document` cannot be converted to :class:`BSON`. :param document: mapping type representing a document :param check_keys: check if keys start with '$' or contain '.', raising :class:`~bson.errors.InvalidDocument` in either case :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionchanged:: 3.0 Replaced `uuid_subtype` option with `codec_options`. )rW)rur]r r^r}r}r~rW{sz BSON.encodera)r^rucCs t||S)aDecode this BSON data. By default, returns a BSON document represented as a Python :class:`dict`. To use a different :class:`MutableMapping` class, configure a :class:`~bson.codec_options.CodecOptions`:: >>> import collections # From Python standard library. >>> import bson >>> from bson.codec_options import CodecOptions >>> data = bson.BSON.encode({'a': 1}) >>> decoded_doc = bson.BSON(data).decode() >>> options = CodecOptions(document_class=collections.OrderedDict) >>> decoded_doc = bson.BSON(data).decode(codec_options=options) >>> type(decoded_doc) :param codec_options: An instance of :class:`~bson.codec_options.CodecOptions`. .. versionchanged:: 3.0 Removed `compile_re` option: PyMongo now always represents BSON regular expressions as :class:`~bson.regex.Regex` objects. Use :meth:`~bson.regex.Regex.try_compile` to attempt to convert from a BSON regular expression to a Python regular expression object. Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with `codec_options`. )rX)selfr^r}r}r~rXs z BSON.decodeN)__name__ __module__ __qualname____doc__ classmethodr!rWrXr}r}r}r~r]sscCstS)zIs the C extension installed?)_USE_Cr}r}r}r~r^scCstjrtjdS)z!Releases the ObjectID lock child.N)r5Z _inc_locklockedreleaser}r}r}r~ _after_forks rregister_at_fork)after_in_child)F)F)F)NF)FF)T)N)N)N)N)N)N)N)N)rz __future__rdatetimerosr3rruuidcodecsrrrr collectionsr_abctypingrrrr r r r r rrrrrrrrrrZ bson.binaryrrrrrrrrZ bson.coder Zbson.codec_optionsr!r"r#r$Zbson.datetime_msr%r&r'r(r)Z bson.dbrefr*Zbson.decimal128r+Z bson.errorsr,r-r.Z bson.int64r/Z bson.max_keyr1Z bson.min_keyr3Z bson.objectidr5Z bson.regexr6Zbson.sonr7r8Zbson.timestampr9Z bson.tz_utilr:rmr<Z bson.typingsr=r>rtr?r| ImportError__all__r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTStruct unpack_fromrunpackZ _UNPACK_INTrrrrrUrrrrrrrrrrrrrrrrrrrrr__annotations__rrrrrrpackrr rr&r@tuplerangerrVrrrrr rrrrr r!r#r$r(r)r+r:r<r?rBrCrErFrGrrxdictrrlistrUUIDrLrNZ_typhasattrrHrOrr r;rYr_rWrXrdrYrgrirlrorZr[r\r]r^rrr}r}r}r~s9    P(             ?      *%               "D """!- #  G