o h'@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z m Z mZddlmZe r?ddZneZefddZd d ZGd d d eZd dZGdddeZdS)zXTools for working with MongoDB `ObjectIds `_. N)PY3bytes_from_hex string_type text_type)utccCs|SN)xrr@/var/www/html/venv/lib/python3.10/site-packages/bson/objectid.py$sr cCs>d}d}d}|D]}|||A}|||}q|d?|d@AS)zFNV-1a 24 bit hashlil9r)data_ordZ hash_sizeZ fnv_32_primeZ fnv_1a_hasheltrrr _fnv_1a_24(s rcCs tdttddS)z,Get the machine portion of an ObjectId. zsrcCs td|)NzS%r is not a valid ObjectId, it must be a 12-byte input or a 24-character hex string)r)oidrrr _raise_invalid_idBs rc@seZdZdZeddZeZ e Z dZ dZ d+ddZ ed d Zed d Zd dZddZeddZeddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Z dS),ObjectIdzA MongoDB ObjectId. rr Z__idNcCsB|dur |dSt|trt|dkr||_dS||dS)aEInitialize 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 3-byte machine identifier, - a 2-byte process id, and - 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` or, in Python 2, any 12-character :class:`str`. 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:`unicode` or :class:`str` of 24 hex digits:: >>> ObjectId('0123456789ab0123456789ab') ObjectId('0123456789ab0123456789ab') >>> >>> # A u-prefixed unicode literal: >>> ObjectId(u'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. :Parameters: - `oid` (optional): a valid ObjectId. .. mongodoc:: objectids N )_ObjectId__generate isinstancebyteslen _ObjectId__id_ObjectId__validateselfrrrr __init__Us %  zObjectId.__init__cCsB|dur ||}t|}tdt|d}||S)a^Create 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}}) :Parameters: - `generation_time`: :class:`~datetime.datetime` to be used as the generation time for the resulting ObjectId. N>is) utcoffsetcalendartimegm timetuplerrint)clsgeneration_time timestamprrrr from_datetimes  zObjectId.from_datetimec Cs0|sdSzt|WdSttfyYdSw)zChecks if a `oid` string is valid or not. :Parameters: - `oid`: the object id to validate .. versionadded:: 2.3 FT)r r TypeError)r2rrrr is_valids zObjectId.is_validcCstdtt}|tj7}|tdtd7}tj|tdtj dd7}tj ddt_ Wdn1s>wY||_ dS)z0Generate a new value for this ObjectId. r,z>Hir N) rrr1timer rosgetpid _inc_lock_incr'r)rrr Z __generates  zObjectId.__generatec Cst|tr |j|_dSt|tr5t|dkr/zt||_WdSttfy.t |YdSwt |dStdt j t |f)a;Validate and use the given id for this ObjectId. Raises TypeError if id is not an instance of (:class:`basestring` (:class:`str` or :class:`bytes` in python 3), ObjectId) and InvalidId if it is not a valid ObjectId. :Parameters: - `oid`: a valid ObjectId r z7id must be an instance of (bytes, %s, ObjectId), not %sN) r$r binaryr'rr&rr6 ValueErrorrrrtyper)rrr Z __validates     zObjectId.__validatecC|jS)z812-byte binary representation of this ObjectId. r'r*rrr r?zObjectId.binarycCs(td|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. r,rr9)runpackr'datetime fromtimestampr)r*r4rrr r3s zObjectId.generation_timecCrB)zdreturn value of object for pickling. needed explicitly because __slots__() defined. rCrDrrr __getstate__rEzObjectId.__getstate__cCs@t|tr |d}n|}trt|tr|d|_dS||_dS)z)explicit state set from pickling r'zlatin-1N)r$dictrrrr')r*valuerrrr __setstate__s   zObjectId.__setstate__cCs tr t|jSt|jSr)rbinasciihexlifyr'decoderDrrr __str__ s zObjectId.__str__cCsdt|fS)NzObjectId('%s'))strrDrrr __repr__szObjectId.__repr__cCst|tr |j|jkStSrr$r r'r?NotImplementedr*otherrrr __eq__  zObjectId.__eq__cCst|tr |j|jkStSrrSrUrrr __ne__rXzObjectId.__ne__cCst|tr |j|jkStSrrSrUrrr __lt__rXzObjectId.__lt__cCst|tr |j|jkStSrrSrUrrr __le__$rXzObjectId.__le__cCst|tr |j|jkStSrrSrUrrr __gt__)rXzObjectId.__gt__cCst|tr |j|jkStSrrSrUrrr __ge__.rXzObjectId.__ge__cCs t|jS)z,Get a hash value for this :class:`ObjectId`.)hashr'rDrrr __hash__3s zObjectId.__hash__r)!rrrrrandomrandintr> threadingLockr=r __slots__Z _type_markerr+ classmethodr5r7r#r(propertyr?r3rIrLrPrRrWrYrZr[r\r]r_rrrr r Hs:  , "     r )rrMr.rGr;r`rrrbr:Zbson.py3compatrrrrZ bson.tz_utilrrordrrr@rrobjectr rrrr s(