@h$dSrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r J r JrJrJr SSKJr SSKJr SSKJr S r\R0"S 5R2r\R0"S 5R2r\R0"S 5R8rSS jrSS jr"SS5r g)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 RC:\Suresh\moveshuttle\MDcreated\moveengine\venv\Lib\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 j5rSS jrS S jr\SS j5r\S!Sj5rSSjrS"SjrS#SjrS#Sjr S$Sjr!S$Sjr"S$Sjr#S$Sjr$S$Sjr%S$Sjr&S%Sjr'Sr(g)&ObjectId1zA MongoDB ObjectId.r)__idNcUcUR5 g[U[5(a[U5S:XaXlgUR U5 g)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 )_ObjectId__generate isinstancebyteslen _ObjectId__id_ObjectId__validateselfrs r__init__ObjectId.__init__?s<J ; OO  U # #CBI OOC rcF[[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) _PACK_INTr )clsgeneration_timers r from_datetimeObjectId.from_datetimeks/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 TypeError)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 r_randomObjectId._randoms0iik ((?H(?CL||rcD[R [RnUS-[S--[lSSS5 [ [ [ R "55[R55[W5SS-Ul g!,(df  N]=f)z'Generate a new value for this ObjectId.N) r _inc_lock_inc_MAX_COUNTER_VALUE_PACK_INT_RANDOMinttimer9r+r$)r'incs r __generateObjectId.__generateso   --C 1W);a)?@HM %S%5x7G7G7IJYWZ^\]^_M``  s )B BcX[U[5(aURUlg[U[5(a7[ U5S:Xa[ RU5Ulg[U5 g[S[U535e![[4a [U5 gf=f)zValidate and use the given id for this ObjectId. Raises TypeError if id is not an instance of :class:`str`, :class:`bytes`, or ObjectId. Raises InvalidId if it is not a valid ObjectId. :param oid: a valid ObjectId z6id must be an instance of (bytes, str, ObjectId), not N) r!rbinaryr$strr#r"fromhexr1 ValueErrorrtyper&s r __validateObjectId.__validates c8 $ $ DI S ! !3x2~+ % c 2DI"#&TUYZ]U^T_`a a ":.+%c*+s B B)(B)cUR$)z/12-byte binary representation of this ObjectId.r$r's rrIObjectId.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 )r' timestamps rr-ObjectId.generation_times6  !A/2   ..y#>>rcUR$)zTReturn value of object for pickling. needed explicitly because __slots__() defined. rQrRs r __getstate__ObjectId.__getstate__syyrc[U[5(aUSnOUn[U[5(aURS5UlgX lg)z Explicit state set from picklingr$zlatin-1N)r!dictrJencoder$)r'valuers r __setstate__ObjectId.__setstate__sD eT " "(CC c3   9-DIIrc^[R"UR5R5$N)binasciihexlifyr$decoderRs r__str__ObjectId.__str__s  *1133rcSU<S3$)Nz ObjectId('z')rrRs r__repr__ObjectId.__repr__sD82&&rcj[U[5(aURUR:H$[$rdr!rr$rINotImplementedr'others r__eq__ObjectId.__eq__( eX & &99 , ,rcj[U[5(aURUR:g$[$rdrnrps r__ne__ObjectId.__ne__rtrcj[U[5(aURUR:$[$rdrnrps r__lt__ObjectId.__lt__( eX & &99u||+ +rcj[U[5(aURUR:*$[$rdrnrps r__le__ObjectId.__le__rtrcj[U[5(aURUR:$[$rdrnrps r__gt__ObjectId.__gt__r{rcj[U[5(aURUR:$[$rdrnrps r__ge__ObjectId.__ge__ rtrc,[UR5$)z,Get a hash value for this :class:`ObjectId`.)hashr$rRs r__hash__ObjectId.__hash__sDIIrrd)rz%Optional[Union[str, ObjectId, bytes]]returnNone)r,Type[ObjectId]r-datetime.datetimerr)r,rrrrboolrr")rr)rrrr)rr)r`rrr)rrJ)rqrrr)rrB))__name__ __module__ __qualname____firstlineno____doc__rr5r6rrandintr@r? threadingLockr>rr7 __slots__ _type_markerr( classmethodr.r2r9r r%propertyrIr-r[rarhrkrrrvryr}rrr__static_attributes__rrrrr1s 99;D > ! !!%7 8D IHIL*!X@ ab, ? ?  4'      rr)rrJrrr)!r __future__rrerVrstructrrCrandomrtypingrrrrr bson.datetime_msr bson.errorsr bson.tz_utilr r@Structpackr+rAunpackrUrrrrrrrs0"  770! MM$  $ $ ==(--mmD!((  aar