1
# Copyright (C) 2009 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 StaticTuple type."""
31
def load_tests(standard_tests, module, loader):
32
"""Parameterize tests for all versions of groupcompress."""
34
('python', {'module': _static_tuple_py}),
36
suite = loader.suiteClass()
37
if CompiledStaticTuple.available():
38
from bzrlib import _static_tuple_c
39
scenarios.append(('C', {'module': _static_tuple_c}))
41
# the compiled module isn't available, so we add a failing test
42
class FailWithoutFeature(tests.TestCase):
44
self.requireFeature(CompiledStaticTuple)
45
suite.addTest(loader.loadTestsFromTestCase(FailWithoutFeature))
46
result = tests.multiply_tests(standard_tests, scenarios, suite)
50
class _CompiledStaticTuple(tests.Feature):
54
import bzrlib._static_tuple_c
59
def feature_name(self):
60
return 'bzrlib._static_tuple_c'
62
CompiledStaticTuple = _CompiledStaticTuple()
65
class _Meliae(tests.Feature):
69
from meliae import scanner
74
def feature_name(self):
75
return "Meliae - python memory debugger"
80
class TestStaticTuple(tests.TestCase):
82
def assertRefcount(self, count, obj):
83
"""Assert that the refcount for obj is what we expect.
85
Note that this automatically adjusts for the fact that calling
86
assertRefcount actually creates a new pointer, as does calling
87
sys.getrefcount. So pass the expected value *before* the call.
89
# I don't understand why it is getrefcount()-3 here, but it seems to be
90
# correct. If I check in the calling function, with:
91
# self.assertEqual(count, sys.getrefcount(obj)-1)
92
# Then it works fine. Something about passing it to assertRefcount is
93
# actually double-incrementing (and decrementing) the refcount
94
self.assertEqual(count, sys.getrefcount(obj)-3)
96
def test_create(self):
97
k = self.module.StaticTuple('foo')
98
k = self.module.StaticTuple('foo', 'bar')
100
def test_create_bad_args(self):
103
self.assertRaises(ValueError, self.module.StaticTuple, *args_256)
105
self.assertRaises(ValueError, self.module.StaticTuple, *args_300)
107
self.assertRaises(TypeError, self.module.StaticTuple, 10)
109
def test_as_tuple(self):
110
k = self.module.StaticTuple('foo')
112
self.assertEqual(('foo',), t)
113
k = self.module.StaticTuple('foo', 'bar')
115
self.assertEqual(('foo', 'bar'), t)
118
k = self.module.StaticTuple()
119
self.assertEqual(0, len(k))
120
k = self.module.StaticTuple('foo')
121
self.assertEqual(1, len(k))
122
k = self.module.StaticTuple('foo', 'bar')
123
self.assertEqual(2, len(k))
124
k = self.module.StaticTuple('foo', 'bar', 'b', 'b', 'b', 'b', 'b')
125
self.assertEqual(7, len(k))
127
k = self.module.StaticTuple(*args)
128
self.assertEqual(255, len(k))
130
def test_hold_other_static_tuples(self):
131
k = self.module.StaticTuple('foo', 'bar')
132
k2 = self.module.StaticTuple(k, k)
133
self.assertEqual(2, len(k2))
134
self.assertIs(k, k2[0])
135
self.assertIs(k, k2[1])
137
def test_getitem(self):
138
k = self.module.StaticTuple('foo', 'bar', 'b', 'b', 'b', 'b', 'z')
139
self.assertEqual('foo', k[0])
140
self.assertEqual('foo', k[0])
141
self.assertEqual('foo', k[0])
142
self.assertEqual('z', k[6])
143
self.assertEqual('z', k[-1])
144
self.assertRaises(IndexError, k.__getitem__, 7)
145
self.assertRaises(IndexError, k.__getitem__, 256+7)
146
self.assertRaises(IndexError, k.__getitem__, 12024)
147
# Python's [] resolver handles the negative arguments, so we can't
148
# really test StaticTuple_item() with negative values.
149
self.assertRaises(TypeError, k.__getitem__, 'not-an-int')
150
self.assertRaises(TypeError, k.__getitem__, '5')
152
def test_refcount(self):
154
num_refs = sys.getrefcount(f) - 1 #sys.getrefcount() adds one
155
k = self.module.StaticTuple(f)
156
self.assertRefcount(num_refs + 1, f)
158
self.assertRefcount(num_refs + 2, f)
160
self.assertRefcount(num_refs + 2, f)
162
self.assertRefcount(num_refs + 3, f)
164
self.assertRefcount(num_refs + 1, f)
166
self.assertRefcount(num_refs, f)
168
def test__repr__(self):
169
k = self.module.StaticTuple('foo', 'bar', 'baz', 'bing')
170
self.assertEqual("StaticTuple('foo', 'bar', 'baz', 'bing')", repr(k))
172
def assertCompareEqual(self, k1, k2):
173
self.assertTrue(k1 == k2)
174
self.assertTrue(k1 <= k2)
175
self.assertTrue(k1 >= k2)
176
self.assertFalse(k1 != k2)
177
self.assertFalse(k1 < k2)
178
self.assertFalse(k1 > k2)
180
def test_compare_same_obj(self):
181
k1 = self.module.StaticTuple('foo', 'bar')
182
self.assertCompareEqual(k1, k1)
183
k2 = self.module.StaticTuple(k1, k1)
184
self.assertCompareEqual(k2, k2)
186
def test_compare_equivalent_obj(self):
187
k1 = self.module.StaticTuple('foo', 'bar')
188
k2 = self.module.StaticTuple('foo', 'bar')
189
self.assertCompareEqual(k1, k2)
190
k3 = self.module.StaticTuple(k1, k2)
191
k4 = self.module.StaticTuple(k2, k1)
192
self.assertCompareEqual(k1, k2)
194
def test_compare_similar_obj(self):
195
k1 = self.module.StaticTuple('foo' + ' bar', 'bar' + ' baz')
196
k2 = self.module.StaticTuple('fo' + 'o bar', 'ba' + 'r baz')
197
self.assertCompareEqual(k1, k2)
198
k3 = self.module.StaticTuple('foo ' + 'bar', 'bar ' + 'baz')
199
k4 = self.module.StaticTuple('f' + 'oo bar', 'b' + 'ar baz')
200
k5 = self.module.StaticTuple(k1, k2)
201
k6 = self.module.StaticTuple(k3, k4)
202
self.assertCompareEqual(k5, k6)
204
def assertCompareDifferent(self, k_small, k_big):
205
self.assertFalse(k_small == k_big)
206
self.assertFalse(k_small >= k_big)
207
self.assertFalse(k_small > k_big)
208
self.assertTrue(k_small != k_big)
209
self.assertTrue(k_small <= k_big)
210
self.assertTrue(k_small < k_big)
212
def assertCompareNoRelation(self, k1, k2):
213
"""Run the comparison operators, make sure they do something.
215
However, we don't actually care what comes first or second. This is
216
stuff like cross-class comparisons. We don't want to segfault/raise an
217
exception, but we don't care about the sort order.
219
self.assertFalse(k1 == k2)
220
self.assertTrue(k1 != k2)
221
# Do the comparison, but we don't care about the result
227
def test_compare_vs_none(self):
228
k1 = self.module.StaticTuple('baz', 'bing')
229
self.assertCompareDifferent(None, k1)
231
def test_compare_cross_class(self):
232
k1 = self.module.StaticTuple('baz', 'bing')
233
self.assertCompareNoRelation(10, k1)
234
self.assertCompareNoRelation('baz', k1)
236
def test_compare_all_different_same_width(self):
237
k1 = self.module.StaticTuple('baz', 'bing')
238
k2 = self.module.StaticTuple('foo', 'bar')
239
self.assertCompareDifferent(k1, k2)
240
k3 = self.module.StaticTuple(k1, k2)
241
k4 = self.module.StaticTuple(k2, k1)
242
self.assertCompareDifferent(k3, k4)
244
def test_compare_some_different(self):
245
k1 = self.module.StaticTuple('foo', 'bar')
246
k2 = self.module.StaticTuple('foo', 'zzz')
247
self.assertCompareDifferent(k1, k2)
248
k3 = self.module.StaticTuple(k1, k1)
249
k4 = self.module.StaticTuple(k1, k2)
250
self.assertCompareDifferent(k3, k4)
252
def test_compare_diff_width(self):
253
k1 = self.module.StaticTuple('foo')
254
k2 = self.module.StaticTuple('foo', 'bar')
255
self.assertCompareDifferent(k1, k2)
256
k3 = self.module.StaticTuple(k1)
257
k4 = self.module.StaticTuple(k1, k2)
258
self.assertCompareDifferent(k3, k4)
260
def test_compare_to_tuples(self):
261
k1 = self.module.StaticTuple('foo')
262
self.assertCompareEqual(k1, ('foo',))
263
self.assertCompareEqual(('foo',), k1)
264
self.assertCompareDifferent(k1, ('foo', 'bar'))
265
self.assertCompareDifferent(k1, ('foo', 10))
267
k2 = self.module.StaticTuple('foo', 'bar')
268
self.assertCompareEqual(k2, ('foo', 'bar'))
269
self.assertCompareEqual(('foo', 'bar'), k2)
270
self.assertCompareDifferent(k2, ('foo', 'zzz'))
271
self.assertCompareDifferent(('foo',), k2)
272
self.assertCompareDifferent(('foo', 'aaa'), k2)
273
self.assertCompareDifferent(('baz', 'bing'), k2)
274
self.assertCompareDifferent(('foo', 10), k2)
276
k3 = self.module.StaticTuple(k1, k2)
277
self.assertCompareEqual(k3, (('foo',), ('foo', 'bar')))
278
self.assertCompareEqual((('foo',), ('foo', 'bar')), k3)
279
self.assertCompareEqual(k3, (k1, ('foo', 'bar')))
280
self.assertCompareEqual((k1, ('foo', 'bar')), k3)
282
def test_compare_mixed_depths(self):
283
stuple = self.module.StaticTuple
284
k1 = stuple(stuple('a',), stuple('b',))
285
k2 = stuple(stuple(stuple('c',), stuple('d',)),
287
# This requires comparing a StaticTuple to a 'string', and then
288
# interpreting that value in the next higher StaticTuple. This used to
289
# generate a PyErr_BadIternalCall. We now fall back to *something*.
290
self.assertCompareNoRelation(k1, k2)
293
k = self.module.StaticTuple('foo')
294
self.assertEqual(hash(k), hash(('foo',)))
295
k = self.module.StaticTuple('foo', 'bar', 'baz', 'bing')
296
as_tuple = ('foo', 'bar', 'baz', 'bing')
297
self.assertEqual(hash(k), hash(as_tuple))
299
# Because k == , it replaces the slot, rather than having both
300
# present in the dict.
301
self.assertEqual('foo', x[as_tuple])
303
self.assertEqual({as_tuple: 'bar'}, x)
305
k2 = self.module.StaticTuple(k)
306
as_tuple2 = (('foo', 'bar', 'baz', 'bing'),)
307
self.assertEqual(hash(k2), hash(as_tuple2))
309
def test_slice(self):
310
k = self.module.StaticTuple('foo', 'bar', 'baz', 'bing')
311
self.assertEqual(('foo', 'bar'), k[:2])
312
self.assertEqual(('baz',), k[2:-1])
316
# C implementation raises a TypeError, we don't need the
317
# implementation yet, so allow this to pass
320
# Python implementation uses a regular Tuple, so make sure it gives
322
self.assertEqual(('foo', 'baz'), val)
324
def test_referents(self):
325
# We implement tp_traverse so that things like 'meliae' can measure the
326
# amount of referenced memory. Unfortunately gc.get_referents() first
327
# checks the IS_GC flag before it traverses anything. We could write a
328
# helper func, but that won't work for the generic implementation...
329
self.requireFeature(Meliae)
330
from meliae import scanner
331
strs = ['foo', 'bar', 'baz', 'bing']
332
k = self.module.StaticTuple(*strs)
333
if self.module is _static_tuple_py:
334
refs = strs + [self.module.StaticTuple]
337
self.assertEqual(sorted(refs), sorted(scanner.get_referents(k)))
339
def test_nested_referents(self):
340
self.requireFeature(Meliae)
341
from meliae import scanner
342
strs = ['foo', 'bar', 'baz', 'bing']
343
k1 = self.module.StaticTuple(*strs[:2])
344
k2 = self.module.StaticTuple(*strs[2:])
345
k3 = self.module.StaticTuple(k1, k2)
347
if self.module is _static_tuple_py:
348
refs.append(self.module.StaticTuple)
349
self.assertEqual(sorted(refs),
350
sorted(scanner.get_referents(k3)))
352
def test_empty_is_singleton(self):
353
key = self.module.StaticTuple()
354
self.assertIs(key, self.module._empty_tuple)
356
def test_intern(self):
357
unique_str1 = 'unique str ' + osutils.rand_chars(20)
358
unique_str2 = 'unique str ' + osutils.rand_chars(20)
359
key = self.module.StaticTuple(unique_str1, unique_str2)
360
self.assertFalse(key in self.module._interned_tuples)
361
key2 = self.module.StaticTuple(unique_str1, unique_str2)
362
self.assertEqual(key, key2)
363
self.assertIsNot(key, key2)
365
self.assertIs(key, key3)
366
self.assertTrue(key in self.module._interned_tuples)
367
self.assertEqual(key, self.module._interned_tuples[key])
369
self.assertIs(key, key2)
371
def test__c_intern_handles_refcount(self):
372
if self.module is _static_tuple_py:
373
return # Not applicable
374
unique_str1 = 'unique str ' + osutils.rand_chars(20)
375
unique_str2 = 'unique str ' + osutils.rand_chars(20)
376
key = self.module.StaticTuple(unique_str1, unique_str2)
377
self.assertRefcount(1, key)
378
self.assertFalse(key in self.module._interned_tuples)
379
self.assertFalse(key._is_interned())
380
key2 = self.module.StaticTuple(unique_str1, unique_str2)
381
self.assertRefcount(1, key)
382
self.assertRefcount(1, key2)
383
self.assertEqual(key, key2)
384
self.assertIsNot(key, key2)
387
self.assertIs(key, key3)
388
self.assertTrue(key in self.module._interned_tuples)
389
self.assertEqual(key, self.module._interned_tuples[key])
390
# key and key3, but we 'hide' the one in _interned_tuples
391
self.assertRefcount(2, key)
393
self.assertRefcount(1, key)
394
self.assertTrue(key._is_interned())
395
self.assertRefcount(1, key2)
397
# key3 now points to key as well, and *not* to key2
398
self.assertRefcount(2, key)
399
self.assertRefcount(1, key2)
400
self.assertIs(key, key3)
401
self.assertIsNot(key3, key2)
404
self.assertRefcount(1, key)
406
def test__c_keys_are_not_immortal(self):
407
if self.module is _static_tuple_py:
408
return # Not applicable
409
unique_str1 = 'unique str ' + osutils.rand_chars(20)
410
unique_str2 = 'unique str ' + osutils.rand_chars(20)
411
key = self.module.StaticTuple(unique_str1, unique_str2)
412
self.assertFalse(key in self.module._interned_tuples)
413
self.assertRefcount(1, key)
415
self.assertRefcount(1, key)
416
self.assertTrue(key in self.module._interned_tuples)
417
self.assertTrue(key._is_interned())
419
# Create a new entry, which would point to the same location
420
key = self.module.StaticTuple(unique_str1, unique_str2)
421
self.assertRefcount(1, key)
422
# This old entry in _interned_tuples should be gone
423
self.assertFalse(key in self.module._interned_tuples)
424
self.assertFalse(key._is_interned())
426
def test__c_has_C_API(self):
427
if self.module is _static_tuple_py:
429
self.assertIsNot(None, self.module._C_API)
431
def test_static_tuple_thunk(self):
432
# Make sure the right implementation is available from
433
# bzrlib.static_tuple.StaticTuple.
434
if self.module is _static_tuple_py:
435
if CompiledStaticTuple.available():
436
# We will be using the C version
438
self.assertIs(static_tuple.StaticTuple,
439
self.module.StaticTuple)