_i$>dZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZmZmZddlmZddlmZddlmZd Zejd jZejd jZejd jZddZddZGddZ dS)z)Tools for working with MongoDB ObjectIds.) annotationsN) SystemRandom)AnyNoReturnOptionalTypeUnion)_datetime_to_millis InvalidId)utciz>Iz>I5soidstrreturnrc&td|z)NzS%r is not a valid ObjectId, it must be a 12-byte input or a 24-character hex stringr )rs 0D:\Nbitz\venv\Lib\site-packages\bson/objectid.py_raise_invalid_idr%s!  (*- .  bytesc*tjdS)z+Get the 5-byte random field of an ObjectId.)osurandomrr _random_bytesr,s :a==rceZdZdZejZede Z e j Z eZdZdZd(d)d Zed*dZed+dZed,dZd-dZd.dZed,dZed/dZd,dZd0dZd1dZd1dZd2d Z d2d!Z!d2d"Z"d2d#Z#d2d$Z$d2d%Z%d3d'Z&dS)4ObjectIdzA MongoDB ObjectId.r)__idNr%Optional[Union[str, ObjectId, bytes]]rNonec||dSt|trt|dkr ||_dS||dS)aZInitialize 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 isinstancerlen _ObjectId__id_ObjectId__validateselfrs r__init__zObjectId.__init__?scJ ; OO      U # # !CBDIII OOC rclsType[ObjectId]generation_timedatetime.datetimec\tt|dzdz}||S)aJCreate 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 )r,r.rs r from_datetimezObjectId.from_datetimeks98 )/::dB C C1 2 s3xxrrboolc^|sdS t|dS#ttf$rYdSwxYw)zChecks if a `oid` string is valid or not. :param oid: the object id to validate .. versionadded:: 2.3 FT)rr TypeError)r,rs ris_validzObjectId.is_validsM 5  SMMM49%   55 s ,,rctj}||jkr||_t|_|jS)z1Generate a 5-byte random number once per process.)rgetpid_pidr_ObjectId__random)r,pids r_randomzObjectId._randoms4ikk #(??CH(??CL|rc^tj5tj}|dztdzzt_dddn #1swxYwYt t t jtt|ddz|_ dS)z'Generate a new value for this ObjectId.N) r _inc_lock_inc_MAX_COUNTER_VALUE_PACK_INT_RANDOMinttimer<r1r')r*incs r __generatezObjectId.__generates   A A-C 1W);a)?@HM A A A A A A A A A A A A A A A %S%5%5x7G7G7I7IJJYWZ^^\]^_\_M`` s'AAAct|tr|j|_dSt|trmt |dkrI t ||_dS#ttf$rt|YdSwxYwt|dStdt|)aValidate 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'rr&rfromhexr5 ValueErrorrtyper)s r __validatezObjectId.__validates c8 $ $ b DIII S ! ! b3xx2~~+ % c 2 2DIII!:.+++%c******+"#&&&&&`UYZ]U^U^``aa as A.. BBc|jS)z/12-byte binary representation of this ObjectId.r'r*s rrJzObjectId.binarys yrct|jddd}tj|tS)a A :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.zObjectId.generation_times9  !A#//2  ..y#>>>rc|jS)zdReturn value of object for pickling. needed explicitly because __slots__() defined. rPrQs r __getstate__zObjectId.__getstate__s yrvaluect|tr |d}n|}t|tr|d|_dS||_dS)z Explicit state set from picklingr'zlatin-1N)r%dictrencoder')r*rYrs r __setstate__zObjectId.__setstate__s] eT " " (CCC c3    9--DIIIDIIIrrcXtj|jSN)binasciihexlifyr'decoderQs r__str__zObjectId.__str__s! **11333rcd|dS)Nz ObjectId('z')rrQs r__repr__zObjectId.__repr__s&D&&&&rothercZt|tr|j|jkStSr_r%rr'rJNotImplementedr*rfs r__eq__zObjectId.__eq__) eX & & -9 , ,rcZt|tr|j|jkStSr_rhrjs r__ne__zObjectId.__ne__rlrcZt|tr|j|jkStSr_rhrjs r__lt__zObjectId.__lt__) eX & & ,9u|+ +rcZt|tr|j|jkStSr_rhrjs r__le__zObjectId.__le__rlrcZt|tr|j|jkStSr_rhrjs r__gt__zObjectId.__gt__rqrcZt|tr|j|jkStSr_rhrjs r__ge__zObjectId.__ge__ rlrrDc*t|jS)z,Get a hash value for this :class:`ObjectId`.)hashr'rQs r__hash__zObjectId.__hash__sDIrr_)rr rr!)r,r-r.r/rr)r,r-rrrr3rr)rr!)rrrr!)rr/)rYrrr!)rr)rfrrr3)rrD)'__name__ __module__ __qualname____doc__rr8r9rrandintrBrA threadingLockr@rr: __slots__ _type_markerr+ classmethodr2r6r<r$r(propertyrJr.rXr]rcrerkrnrprsrurwrzrrrrr1s. 29;;D <>> ! !!%7 8 8D   I}HIL*!*!*!*!*!X[@[ [aaaabbbb,X ? ? ?X ?  4444''''      rr)rrrrr{)!r __future__rr`rTrstructrrErandomrtypingrrrrr bson.datetime_msr bson.errorsr bson.tz_utilr rBStructpackr1rCunpackrSrrrrrrrsq0/""""""  77777777777777000000!!!!!! FM$   $  6=((-fmD!!(  aaaaaaaaaar