i!\SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r SSK J r J r J r JrJr SSKJr SSKJr SSKJr S r\R."S 5R0r\R."S 5R0r\R."S 5R6rSS jrSS jr"SS5rg)z)Tools for working with MongoDB ObjectIds.) annotationsN) SystemRandom)AnyNoReturnOptionalTypeUnion)_datetime_to_millis InvalidId)utciz>Iz>I5sc[SU-5e)NzS%r is not a valid ObjectId, it must be a 12-byte input or a 24-character hex stringr )oids :/app/mltbenv/lib/python3.13/site-packages/bson/objectid.py_raise_invalid_idr$s  (*- . c.[R"S5$)z+Get the 5-byte random field of an ObjectId.)osurandomrr _random_bytesr+s ::a=rc\rSrSrSr\R "5r\"5RS\ 5r \ R"5r\"5rSrSrSSSjjr\SSj5r\SS j5r\SS j5r\SS j5r\SS j5rSS jrSSjrSSjrSSjrS SjrS Sjr S Sjr!S Sjr"S Sjr#S Sjr$S!Sjr%Sr&g)"ObjectId0zA MongoDB ObjectId.r)__idNcUc[R [RnUS-[S--[lSSS5 [ [ [ R "55[R55[W5SS-Ul g[U[5(a[U5S:XaXl g[U[5(a7[U5S:Xa[RU5Ul g[#U5 g[U[5(aUR$Ul g[S['U535e!,(df  GN=f![[ 4a [#U5 gf=f)aInitialize a new ObjectId. An ObjectId is a 12-byte unique identifier consisting of: - a 4-byte value representing the seconds since the Unix epoch, - a 5-byte random value, - a 3-byte counter, starting with a random value. By default, ``ObjectId()`` creates a new unique identifier. The optional parameter `oid` can be an :class:`ObjectId`, or any 12 :class:`bytes`. For example, the 12 bytes b'foo-bar-quux' do not follow the ObjectId specification but they are acceptable input:: >>> ObjectId(b'foo-bar-quux') ObjectId('666f6f2d6261722d71757578') `oid` can also be a :class:`str` of 24 hex digits:: >>> ObjectId('0123456789ab0123456789ab') ObjectId('0123456789ab0123456789ab') Raises :class:`~bson.errors.InvalidId` if `oid` is not 12 bytes nor 24 hex digits, or :class:`TypeError` if `oid` is not an accepted type. :param oid: a valid ObjectId. .. seealso:: The MongoDB documentation on `ObjectIds `_. .. versionchanged:: 3.8 :class:`~bson.objectid.ObjectId` now implements the `ObjectID specification version 0.2 `_. N z6id must be an instance of (bytes, str, ObjectId), not )r _inc_lock_inc_MAX_COUNTER_VALUE_PACK_INT_RANDOMinttime_random _PACK_INT _ObjectId__id isinstancebyteslenstrfromhex TypeError ValueErrorrbinarytype)selfrincs r__init__ObjectId.__init__>sJ ;##mm!$q-?!-C D $ )TYY[)98;K;K;MNQZ[^Q_`abcQddDI U # #CBI S ! !3x2~+ % c 2DI"#& X & & DITUYZ]U^T_`a a'$#":.+%c*+s)E $E EE98E9cF[[U5S-5S-nU"U5$)aCreate a dummy ObjectId instance with a specific generation time. This method is useful for doing range queries on a field containing :class:`ObjectId` instances. .. warning:: It is not safe to insert a document containing an ObjectId generated using this method. This method deliberately eliminates the uniqueness guarantee that ObjectIds generally provide. ObjectIds generated with this method should be used exclusively in queries. `generation_time` will be converted to UTC. Naive datetime instances will be treated as though they already contain UTC. An example using this helper to get documents where ``"_id"`` was generated before January 1, 2010 would be: >>> gen_time = datetime.datetime(2010, 1, 1) >>> dummy_id = ObjectId.from_datetime(gen_time) >>> result = collection.find({"_id": {"$lt": dummy_id}}) :param generation_time: :class:`~datetime.datetime` to be used as the generation time for the resulting ObjectId. is)r*r )clsgeneration_timers r from_datetimeObjectId.from_datetimezs/8 )/:dB C1 2 3xrcXU(dg[U5 g![[4a gf=f)zhChecks if a `oid` string is valid or not. :param oid: the object id to validate .. versionadded:: 2.3 FT)rr r1)r:rs ris_validObjectId.is_valids0  SM9%  s ))c[R"5nXR:waXl[5UlUR$)z1Generate a 5-byte random number once per process.)rgetpid_pidr_ObjectId__random)r:pids rr)ObjectId._randoms0iik ((?H(?CL||rcUR$)z/12-byte binary representation of this ObjectId.r+r5s rr3ObjectId.binarysyyrc[URSS5Sn[RRU[5$)zA :class:`datetime.datetime` instance representing the time of generation for this :class:`ObjectId`. The :class:`datetime.datetime` is timezone aware, and represents the generation time in UTC. It is precise to the second. rr ) _UNPACK_INTr+datetime fromtimestampr )r5 timestamps rr;ObjectId.generation_times6  !A/2   ..y#>>rcUR$)zTReturn value of object for pickling. needed explicitly because __slots__() defined. rHrIs r __getstate__ObjectId.__getstate__syyrc[U[5(aUSnOUn[U[5(aURS5UlgX lg)z Explicit state set from picklingr+zlatin-1N)r,dictr/encoder+)r5valuers r __setstate__ObjectId.__setstate__sD eT " "(CC c3   9-DIIrc6URR5$N)r+hexrIs r__str__ObjectId.__str__syy}}rcSU<S3$)Nz ObjectId('z')rrIs r__repr__ObjectId.__repr__sD82&&rcj[U[5(aURUR:H$[$r[r,rr+r3NotImplementedr5others r__eq__ObjectId.__eq__( eX & &99 , ,rcj[U[5(aURUR:g$[$r[rcres r__ne__ObjectId.__ne__rircj[U[5(aURUR:$[$r[rcres r__lt__ObjectId.__lt__( eX & &99u||+ +rcj[U[5(aURUR:*$[$r[rcres r__le__ObjectId.__le__rircj[U[5(aURUR:$[$r[rcres r__gt__ObjectId.__gt__rprcj[U[5(aURUR:$[$r[rcres r__ge__ObjectId.__ge__rirc,[UR5$)z,Get a hash value for this :class:`ObjectId`.)hashr+rIs r__hash__ObjectId.__hash__sDIIrr[)rz%Optional[Union[str, ObjectId, bytes]]returnNone)r:Type[ObjectId]r;datetime.datetimer~r)r:rrrr~boolr~r-)r~r)rWrr~r)r~r/)rfrr~r)r~r')'__name__ __module__ __qualname____firstlineno____doc__rrBrCrrandintr%r$ threadingLockr#rrD __slots__ _type_markerr7 classmethodr<r?r)propertyr3r;rRrXr]r`rgrkrnrrrurxr|__static_attributes__rrrrr0s 99;D > ! !!%7 8D IHIL:bx@  ? ?  '      rr)rr/r~rr) r __future__rrMrstructrr(randomrtypingrrrrr bson.datetime_msr bson.errorsr bson.tz_utilr r%Structpackr*r&unpackrLrrrrrrrs0"  770! MM$  $ $ ==(--mmD!((  RRr