+ 8i^Rt^RIHt^RIHtHtHt!RR4t!RR4tRRlt R #) a Support for MongoDB Stable API. .. _versioned-api-ref: MongoDB Stable API ===================== Starting in MongoDB 5.0, applications can specify the server API version to use when creating a :class:`~pymongo.mongo_client.MongoClient`. Doing so ensures that the driver behaves in a manner compatible with that server API version, regardless of the server's actual release version. Declaring an API Version ```````````````````````` .. attention:: Stable API requires MongoDB >=5.0. To configure MongoDB Stable API, pass the ``server_api`` keyword option to :class:`~pymongo.mongo_client.MongoClient`:: >>> from pymongo.mongo_client import MongoClient >>> from pymongo.server_api import ServerApi >>> >>> # Declare API version "1" for MongoClient "client" >>> server_api = ServerApi('1') >>> client = MongoClient(server_api=server_api) The declared API version is applied to all commands run through ``client``, including those sent through the generic :meth:`~pymongo.database.Database.command` helper. .. note:: Declaring an API version on the :class:`~pymongo.mongo_client.MongoClient` **and** specifying stable API options in :meth:`~pymongo.database.Database.command` command document is not supported and will lead to undefined behaviour. To run any command without declaring a server API version or using a different API version, create a separate :class:`~pymongo.mongo_client.MongoClient` instance. Strict Mode ``````````` Configuring ``strict`` mode will cause the MongoDB server to reject all commands that are not part of the declared :attr:`ServerApi.version`. This includes command options and aggregation pipeline stages. For example:: >>> server_api = ServerApi('1', strict=True) >>> client = MongoClient(server_api=server_api) >>> client.test.command('count', 'test') Traceback (most recent call last): ... pymongo.errors.OperationFailure: Provided apiStrict:true, but the command count is not in API Version 1, full error: {'ok': 0.0, 'errmsg': 'Provided apiStrict:true, but the command count is not in API Version 1', 'code': 323, 'codeName': 'APIStrictError' Detecting API Deprecations `````````````````````````` The ``deprecationErrors`` option can be used to enable command failures when using functionality that is deprecated from the configured :attr:`ServerApi.version`. For example:: >>> server_api = ServerApi('1', deprecation_errors=True) >>> client = MongoClient(server_api=server_api) Note that at the time of this writing, no deprecated APIs exist. Classes ======= ) annotations)AnyMutableMappingOptionalc]tRt^[tRtRtRtR#)ServerApiVersionzSAn enum that defines values for :attr:`ServerApi.version`. .. versionadded:: 3.12 1N)__name__ __module__ __qualname____firstlineno____doc__V1__static_attributes__r P/var/www/html/photoedit/myenv/lib/python3.14/site-packages/pymongo/server_api.pyrr[s B!rrcl]tRt^etRtR RRllt]RRl4t]RRl4t]R R l4t R t R#) ServerApizMongoDB Stable API.Nc$V^8dQhRRRRRR/#)versionstrstrictOptional[bool]deprecation_errorsr )formats"r __annotate__ServerApi.__annotate__hs$666$26O]6rc 4V\P8wd\RV 24hVe.\V\4'g\ R\ V4 24hVe.\V\4'g\ R\ V4 24hWnW nW0n R#)aOptions to configure MongoDB Stable API. :param version: The API version string. Must be one of the values in :class:`ServerApiVersion`. :param strict: Set to ``True`` to enable API strict mode. Defaults to ``None`` which means "use the server's default". :param deprecation_errors: Set to ``True`` to enable deprecation errors. Defaults to ``None`` which means "use the server's default". .. versionadded:: 3.12 zUnknown ServerApi version: NzHWrong type for ServerApi strict, value must be an instance of bool, not zTWrong type for ServerApi deprecation_errors, value must be an instance of bool, not ) rr ValueError isinstancebool TypeErrortype_version_strict_deprecation_errors)selfrrrs&&&&r__init__ServerApi.__init__hs &)) ):7)DE E  j&>&> $V ~/   )*=OQU2V2V,,01C,D+EG   #5 rcV^8dQhRR/#)rreturnrr )rs"rrrsrc VP#)zVThe API version setting. This value is sent to the server in the "apiVersion" field. )r%r(s&rrServerApi.versions }}rcV^8dQhRR/#rr,rr )rs"rrrsrc VP#)zcThe API strict mode setting. When set, this value is sent to the server in the "apiStrict" field. )r&r.s&rrServerApi.stricts ||rcV^8dQhRR/#r1r )rs"rrrs((N(rc VP#)zuThe API deprecation errors setting. When set, this value is sent to the server in the "apiDeprecationErrors" field. )r'r.s&rrServerApi.deprecation_errorss'''r)r'r&r%)NN) r r r r rr)propertyrrrrr rrrresF6>((rrc$V^8dQhRRRRRR/#)rcmdzMutableMapping[str, Any] server_apizOptional[ServerApi]r,Noner )rs"rrrs) D D1 D?R DW[ DrcV'gR#VPVR&VPeVPVR&VPeVPVR&R#R#)zInternal helper which adds API versioning options to a command. :param cmd: The command. :param server_api: A :class:`ServerApi` or ``None``. N apiVersion apiStrictapiDeprecationErrors)rrr)r9r:s&&r_add_to_commandr@sX "**C $%,,K$$0&0&C&C "#1rN) r __future__rtypingrrrrrr@r rrrCs2FN#00""9(9(x Dr