1
# Copyright (C) 2008 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""Tests for the fifo_cache module."""
23
from ..sixish import (
30
class TestFIFOCache(tests.TestCase):
31
"""Test that FIFO cache properly keeps track of entries."""
33
def test_add_is_present(self):
34
c = fifo_cache.FIFOCache()
36
self.assertTrue(1 in c)
37
self.assertEqual(1, len(c))
38
self.assertEqual(2, c[1])
39
self.assertEqual(2, c.get(1))
40
self.assertEqual(2, c.get(1, None))
41
self.assertEqual([1], list(c))
42
self.assertEqual({1}, viewkeys(c))
43
self.assertEqual([(1, 2)], sorted(viewitems(c)))
44
self.assertEqual([2], sorted(viewvalues(c)))
45
self.assertEqual({1: 2}, c)
47
def test_cache_size(self):
48
c = fifo_cache.FIFOCache()
49
self.assertEqual(100, c.cache_size())
51
self.assertEqual(20, c.cache_size())
53
def test_missing(self):
54
c = fifo_cache.FIFOCache()
55
self.assertRaises(KeyError, c.__getitem__, 1)
56
self.assertFalse(1 in c)
57
self.assertEqual(0, len(c))
58
self.assertEqual(None, c.get(1))
59
self.assertEqual(None, c.get(1, None))
60
self.assertEqual([], list(c))
61
self.assertEqual(set(), viewkeys(c))
62
self.assertEqual([], list(viewitems(c)))
63
self.assertEqual([], list(viewvalues(c)))
64
self.assertEqual({}, c)
66
def test_add_maintains_fifo(self):
67
c = fifo_cache.FIFOCache(4, 4)
72
self.assertEqual({1, 2, 3, 4}, viewkeys(c))
74
# This should pop out the oldest entry
75
self.assertEqual({2, 3, 4, 5}, viewkeys(c))
76
# Replacing an item doesn't change the stored keys
78
self.assertEqual({2, 3, 4, 5}, viewkeys(c))
79
# But it does change the position in the FIFO
81
self.assertEqual({2, 4, 5, 6}, viewkeys(c))
82
self.assertEqual([4, 5, 2, 6], list(c._queue))
84
def test_default_after_cleanup_count(self):
85
c = fifo_cache.FIFOCache(5)
86
self.assertEqual(4, c._after_cleanup_count)
92
# So far, everything fits
93
self.assertEqual({1, 2, 3, 4, 5}, viewkeys(c))
95
# But adding one more should shrink down to after_cleanup_count
96
self.assertEqual({3, 4, 5, 6}, viewkeys(c))
99
c = fifo_cache.FIFOCache(5)
106
self.assertEqual({2, 3, 4, 5}, viewkeys(c))
108
self.assertEqual(set(), viewkeys(c))
109
self.assertEqual([], list(c._queue))
110
self.assertEqual({}, c)
112
def test_copy_not_implemented(self):
113
c = fifo_cache.FIFOCache()
114
self.assertRaises(NotImplementedError, c.copy)
116
def test_pop_not_implemeted(self):
117
c = fifo_cache.FIFOCache()
118
self.assertRaises(NotImplementedError, c.pop, 'key')
120
def test_popitem_not_implemeted(self):
121
c = fifo_cache.FIFOCache()
122
self.assertRaises(NotImplementedError, c.popitem)
124
def test_resize_smaller(self):
125
c = fifo_cache.FIFOCache()
131
# No cleanup, because it is the exact size
133
self.assertEqual({1: 2, 2: 3, 3: 4, 4: 5, 5: 6}, c)
134
self.assertEqual(5, c.cache_size())
135
# Adding one more will trigger a cleanup, though
137
self.assertEqual({3: 4, 4: 5, 5: 6, 6: 7}, c)
139
self.assertEqual({5: 6, 6: 7}, c)
141
def test_resize_larger(self):
142
c = fifo_cache.FIFOCache(5, 4)
148
# No cleanup, because it is the exact size
150
self.assertEqual({1: 2, 2: 3, 3: 4, 4: 5, 5: 6}, c)
151
self.assertEqual(10, c.cache_size())
157
self.assertEqual({1: 2, 2: 3, 3: 4, 4: 5, 5: 6, 6: 7, 7: 8, 8: 9,
160
self.assertEqual({4: 5, 5: 6, 6: 7, 7: 8, 8: 9, 9: 10, 10: 11,
163
def test_setdefault(self):
164
c = fifo_cache.FIFOCache(5, 4)
169
self.assertIs(myobj, c.setdefault('four', myobj))
170
self.assertEqual({'one': 1, 'two': 2, 'three': 3, 'four': myobj}, c)
171
self.assertEqual(3, c.setdefault('three', myobj))
172
c.setdefault('five', myobj)
173
c.setdefault('six', myobj)
174
self.assertEqual({'three': 3, 'four': myobj, 'five': myobj,
177
def test_update(self):
178
c = fifo_cache.FIFOCache(5, 4)
179
# We allow an iterable
180
c.update([(1, 2), (3, 4)])
181
self.assertEqual({1: 2, 3: 4}, c)
183
c.update(foo=3, bar=4)
184
self.assertEqual({1: 2, 3: 4, 'foo': 3, 'bar': 4}, c)
185
# Even a dict (This triggers a cleanup)
186
c.update({'baz': 'biz', 'bing': 'bang'})
187
self.assertEqual({'foo': 3, 'bar': 4, 'baz': 'biz', 'bing': 'bang'}, c)
188
# We only allow 1 iterable, just like dict
189
self.assertRaises(TypeError, c.update, [(1, 2)], [(3, 4)])
190
# But you can mix and match. kwargs take precedence over iterable
191
c.update([('a', 'b'), ('d', 'e')], a='c', q='r')
192
self.assertEqual({'baz': 'biz', 'bing': 'bang',
193
'a': 'c', 'd': 'e', 'q': 'r'}, c)
195
def test_cleanup_funcs(self):
198
def logging_cleanup(key, value):
199
log.append((key, value))
200
c = fifo_cache.FIFOCache(5, 4)
201
c.add(1, 2, cleanup=logging_cleanup)
202
c.add(2, 3, cleanup=logging_cleanup)
203
c.add(3, 4, cleanup=logging_cleanup)
204
c.add(4, 5, cleanup=None) # no cleanup for 4
205
c[5] = 6 # no cleanup for 5
206
self.assertEqual([], log)
207
# Adding another key should cleanup 1 & 2
208
c.add(6, 7, cleanup=logging_cleanup)
209
self.assertEqual([(1, 2), (2, 3)], log)
211
# replacing 3 should trigger a cleanup
212
c.add(3, 8, cleanup=logging_cleanup)
213
self.assertEqual([(3, 4)], log)
216
self.assertEqual([(3, 8)], log)
218
# Clearing everything should call all remaining cleanups
220
self.assertEqual([(6, 7)], log)
222
c.add(8, 9, cleanup=logging_cleanup)
223
# __delitem__ should also trigger a cleanup
225
self.assertEqual([(8, 9)], log)
227
def test_cleanup_at_deconstruct(self):
230
def logging_cleanup(key, value):
231
log.append((key, value))
232
c = fifo_cache.FIFOCache()
233
c.add(1, 2, cleanup=logging_cleanup)
235
# As a matter of design, bzr does not (can not) count on anything
236
# being run from Python __del__ methods, because they may not run for
237
# a long time, and because in cPython merely having them defined
238
# interferes with garbage collection.
239
self.assertEqual([], log)
242
class TestFIFOSizeCache(tests.TestCase):
244
def test_add_is_present(self):
245
c = fifo_cache.FIFOSizeCache()
247
self.assertTrue(1 in c)
248
self.assertEqual(1, len(c))
249
self.assertEqual('2', c[1])
250
self.assertEqual('2', c.get(1))
251
self.assertEqual('2', c.get(1, None))
252
self.assertEqual([1], list(c))
253
self.assertEqual({1}, viewkeys(c))
254
self.assertEqual([(1, '2')], sorted(viewitems(c)))
255
self.assertEqual(['2'], sorted(viewvalues(c)))
256
self.assertEqual({1: '2'}, c)
257
self.assertEqual(1024 * 1024, c.cache_size())
259
def test_missing(self):
260
c = fifo_cache.FIFOSizeCache()
261
self.assertRaises(KeyError, c.__getitem__, 1)
262
self.assertFalse(1 in c)
263
self.assertEqual(0, len(c))
264
self.assertEqual(None, c.get(1))
265
self.assertEqual(None, c.get(1, None))
266
self.assertEqual([], list(c))
267
self.assertEqual(set(), viewkeys(c))
268
self.assertEqual([], list(viewitems(c)))
269
self.assertEqual([], list(viewvalues(c)))
270
self.assertEqual({}, c)
272
def test_add_maintains_fifo(self):
273
c = fifo_cache.FIFOSizeCache(10, 8)
277
self.assertEqual({1: 'ab', 2: 'cde', 3: 'fghi'}, c)
278
c[4] = 'jkl' # Collapse
279
self.assertEqual({3: 'fghi', 4: 'jkl'}, c)
280
# Replacing an item will bump it to the end of the queue
282
self.assertEqual({3: 'mnop', 4: 'jkl'}, c)
284
self.assertEqual({3: 'mnop', 5: 'qrst'}, c)
286
def test_adding_large_key(self):
287
c = fifo_cache.FIFOSizeCache(10, 8)
288
c[1] = 'abcdefgh' # Adding a large key won't get cached at all
289
self.assertEqual({}, c)
291
self.assertEqual({1: 'abcdefg'}, c)
292
# Replacing with a too-large key will remove it
294
self.assertEqual({}, c)
295
self.assertEqual(0, c._value_size)
297
def test_resize_smaller(self):
298
c = fifo_cache.FIFOSizeCache(20, 16)
303
# No cleanup, because it is the exact size
305
self.assertEqual({1: 'a', 2: 'bc', 3: 'def', 4: 'ghij'}, c)
306
self.assertEqual(10, c.cache_size())
307
# Adding one more will trigger a cleanup, though
309
self.assertEqual({3: 'def', 4: 'ghij', 5: 'k'}, c)
311
self.assertEqual({5: 'k'}, c)
313
def test_resize_larger(self):
314
c = fifo_cache.FIFOSizeCache(10, 8)
320
self.assertEqual({1: 'a', 2: 'bc', 3: 'def', 4: 'ghij'}, c)
322
self.assertEqual({1: 'a', 2: 'bc', 3: 'def', 4: 'ghij', 5: 'kl'}, c)
324
self.assertEqual({4: 'ghij', 5: 'kl', 6: 'mn'}, c)