o 'h#@sdZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZmZmZddlmZddlmZddlmZd Zed jZed jZed jZdddZdddZGdddZ dS)z)Tools for working with MongoDB ObjectIds.) annotationsN) SystemRandom)AnyNoReturnOptionalTypeUnion)_datetime_to_millis InvalidId)utciz>Iz>I5soidstrreturnrcCs td|)NzS%r is not a valid ObjectId, it must be a 12-byte input or a 24-character hex stringr )r rI/var/www/html/olx_land/venv/lib/python3.10/site-packages/bson/objectid.py_raise_invalid_id%s rbytescCs tdS)z+Get the 5-byte random field of an ObjectId.)osurandomrrrr _random_bytes, rc@seZdZdZeZede Z e Z eZdZdZd;dddZed?ddZd@ddZdAddZed?ddZedBdd Zd?d!d"ZdCd$d%ZdDd'd(ZdDd)d*ZdEd,d-Z dEd.d/Z!dEd0d1Z"dEd2d3Z#dEd4d5Z$dEd6d7Z%dFd9d:Z&dS)GObjectIdzA MongoDB ObjectId.r)__idNr %Optional[Union[str, ObjectId, bytes]]rNonecCsB|dur |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__validateselfr rrr__init__?s %  zObjectId.__init__clsType[ObjectId]generation_timedatetime.datetimecCstt|dd}||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)r rrr from_datetimeks zObjectId.from_datetimerboolc Cs0|sdSzt|WdSttfyYdSw)zChecks if a `oid` string is valid or not. :param oid: the object id to validate .. versionadded:: 2.3 FT)rr TypeError)r'r rrris_validszObjectId.is_validrcCs&t}||jkr||_t|_|jS)z1Generate a 5-byte random number once per process.)rgetpid_pidr_ObjectId__random)r'pidrrr_randoms  zObjectId._randomcCsjtjtj}|dtdt_Wdn1swYttttt|dd|_ dS)z'Generate a new value for this ObjectId.N) r _inc_lock_inc_MAX_COUNTER_VALUE_PACK_INT_RANDOMinttimer4r+r")r%incrrr __generates ,zObjectId.__generatec Cs~t|tr |j|_dSt|tr6t|dkr0z t||_WdStt fy/t |YdSwt |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!rfromhexr. ValueErrorrtyper$rrr __validates    zObjectId.__validatecC|jS)z/12-byte binary representation of this ObjectId.r"r%rrrr@szObjectId.binarycCs$t|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. rr6) _UNPACK_INTr"datetime fromtimestampr )r% timestamprrrr)s zObjectId.generation_timecCrE)zdReturn value of object for pickling. needed explicitly because __slots__() defined. rFrGrrr __getstate__szObjectId.__getstate__valuecCs<t|tr |d}n|}t|tr|d|_dS||_dS)z Explicit state set from picklingr"zlatin-1N)r dictrencoder")r%rMr rrr __setstate__s    zObjectId.__setstate__rcCst|jSN)binasciihexlifyr"decoderGrrr__str__szObjectId.__str__cCs d|dS)Nz ObjectId('z')rrGrrr__repr__s zObjectId.__repr__othercCst|tr |j|jkStSrQr rr"r@NotImplementedr%rWrrr__eq__  zObjectId.__eq__cCst|tr |j|jkStSrQrXrZrrr__ne__r\zObjectId.__ne__cCst|tr |j|jkStSrQrXrZrrr__lt__r\zObjectId.__lt__cCst|tr |j|jkStSrQrXrZrrr__le__r\zObjectId.__le__cCst|tr |j|jkStSrQrXrZrrr__gt__r\zObjectId.__gt__cCst|tr |j|jkStSrQrXrZrrr__ge__ r\zObjectId.__ge__r;cCs t|jS)z,Get a hash value for this :class:`ObjectId`.)hashr"rGrrr__hash__rzObjectId.__hash__rQ)r rrr)r'r(r)r*rr)r'r(r rrr-rr)rr)r rrr)rr*)rMrrr)rr)rWrrr-)rr;)'__name__ __module__ __qualname____doc__rr0r1rrandintr9r8 threadingLockr7rr2 __slots__ _type_markerr& classmethodr,r/r4rr#propertyr@r)rLrPrUrVr[r]r^r_r`rarcrrrrr1s@ ,                r)r rrrrd)!rh __future__rrRrIrstructrjr<randomrtypingrrrrrbson.datetime_msr bson.errorsr bson.tz_utilr r9Structpackr+r:unpackrHrrrrrrrs(