def setUp(self):
super(TestReadOnlyMode, self).setUp()
# Ensure db directory exists, since read only mode
# cannot create the db directory
db = semidbm.open(self.dbdir, 'c')
db.close()
def test_keys_method(self):
db = self.open_db_file()
db['one'] = 'bar'
db['two'] = 'bar'
db['three'] = 'bar'
self.assertEqual(set(db.keys()), set([b'one', b'two', b'three']))
db.close()
def test_compact_on_close(self):
db = self.open_db_file()
db['key'] = 'original'
del db['key']
db.close(compact=True)
# Header is 8 bytes.
self.assertEqual(len(open(db._data_filename).read()), 8)
def test_compact_on_close(self):
db = self.open_db_file()
db['key'] = 'original'
del db['key']
db.close(compact=True)
# Header is 8 bytes.
self.assertEqual(len(open(db._data_filename).read()), 8)
def test_iterate(self):
db = self.open_db_file()
db['one'] = 'foo'
db['two'] = 'bar'
db['three'] = 'baz'
self.assertEqual(set(db), set([b'one', b'two', b'three']))
db.close()
def test_recover_from_last_failed_write(self):
# Testing this scenario:
# - we're writing a large object, we write the entry
# header properly but we crash so we don't write out the
# full value. The next time the db is loaded we should
# be able to recover from this situation.
db = self.open_db_file()
# First write a few good keys.
db['foobar'] = 'foobar'
db['key'] = 'value'
db['key2'] = 'value2'
# Now simulate a failing write.
db['largevalue'] = 'foobarbaz' * 1024
db.close()
# This is implementation specific, but we're going to read the raw data
# file and truncate it.
with self.open_data_file(mode='rb') as f:
filename = f.name
original_size = os.path.getsize(filename)
self.truncate_data_file(bytes_from_end=100)
db2 = self.open_db_file()
self.assertEquals(db2['foobar'], b'foobar')
self.assertEquals(db2['key'], b'value')
self.assertEquals(db2['key2'], b'value2')
# But largevalue is not there, we recovered and just removed it.
self.assertNotIn('largevalue', db2)
# And when we compact the data file, the junk data
# is ignored and not written to the new file.
db2.compact()
db2.close()
new_size = os.path.getsize(filename)
self.assertTrue(new_size < original_size)
def test_iterate(self):
db = self.open_db_file()
db['one'] = 'foo'
db['two'] = 'bar'
db['three'] = 'baz'
self.assertEqual(set(db), set([b'one', b'two', b'three']))
db.close()
def test_keys_method(self):
db = self.open_db_file()
db['one'] = 'bar'
db['two'] = 'bar'
db['three'] = 'bar'
self.assertEqual(set(db.keys()), set([b'one', b'two', b'three']))
db.close()
def test_recover_from_last_failed_write(self):
# Testing this scenario:
# - we're writing a large object, we write the entry
# header properly but we crash so we don't write out the
# full value. The next time the db is loaded we should
# be able to recover from this situation.
db = self.open_db_file()
# First write a few good keys.
db['foobar'] = 'foobar'
db['key'] = 'value'
db['key2'] = 'value2'
# Now simulate a failing write.
db['largevalue'] = 'foobarbaz' * 1024
db.close()
# This is implementation specific, but we're going to read the raw data
# file and truncate it.
with self.open_data_file(mode='rb') as f:
filename = f.name
original_size = os.path.getsize(filename)
self.truncate_data_file(bytes_from_end=100)
db2 = self.open_db_file()
self.assertEquals(db2['foobar'], b'foobar')
self.assertEquals(db2['key'], b'value')
self.assertEquals(db2['key2'], b'value2')
# But largevalue is not there, we recovered and just removed it.
self.assertNotIn('largevalue', db2)
# And when we compact the data file, the junk data
# is ignored and not written to the new file.
db2.compact()
db2.close()
new_size = os.path.getsize(filename)
self.assertTrue(new_size < original_size)
def test_values_method(self):
db = self.open_db_file()
db['one'] = 'one_value'
db['two'] = 'two_value'
db['three'] = 'three_value'
self.assertEqual(set(db.values()), set([b'one_value', b'two_value',
b'three_value']))
db.close()
def test_inserts_after_deletes(self):
db = self.open_db_file()
db['one'] = b'one'
del db['one']
db['two'] = b'two'
self.assertEqual(db['two'], b'two')
db.close()
def test_updates(self):
db = self.open_db_file()
db['one'] = 'foo'
db['one'] = 'bar'
self.assertEqual(db['one'], b'bar')
db['one'] = 'baz'
self.assertEqual(db['one'], b'baz')
db.close()
def test_values_method(self):
db = self.open_db_file()
db['one'] = 'one_value'
db['two'] = 'two_value'
db['three'] = 'three_value'
self.assertEqual(set(db.values()),
set([b'one_value', b'two_value', b'three_value']))
db.close()
def test_updates(self):
db = self.open_db_file()
db['one'] = 'foo'
db['one'] = 'bar'
self.assertEqual(db['one'], b'bar')
db['one'] = 'baz'
self.assertEqual(db['one'], b'baz')
db.close()
def test_inserts_after_deletes(self):
db = self.open_db_file()
db['one'] = b'one'
del db['one']
db['two'] = b'two'
self.assertEqual(db['two'], b'two')
db.close()
def test_key_does_not_exist(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db.close()
read_only = self.open_db_file()
self.assertRaises(KeyError, read_only.__getitem__, 'bar')
read_only.close()
def test_when_files_exist(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
db_write_mode = semidbm.open(self.dbdir, 'w')
self.assertEqual(db_write_mode['foo'], b'bar')
db_write_mode.close()
def test_key_does_not_exist(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db.close()
read_only = self.open_db_file()
self.assertRaises(KeyError, read_only.__getitem__, 'bar')
read_only.close()
def test_when_files_exist(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
db_write_mode = semidbm.open(self.dbdir, 'w')
self.assertEqual(db_write_mode['foo'], b'bar')
db_write_mode.close()
def test_intermixed_inserts_and_retrievals(self):
db = self.open_db_file()
db['one'] = '1'
db['two'] = '2'
self.assertEqual(db['one'], b'1')
db['three'] = '3'
self.assertEqual(db['two'], b'2')
self.assertEqual(db['three'], b'3')
db.close()
def test_insert_multiple(self):
db = self.open_db_file()
db['one'] = '1'
db['two'] = '2'
db['three'] = '3'
self.assertEqual(db['one'], b'1')
self.assertEqual(db['two'], b'2')
self.assertEqual(db['three'], b'3')
db.close()
def test_insert_close_retrieve(self):
# This will verify loading the index.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['foo'], b'bar')
db2.close()
def test_close_never_compacts_index(self):
db = self.open_db_file()
db.calls = []
db.compact = lambda: db.calls.append('compact')
db.sync = lambda: db.calls.append('sync')
db.close(compact=True)
self.assertEqual(db.calls, [])
def test_intermixed_inserts_and_retrievals(self):
db = self.open_db_file()
db['one'] = '1'
db['two'] = '2'
self.assertEqual(db['one'], b'1')
db['three'] = '3'
self.assertEqual(db['two'], b'2')
self.assertEqual(db['three'], b'3')
db.close()
def test_insert_multiple(self):
db = self.open_db_file()
db['one'] = '1'
db['two'] = '2'
db['three'] = '3'
self.assertEqual(db['one'], b'1')
self.assertEqual(db['two'], b'2')
self.assertEqual(db['three'], b'3')
db.close()
def test_bad_magic_number(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
with self.open_data_file(mode='rb+') as f:
f.seek(0)
f.write(b'Z')
# Opening the db file should now fail.
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_incompatible_version_number(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
with self.open_data_file(mode='rb+') as f:
f.seek(4)
f.write(struct.pack('!H', 2))
# Opening the db file should now fail.
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_insert_close_retrieve(self):
# This will verify loading the index.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['foo'], b'bar')
db2.close()
def test_close_never_compacts_index(self):
db = self.open_db_file()
db.calls = []
db.compact = lambda: db.calls.append('compact')
db.sync = lambda: db.calls.append('sync')
db.close(compact=True)
self.assertEqual(db.calls, [])
def test_bad_magic_number(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
with self.open_data_file(mode='rb+') as f:
f.seek(0)
f.write(b'Z')
# Opening the db file should now fail.
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_incompatible_version_number(self):
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
with self.open_data_file(mode='rb+') as f:
f.seek(4)
f.write(struct.pack('!H', 2))
# Opening the db file should now fail.
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_updates_persist(self):
db = self.open_db_file()
db['one'] = 'foo'
db['one'] = 'bar'
db['one'] = 'baz'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['one'], b'baz')
db2.close()
def test_sync_contents(self):
# So there's not really a good way to test this, so
# I'm just making sure you can call it, and you can see the data.
db = self.open_db_file()
db['foo'] = 'bar'
db.sync()
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['foo'], b'bar')
db2.close()
def test_sync_contents(self):
# So there's not really a good way to test this, so
# I'm just making sure you can call it, and you can see the data.
db = self.open_db_file()
db['foo'] = 'bar'
db.sync()
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['foo'], b'bar')
db2.close()
def test_open_read_multiple_times(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db.close()
# Open then close db immediately.
db2 = self.open_db_file()
db2.close()
read_only = self.open_db_file()
self.assertEqual(read_only['foo'], b'bar')
read_only.close()
def test_open_read_multiple_times(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db.close()
# Open then close db immediately.
db2 = self.open_db_file()
db2.close()
read_only = self.open_db_file()
self.assertEqual(read_only['foo'], b'bar')
read_only.close()
def test_updates_persist(self):
db = self.open_db_file()
db['one'] = 'foo'
db['one'] = 'bar'
db['one'] = 'baz'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['one'], b'baz')
db2.close()
def test_compact_then_write_data(self):
db = self.open_db_file()
db['before'] = 'before'
del db['before']
db.compact()
db['after'] = 'after'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['after'], b'after')
db2.close()
def test_delete_key_not_there_when_reopened(self):
db = self.open_db_file()
db['foo'] = 'foo'
db['bar'] = 'bar'
del db['foo']
db.close()
db2 = self.open_db_file()
self.assertTrue('foo' not in db2)
self.assertEqual(db2['bar'], b'bar')
db2.close()
def test_compact_then_write_data(self):
db = self.open_db_file()
db['before'] = 'before'
del db['before']
db.compact()
db['after'] = 'after'
db.close()
db2 = self.open_db_file()
self.assertEqual(db2['after'], b'after')
db2.close()
def test_delete_key_not_there_when_reopened(self):
db = self.open_db_file()
db['foo'] = 'foo'
db['bar'] = 'bar'
del db['foo']
db.close()
db2 = self.open_db_file()
self.assertTrue('foo' not in db2)
self.assertEqual(db2['bar'], b'bar')
db2.close()
def test_can_read_items(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db['bar'] = 'baz'
db['baz'] = 'foo'
db.close()
read_only = self.open_db_file()
self.assertEqual(read_only[b'foo'], b'bar')
self.assertEqual(read_only[b'bar'], b'baz')
self.assertEqual(read_only[b'baz'], b'foo')
read_only.close()
def test_can_read_items(self):
db = semidbm.open(self.dbdir, 'c')
db['foo'] = 'bar'
db['bar'] = 'baz'
db['baz'] = 'foo'
db.close()
read_only = self.open_db_file()
self.assertEqual(read_only[b'foo'], b'bar')
self.assertEqual(read_only[b'bar'], b'baz')
self.assertEqual(read_only[b'baz'], b'foo')
read_only.close()
def test_when_file_does_not_exist(self):
path = os.path.join(self.tempdir, 'foo.db')
db = semidbm.open(path, 'n')
db['foo'] = 'bar'
self.assertEqual(db['foo'], b'bar')
db.close()
# Opening the file again should basically blank out
# any existing database.
db = semidbm.open(path, 'n')
self.assertEqual(list(db.keys()), [])
db.close()
def test_key_size_says_to_read_past_end_of_file(self):
# We can create this situation by creating an entry
# and truncating the key/value part.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
# From the end we have a 4 byte checksum + 3 bytes for
# the key and 3 bytes for the value, or a total of
# 10 bytes. We'll chop off 8 which means we're missing
# the checksum, the value, and one byte of the key.
self.truncate_data_file(bytes_from_end=8)
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_key_size_says_to_read_past_end_of_file(self):
# We can create this situation by creating an entry
# and truncating the key/value part.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
# From the end we have a 4 byte checksum + 3 bytes for
# the key and 3 bytes for the value, or a total of
# 10 bytes. We'll chop off 8 which means we're missing
# the checksum, the value, and one byte of the key.
self.truncate_data_file(bytes_from_end=8)
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_when_file_does_not_exist(self):
path = os.path.join(self.tempdir, 'foo.db')
db = semidbm.open(path, 'n')
db['foo'] = 'bar'
self.assertEqual(db['foo'], b'bar')
db.close()
# Opening the file again should basically blank out
# any existing database.
db = semidbm.open(path, 'n')
self.assertEqual(list(db.keys()), [])
db.close()
def test_mixed_updates_and_deletes(self):
db = self.open_db_file()
db['one'] = 'one'
db['CHECK'] = 'original'
db['two'] = 'two'
db['CHECK'] = 'updated'
del db['CHECK']
db['three'] = 'three'
self.assertEqual(db['one'], b'one')
self.assertEqual(db['two'], b'two')
self.assertEqual(db['three'], b'three')
db.close()
def test_compact_and_retrieve_data(self):
db = self.open_db_file()
db['one'] = 'foo'
db['key'] = 'original'
db['two'] = 'bar'
db['key'] = 'updated'
del db['key']
db['three'] = 'baz'
db.compact()
self.assertEqual(db['one'], b'foo')
self.assertEqual(db['two'], b'bar')
self.assertEqual(db['three'], b'baz')
db.close()
def test_compaction_does_not_leave_behind_files(self):
db = self.open_db_file()
before = len(os.listdir(self.dbdir))
for i in range(10):
db[str(i)] = str(i)
for i in range(10):
del db[str(i)]
db.close()
db2 = self.open_db_file()
db2.compact()
db2.close()
after = len(os.listdir(self.dbdir))
self.assertEqual(before, after, os.listdir(self.dbdir))
def test_mixed_updates_and_deletes(self):
db = self.open_db_file()
db['one'] = 'one'
db['CHECK'] = 'original'
db['two'] = 'two'
db['CHECK'] = 'updated'
del db['CHECK']
db['three'] = 'three'
self.assertEqual(db['one'], b'one')
self.assertEqual(db['two'], b'two')
self.assertEqual(db['three'], b'three')
db.close()
def test_compaction_does_not_leave_behind_files(self):
db = self.open_db_file()
before = len(os.listdir(self.dbdir))
for i in range(10):
db[str(i)] = str(i)
for i in range(10):
del db[str(i)]
db.close()
db2 = self.open_db_file()
db2.compact()
db2.close()
after = len(os.listdir(self.dbdir))
self.assertEqual(before, after, os.listdir(self.dbdir))
def test_compact_and_retrieve_data(self):
db = self.open_db_file()
db['one'] = 'foo'
db['key'] = 'original'
db['two'] = 'bar'
db['key'] = 'updated'
del db['key']
db['three'] = 'baz'
db.compact()
self.assertEqual(db['one'], b'foo')
self.assertEqual(db['two'], b'bar')
self.assertEqual(db['three'], b'baz')
db.close()
def test_multiple_deletes(self):
db = self.open_db_file()
db['foo'] = 'foo'
del db['foo']
db['foo'] = 'foo'
del db['foo']
db['foo'] = 'foo'
del db['foo']
db['bar'] = 'bar'
db.close()
db2 = self.open_db_file()
self.assertTrue('foo' not in db2)
self.assertEqual(db2['bar'], b'bar')
db2.close()
def test_multiple_deletes(self):
db = self.open_db_file()
db['foo'] = 'foo'
del db['foo']
db['foo'] = 'foo'
del db['foo']
db['foo'] = 'foo'
del db['foo']
db['bar'] = 'bar'
db.close()
db2 = self.open_db_file()
self.assertTrue('foo' not in db2)
self.assertEqual(db2['bar'], b'bar')
db2.close()
def test_file_thats_truncated(self):
# Let's say that the file header is fine, but part
# of the header for an individual record has been
# trunated.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
# Now let's truncate the file to only 10 bytes which
# will include the file header and part of an entry
# header.
with self.open_data_file(mode='rb') as f:
contents = f.read()
with self.open_data_file(mode='wb') as f2:
f2.write(contents[:10])
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_file_thats_truncated(self):
# Let's say that the file header is fine, but part
# of the header for an individual record has been
# trunated.
db = self.open_db_file()
db['foo'] = 'bar'
db.close()
# Now let's truncate the file to only 10 bytes which
# will include the file header and part of an entry
# header.
with self.open_data_file(mode='rb') as f:
contents = f.read()
with self.open_data_file(mode='wb') as f2:
f2.write(contents[:10])
self.assertRaises(semidbm.DBMLoadError, self.open_db_file)
def test_remap_required(self):
# Verify the loading buffer logic works. This is
# really slow.
size = (semidbm.loaders.mmapload._MAPPED_LOAD_PAGES *
mmap.ALLOCATIONGRANULARITY * 4)
db = self.open_db_file()
# 100 byte values.
values = b'abcd' * 25
for i in range(int(size / 100)):
db[str(i)] = values
db.close()
db2 = self.open_db_file()
for k in db2:
self.assertEqual(db2[k], values)
db2.close()
def test_remap_required(self):
# Verify the loading buffer logic works. This is
# really slow.
size = (
semidbm.loaders.mmapload._MAPPED_LOAD_PAGES *
mmap.ALLOCATIONGRANULARITY * 4)
db = self.open_db_file()
# 100 byte values.
values = b'abcd' * 25
for i in range(int(size / 100)):
db[str(i)] = values
db.close()
db2 = self.open_db_file()
for k in db2:
self.assertEqual(db2[k], values)
db2.close()
def test_checksum_failure(self):
db = semidbm.open(self.dbdir, 'c')
db[b'key'] = b'value'
db.close()
data_file = self.open_data_file(mode='rb')
contents = data_file.read()
data_file.close()
# Changing 'value' to 'Value' should cause a checksum failure.
contents = contents.replace(b'value', b'Value')
data_file = self.open_data_file(mode='wb')
data_file.write(contents)
data_file.close()
db = self.open_db_file(verify_checksums=True)
with self.assertRaises(semidbm.DBMChecksumError):
db['key']
db.close()
# If checksums are not enabled, an exception is not raised.
db = self.open_db_file(verify_checksums=False)
try:
db['key']
except semidbm.DBMChecksumError:
self.fail("Checksums were suppose to be disabled.")
finally:
db.close()