&g%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r SSK J r SSKJr SSKJrJrJrJrJrJrJrJrJrJrJrJrJrJ r J!r!J"r"J#r#J$r$ SSK%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r- SS K.J/r/ SS K0J1r1J2r2J3r3J4r4 SS K5J6r6J7r7J8r8J9r9J:r: SS K;Jr> SSK?J@r@JArAJBrB SSKCJDrD SSKEJFrF SSKGJHrH SSKIJJrJ SSKKJLrL SSKMJNrNJOrO SSKPJQrQ SSKRJSrS \(aSSKTJUrU SSKVJWrWJXrX SSKYJZrZ Sr[/SQr]Sr^Sr_Sr`S raS!rbS"rcS#rdS$reS%rfS&rgS'rhS(riS)rjS*rkS+rlS,rmS-rnS.roS/rpS0rqS1rr\R"S25Rru\R"S35Rrw\R"S35Rrx\R"S45Rry\R"S55Rrz\R"S65Rr{SS7jr|SS8jr}SS9jr~SS:jrSS;jrSS<jrSS=jrSS>jrSS?jrSS@jrSSAjrSSBjrSSCjrSSDjrSSEjrSSFjrSSGjrSSHjrSSIjrSSJjr0\"\^5\_\"\_5\_\"\`5\_\"\a5\_\"\b5\_\"\c5SK_\"\d5\_\"\e5\_\"\f5\_\"\g5SL_\"\h5\_\"\i5\_\"\j5\_\"\k5\_\"\l5\_\"\m5\~_\"\n5\_\"\o5\\"\p5\\"\q5SM\"\r5SN0ErSO\SP'\[(aSSSQjjrOSSSRjjr\!"SS\\\4ST9rSSSUjjrSSSVjjrSSWjr\[(a \ZGR0r\R"S25GR2r\R"S35GR2r\R"S45GR2r\R"S55GR2r\R"S65GR2r\"SX\"SY555rSSZjrSS[jrSS\jrSS]jrSS^jrSS_jrSS`jrSSajrSSbjrSScjrSSdjrSSejrSSfjrSSgjrSShjrSSijrSSjjrSSkjrSSljrSSmjrSSnjrSSojrSSpjrSSqjrSSrjr0\\_\\_\R\_\8\_\\_\\_\\_\\_\\_\\_\"S5\_\ GR\_\,\_\D\_\/\_\<\_\F\_\H\\J\\L\\N\\O\\Q\\>\\R4\0Er0r\H&r\"\Ss5(dM\\\\GR'M( \"St\55rSSSujjrSSvjrSSSwjjr\[(a \ZGRr\"Sx5rS\14SSyjjr\$SSSzjj5r\$SS{j5rSSS|jjrSS}jr\[(a \ZGRr\$SSS~jj5r\$SSj5rSSSjjrSSjrSSjr\[(a \ZGRrSSjrSSjr\$SSSjj5r\$SSj5rSSSjjr\$SSSjj5r\$SSj5rSSSjjrSSjr"SS\5rSSjrSSjr\"\S5(a\GR"\S9 gg!\\a Sr[GNf=f)av 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)_cbsonTF)4 cf[SR[U5R5U55e)zUnknown type helper.z\Detected unknown BSON type {!r} for fieldname '{}'. Are you using the latest driver version?)r-formatchrrX) element_type element_names r~_raise_unknown_typers/  //5vc,6G6N6N6PR^/_ rc([X5SUS-4$)z"Decode a BSON int32 to python int.r)_UNPACK_INT_FROMr|_viewpositiondummy0dummy1dummy2s r~_get_intrs D +A .1 <>rc[X5SnUS- nUS:dX2- U:a [S5eX&-S- nXS:wa [S5e[XUURS5SUS-4$)z#Decode a BSON string to python str.rrrzinvalid string lengthzinvalid end of stringT)rr-rr)r|r}robj_endrdummylengthrs r~ _get_stringrsd -a 0F MH zW'&0122  a C yA~122 s+T-N-NPT UVW XZ]`aZa aarc[X5SnX-S- nXR:a [S5eXS:wa [S5eUS:XaX2:wa [S5eX54$![Ran[[ U55SeSnAff=f)z+Validate and return a BSON document's size.rNrzinvalid object lengthbad eoo)rstructerrorr-str)r|rrobj_sizeexcrs r~_get_object_sizer(s.#D3A6   !C ~122 yA~)$$1},122 = <<.#c(#-.sAB'A<<Bc[XU5upg[UR5(aURXUS-U5X&-4$[XUS-Xt5nX&- n[ UR S5[ 5(atSU;an[ UR S5[ [S545(a?[URS5URSS5URSS5U5U4$X4$)zEDecode a BSON subdocument to opts.document_class or bson.dbref.DBRef.rrz$refz$idz$dbN) rr%document_class_elements_to_dictrwgetrtyper+pop) r|r}rrrrrrobjs r~ _get_objectr9s%TW=MH4..//##DC!G$rD!9rc SU4$rvrrs r~rrrrc[5U4$rvr3rs r~rr FHa=rc[5U4$rvr1rs r~rrrrz)dict[int, Callable[..., Tuple[Any, int]]]rc F[S[R"XX4U55$)NTuple[str, Any, int])rr@_element_to_dict)r|r}rrr raw_arrays r~rrs& "  # #DG9 M  rcXnUS- n[XX$5uprU(a6U[[5:Xa#[X[ U55upXqX)S-U S-4$[ U"XX#XG5upURR(a9URRR[W 55n U bU "U 5n UW U4$![ a [Xg5 Npf=f)z Decode a single key, value pair.r) rordrDrlenrrrrrrr) r|r}rrrrrr_rrrs r~rr's~ A !.t8!J W5%dc$i@FAhq!937B B <-l;HtOE    * *!//<<@@eMN)&u-UH,, <  ; rN) rVr%rrrrrr- Exceptionsysexc_inforwith_traceback)r|rr}rr exc_valueexc_tbs r~ _bson_to_dictrms"4(JD K t22 3 3&&t2 2!$3t95O%6t1c%PQQ  K"||~f#i.)88@dJKs*A).A))AB:c#\# UH"n[U5S-RS5v M$ g7f)utf8N)rrX).0is r~ rs&JkSVf_,,V44ks*,c## [ShvN [R"S5n[[ U55S-R S5v M*NE7f)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 itertoolscountrnextrX)counters r~rWrWsJood#G 4=!F*226:: s AAAAc[U[5(a$SU;a [S5e[USS5 US-$SU;a [S5e[ U5SS-$![a [ SU-5Sef=f)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_encodestrings r~_make_c_string_checkr+s&%  f !"_` `  &$ -G# # V !"_` `V$Q''11 #>G  s AA6c[U[5(a[USS5 US-$[ U5SS-$![a [ SU-5Sef=f)zMake a 'C' string.NTrr&r)rwrxrr'r/r(r)s r~_make_c_stringr-sk&%    &$ -G# # V$Q''11  #>G  s :AcFSU;a [S5e[U5SS-$)z*Make a 'C' string suitable for a BSON key.rz*BSON keys must not contain a NUL characterrr)r.r(r)s r~ _make_namer/s+ JKK   #g --rc$SU-[U5-$)zEncode a float.r`) _PACK_FLOATnamerrrs r~ _encode_floatr4s T>K. ..rcBSU-[[U55-S-U-$)zEncode a python bytes.rdr) _PACK_INTrr2s r~ _encode_bytesr7s& T>Ic%j1 1G ;e CCrc 0[U5(a SU-[[UR5-$SR UR 5VVs/sHupE[ XEX#5PM snn5nSU-[[U5S-5-U-S-$s snnf)zEncode a mapping type.rbrrr) r%rrxrawjoinitems_element_to_bsonr6r)r3r check_keysrrvalr|s r~_encode_mappingr?s5!!~UEII 666 88RWR]R]R_`R_hc%c AR_` aD T>Ic$i!m4 4t ;g EEasB c[SU-S-5n[U5S- nU[SURX#5- nU[SURX#5- nUR bU[SUR X#5- nUR R5HupgU[XgX#5- nM US- n[[U5U- 5XEUS-&[U5$)zEncode bson.dbref.DBRef.rbsrs$refs$ids$dbr) ryr_name_value_to_bsonriddatabase_DBRef__kwargsr;r<r6rx)r3rr=rbufbeginrr>s r~ _encode_dbrefrGs GdN%88 9C HqLE {E,<,Ic$i!m4 4t ;g EEas A$cd[U5SnSU-[[U5S-5-U-S-$)zEncode a python str.rrarr)r(r6r)r3rrrbvalues r~ _encode_textrNs7 5 !! $F T>Ic&kAo6 6 ?' IIrcURnUS:Xa[[U55U-nSU-[[U5U5-U-$)zEncode bson.binary.Binary.rrd)rr6r_PACK_LENGTH_SUBTYPE)r3rrrrs r~_encode_binaryrQsEmmG!|#e*%- T>0UWE E MMrcZURn[R"XS9n[XX#5$)zEncode uuid.UUID.)r)rr from_uuidrQ)r3rrrrbinvals r~ _encode_uuidrUs+22   e MF $ 44rc&SU-UR-$)zEncode bson.objectid.ObjectId.rf)binary)r3rrrs r~_encode_objectidrXs T>ELL ((rc6SU-U=(a S=(d S-$)z%Encode a python boolean (True/False).rgr`rrr2s r~ _encode_boolrZs T>U.w9' ::rc:[U5nSU-[U5-$zEncode datetime.datetime.rh)r) _PACK_LONGr3rrrmilliss r~_encode_datetimer` s  'F T>Jv. ..rc:[U5nSU-[U5-$r\)intr]r^s r~_encode_datetime_msrcs ZF T>Jv. ..rc SU-$)zEncode python None.rirr3rrrs r~ _encode_nonerf T>rclURnU[R:XaSU-[UR5-S-$US:XaSU-[UR5-S-$SnU[R -(aUS- nU[R -(aUS- nU[R-(aUS- nU[R-(aUS - nU[R-(aUS - nU[R-(aUS - nUS- nSU-[UR5-U-$) z*Encode a python regex or bson.regex.Regex.rjsurrrilmsux) flagsreUNICODEr+r IGNORECASELOCALE MULTILINEDOTALLVERBOSE)r3rrrrosflagss r~ _encode_regexrxs KKE  ~ 4U]] CChNN !~ 4U]] CCgMM 2== dNF 299  dNF 2<<  dNF 299  dNF 2::  dNF 2::  dNF'~ 4U]] CCfLLrc[U5n[U5nURcSU-[U5-U-$[ URSUS5n[SU-[U5-5nSU-U-[U5-U-U-$)zEncode bson.code.Code.rlFrrn)r-rrr6 _dict_to_bson)r3rrrcstringcstrlenr full_lengths r~ _encode_coder~5sU#G'lG {{~ ' 22W<< %++udE :EAK#e*45K T>K ')G*< Ju$55 5|| T HIt S Ts 4!AcNSU-[URUR5-$)z Encode bson.timestamp.Timestamp.rp)_PACK_TIMESTAMPrtimer2s r~_encode_timestamprKs T>OEIIuzzB BBrcnSU-[U5-$![Ra [S5Sef=f)zEncode a bson.int64.Int64.rqrN)r]rrrr2s r~ _encode_longrPs?P~ 5 111 <<PDE4OPs!4c&SU-UR-$)z"Encode bson.decimal128.Decimal128.rr)bidr2s r~_encode_decimal128rXs T>EII %%rc SU-$)zEncode bson.min_key.MinKey.rsrres r~_encode_minkeyr]rgrc SU-$)zEncode bson.max_key.MaxKey.rtrres r~_encode_maxkeyrbrgr _type_markerc#$# UHov M g7frvr)rts r~rrs-9a9sc^Sn[[U5"XX#5$![a O'[a [ U[ 5(deSnOf=f[ USS5n[ U[ 5(a.U[;a$[UnU[[U5'U"XX#5$U(d]URR(aBURRR[U55n U b[X "U5X#SS9$[HBn U(aM [ X5(dM[U nU[[U5'U"XX#5s $ URRn U(dU b[X "U5X#SS9$U(a [S5e[SU<S [U5<35e) z!Encode a single name, value pair.FTrN)in_custom_call)in_fallback_callrzcannot encode object: z , of type: ) _ENCODERSrrrrwrbgetattr_MARKERSr _encoder_maprrA_BUILT_IN_TYPES_fallback_encoderr.) r3rr=rrrwas_integer_overflowmarkerfunccustom_encoderbasefallback_encoders r~rArAs! $e%d:DD   $%%%  $ $UND 1F&#6X#5!% $u+D22 d00==++88<>#  !D/G"HI I #:!D/D"EF F c?D tJ ==rc [U5(a[[UR5$/nU(a%SU;aUR [ SUSX55 UR 5H0upVU(aUS:wdMUR [XVX55 M2 SRU5n[[U5S-5U-S -$![an[SUSU35UeSnAff=f![a [SU<35Sef=f) zEncode a document to BSON._ids_idzInvalid document z | Nz)encoder expected a mapping type but got: rrr)r%rrxr9rrAr;r<r.AttributeError TypeErrorr:r6r) docr=r top_levelelementsrrerrencodeds r~rzrzs3E377## W # OO/ CJ Y Z))+JCu VOO$4S$RS&hhx G S\A% & 07 :: 'V),=cU#cU*KLRUUV WCC7KLRVVWs0AC0?C C0 C-C((C--C00D z1codec_options must be an instance of CodecOptionscP[U[5(d[e[XU5$)aVEncode 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_ERRORrz)documentr= codec_optionss r~rXrXs$. m\ 2 2'' } ==rcgrvrr|rs r~rYrY rcgrvrrs r~rYrY%rrcU=(d [n[U[5(d[e[ S[ X55$)aGDecode 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 $Union[dict[str, Any], _DocumentType])r"rwr#rrr)r|rrs r~rYrY*s56,D/DD dL ) )'' 6 d8Q RRrc L[U5up[U5n/nSnUS- n[UR5nXV:a[ X5SnX5- U:a [ S5eXX-S- n X S:wa [ S5eU(a'UR URXU S-U55 OUR [XUS-X55 XX- nXV:aMU$![ a e[a= [R"5upn [ [U 55RU 5Sef=f)z)Decode a BSON data to multiple documents.rrzinvalid object sizerrN) rVrr%rrr-rrrrrrr) r|rr}data_lendocsrruse_rawrrrrrs r~ _decode_allrLs*"4(JD4yH "DH Q,C!$"5"56GKn'7:H"X-!"788)A-G}!!),, D//! 0LdST -d(Q,VW  Hn  K"||~f#i.)88@dJKsBCCAD#cgrvrrs r~rZrZnrrcgrvrrs r~rZrZsrctUc[U[5$[U[5(d[e[X5$)aDecode 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`. )rr"rwr#rrs r~rZrZzs604!677 m\ 2 2'' t ++rc[UR5(a0nOUR5nUR5HFupEXA;a8XS:Xa[URU5UX4'M/[ XQUU5X4'MBXSU'MH U$)Nr)r%rr;rr9_decode_selective)rawdocfieldsrrrrs r~rrs=7788 **,lln  ={a(]CCH,#; H% JrcJSn[U5n[X![U55up4US- n/nURnXS- :aDX!S:waUS- nX!S:waMUS- n[X!U5upsU"X!X-5 X- nXS- :aMDX:wa [ S5eSR U5$)Nrrrrr)rzrrrr-r:)r|rr}rrbuffersrrs r~_array_of_documents_to_bufferrsH d D dc$i 8FA MH "G ^^F 1W n! MHn!A &ts; tx234 1W 899 88G rcURS5nU(dgSH:nURU5nU(dM[U5nU(aU/X'M6/X'M< g)z=Convert raw array of documents to a stream of BSON documents.cursorN) firstBatch nextBatch)rr)rrrbatchr|s r~&_convert_raw_document_lists_to_streamsrsP \\( #F * 3 ,U3 &FKFK+rcURR(d [X5$U(d[XRSS95$SSKJn URUSS9n[ X5n[UUU5/$)aDecode 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)rrrZ with_options bson.raw_bsonr=rr)r|rrr=internal_codec_options_docs r~_decode_all_selectivers.  & & 3 3$.. $ : : : NOO.>H++ sBBc[U[5(d[S[U535e[ U[ 5 g![ a gf=f)zCheck 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 z:BSON data must be an instance of a subclass of bytes, not TF)rwrxrrrr"r)bsons r~r]r]csQ dE " "TUYZ^U_T`abbd12 s? A  A c\\rSrSrSr\S\4SSjj5r\4S SjjrSr g) r^ivzBSON (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. Fc&U"[XU55$)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`. )rX)clsrr=rs r~rX BSON.encode~s46( >??rc[X5$)a\Decode 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`. )rY)selfrs r~rY BSON.decodes@d**rrN) rz Type[BSON]rMapping[str, Any]r=boolrCodecOptions[Any]returnr^)rrrdict[str, Any]) __name__ __module__ __qualname____firstlineno____doc__ classmethodr"rXrY__static_attributes__rrr~r^r^vsx!+@ @ @#@@) @  @@82G +. +  + +rr^c[$)zIs the C extension installed?)_USE_Crrr~r_r_s Mrc[RR5(a[RR5 gg)z!Releases the ObjectID lock child.N)r6 _inc_locklockedreleaserrr~ _after_forkrs.  """"$#rregister_at_fork)after_in_child)r|r rzTuple[Any, memoryview])rrbrrrr)r|r rr rrbrr rr rr rTuple[int, int]) r|r r}r rrbrrrTuple[str, int])r|r rr rrbrr rr rr rzTuple[float, int])r|r r}r rrbrrbrrrr rr)r|r rrbrrbrr)r|r r}r rrbrrbrrrr rTuple[Any, int])r|r r}r rrbrrbrrrrrr)r|r rr rrbrrbrrrr rz$Tuple[Union[Binary, uuid.UUID], int])r|r rr rrbrr rr rr rzTuple[ObjectId, int])r|r rr rrbrr rr rr rzTuple[bool, int])r|r rr rrbrrbrrrr rz0Tuple[Union[datetime.datetime, DatetimeMS], int])r|r r}r rrbrrbrrrrrTuple[Code, int])r|r r}r rrbrrbrrrrrr)r|r r}r rrbrr rrrr rzTuple[Regex[Any], int])r|r r}r rrbrrbrrrrrzTuple[DBRef, int])r|r rr rrbrr rr rr rzTuple[Timestamp, int])r|r rr rrbrr rr rr rzTuple[Int64, int])r|r rr rrbrr rr rr rzTuple[Decimal128, int])F)r|r r}r rrbrrbrrrrrr)r|r rrbrrbrzCodecOptions[RawBSONDocument]rrrrrr)NF)r|r r}r rrbrrbrrrr rrrr )r|r rCodecOptions[_DocumentType]rr>)rzGenerator[bytes, None, None])r*zUnion[str, bytes]rrx)r*rrrx) r3rxrfloatrr rr rrx) r3rxrrxrr rr rrx) r3rxrr r=rrrrrx) r3rxrr+r=rrrrrx) r3rxrz Sequence[Any]r=rrrrrx) r3rxrrrr rr rrx) r3rxrrrr rr rrx) r3rxrz uuid.UUIDrr rrrrx) r3rxrr6rr rr rrx) r3rxrrrr rr rrx) r3rxrzdatetime.datetimerr rr rrx) r3rxrr(rr rr rrx) r3rxrr rr rr rrx) r3rxrz Regex[Any]rr rr rrx) r3rxrr!rr rrrrx) r3rxrrbrr rr rrx) r3rxrr rr rr rrx) r3rxrr,rr rr rrx)FF)r3rxrr r=rrrrrrrrrx) rr rr r=rrrrrx)T) rr r=rrrrrrrx)rrr=rrrrrxrv)r|r?rNonerr)r|r?rrrr>)r|r?r%Optional[CodecOptions[_DocumentType]]rr)r|r?rrrlist[_DocumentType])r|r?rrrzlist[dict[str, Any]])r|r?rrrr)r|r?rrrz0Union[list[dict[str, Any]], list[_DocumentType]])rr rr rrrr>)r|zUnion[memoryview, bytes]rrx)rr rr)r|r rrrr rr)r|rxrrrIterator[dict[str, Any]])r|rxrrrIterator[_DocumentType])r|rxrrr8Union[Iterator[dict[str, Any]], Iterator[_DocumentType]])rUnion[BinaryIO, IO[bytes]]rrrr)rr rrrr)rr rrrr )rrxrr)rr)rr)r __future__rdatetimer!osrprruuidcodecsrrrr( collectionsr_abctypingrrr r r r r rrrrrrrrrrr bson.binaryrrrrrrrr bson.coder!bson.codec_optionsr"r#r$r%bson.datetime_msr&r'r(r)r* bson.dbrefr+bson.decimal128r, bson.errorsr-r.r/ bson.int64r0 bson.max_keyr2 bson.min_keyr4 bson.objectidr6 bson.regexr7bson.sonr8r9bson.timestampr: bson.tz_utilr;rr= bson.typingsr>r?rr@r ImportError__all__rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUStruct unpack_fromrunpack _UNPACK_INTrrrrrVrrrrrrrrrrrrrrrrrrrrr__annotations__rrrr rrpackr1r6rPr]rtupleranger rWr+r-r/r4r7r?rGrKrNrQrUrXrZr`rcrfrxr~rrrrrrrrxdictrrblistrUUIDrr_typhasattrrrrAr<rzrrrXrYrrZrrrrr[r\r]r^r_rrrrr~r2s*8r# 00#*    &GG"!$-; F= ~                     ]]4(44mmD!(( ==&22$mmE2>>MM$'33u-99 = ==%(=25=?B=LO==b ? ??%(?25??B?LO?? b  b b$' b25 b=N bWZ b b" $'25=NWZ*' ' ' $'' 25' =N' ^a' ' T" ""%("36">O"Y\")"J- --%(-25-?B-LO-- B  B B%( B25 B?B BLO B BY YY%(Y25Y=NYX[Y5Y   $' 25 =N ^a   '  ' '$' '36 '>O '_b ' ' $'14L*>L+>L+>L* > L+ > L4 >L(>L,>L)>L4>L*>L(>L)>L+>L#> L(!>"L.#>$L*L/L8L8+>:2                  * ---- -  -  - -< TS12      (      (        . K  ((MmmD!&& MM$  $ $ }}U+00 ]]4 % % --&++JeDkJJ  ;2$ 2./ D F"F F%F37F?PF FJ N5) ; / /  M4OTC P&   ,  =  ' #    /    =    ,   <  J   II|  N  <  ,   =! " N# $ N  = ]  "LL/5  <  Dt^$$&/o""#  -9--!" AX AX AXAX  AX  AX  AX AXH >LP; ;;&7;DH; ;. ((M&&YZ '<>>>%> >:     SWS S*OS)SDK< $$K    *E SW, ,*O,5,B -H.* $*$H$H!  * *9*CF**Z     IM ,  , E ,= ,F @D(9=   (9T <@,(,8,>,@&D+5D+N %  2!""{3 #e) Fs2^66__