blob: ce517b51d58e94c8a1ee924b12347ea49245869f [file] [log] [blame]
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001from collections import deque
2import unittest
Benjamin Petersonee8712c2008-05-20 21:35:26 +00003from test import support, seq_tests
Antoine Pitrou7ddda782009-01-01 15:35:33 +00004import gc
5import weakref
Raymond Hettinger756b3f32004-01-29 06:37:52 +00006import copy
Guido van Rossumbf12cdb2006-08-17 20:24:18 +00007import pickle
Guido van Rossum34d19282007-08-09 01:03:29 +00008from io import StringIO
Raymond Hettinger0a4977c2004-03-01 23:16:22 +00009import random
Jesus Cea16e2fca2012-08-03 14:49:42 +020010import struct
Raymond Hettinger756b3f32004-01-29 06:37:52 +000011
12BIG = 100000
13
Raymond Hettingera435c532004-07-09 04:10:20 +000014def fail():
15 raise SyntaxError
16 yield 1
17
Raymond Hettinger4aec61e2005-03-18 21:20:23 +000018class BadCmp:
19 def __eq__(self, other):
20 raise RuntimeError
21
22class MutateCmp:
Raymond Hettingerd73202c2005-03-19 00:00:51 +000023 def __init__(self, deque, result):
Raymond Hettinger4aec61e2005-03-18 21:20:23 +000024 self.deque = deque
Raymond Hettingerd73202c2005-03-19 00:00:51 +000025 self.result = result
Raymond Hettinger4aec61e2005-03-18 21:20:23 +000026 def __eq__(self, other):
27 self.deque.clear()
Raymond Hettingerd73202c2005-03-19 00:00:51 +000028 return self.result
Raymond Hettinger4aec61e2005-03-18 21:20:23 +000029
Raymond Hettinger756b3f32004-01-29 06:37:52 +000030class TestBasic(unittest.TestCase):
31
32 def test_basics(self):
Christian Heimes38053212007-12-14 01:24:44 +000033 d = deque(range(-5125, -5000))
34 d.__init__(range(200))
Guido van Rossum805365e2007-05-07 22:24:25 +000035 for i in range(200, 400):
Raymond Hettinger756b3f32004-01-29 06:37:52 +000036 d.append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +000037 for i in reversed(range(-200, 0)):
Raymond Hettinger756b3f32004-01-29 06:37:52 +000038 d.appendleft(i)
Guido van Rossum805365e2007-05-07 22:24:25 +000039 self.assertEqual(list(d), list(range(-200, 400)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +000040 self.assertEqual(len(d), 600)
41
Guido van Rossum805365e2007-05-07 22:24:25 +000042 left = [d.popleft() for i in range(250)]
43 self.assertEqual(left, list(range(-200, 50)))
44 self.assertEqual(list(d), list(range(50, 400)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +000045
Guido van Rossum805365e2007-05-07 22:24:25 +000046 right = [d.pop() for i in range(250)]
Raymond Hettinger756b3f32004-01-29 06:37:52 +000047 right.reverse()
Guido van Rossum805365e2007-05-07 22:24:25 +000048 self.assertEqual(right, list(range(150, 400)))
49 self.assertEqual(list(d), list(range(50, 150)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +000050
Guido van Rossum8ce8a782007-11-01 19:42:39 +000051 def test_maxlen(self):
52 self.assertRaises(ValueError, deque, 'abc', -1)
53 self.assertRaises(ValueError, deque, 'abc', -2)
Raymond Hettinger060c7f62009-03-10 09:36:07 +000054 it = iter(range(10))
55 d = deque(it, maxlen=3)
56 self.assertEqual(list(it), [])
Guido van Rossum8ce8a782007-11-01 19:42:39 +000057 self.assertEqual(repr(d), 'deque([7, 8, 9], maxlen=3)')
58 self.assertEqual(list(d), [7, 8, 9])
59 self.assertEqual(d, deque(range(10), 3))
60 d.append(10)
61 self.assertEqual(list(d), [8, 9, 10])
62 d.appendleft(7)
63 self.assertEqual(list(d), [7, 8, 9])
64 d.extend([10, 11])
65 self.assertEqual(list(d), [9, 10, 11])
66 d.extendleft([8, 7])
67 self.assertEqual(list(d), [7, 8, 9])
68 d = deque(range(200), maxlen=10)
69 d.append(d)
Benjamin Petersonee8712c2008-05-20 21:35:26 +000070 support.unlink(support.TESTFN)
71 fo = open(support.TESTFN, "w")
Christian Heimescc47b052008-03-25 14:56:36 +000072 try:
73 fo.write(str(d))
74 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +000075 fo = open(support.TESTFN, "r")
Christian Heimescc47b052008-03-25 14:56:36 +000076 self.assertEqual(fo.read(), repr(d))
77 finally:
78 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +000079 support.unlink(support.TESTFN)
Christian Heimescc47b052008-03-25 14:56:36 +000080
Guido van Rossum8ce8a782007-11-01 19:42:39 +000081 d = deque(range(10), maxlen=None)
82 self.assertEqual(repr(d), 'deque([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])')
Benjamin Petersonee8712c2008-05-20 21:35:26 +000083 fo = open(support.TESTFN, "w")
Christian Heimescc47b052008-03-25 14:56:36 +000084 try:
85 fo.write(str(d))
86 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +000087 fo = open(support.TESTFN, "r")
Christian Heimescc47b052008-03-25 14:56:36 +000088 self.assertEqual(fo.read(), repr(d))
89 finally:
90 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +000091 support.unlink(support.TESTFN)
Guido van Rossum8ce8a782007-11-01 19:42:39 +000092
Raymond Hettinger060c7f62009-03-10 09:36:07 +000093 def test_maxlen_zero(self):
94 it = iter(range(100))
95 deque(it, maxlen=0)
96 self.assertEqual(list(it), [])
97
98 it = iter(range(100))
99 d = deque(maxlen=0)
100 d.extend(it)
101 self.assertEqual(list(it), [])
102
103 it = iter(range(100))
104 d = deque(maxlen=0)
105 d.extendleft(it)
106 self.assertEqual(list(it), [])
107
Raymond Hettinger5bb0f0e2009-03-10 12:56:32 +0000108 def test_maxlen_attribute(self):
109 self.assertEqual(deque().maxlen, None)
110 self.assertEqual(deque('abc').maxlen, None)
111 self.assertEqual(deque('abc', maxlen=4).maxlen, 4)
112 self.assertEqual(deque('abc', maxlen=2).maxlen, 2)
113 self.assertEqual(deque('abc', maxlen=0).maxlen, 0)
114 with self.assertRaises(AttributeError):
115 d = deque('abc')
116 d.maxlen = 10
117
Raymond Hettinger44459de2010-04-03 23:20:46 +0000118 def test_count(self):
119 for s in ('', 'abracadabra', 'simsalabim'*500+'abc'):
120 s = list(s)
121 d = deque(s)
122 for letter in 'abcdefghijklmnopqrstuvwxyz':
123 self.assertEqual(s.count(letter), d.count(letter), (s, d, letter))
124 self.assertRaises(TypeError, d.count) # too few args
125 self.assertRaises(TypeError, d.count, 1, 2) # too many args
126 class BadCompare:
127 def __eq__(self, other):
128 raise ArithmeticError
129 d = deque([1, 2, BadCompare(), 3])
130 self.assertRaises(ArithmeticError, d.count, 2)
131 d = deque([1, 2, 3])
132 self.assertRaises(ArithmeticError, d.count, BadCompare())
133 class MutatingCompare:
134 def __eq__(self, other):
135 self.d.pop()
136 return True
137 m = MutatingCompare()
138 d = deque([1, 2, 3, m, 4, 5])
139 m.d = d
140 self.assertRaises(RuntimeError, d.count, 3)
141
Raymond Hettinger512d2cc2011-01-25 21:32:39 +0000142 # test issue11004
143 # block advance failed after rotation aligned elements on right side of block
144 d = deque([None]*16)
145 for i in range(len(d)):
146 d.rotate(-1)
147 d.rotate(1)
148 self.assertEqual(d.count(1), 0)
149 self.assertEqual(d.count(None), 16)
150
Raymond Hettinger738ec902004-02-29 02:15:56 +0000151 def test_comparisons(self):
152 d = deque('xabc'); d.popleft()
153 for e in [d, deque('abc'), deque('ab'), deque(), list(d)]:
154 self.assertEqual(d==e, type(d)==type(e) and list(d)==list(e))
155 self.assertEqual(d!=e, not(type(d)==type(e) and list(d)==list(e)))
156
157 args = map(deque, ('', 'a', 'b', 'ab', 'ba', 'abc', 'xba', 'xabc', 'cba'))
158 for x in args:
159 for y in args:
160 self.assertEqual(x == y, list(x) == list(y), (x,y))
161 self.assertEqual(x != y, list(x) != list(y), (x,y))
162 self.assertEqual(x < y, list(x) < list(y), (x,y))
163 self.assertEqual(x <= y, list(x) <= list(y), (x,y))
164 self.assertEqual(x > y, list(x) > list(y), (x,y))
165 self.assertEqual(x >= y, list(x) >= list(y), (x,y))
Raymond Hettinger738ec902004-02-29 02:15:56 +0000166
Raymond Hettinger39dadf72015-03-20 16:38:56 -0700167 def test_contains(self):
168 n = 200
169
170 d = deque(range(n))
171 for i in range(n):
172 self.assertTrue(i in d)
173 self.assertTrue((n+1) not in d)
174
175 # Test detection of mutation during iteration
176 d = deque(range(n))
177 d[n//2] = MutateCmp(d, False)
178 with self.assertRaises(RuntimeError):
179 n in d
180
181 # Test detection of comparison exceptions
182 d = deque(range(n))
183 d[n//2] = BadCmp()
184 with self.assertRaises(RuntimeError):
185 n in d
186
Raymond Hettinger3ba85c22004-02-06 19:04:56 +0000187 def test_extend(self):
188 d = deque('a')
189 self.assertRaises(TypeError, d.extend, 1)
190 d.extend('bcd')
191 self.assertEqual(list(d), list('abcd'))
Raymond Hettinger3f9afd82009-12-10 03:03:02 +0000192 d.extend(d)
193 self.assertEqual(list(d), list('abcdabcd'))
194
Raymond Hettinger41290a62015-03-31 08:12:23 -0700195 def test_add(self):
196 d = deque()
197 e = deque('abc')
198 f = deque('def')
199 self.assertEqual(d + d, deque())
200 self.assertEqual(e + f, deque('abcdef'))
201 self.assertEqual(e + e, deque('abcabc'))
202 self.assertEqual(e + d, deque('abc'))
203 self.assertEqual(d + e, deque('abc'))
204 self.assertIsNot(d + d, deque())
205 self.assertIsNot(e + d, deque('abc'))
206 self.assertIsNot(d + e, deque('abc'))
207
208 g = deque('abcdef', maxlen=4)
209 h = deque('gh')
210 self.assertEqual(g + h, deque('efgh'))
211
212 with self.assertRaises(TypeError):
213 deque('abc') + 'def'
214
Raymond Hettinger3f9afd82009-12-10 03:03:02 +0000215 def test_iadd(self):
216 d = deque('a')
217 d += 'bcd'
218 self.assertEqual(list(d), list('abcd'))
219 d += d
220 self.assertEqual(list(d), list('abcdabcd'))
Raymond Hettinger3ba85c22004-02-06 19:04:56 +0000221
222 def test_extendleft(self):
223 d = deque('a')
224 self.assertRaises(TypeError, d.extendleft, 1)
225 d.extendleft('bcd')
226 self.assertEqual(list(d), list(reversed('abcd')))
Raymond Hettinger3f9afd82009-12-10 03:03:02 +0000227 d.extendleft(d)
228 self.assertEqual(list(d), list('abcddcba'))
Raymond Hettingera435c532004-07-09 04:10:20 +0000229 d = deque()
230 d.extendleft(range(1000))
231 self.assertEqual(list(d), list(reversed(range(1000))))
232 self.assertRaises(SyntaxError, d.extendleft, fail())
Raymond Hettinger3ba85c22004-02-06 19:04:56 +0000233
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000234 def test_getitem(self):
235 n = 200
Guido van Rossum805365e2007-05-07 22:24:25 +0000236 d = deque(range(n))
237 l = list(range(n))
238 for i in range(n):
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000239 d.popleft()
240 l.pop(0)
241 if random.random() < 0.5:
242 d.append(i)
243 l.append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000244 for j in range(1-len(l), len(l)):
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000245 assert d[j] == l[j]
246
Raymond Hettinger738ec902004-02-29 02:15:56 +0000247 d = deque('superman')
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000248 self.assertEqual(d[0], 's')
249 self.assertEqual(d[-1], 'n')
Raymond Hettinger738ec902004-02-29 02:15:56 +0000250 d = deque()
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000251 self.assertRaises(IndexError, d.__getitem__, 0)
252 self.assertRaises(IndexError, d.__getitem__, -1)
253
Raymond Hettinger32ea1652015-03-21 01:37:37 -0700254 def test_index(self):
255 for n in 1, 2, 30, 40, 200:
256
257 d = deque(range(n))
258 for i in range(n):
259 self.assertEqual(d.index(i), i)
260
261 with self.assertRaises(ValueError):
262 d.index(n+1)
263
264 # Test detection of mutation during iteration
265 d = deque(range(n))
266 d[n//2] = MutateCmp(d, False)
267 with self.assertRaises(RuntimeError):
268 d.index(n)
269
270 # Test detection of comparison exceptions
271 d = deque(range(n))
272 d[n//2] = BadCmp()
273 with self.assertRaises(RuntimeError):
274 d.index(n)
275
276 # Test start and stop arguments behavior matches list.index()
277 elements = 'ABCDEFGHI'
278 nonelement = 'Z'
279 d = deque(elements * 2)
280 s = list(elements * 2)
281 for start in range(-5 - len(s)*2, 5 + len(s) * 2):
282 for stop in range(-5 - len(s)*2, 5 + len(s) * 2):
283 for element in elements + 'Z':
284 try:
285 target = s.index(element, start, stop)
286 except ValueError:
287 with self.assertRaises(ValueError):
288 d.index(element, start, stop)
289 else:
290 self.assertEqual(d.index(element, start, stop), target)
291
Raymond Hettinger906d82d2016-01-25 23:00:21 -0800292 def test_index_bug_24913(self):
Raymond Hettinger87674ec2015-08-26 08:08:38 -0700293 d = deque('A' * 3)
294 with self.assertRaises(ValueError):
295 i = d.index("Hello world", 0, 4)
296
Raymond Hettinger32ea1652015-03-21 01:37:37 -0700297 def test_insert(self):
298 # Test to make sure insert behaves like lists
299 elements = 'ABCDEFGHI'
300 for i in range(-5 - len(elements)*2, 5 + len(elements) * 2):
301 d = deque('ABCDEFGHI')
302 s = list('ABCDEFGHI')
303 d.insert(i, 'Z')
304 s.insert(i, 'Z')
305 self.assertEqual(list(d), s)
306
Raymond Hettingera6389712016-02-01 21:21:19 -0800307 def test_insert_bug_26194(self):
Raymond Hettinger37434322016-01-26 21:44:16 -0800308 data = 'ABC'
Raymond Hettingera6389712016-02-01 21:21:19 -0800309 d = deque(data, maxlen=len(data))
310 with self.assertRaises(IndexError):
311 d.insert(2, None)
312
313 elements = 'ABCDEFGHI'
314 for i in range(-len(elements), len(elements)):
315 d = deque(elements, maxlen=len(elements)+1)
316 d.insert(i, 'Z')
317 if i >= 0:
318 self.assertEqual(d[i], 'Z')
Raymond Hettinger37434322016-01-26 21:44:16 -0800319 else:
Raymond Hettingera6389712016-02-01 21:21:19 -0800320 self.assertEqual(d[i-1], 'Z')
Raymond Hettinger37434322016-01-26 21:44:16 -0800321
Raymond Hettinger41290a62015-03-31 08:12:23 -0700322 def test_imul(self):
323 for n in (-10, -1, 0, 1, 2, 10, 1000):
324 d = deque()
325 d *= n
326 self.assertEqual(d, deque())
327 self.assertIsNone(d.maxlen)
328
329 for n in (-10, -1, 0, 1, 2, 10, 1000):
330 d = deque('a')
331 d *= n
332 self.assertEqual(d, deque('a' * n))
333 self.assertIsNone(d.maxlen)
334
335 for n in (-10, -1, 0, 1, 2, 10, 499, 500, 501, 1000):
336 d = deque('a', 500)
337 d *= n
338 self.assertEqual(d, deque('a' * min(n, 500)))
339 self.assertEqual(d.maxlen, 500)
340
341 for n in (-10, -1, 0, 1, 2, 10, 1000):
342 d = deque('abcdef')
343 d *= n
344 self.assertEqual(d, deque('abcdef' * n))
345 self.assertIsNone(d.maxlen)
346
347 for n in (-10, -1, 0, 1, 2, 10, 499, 500, 501, 1000):
348 d = deque('abcdef', 500)
349 d *= n
350 self.assertEqual(d, deque(('abcdef' * n)[-500:]))
351 self.assertEqual(d.maxlen, 500)
352
353 def test_mul(self):
354 d = deque('abc')
355 self.assertEqual(d * -5, deque())
356 self.assertEqual(d * 0, deque())
357 self.assertEqual(d * 1, deque('abc'))
358 self.assertEqual(d * 2, deque('abcabc'))
359 self.assertEqual(d * 3, deque('abcabcabc'))
360 self.assertIsNot(d * 1, d)
361
362 self.assertEqual(deque() * 0, deque())
363 self.assertEqual(deque() * 1, deque())
364 self.assertEqual(deque() * 5, deque())
365
366 self.assertEqual(-5 * d, deque())
367 self.assertEqual(0 * d, deque())
368 self.assertEqual(1 * d, deque('abc'))
369 self.assertEqual(2 * d, deque('abcabc'))
370 self.assertEqual(3 * d, deque('abcabcabc'))
371
372 d = deque('abc', maxlen=5)
373 self.assertEqual(d * -5, deque())
374 self.assertEqual(d * 0, deque())
375 self.assertEqual(d * 1, deque('abc'))
376 self.assertEqual(d * 2, deque('bcabc'))
377 self.assertEqual(d * 30, deque('bcabc'))
378
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000379 def test_setitem(self):
380 n = 200
Guido van Rossum805365e2007-05-07 22:24:25 +0000381 d = deque(range(n))
382 for i in range(n):
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000383 d[i] = 10 * i
Guido van Rossum805365e2007-05-07 22:24:25 +0000384 self.assertEqual(list(d), [10*i for i in range(n)])
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000385 l = list(d)
Guido van Rossum805365e2007-05-07 22:24:25 +0000386 for i in range(1-n, 0, -1):
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000387 d[i] = 7*i
388 l[i] = 7*i
389 self.assertEqual(list(d), l)
Raymond Hettinger738ec902004-02-29 02:15:56 +0000390
Raymond Hettinger0e371f22004-05-12 20:55:56 +0000391 def test_delitem(self):
392 n = 500 # O(n**2) test, don't make this too big
Guido van Rossum805365e2007-05-07 22:24:25 +0000393 d = deque(range(n))
Raymond Hettinger0e371f22004-05-12 20:55:56 +0000394 self.assertRaises(IndexError, d.__delitem__, -n-1)
395 self.assertRaises(IndexError, d.__delitem__, n)
Guido van Rossum805365e2007-05-07 22:24:25 +0000396 for i in range(n):
Raymond Hettinger0e371f22004-05-12 20:55:56 +0000397 self.assertEqual(len(d), n-i)
398 j = random.randrange(-len(d), len(d))
399 val = d[j]
Benjamin Peterson577473f2010-01-19 00:09:57 +0000400 self.assertIn(val, d)
Raymond Hettinger0e371f22004-05-12 20:55:56 +0000401 del d[j]
Benjamin Peterson577473f2010-01-19 00:09:57 +0000402 self.assertNotIn(val, d)
Raymond Hettinger0e371f22004-05-12 20:55:56 +0000403 self.assertEqual(len(d), 0)
404
Raymond Hettingere5fdedb2009-12-10 00:47:21 +0000405 def test_reverse(self):
406 n = 500 # O(n**2) test, don't make this too big
407 data = [random.random() for i in range(n)]
408 for i in range(n):
409 d = deque(data[:i])
410 r = d.reverse()
411 self.assertEqual(list(d), list(reversed(data[:i])))
Ezio Melottib3aedd42010-11-20 19:04:17 +0000412 self.assertIs(r, None)
Raymond Hettingere5fdedb2009-12-10 00:47:21 +0000413 d.reverse()
414 self.assertEqual(list(d), data[:i])
415 self.assertRaises(TypeError, d.reverse, 1) # Arity is zero
416
Raymond Hettinger5c5eb862004-02-07 21:13:00 +0000417 def test_rotate(self):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000418 s = tuple('abcde')
419 n = len(s)
420
Raymond Hettinger5c5eb862004-02-07 21:13:00 +0000421 d = deque(s)
Raymond Hettingeree33b272004-02-08 04:05:26 +0000422 d.rotate(1) # verify rot(1)
423 self.assertEqual(''.join(d), 'eabcd')
424
425 d = deque(s)
426 d.rotate(-1) # verify rot(-1)
427 self.assertEqual(''.join(d), 'bcdea')
428 d.rotate() # check default to 1
429 self.assertEqual(tuple(d), s)
430
Guido van Rossum805365e2007-05-07 22:24:25 +0000431 for i in range(n*3):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000432 d = deque(s)
433 e = deque(d)
434 d.rotate(i) # check vs. rot(1) n times
Guido van Rossum805365e2007-05-07 22:24:25 +0000435 for j in range(i):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000436 e.rotate(1)
437 self.assertEqual(tuple(d), tuple(e))
438 d.rotate(-i) # check that it works in reverse
439 self.assertEqual(tuple(d), s)
440 e.rotate(n-i) # check that it wraps forward
441 self.assertEqual(tuple(e), s)
442
Guido van Rossum805365e2007-05-07 22:24:25 +0000443 for i in range(n*3):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000444 d = deque(s)
445 e = deque(d)
446 d.rotate(-i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000447 for j in range(i):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000448 e.rotate(-1) # check vs. rot(-1) n times
449 self.assertEqual(tuple(d), tuple(e))
450 d.rotate(i) # check that it works in reverse
451 self.assertEqual(tuple(d), s)
452 e.rotate(i-n) # check that it wraps backaround
453 self.assertEqual(tuple(e), s)
454
455 d = deque(s)
456 e = deque(s)
457 e.rotate(BIG+17) # verify on long series of rotates
458 dr = d.rotate
Guido van Rossum805365e2007-05-07 22:24:25 +0000459 for i in range(BIG+17):
Raymond Hettingeree33b272004-02-08 04:05:26 +0000460 dr()
461 self.assertEqual(tuple(d), tuple(e))
Raymond Hettinger5c5eb862004-02-07 21:13:00 +0000462
Raymond Hettingera435c532004-07-09 04:10:20 +0000463 self.assertRaises(TypeError, d.rotate, 'x') # Wrong arg type
464 self.assertRaises(TypeError, d.rotate, 1, 10) # Too many args
465
466 d = deque()
467 d.rotate() # rotate an empty deque
468 self.assertEqual(d, deque())
469
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000470 def test_len(self):
471 d = deque('ab')
472 self.assertEqual(len(d), 2)
473 d.popleft()
474 self.assertEqual(len(d), 1)
475 d.pop()
476 self.assertEqual(len(d), 0)
Raymond Hettinger738ec902004-02-29 02:15:56 +0000477 self.assertRaises(IndexError, d.pop)
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000478 self.assertEqual(len(d), 0)
479 d.append('c')
480 self.assertEqual(len(d), 1)
481 d.appendleft('d')
482 self.assertEqual(len(d), 2)
483 d.clear()
484 self.assertEqual(len(d), 0)
485
486 def test_underflow(self):
487 d = deque()
Raymond Hettinger738ec902004-02-29 02:15:56 +0000488 self.assertRaises(IndexError, d.pop)
489 self.assertRaises(IndexError, d.popleft)
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000490
491 def test_clear(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000492 d = deque(range(100))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000493 self.assertEqual(len(d), 100)
494 d.clear()
495 self.assertEqual(len(d), 0)
496 self.assertEqual(list(d), [])
Martin Pantereb995702016-07-28 01:11:04 +0000497 d.clear() # clear an empty deque
Raymond Hettingera435c532004-07-09 04:10:20 +0000498 self.assertEqual(list(d), [])
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000499
Raymond Hettinger4aec61e2005-03-18 21:20:23 +0000500 def test_remove(self):
501 d = deque('abcdefghcij')
502 d.remove('c')
503 self.assertEqual(d, deque('abdefghcij'))
504 d.remove('c')
505 self.assertEqual(d, deque('abdefghij'))
506 self.assertRaises(ValueError, d.remove, 'c')
507 self.assertEqual(d, deque('abdefghij'))
508
Walter Dörwaldc448a912005-03-22 11:22:38 +0000509 # Handle comparison errors
Raymond Hettinger4aec61e2005-03-18 21:20:23 +0000510 d = deque(['a', 'b', BadCmp(), 'c'])
511 e = deque(d)
512 self.assertRaises(RuntimeError, d.remove, 'c')
513 for x, y in zip(d, e):
514 # verify that original order and values are retained.
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000515 self.assertTrue(x is y)
Raymond Hettinger4aec61e2005-03-18 21:20:23 +0000516
517 # Handle evil mutator
Raymond Hettingerd73202c2005-03-19 00:00:51 +0000518 for match in (True, False):
519 d = deque(['ab'])
520 d.extend([MutateCmp(d, match), 'c'])
521 self.assertRaises(IndexError, d.remove, 'c')
522 self.assertEqual(d, deque())
Raymond Hettinger4aec61e2005-03-18 21:20:23 +0000523
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000524 def test_repr(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000525 d = deque(range(200))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000526 e = eval(repr(d))
527 self.assertEqual(list(d), list(e))
528 d.append(d)
Benjamin Peterson577473f2010-01-19 00:09:57 +0000529 self.assertIn('...', repr(d))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000530
531 def test_print(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000532 d = deque(range(200))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000533 d.append(d)
Raymond Hettingera435c532004-07-09 04:10:20 +0000534 try:
Benjamin Petersonee8712c2008-05-20 21:35:26 +0000535 support.unlink(support.TESTFN)
536 fo = open(support.TESTFN, "w")
Christian Heimescc47b052008-03-25 14:56:36 +0000537 print(d, file=fo, end='')
Raymond Hettingera435c532004-07-09 04:10:20 +0000538 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +0000539 fo = open(support.TESTFN, "r")
Raymond Hettingera435c532004-07-09 04:10:20 +0000540 self.assertEqual(fo.read(), repr(d))
541 finally:
542 fo.close()
Benjamin Petersonee8712c2008-05-20 21:35:26 +0000543 support.unlink(support.TESTFN)
Raymond Hettingera435c532004-07-09 04:10:20 +0000544
545 def test_init(self):
Guido van Rossum8ce8a782007-11-01 19:42:39 +0000546 self.assertRaises(TypeError, deque, 'abc', 2, 3);
Raymond Hettingera435c532004-07-09 04:10:20 +0000547 self.assertRaises(TypeError, deque, 1);
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000548
549 def test_hash(self):
550 self.assertRaises(TypeError, hash, deque('abc'))
551
552 def test_long_steadystate_queue_popleft(self):
553 for size in (0, 1, 2, 100, 1000):
Guido van Rossum805365e2007-05-07 22:24:25 +0000554 d = deque(range(size))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000555 append, pop = d.append, d.popleft
Guido van Rossum805365e2007-05-07 22:24:25 +0000556 for i in range(size, BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000557 append(i)
558 x = pop()
559 if x != i - size:
560 self.assertEqual(x, i-size)
Guido van Rossum805365e2007-05-07 22:24:25 +0000561 self.assertEqual(list(d), list(range(BIG-size, BIG)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000562
563 def test_long_steadystate_queue_popright(self):
564 for size in (0, 1, 2, 100, 1000):
Guido van Rossum805365e2007-05-07 22:24:25 +0000565 d = deque(reversed(range(size)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000566 append, pop = d.appendleft, d.pop
Guido van Rossum805365e2007-05-07 22:24:25 +0000567 for i in range(size, BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000568 append(i)
569 x = pop()
570 if x != i - size:
571 self.assertEqual(x, i-size)
Guido van Rossum805365e2007-05-07 22:24:25 +0000572 self.assertEqual(list(reversed(list(d))),
573 list(range(BIG-size, BIG)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000574
575 def test_big_queue_popleft(self):
576 pass
577 d = deque()
578 append, pop = d.append, d.popleft
Guido van Rossum805365e2007-05-07 22:24:25 +0000579 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000580 append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000581 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000582 x = pop()
583 if x != i:
584 self.assertEqual(x, i)
585
586 def test_big_queue_popright(self):
587 d = deque()
588 append, pop = d.appendleft, d.pop
Guido van Rossum805365e2007-05-07 22:24:25 +0000589 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000590 append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000591 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000592 x = pop()
593 if x != i:
594 self.assertEqual(x, i)
595
596 def test_big_stack_right(self):
597 d = deque()
598 append, pop = d.append, d.pop
Guido van Rossum805365e2007-05-07 22:24:25 +0000599 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000600 append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000601 for i in reversed(range(BIG)):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000602 x = pop()
603 if x != i:
604 self.assertEqual(x, i)
605 self.assertEqual(len(d), 0)
606
607 def test_big_stack_left(self):
608 d = deque()
609 append, pop = d.appendleft, d.popleft
Guido van Rossum805365e2007-05-07 22:24:25 +0000610 for i in range(BIG):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000611 append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000612 for i in reversed(range(BIG)):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000613 x = pop()
614 if x != i:
615 self.assertEqual(x, i)
616 self.assertEqual(len(d), 0)
617
618 def test_roundtrip_iter_init(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000619 d = deque(range(200))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000620 e = deque(d)
621 self.assertNotEqual(id(d), id(e))
622 self.assertEqual(list(d), list(e))
623
624 def test_pickle(self):
Serhiy Storchakaa0d416f2016-03-06 08:55:21 +0200625 for d in deque(range(200)), deque(range(200), 100):
626 for i in range(pickle.HIGHEST_PROTOCOL + 1):
627 s = pickle.dumps(d, i)
628 e = pickle.loads(s)
629 self.assertNotEqual(id(e), id(d))
630 self.assertEqual(list(e), list(d))
631 self.assertEqual(e.maxlen, d.maxlen)
Raymond Hettinger952f8802004-11-09 07:27:35 +0000632
Serhiy Storchakaa0d416f2016-03-06 08:55:21 +0200633 def test_pickle_recursive(self):
634 for d in deque('abc'), deque('abc', 3):
635 d.append(d)
636 for i in range(pickle.HIGHEST_PROTOCOL + 1):
637 e = pickle.loads(pickle.dumps(d, i))
638 self.assertNotEqual(id(e), id(d))
639 self.assertEqual(id(e[-1]), id(e))
640 self.assertEqual(e.maxlen, d.maxlen)
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000641
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000642 def test_iterator_pickle(self):
Serhiy Storchakaaabafe72016-03-06 14:10:24 +0200643 orig = deque(range(200))
644 data = [i*1.01 for i in orig]
Serhiy Storchakabad12572014-12-15 14:03:42 +0200645 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
Serhiy Storchakaaabafe72016-03-06 14:10:24 +0200646 # initial iterator
647 itorg = iter(orig)
648 dump = pickle.dumps((itorg, orig), proto)
649 it, d = pickle.loads(dump)
650 for i, x in enumerate(data):
651 d[i] = x
652 self.assertEqual(type(it), type(itorg))
653 self.assertEqual(list(it), data)
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000654
Serhiy Storchakaaabafe72016-03-06 14:10:24 +0200655 # running iterator
656 next(itorg)
657 dump = pickle.dumps((itorg, orig), proto)
658 it, d = pickle.loads(dump)
659 for i, x in enumerate(data):
660 d[i] = x
661 self.assertEqual(type(it), type(itorg))
662 self.assertEqual(list(it), data[1:])
663
664 # empty iterator
665 for i in range(1, len(data)):
666 next(itorg)
667 dump = pickle.dumps((itorg, orig), proto)
668 it, d = pickle.loads(dump)
669 for i, x in enumerate(data):
670 d[i] = x
671 self.assertEqual(type(it), type(itorg))
672 self.assertEqual(list(it), [])
673
674 # exhausted iterator
675 self.assertRaises(StopIteration, next, itorg)
676 dump = pickle.dumps((itorg, orig), proto)
677 it, d = pickle.loads(dump)
678 for i, x in enumerate(data):
679 d[i] = x
680 self.assertEqual(type(it), type(itorg))
681 self.assertEqual(list(it), [])
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000682
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000683 def test_deepcopy(self):
684 mut = [10]
685 d = deque([mut])
686 e = copy.deepcopy(d)
687 self.assertEqual(list(d), list(e))
688 mut[0] = 11
689 self.assertNotEqual(id(d), id(e))
690 self.assertNotEqual(list(d), list(e))
691
692 def test_copy(self):
693 mut = [10]
694 d = deque([mut])
695 e = copy.copy(d)
696 self.assertEqual(list(d), list(e))
697 mut[0] = 11
698 self.assertNotEqual(id(d), id(e))
699 self.assertEqual(list(d), list(e))
700
Raymond Hettingeraed88302015-09-19 09:05:42 -0700701 for i in range(5):
702 for maxlen in range(-1, 6):
703 s = [random.random() for j in range(i)]
704 d = deque(s) if maxlen == -1 else deque(s, maxlen)
705 e = d.copy()
706 self.assertEqual(d, e)
707 self.assertEqual(d.maxlen, e.maxlen)
708 self.assertTrue(all(x is y for x, y in zip(d, e)))
709
Raymond Hettinger32ea1652015-03-21 01:37:37 -0700710 def test_copy_method(self):
711 mut = [10]
712 d = deque([mut])
713 e = d.copy()
714 self.assertEqual(list(d), list(e))
715 mut[0] = 11
716 self.assertNotEqual(id(d), id(e))
717 self.assertEqual(list(d), list(e))
718
Raymond Hettingerc058fd12004-02-07 02:45:22 +0000719 def test_reversed(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000720 for s in ('abcd', range(2000)):
Raymond Hettingerc058fd12004-02-07 02:45:22 +0000721 self.assertEqual(list(reversed(deque(s))), list(reversed(s)))
722
Raymond Hettingerbadf5d82014-06-14 20:41:22 -0700723 def test_reversed_new(self):
724 klass = type(reversed(deque()))
725 for s in ('abcd', range(2000)):
726 self.assertEqual(list(klass(deque(s))), list(reversed(s)))
727
Tim Peters10c7e862004-10-01 02:01:04 +0000728 def test_gc_doesnt_blowup(self):
729 import gc
730 # This used to assert-fail in deque_traverse() under a debug
731 # build, or run wild with a NULL pointer in a release build.
732 d = deque()
Guido van Rossum805365e2007-05-07 22:24:25 +0000733 for i in range(100):
Tim Peters10c7e862004-10-01 02:01:04 +0000734 d.append(1)
735 gc.collect()
736
Antoine Pitrou7ddda782009-01-01 15:35:33 +0000737 def test_container_iterator(self):
738 # Bug #3680: tp_traverse was not implemented for deque iterator objects
739 class C(object):
740 pass
741 for i in range(2):
742 obj = C()
743 ref = weakref.ref(obj)
744 if i == 0:
745 container = deque([obj, 1])
746 else:
747 container = reversed(deque([obj, 1]))
748 obj.x = iter(container)
749 del obj, container
750 gc.collect()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000751 self.assertTrue(ref() is None, "Cycle was not collected")
Antoine Pitrou7ddda782009-01-01 15:35:33 +0000752
Jesus Cea16e2fca2012-08-03 14:49:42 +0200753 check_sizeof = support.check_sizeof
754
755 @support.cpython_only
756 def test_sizeof(self):
Raymond Hettingerdaf57f22015-02-26 23:21:29 -0800757 BLOCKLEN = 64
Serhiy Storchakae23c90c2016-05-18 13:00:56 +0300758 basesize = support.calcvobjsize('2P4nP')
759 blocksize = struct.calcsize('P%dPP' % BLOCKLEN)
Jesus Cea16e2fca2012-08-03 14:49:42 +0200760 self.assertEqual(object.__sizeof__(deque()), basesize)
761 check = self.check_sizeof
762 check(deque(), basesize + blocksize)
763 check(deque('a'), basesize + blocksize)
Raymond Hettingerd9c116c2013-07-09 00:13:21 -0700764 check(deque('a' * (BLOCKLEN - 1)), basesize + blocksize)
765 check(deque('a' * BLOCKLEN), basesize + 2 * blocksize)
Jesus Cea16e2fca2012-08-03 14:49:42 +0200766 check(deque('a' * (42 * BLOCKLEN)), basesize + 43 * blocksize)
767
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000768class TestVariousIteratorArgs(unittest.TestCase):
769
770 def test_constructor(self):
Guido van Rossum805365e2007-05-07 22:24:25 +0000771 for s in ("123", "", range(1000), ('do', 1.2), range(2000,2200,5)):
Walter Dörwald09a3f2c2005-03-22 22:43:28 +0000772 for g in (seq_tests.Sequence, seq_tests.IterFunc,
773 seq_tests.IterGen, seq_tests.IterFuncStop,
774 seq_tests.itermulti, seq_tests.iterfunc):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000775 self.assertEqual(list(deque(g(s))), list(g(s)))
Walter Dörwald09a3f2c2005-03-22 22:43:28 +0000776 self.assertRaises(TypeError, deque, seq_tests.IterNextOnly(s))
777 self.assertRaises(TypeError, deque, seq_tests.IterNoNext(s))
778 self.assertRaises(ZeroDivisionError, deque, seq_tests.IterGenExc(s))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000779
780 def test_iter_with_altered_data(self):
781 d = deque('abcdefg')
782 it = iter(d)
783 d.pop()
Georg Brandla18af4e2007-04-21 15:47:16 +0000784 self.assertRaises(RuntimeError, next, it)
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000785
Thomas Wouters902d6eb2007-01-09 23:18:33 +0000786 def test_runtime_error_on_empty_deque(self):
787 d = deque()
788 it = iter(d)
789 d.append(10)
Georg Brandla18af4e2007-04-21 15:47:16 +0000790 self.assertRaises(RuntimeError, next, it)
Thomas Wouters902d6eb2007-01-09 23:18:33 +0000791
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000792class Deque(deque):
793 pass
794
Raymond Hettinger952f8802004-11-09 07:27:35 +0000795class DequeWithBadIter(deque):
796 def __iter__(self):
797 raise TypeError
798
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000799class TestSubclass(unittest.TestCase):
800
801 def test_basics(self):
Christian Heimes38053212007-12-14 01:24:44 +0000802 d = Deque(range(25))
803 d.__init__(range(200))
Guido van Rossum805365e2007-05-07 22:24:25 +0000804 for i in range(200, 400):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000805 d.append(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000806 for i in reversed(range(-200, 0)):
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000807 d.appendleft(i)
Guido van Rossum805365e2007-05-07 22:24:25 +0000808 self.assertEqual(list(d), list(range(-200, 400)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000809 self.assertEqual(len(d), 600)
810
Guido van Rossum805365e2007-05-07 22:24:25 +0000811 left = [d.popleft() for i in range(250)]
812 self.assertEqual(left, list(range(-200, 50)))
813 self.assertEqual(list(d), list(range(50, 400)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000814
Guido van Rossum805365e2007-05-07 22:24:25 +0000815 right = [d.pop() for i in range(250)]
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000816 right.reverse()
Guido van Rossum805365e2007-05-07 22:24:25 +0000817 self.assertEqual(right, list(range(150, 400)))
818 self.assertEqual(list(d), list(range(50, 150)))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000819
820 d.clear()
821 self.assertEqual(len(d), 0)
822
823 def test_copy_pickle(self):
824
825 d = Deque('abc')
826
827 e = d.__copy__()
828 self.assertEqual(type(d), type(e))
829 self.assertEqual(list(d), list(e))
830
831 e = Deque(d)
832 self.assertEqual(type(d), type(e))
833 self.assertEqual(list(d), list(e))
834
Serhiy Storchakabad12572014-12-15 14:03:42 +0200835 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
836 s = pickle.dumps(d, proto)
837 e = pickle.loads(s)
838 self.assertNotEqual(id(d), id(e))
839 self.assertEqual(type(d), type(e))
840 self.assertEqual(list(d), list(e))
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000841
Guido van Rossum8ce8a782007-11-01 19:42:39 +0000842 d = Deque('abcde', maxlen=4)
Raymond Hettinger952f8802004-11-09 07:27:35 +0000843
Guido van Rossum8ce8a782007-11-01 19:42:39 +0000844 e = d.__copy__()
845 self.assertEqual(type(d), type(e))
846 self.assertEqual(list(d), list(e))
847
848 e = Deque(d)
849 self.assertEqual(type(d), type(e))
850 self.assertEqual(list(d), list(e))
851
Serhiy Storchakabad12572014-12-15 14:03:42 +0200852 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
853 s = pickle.dumps(d, proto)
854 e = pickle.loads(s)
855 self.assertNotEqual(id(d), id(e))
856 self.assertEqual(type(d), type(e))
857 self.assertEqual(list(d), list(e))
Raymond Hettinger952f8802004-11-09 07:27:35 +0000858
Serhiy Storchakaa0d416f2016-03-06 08:55:21 +0200859 def test_pickle_recursive(self):
860 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
861 for d in Deque('abc'), Deque('abc', 3):
862 d.append(d)
863
864 e = pickle.loads(pickle.dumps(d, proto))
865 self.assertNotEqual(id(e), id(d))
866 self.assertEqual(type(e), type(d))
867 self.assertEqual(e.maxlen, d.maxlen)
868 dd = d.pop()
869 ee = e.pop()
870 self.assertEqual(id(ee), id(e))
871 self.assertEqual(e, d)
872
873 d.x = d
874 e = pickle.loads(pickle.dumps(d, proto))
875 self.assertEqual(id(e.x), id(e))
876
877 for d in DequeWithBadIter('abc'), DequeWithBadIter('abc', 2):
878 self.assertRaises(TypeError, pickle.dumps, d, proto)
Raymond Hettinger952f8802004-11-09 07:27:35 +0000879
Raymond Hettinger691d8052004-05-30 07:26:47 +0000880 def test_weakref(self):
881 d = deque('gallahad')
Antoine Pitrou7ddda782009-01-01 15:35:33 +0000882 p = weakref.proxy(d)
Raymond Hettinger691d8052004-05-30 07:26:47 +0000883 self.assertEqual(str(p), str(d))
884 d = None
885 self.assertRaises(ReferenceError, str, p)
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000886
Armin Rigo974d7572004-10-02 13:59:34 +0000887 def test_strange_subclass(self):
888 class X(deque):
889 def __iter__(self):
890 return iter([])
891 d1 = X([1,2,3])
892 d2 = X([4,5,6])
893 d1 == d2 # not clear if this is supposed to be True or False,
894 # but it used to give a SystemError
895
Thomas Woutersb2137042007-02-01 18:02:27 +0000896
897class SubclassWithKwargs(deque):
898 def __init__(self, newarg=1):
899 deque.__init__(self)
900
901class TestSubclassWithKwargs(unittest.TestCase):
902 def test_subclass_with_kwargs(self):
903 # SF bug #1486663 -- this used to erroneously raise a TypeError
904 SubclassWithKwargs(newarg=1)
905
Raymond Hettinger067bbba2015-04-01 08:11:09 -0700906class TestSequence(seq_tests.CommonTest):
907 type2test = deque
908
909 def test_getitem(self):
910 # For now, bypass tests that require slicing
911 pass
912
913 def test_getslice(self):
914 # For now, bypass tests that require slicing
915 pass
916
917 def test_subscript(self):
918 # For now, bypass tests that require slicing
919 pass
920
Serhiy Storchakafbb1c5e2016-03-30 20:40:02 +0300921 def test_free_after_iterating(self):
922 # For now, bypass tests that require slicing
923 self.skipTest("Exhausted deque iterator doesn't free a deque")
924
Raymond Hettinger756b3f32004-01-29 06:37:52 +0000925#==============================================================================
926
Raymond Hettinger738ec902004-02-29 02:15:56 +0000927libreftest = """
928Example from the Library Reference: Doc/lib/libcollections.tex
929
930>>> from collections import deque
931>>> d = deque('ghi') # make a new deque with three items
932>>> for elem in d: # iterate over the deque's elements
Guido van Rossum7131f842007-02-09 20:13:25 +0000933... print(elem.upper())
Raymond Hettinger738ec902004-02-29 02:15:56 +0000934G
935H
936I
937>>> d.append('j') # add a new entry to the right side
938>>> d.appendleft('f') # add a new entry to the left side
939>>> d # show the representation of the deque
940deque(['f', 'g', 'h', 'i', 'j'])
941>>> d.pop() # return and remove the rightmost item
942'j'
943>>> d.popleft() # return and remove the leftmost item
944'f'
945>>> list(d) # list the contents of the deque
946['g', 'h', 'i']
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000947>>> d[0] # peek at leftmost item
Raymond Hettinger738ec902004-02-29 02:15:56 +0000948'g'
Raymond Hettinger0a4977c2004-03-01 23:16:22 +0000949>>> d[-1] # peek at rightmost item
Raymond Hettinger738ec902004-02-29 02:15:56 +0000950'i'
951>>> list(reversed(d)) # list the contents of a deque in reverse
952['i', 'h', 'g']
953>>> 'h' in d # search the deque
954True
955>>> d.extend('jkl') # add multiple elements at once
956>>> d
957deque(['g', 'h', 'i', 'j', 'k', 'l'])
958>>> d.rotate(1) # right rotation
959>>> d
960deque(['l', 'g', 'h', 'i', 'j', 'k'])
961>>> d.rotate(-1) # left rotation
962>>> d
963deque(['g', 'h', 'i', 'j', 'k', 'l'])
964>>> deque(reversed(d)) # make a new deque in reverse order
965deque(['l', 'k', 'j', 'i', 'h', 'g'])
966>>> d.clear() # empty the deque
967>>> d.pop() # cannot pop from an empty deque
968Traceback (most recent call last):
969 File "<pyshell#6>", line 1, in -toplevel-
970 d.pop()
971IndexError: pop from an empty deque
972
973>>> d.extendleft('abc') # extendleft() reverses the input order
974>>> d
975deque(['c', 'b', 'a'])
976
Raymond Hettingere7169eb2004-05-09 01:15:01 +0000977
978
Raymond Hettingere7169eb2004-05-09 01:15:01 +0000979>>> def delete_nth(d, n):
Raymond Hettingere7169eb2004-05-09 01:15:01 +0000980... d.rotate(-n)
981... d.popleft()
982... d.rotate(n)
983...
984>>> d = deque('abcdef')
985>>> delete_nth(d, 2) # remove the entry at d[2]
986>>> d
987deque(['a', 'b', 'd', 'e', 'f'])
988
989
990
991>>> def roundrobin(*iterables):
992... pending = deque(iter(i) for i in iterables)
993... while pending:
994... task = pending.popleft()
995... try:
Georg Brandla18af4e2007-04-21 15:47:16 +0000996... yield next(task)
Raymond Hettingere7169eb2004-05-09 01:15:01 +0000997... except StopIteration:
998... continue
999... pending.append(task)
1000...
1001
1002>>> for value in roundrobin('abc', 'd', 'efgh'):
Guido van Rossum7131f842007-02-09 20:13:25 +00001003... print(value)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001004...
Raymond Hettingere7169eb2004-05-09 01:15:01 +00001005a
1006d
1007e
1008b
1009f
1010c
1011g
1012h
1013
1014
1015>>> def maketree(iterable):
1016... d = deque(iterable)
1017... while len(d) > 1:
1018... pair = [d.popleft(), d.popleft()]
1019... d.append(pair)
1020... return list(d)
1021...
Guido van Rossum7131f842007-02-09 20:13:25 +00001022>>> print(maketree('abcdefgh'))
Raymond Hettingere7169eb2004-05-09 01:15:01 +00001023[[[['a', 'b'], ['c', 'd']], [['e', 'f'], ['g', 'h']]]]
1024
Raymond Hettinger738ec902004-02-29 02:15:56 +00001025"""
1026
1027
1028#==============================================================================
1029
1030__test__ = {'libreftest' : libreftest}
1031
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001032def test_main(verbose=None):
1033 import sys
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001034 test_classes = (
1035 TestBasic,
1036 TestVariousIteratorArgs,
1037 TestSubclass,
Thomas Woutersb2137042007-02-01 18:02:27 +00001038 TestSubclassWithKwargs,
Raymond Hettinger067bbba2015-04-01 08:11:09 -07001039 TestSequence,
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001040 )
1041
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001042 support.run_unittest(*test_classes)
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001043
1044 # verify reference counting
1045 if verbose and hasattr(sys, "gettotalrefcount"):
1046 import gc
1047 counts = [None] * 5
Guido van Rossum805365e2007-05-07 22:24:25 +00001048 for i in range(len(counts)):
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001049 support.run_unittest(*test_classes)
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001050 gc.collect()
1051 counts[i] = sys.gettotalrefcount()
Guido van Rossumbe19ed72007-02-09 05:37:30 +00001052 print(counts)
Raymond Hettinger0a4977c2004-03-01 23:16:22 +00001053
Raymond Hettinger738ec902004-02-29 02:15:56 +00001054 # doctests
1055 from test import test_deque
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001056 support.run_doctest(test_deque, verbose)
Raymond Hettinger756b3f32004-01-29 06:37:52 +00001057
1058if __name__ == "__main__":
1059 test_main(verbose=True)