o hw@sHdZddlmZddlmZmZgdZdZ dZ dZ dZ d Z d Z dd l mZdd lmZmZmZdd lmZddlmZmZmZddlmZddlmZmZmZmZm Z m!Z!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl m+Z+ddl m,Z,ddl m-Z-ddl m.Z.ddl m/Z/ddl m0Z0eZ1 d"dd Z2d!S)#zPython driver for MongoDB.) annotations)ContextManagerOptional) ASCENDING DESCENDINGGEO2D GEOSPHEREHASHEDTEXT version_tupleget_version_string __version__versionReturnDocumentMAX_SUPPORTED_WIRE_VERSIONMIN_SUPPORTED_WIRE_VERSION CursorType MongoClientAsyncMongoClient DeleteMany DeleteOne IndexModel InsertOne ReplaceOne UpdateMany UpdateOneReadPreference WriteConcernhas_ctimeoutZ2dZ2dspherehashedtext)_csot)r r r )r)rrr)r)rrrrrrr)r)r)r)r) uri_parser) change_stream)client_session) collection)command_cursor)databasesecondsOptional[float]returnContextManager[None]cCsTt|tttdfstdt||r|dkrtd|dur%t|}t|S)a**(Provisional)** Apply the given timeout for a block of operations. .. note:: :func:`~pymongo.timeout` is currently provisional. Backwards incompatible changes may occur before becoming officially supported. Use :func:`~pymongo.timeout` in a with-statement:: with pymongo.timeout(5): client.db.coll.insert_one({}) client.db.coll2.insert_one({}) When the with-statement is entered, a deadline is set for the entire block. When that deadline is exceeded, any blocking pymongo operation will raise a timeout exception. For example:: try: with pymongo.timeout(5): client.db.coll.insert_one({}) time.sleep(5) # The deadline has now expired, the next operation will raise # a timeout exception. client.db.coll2.insert_one({}) except PyMongoError as exc: if exc.timeout: print(f"block timed out: {exc!r}") else: print(f"failed with non-timeout error: {exc!r}") When nesting :func:`~pymongo.timeout`, the nested deadline is capped by the outer deadline. The deadline can only be shortened, not extended. When exiting the block, the previous deadline is restored:: with pymongo.timeout(5): coll.find_one() # Uses the 5 second deadline. with pymongo.timeout(3): coll.find_one() # Uses the 3 second deadline. coll.find_one() # Uses the original 5 second deadline. with pymongo.timeout(10): coll.find_one() # Still uses the original 5 second deadline. coll.find_one() # Uses the original 5 second deadline. :param seconds: A non-negative floating point number expressing seconds, or None. :raises: :py:class:`ValueError`: When `seconds` is negative. See :ref:`timeout-example` for more examples. .. versionadded:: 4.2 Nz.timeout must be None, an int, or a float, not rztimeout cannot be negative) isinstanceintfloattype TypeError ValueErrorr$Z_TimeoutContext)r+r5C/var/www/html/venv/lib/python3.10/site-packages/pymongo/__init__.pyrzs2  rN)r+r,r-r.)3__doc__ __future__rtypingrr__all__rrrrr r Zpymongor$Zpymongo._versionr r r Z!pymongo.asynchronous.mongo_clientrZpymongo.commonrrrZpymongo.cursorrZpymongo.operationsrrrrrrrZpymongo.read_preferencesrZpymongo.synchronous.collectionrZ pymongo.synchronous.mongo_clientrZpymongo.write_concernrr%r&r'r(r)r*rrr5r5r5r6sF    $