Repository URL to install this package:
|
Version:
3.12.2 ▾
|
# 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 bson.son import SON
from pymongo.errors import ConfigurationError
from pymongo.read_concern import ReadConcern
from test import client_context, IntegrationTest
from test.utils import single_client, rs_or_single_client, OvertCommandListener
class TestReadConcern(IntegrationTest):
@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)
@client_context.require_version_max(3, 1)
def test_invalid_read_concern(self):
coll = self.db.get_collection(
'coll', read_concern=ReadConcern('majority'))
self.assertRaisesRegexp(
ConfigurationError,
'read concern level of majority is not valid '
'with a max wire version of [0-3]',
coll.count)
@client_context.require_version_min(3, 1, 9, -1)
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)
@client_context.require_version_min(3, 1, 9, -1)
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)
def test_map_reduce_out(self):
coll = self.db.get_collection('coll', read_concern=ReadConcern('local'))
coll.map_reduce('function() { emit(this._id, this.value); }',
'function(key, values) { return 42; }',
out='output_collection')
self.assertNotIn('readConcern',
self.listener.results['started'][0].command)
if client_context.version.at_least(3, 1, 9, -1):
self.listener.results.clear()
coll.map_reduce(
'function() { emit(this._id, this.value); }',
'function(key, values) { return 42; }',
out={'inline': 1})
self.assertEqual(
{'level': 'local'},
self.listener.results['started'][0].command['readConcern'])
@client_context.require_version_min(3, 1, 9, -1)
def test_inline_map_reduce(self):
coll = self.db.get_collection('coll', read_concern=ReadConcern('local'))
tuple(coll.inline_map_reduce(
'function() { emit(this._id, this.value); }',
'function(key, values) { return 42; }'))
self.assertEqual(
{'level': 'local'},
self.listener.results['started'][0].command['readConcern'])