mongo-python-driver/test/test_read_concern.py
2022-02-09 06:44:28 -06:00

119 lines
4.4 KiB
Python

# Copyright 2015-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.
"""Test the read_concern module."""
from test import IntegrationTest, client_context
from test.utils import OvertCommandListener, rs_or_single_client, single_client
from bson.son import SON
from pymongo.errors import OperationFailure
from pymongo.read_concern import ReadConcern
class TestReadConcern(IntegrationTest):
listener: OvertCommandListener
@classmethod
@client_context.require_connection
def setUpClass(cls):
super(TestReadConcern, cls).setUpClass()
cls.listener = OvertCommandListener()
cls.client = single_client(event_listeners=[cls.listener])
cls.db = cls.client.pymongo_test
client_context.client.pymongo_test.create_collection("coll")
@classmethod
def tearDownClass(cls):
cls.client.close()
client_context.client.pymongo_test.drop_collection("coll")
super(TestReadConcern, cls).tearDownClass()
def tearDown(self):
self.listener.results.clear()
super(TestReadConcern, self).tearDown()
def test_read_concern(self):
rc = ReadConcern()
self.assertIsNone(rc.level)
self.assertTrue(rc.ok_for_legacy)
rc = ReadConcern("majority")
self.assertEqual("majority", rc.level)
self.assertFalse(rc.ok_for_legacy)
rc = ReadConcern("local")
self.assertEqual("local", rc.level)
self.assertTrue(rc.ok_for_legacy)
self.assertRaises(TypeError, ReadConcern, 42)
def test_read_concern_uri(self):
uri = "mongodb://%s/?readConcernLevel=majority" % (client_context.pair,)
client = rs_or_single_client(uri, connect=False)
self.assertEqual(ReadConcern("majority"), client.read_concern)
def test_invalid_read_concern(self):
coll = self.db.get_collection("coll", read_concern=ReadConcern("unknown"))
# We rely on the server to validate read concern.
with self.assertRaises(OperationFailure):
coll.find_one()
def test_find_command(self):
# readConcern not sent in command if not specified.
coll = self.db.coll
tuple(coll.find({"field": "value"}))
self.assertNotIn("readConcern", self.listener.results["started"][0].command)
self.listener.results.clear()
# Explicitly set readConcern to 'local'.
coll = self.db.get_collection("coll", read_concern=ReadConcern("local"))
tuple(coll.find({"field": "value"}))
self.assertEqualCommand(
SON(
[
("find", "coll"),
("filter", {"field": "value"}),
("readConcern", {"level": "local"}),
]
),
self.listener.results["started"][0].command,
)
def test_command_cursor(self):
# readConcern not sent in command if not specified.
coll = self.db.coll
tuple(coll.aggregate([{"$match": {"field": "value"}}]))
self.assertNotIn("readConcern", self.listener.results["started"][0].command)
self.listener.results.clear()
# Explicitly set readConcern to 'local'.
coll = self.db.get_collection("coll", read_concern=ReadConcern("local"))
tuple(coll.aggregate([{"$match": {"field": "value"}}]))
self.assertEqual(
{"level": "local"}, self.listener.results["started"][0].command["readConcern"]
)
def test_aggregate_out(self):
coll = self.db.get_collection("coll", read_concern=ReadConcern("local"))
tuple(coll.aggregate([{"$match": {"field": "value"}}, {"$out": "output_collection"}]))
# Aggregate with $out supports readConcern MongoDB 4.2 onwards.
if client_context.version >= (4, 1):
self.assertIn("readConcern", self.listener.results["started"][0].command)
else:
self.assertNotIn("readConcern", self.listener.results["started"][0].command)