mongo-python-driver/test/test_versioned_api.py
2024-06-06 09:01:24 -07:00

109 lines
4.0 KiB
Python

# Copyright 2020-present MongoDB, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from __future__ import annotations
import os
import sys
sys.path[0:0] = [""]
from test import IntegrationTest, client_context, unittest
from test.unified_format import generate_test_classes
from test.utils import OvertCommandListener, rs_or_single_client
from pymongo.server_api import ServerApi, ServerApiVersion
from pymongo.synchronous.mongo_client import MongoClient
TEST_PATH = os.path.join(os.path.dirname(os.path.realpath(__file__)), "versioned-api")
# Generate unified tests.
globals().update(generate_test_classes(TEST_PATH, module=__name__))
class TestServerApi(IntegrationTest):
RUN_ON_LOAD_BALANCER = True
RUN_ON_SERVERLESS = True
def test_server_api_defaults(self):
api = ServerApi(ServerApiVersion.V1)
self.assertEqual(api.version, "1")
self.assertIsNone(api.strict)
self.assertIsNone(api.deprecation_errors)
def test_server_api_explicit_false(self):
api = ServerApi("1", strict=False, deprecation_errors=False)
self.assertEqual(api.version, "1")
self.assertFalse(api.strict)
self.assertFalse(api.deprecation_errors)
def test_server_api_strict(self):
api = ServerApi("1", strict=True, deprecation_errors=True)
self.assertEqual(api.version, "1")
self.assertTrue(api.strict)
self.assertTrue(api.deprecation_errors)
def test_server_api_validation(self):
with self.assertRaises(ValueError):
ServerApi("2")
with self.assertRaises(TypeError):
ServerApi("1", strict="not-a-bool") # type: ignore[arg-type]
with self.assertRaises(TypeError):
ServerApi("1", deprecation_errors="not-a-bool") # type: ignore[arg-type]
with self.assertRaises(TypeError):
MongoClient(server_api="not-a-ServerApi")
def assertServerApi(self, event):
self.assertIn("apiVersion", event.command)
self.assertEqual(event.command["apiVersion"], "1")
def assertNoServerApi(self, event):
self.assertNotIn("apiVersion", event.command)
def assertServerApiInAllCommands(self, events):
for event in events:
self.assertServerApi(event)
@client_context.require_version_min(4, 7)
def test_command_options(self):
listener = OvertCommandListener()
client = rs_or_single_client(server_api=ServerApi("1"), event_listeners=[listener])
self.addCleanup(client.close)
coll = client.test.test
coll.insert_many([{} for _ in range(100)])
self.addCleanup(coll.delete_many, {})
list(coll.find(batch_size=25))
client.admin.command("ping")
self.assertServerApiInAllCommands(listener.started_events)
@client_context.require_version_min(4, 7)
@client_context.require_transactions
def test_command_options_txn(self):
listener = OvertCommandListener()
client = rs_or_single_client(server_api=ServerApi("1"), event_listeners=[listener])
self.addCleanup(client.close)
coll = client.test.test
coll.insert_many([{} for _ in range(100)])
self.addCleanup(coll.delete_many, {})
listener.reset()
with client.start_session() as s, s.start_transaction():
coll.insert_many([{} for _ in range(100)], session=s)
list(coll.find(batch_size=25, session=s))
client.test.command("find", "test", session=s)
self.assertServerApiInAllCommands(listener.started_events)
if __name__ == "__main__":
unittest.main()