blob: 5d0351bbfe54db6d110e04d4fbb4dd1dc499276b [file] [log] [blame]
Guido van Rossum254348e2007-11-21 19:29:53 +00001"""Unit tests for the bytes and bytearray types.
Guido van Rossum98297ee2007-11-06 21:34:58 +00002
3XXX This is a mess. Common tests should be moved to buffer_tests.py,
4which itself ought to be unified with string_tests.py (and the latter
5should be modernized).
6"""
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00007
Guido van Rossumd624f182006-04-24 13:47:05 +00008import os
9import re
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000010import sys
Guido van Rossuma6c04be2007-11-03 00:24:24 +000011import copy
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +000012import functools
Guido van Rossum0ad08122007-04-11 04:37:43 +000013import pickle
Guido van Rossumd624f182006-04-24 13:47:05 +000014import tempfile
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000015import unittest
Antoine Pitroucc231542014-11-02 18:40:09 +010016
Benjamin Petersonee8712c2008-05-20 21:35:26 +000017import test.support
Georg Brandlc7885542007-03-06 19:16:20 +000018import test.string_tests
Gregory P. Smith60d241f2007-10-16 06:31:30 +000019import test.buffer_tests
Antoine Pitroucc231542014-11-02 18:40:09 +010020from test.support import bigaddrspacetest, MAX_Py_ssize_t
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000021
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +000022
23if sys.flags.bytes_warning:
24 def check_bytes_warnings(func):
25 @functools.wraps(func)
26 def wrapper(*args, **kw):
27 with test.support.check_warnings(('', BytesWarning)):
28 return func(*args, **kw)
29 return wrapper
30else:
31 # no-op
32 def check_bytes_warnings(func):
33 return func
34
35
Georg Brandl9a54d7c2008-07-16 23:15:30 +000036class Indexable:
37 def __init__(self, value=0):
38 self.value = value
39 def __index__(self):
40 return self.value
41
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000042
Ezio Melotti0dceb562013-01-10 07:43:26 +020043class BaseBytesTest:
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000044
45 def test_basics(self):
Christian Heimes510711d2008-01-30 11:57:58 +000046 b = self.type2test()
47 self.assertEqual(type(b), self.type2test)
48 self.assertEqual(b.__class__, self.type2test)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000049
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +000050 def test_copy(self):
51 a = self.type2test(b"abcd")
52 for copy_method in (copy.copy, copy.deepcopy):
53 b = copy_method(a)
54 self.assertEqual(a, b)
55 self.assertEqual(type(a), type(b))
56
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000057 def test_empty_sequence(self):
Christian Heimes510711d2008-01-30 11:57:58 +000058 b = self.type2test()
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000059 self.assertEqual(len(b), 0)
60 self.assertRaises(IndexError, lambda: b[0])
61 self.assertRaises(IndexError, lambda: b[1])
Christian Heimesa37d4c62007-12-04 23:02:19 +000062 self.assertRaises(IndexError, lambda: b[sys.maxsize])
63 self.assertRaises(IndexError, lambda: b[sys.maxsize+1])
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000064 self.assertRaises(IndexError, lambda: b[10**100])
65 self.assertRaises(IndexError, lambda: b[-1])
66 self.assertRaises(IndexError, lambda: b[-2])
Christian Heimesa37d4c62007-12-04 23:02:19 +000067 self.assertRaises(IndexError, lambda: b[-sys.maxsize])
68 self.assertRaises(IndexError, lambda: b[-sys.maxsize-1])
69 self.assertRaises(IndexError, lambda: b[-sys.maxsize-2])
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000070 self.assertRaises(IndexError, lambda: b[-10**100])
71
72 def test_from_list(self):
73 ints = list(range(256))
Christian Heimes510711d2008-01-30 11:57:58 +000074 b = self.type2test(i for i in ints)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000075 self.assertEqual(len(b), 256)
76 self.assertEqual(list(b), ints)
77
78 def test_from_index(self):
Georg Brandl9a54d7c2008-07-16 23:15:30 +000079 b = self.type2test([Indexable(), Indexable(1), Indexable(254),
80 Indexable(255)])
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000081 self.assertEqual(list(b), [0, 1, 254, 255])
Benjamin Peterson4c045832010-04-16 22:35:32 +000082 self.assertRaises(ValueError, self.type2test, [Indexable(-1)])
83 self.assertRaises(ValueError, self.type2test, [Indexable(256)])
Guido van Rossum98297ee2007-11-06 21:34:58 +000084
85 def test_from_ssize(self):
Benjamin Peterson4c045832010-04-16 22:35:32 +000086 self.assertEqual(self.type2test(0), b'')
87 self.assertEqual(self.type2test(1), b'\x00')
88 self.assertEqual(self.type2test(5), b'\x00\x00\x00\x00\x00')
89 self.assertRaises(ValueError, self.type2test, -1)
Guido van Rossum98297ee2007-11-06 21:34:58 +000090
Benjamin Peterson4c045832010-04-16 22:35:32 +000091 self.assertEqual(self.type2test('0', 'ascii'), b'0')
92 self.assertEqual(self.type2test(b'0'), b'0')
Benjamin Peterson8380dd52010-04-16 22:51:37 +000093 self.assertRaises(OverflowError, self.type2test, sys.maxsize + 1)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000094
95 def test_constructor_type_errors(self):
Christian Heimes510711d2008-01-30 11:57:58 +000096 self.assertRaises(TypeError, self.type2test, 0.0)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +000097 class C:
98 pass
Christian Heimes510711d2008-01-30 11:57:58 +000099 self.assertRaises(TypeError, self.type2test, ["0"])
100 self.assertRaises(TypeError, self.type2test, [0.0])
101 self.assertRaises(TypeError, self.type2test, [None])
102 self.assertRaises(TypeError, self.type2test, [C()])
Serhiy Storchaka83cf99d2014-12-02 09:24:06 +0200103 self.assertRaises(TypeError, self.type2test, 0, 'ascii')
104 self.assertRaises(TypeError, self.type2test, b'', 'ascii')
105 self.assertRaises(TypeError, self.type2test, 0, errors='ignore')
106 self.assertRaises(TypeError, self.type2test, b'', errors='ignore')
107 self.assertRaises(TypeError, self.type2test, '')
108 self.assertRaises(TypeError, self.type2test, '', errors='ignore')
109 self.assertRaises(TypeError, self.type2test, '', b'ascii')
110 self.assertRaises(TypeError, self.type2test, '', 'ascii', b'ignore')
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000111
112 def test_constructor_value_errors(self):
Christian Heimes510711d2008-01-30 11:57:58 +0000113 self.assertRaises(ValueError, self.type2test, [-1])
114 self.assertRaises(ValueError, self.type2test, [-sys.maxsize])
115 self.assertRaises(ValueError, self.type2test, [-sys.maxsize-1])
116 self.assertRaises(ValueError, self.type2test, [-sys.maxsize-2])
117 self.assertRaises(ValueError, self.type2test, [-10**100])
118 self.assertRaises(ValueError, self.type2test, [256])
119 self.assertRaises(ValueError, self.type2test, [257])
120 self.assertRaises(ValueError, self.type2test, [sys.maxsize])
121 self.assertRaises(ValueError, self.type2test, [sys.maxsize+1])
122 self.assertRaises(ValueError, self.type2test, [10**100])
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000123
Antoine Pitroucc231542014-11-02 18:40:09 +0100124 @bigaddrspacetest
125 def test_constructor_overflow(self):
126 size = MAX_Py_ssize_t
127 self.assertRaises((OverflowError, MemoryError), self.type2test, size)
128 try:
129 # Should either pass or raise an error (e.g. on debug builds with
130 # additional malloc() overhead), but shouldn't crash.
131 bytearray(size - 4)
132 except (OverflowError, MemoryError):
133 pass
134
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000135 def test_compare(self):
Christian Heimes510711d2008-01-30 11:57:58 +0000136 b1 = self.type2test([1, 2, 3])
137 b2 = self.type2test([1, 2, 3])
138 b3 = self.type2test([1, 3])
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000139
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000140 self.assertEqual(b1, b2)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000141 self.assertTrue(b2 != b3)
142 self.assertTrue(b1 <= b2)
143 self.assertTrue(b1 <= b3)
144 self.assertTrue(b1 < b3)
145 self.assertTrue(b1 >= b2)
146 self.assertTrue(b3 >= b2)
147 self.assertTrue(b3 > b2)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000148
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000149 self.assertFalse(b1 != b2)
150 self.assertFalse(b2 == b3)
151 self.assertFalse(b1 > b2)
152 self.assertFalse(b1 > b3)
153 self.assertFalse(b1 >= b3)
154 self.assertFalse(b1 < b2)
155 self.assertFalse(b3 < b2)
156 self.assertFalse(b3 <= b2)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000157
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +0000158 @check_bytes_warnings
Guido van Rossum343e97f2007-04-09 00:43:24 +0000159 def test_compare_to_str(self):
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +0000160 # Byte comparisons with unicode should always fail!
161 # Test this for all expected byte orders and Unicode character
162 # sizes.
163 self.assertEqual(self.type2test(b"\0a\0b\0c") == "abc", False)
164 self.assertEqual(self.type2test(b"\0\0\0a\0\0\0b\0\0\0c") == "abc",
165 False)
166 self.assertEqual(self.type2test(b"a\0b\0c\0") == "abc", False)
167 self.assertEqual(self.type2test(b"a\0\0\0b\0\0\0c\0\0\0") == "abc",
168 False)
169 self.assertEqual(self.type2test() == str(), False)
170 self.assertEqual(self.type2test() != str(), True)
Christian Heimes510711d2008-01-30 11:57:58 +0000171
172 def test_reversed(self):
173 input = list(map(ord, "Hello"))
174 b = self.type2test(input)
175 output = list(reversed(b))
176 input.reverse()
177 self.assertEqual(output, input)
178
179 def test_getslice(self):
180 def by(s):
181 return self.type2test(map(ord, s))
182 b = by("Hello, world")
183
184 self.assertEqual(b[:5], by("Hello"))
185 self.assertEqual(b[1:5], by("ello"))
186 self.assertEqual(b[5:7], by(", "))
187 self.assertEqual(b[7:], by("world"))
188 self.assertEqual(b[7:12], by("world"))
189 self.assertEqual(b[7:100], by("world"))
190
191 self.assertEqual(b[:-7], by("Hello"))
192 self.assertEqual(b[-11:-7], by("ello"))
193 self.assertEqual(b[-7:-5], by(", "))
194 self.assertEqual(b[-5:], by("world"))
195 self.assertEqual(b[-5:12], by("world"))
196 self.assertEqual(b[-5:100], by("world"))
197 self.assertEqual(b[-100:5], by("Hello"))
198
199 def test_extended_getslice(self):
200 # Test extended slicing by comparing with list slicing.
201 L = list(range(255))
202 b = self.type2test(L)
203 indices = (0, None, 1, 3, 19, 100, -1, -2, -31, -100)
204 for start in indices:
205 for stop in indices:
206 # Skip step 0 (invalid)
207 for step in indices[1:]:
208 self.assertEqual(b[start:stop:step], self.type2test(L[start:stop:step]))
209
210 def test_encoding(self):
Martin v. Löwisdb12d452009-05-02 18:52:14 +0000211 sample = "Hello world\n\u1234\u5678\u9abc"
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000212 for enc in ("utf-8", "utf-16"):
Christian Heimes510711d2008-01-30 11:57:58 +0000213 b = self.type2test(sample, enc)
214 self.assertEqual(b, self.type2test(sample.encode(enc)))
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000215 self.assertRaises(UnicodeEncodeError, self.type2test, sample, "latin-1")
216 b = self.type2test(sample, "latin-1", "ignore")
Martin v. Löwisdb12d452009-05-02 18:52:14 +0000217 self.assertEqual(b, self.type2test(sample[:-3], "utf-8"))
Christian Heimes510711d2008-01-30 11:57:58 +0000218
219 def test_decode(self):
220 sample = "Hello world\n\u1234\u5678\u9abc\def0\def0"
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000221 for enc in ("utf-8", "utf-16"):
Christian Heimes510711d2008-01-30 11:57:58 +0000222 b = self.type2test(sample, enc)
223 self.assertEqual(b.decode(enc), sample)
224 sample = "Hello world\n\x80\x81\xfe\xff"
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000225 b = self.type2test(sample, "latin-1")
226 self.assertRaises(UnicodeDecodeError, b.decode, "utf-8")
227 self.assertEqual(b.decode("utf-8", "ignore"), "Hello world\n")
228 self.assertEqual(b.decode(errors="ignore", encoding="utf-8"),
Benjamin Peterson308d6372009-09-18 21:42:35 +0000229 "Hello world\n")
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000230 # Default encoding is utf-8
231 self.assertEqual(self.type2test(b'\xe2\x98\x83').decode(), '\u2603')
Christian Heimes510711d2008-01-30 11:57:58 +0000232
233 def test_from_int(self):
234 b = self.type2test(0)
235 self.assertEqual(b, self.type2test())
236 b = self.type2test(10)
237 self.assertEqual(b, self.type2test([0]*10))
238 b = self.type2test(10000)
239 self.assertEqual(b, self.type2test([0]*10000))
240
241 def test_concat(self):
242 b1 = self.type2test(b"abc")
243 b2 = self.type2test(b"def")
244 self.assertEqual(b1 + b2, b"abcdef")
245 self.assertEqual(b1 + bytes(b"def"), b"abcdef")
246 self.assertEqual(bytes(b"def") + b1, b"defabc")
247 self.assertRaises(TypeError, lambda: b1 + "def")
248 self.assertRaises(TypeError, lambda: "abc" + b2)
249
250 def test_repeat(self):
251 for b in b"abc", self.type2test(b"abc"):
252 self.assertEqual(b * 3, b"abcabcabc")
253 self.assertEqual(b * 0, b"")
254 self.assertEqual(b * -1, b"")
255 self.assertRaises(TypeError, lambda: b * 3.14)
256 self.assertRaises(TypeError, lambda: 3.14 * b)
257 # XXX Shouldn't bytes and bytearray agree on what to raise?
Mark Dickinsoncf940c72010-08-10 18:35:01 +0000258 with self.assertRaises((OverflowError, MemoryError)):
259 c = b * sys.maxsize
260 with self.assertRaises((OverflowError, MemoryError)):
261 b *= sys.maxsize
Christian Heimes510711d2008-01-30 11:57:58 +0000262
263 def test_repeat_1char(self):
264 self.assertEqual(self.type2test(b'x')*100, self.type2test([ord('x')]*100))
265
266 def test_contains(self):
267 b = self.type2test(b"abc")
Benjamin Peterson577473f2010-01-19 00:09:57 +0000268 self.assertIn(ord('a'), b)
269 self.assertIn(int(ord('a')), b)
Ezio Melottib58e0bd2010-01-23 15:40:09 +0000270 self.assertNotIn(200, b)
Christian Heimes510711d2008-01-30 11:57:58 +0000271 self.assertRaises(ValueError, lambda: 300 in b)
272 self.assertRaises(ValueError, lambda: -1 in b)
273 self.assertRaises(TypeError, lambda: None in b)
274 self.assertRaises(TypeError, lambda: float(ord('a')) in b)
275 self.assertRaises(TypeError, lambda: "a" in b)
276 for f in bytes, bytearray:
Benjamin Peterson577473f2010-01-19 00:09:57 +0000277 self.assertIn(f(b""), b)
278 self.assertIn(f(b"a"), b)
279 self.assertIn(f(b"b"), b)
280 self.assertIn(f(b"c"), b)
281 self.assertIn(f(b"ab"), b)
282 self.assertIn(f(b"bc"), b)
283 self.assertIn(f(b"abc"), b)
Ezio Melottib58e0bd2010-01-23 15:40:09 +0000284 self.assertNotIn(f(b"ac"), b)
285 self.assertNotIn(f(b"d"), b)
286 self.assertNotIn(f(b"dab"), b)
287 self.assertNotIn(f(b"abd"), b)
Christian Heimes510711d2008-01-30 11:57:58 +0000288
289 def test_fromhex(self):
290 self.assertRaises(TypeError, self.type2test.fromhex)
291 self.assertRaises(TypeError, self.type2test.fromhex, 1)
Ezio Melottib3aedd42010-11-20 19:04:17 +0000292 self.assertEqual(self.type2test.fromhex(''), self.type2test())
Christian Heimes510711d2008-01-30 11:57:58 +0000293 b = bytearray([0x1a, 0x2b, 0x30])
Ezio Melottib3aedd42010-11-20 19:04:17 +0000294 self.assertEqual(self.type2test.fromhex('1a2B30'), b)
295 self.assertEqual(self.type2test.fromhex(' 1A 2B 30 '), b)
296 self.assertEqual(self.type2test.fromhex('0000'), b'\0\0')
Christian Heimes510711d2008-01-30 11:57:58 +0000297 self.assertRaises(TypeError, self.type2test.fromhex, b'1B')
298 self.assertRaises(ValueError, self.type2test.fromhex, 'a')
299 self.assertRaises(ValueError, self.type2test.fromhex, 'rt')
300 self.assertRaises(ValueError, self.type2test.fromhex, '1a b cd')
301 self.assertRaises(ValueError, self.type2test.fromhex, '\x00')
302 self.assertRaises(ValueError, self.type2test.fromhex, '12 \x00 34')
303
Victor Stinner2bf89932015-10-14 11:25:33 +0200304 for data, pos in (
305 # invalid first hexadecimal character
306 ('12 x4 56', 3),
307 # invalid second hexadecimal character
308 ('12 3x 56', 4),
309 # two invalid hexadecimal characters
310 ('12 xy 56', 3),
311 # test non-ASCII string
312 ('12 3\xff 56', 4),
313 ):
314 with self.assertRaises(ValueError) as cm:
315 self.type2test.fromhex(data)
316 self.assertIn('at position %s' % pos, str(cm.exception))
317
Gregory P. Smith8cb65692015-04-25 23:22:26 +0000318 def test_hex(self):
319 self.assertRaises(TypeError, self.type2test.hex)
320 self.assertRaises(TypeError, self.type2test.hex, 1)
Gregory P. Smith32d34bc2015-04-26 05:05:53 +0000321 self.assertEqual(self.type2test(b"").hex(), "")
322 self.assertEqual(bytearray([0x1a, 0x2b, 0x30]).hex(), '1a2b30')
323 self.assertEqual(self.type2test(b"\x1a\x2b\x30").hex(), '1a2b30')
324 self.assertEqual(memoryview(b"\x1a\x2b\x30").hex(), '1a2b30')
Gregory P. Smith8cb65692015-04-25 23:22:26 +0000325
Christian Heimes510711d2008-01-30 11:57:58 +0000326 def test_join(self):
327 self.assertEqual(self.type2test(b"").join([]), b"")
328 self.assertEqual(self.type2test(b"").join([b""]), b"")
329 for lst in [[b"abc"], [b"a", b"bc"], [b"ab", b"c"], [b"a", b"b", b"c"]]:
330 lst = list(map(self.type2test, lst))
331 self.assertEqual(self.type2test(b"").join(lst), b"abc")
332 self.assertEqual(self.type2test(b"").join(tuple(lst)), b"abc")
333 self.assertEqual(self.type2test(b"").join(iter(lst)), b"abc")
Antoine Pitroucfc22b42012-10-16 21:07:23 +0200334 dot_join = self.type2test(b".:").join
335 self.assertEqual(dot_join([b"ab", b"cd"]), b"ab.:cd")
336 self.assertEqual(dot_join([memoryview(b"ab"), b"cd"]), b"ab.:cd")
337 self.assertEqual(dot_join([b"ab", memoryview(b"cd")]), b"ab.:cd")
338 self.assertEqual(dot_join([bytearray(b"ab"), b"cd"]), b"ab.:cd")
339 self.assertEqual(dot_join([b"ab", bytearray(b"cd")]), b"ab.:cd")
340 # Stress it with many items
341 seq = [b"abc"] * 1000
342 expected = b"abc" + b".:abc" * 999
343 self.assertEqual(dot_join(seq), expected)
Benjamin Petersonc31f12d2014-09-28 12:56:42 -0400344 self.assertRaises(TypeError, self.type2test(b" ").join, None)
Antoine Pitroucfc22b42012-10-16 21:07:23 +0200345 # Error handling and cleanup when some item in the middle of the
346 # sequence has the wrong type.
347 with self.assertRaises(TypeError):
348 dot_join([bytearray(b"ab"), "cd", b"ef"])
349 with self.assertRaises(TypeError):
350 dot_join([memoryview(b"ab"), "cd", b"ef"])
Christian Heimes510711d2008-01-30 11:57:58 +0000351
Christian Heimes510711d2008-01-30 11:57:58 +0000352 def test_count(self):
353 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200354 i = 105
355 p = 112
356 w = 119
357
Christian Heimes510711d2008-01-30 11:57:58 +0000358 self.assertEqual(b.count(b'i'), 4)
359 self.assertEqual(b.count(b'ss'), 2)
360 self.assertEqual(b.count(b'w'), 0)
361
Antoine Pitrouac65d962011-10-20 23:54:17 +0200362 self.assertEqual(b.count(i), 4)
363 self.assertEqual(b.count(w), 0)
364
365 self.assertEqual(b.count(b'i', 6), 2)
366 self.assertEqual(b.count(b'p', 6), 2)
367 self.assertEqual(b.count(b'i', 1, 3), 1)
368 self.assertEqual(b.count(b'p', 7, 9), 1)
369
370 self.assertEqual(b.count(i, 6), 2)
371 self.assertEqual(b.count(p, 6), 2)
372 self.assertEqual(b.count(i, 1, 3), 1)
373 self.assertEqual(b.count(p, 7, 9), 1)
374
Christian Heimes510711d2008-01-30 11:57:58 +0000375 def test_startswith(self):
376 b = self.type2test(b'hello')
377 self.assertFalse(self.type2test().startswith(b"anything"))
378 self.assertTrue(b.startswith(b"hello"))
379 self.assertTrue(b.startswith(b"hel"))
380 self.assertTrue(b.startswith(b"h"))
381 self.assertFalse(b.startswith(b"hellow"))
382 self.assertFalse(b.startswith(b"ha"))
Ezio Melottif2b3f782011-04-26 06:40:59 +0300383 with self.assertRaises(TypeError) as cm:
Ezio Melottiba42fd52011-04-26 06:09:45 +0300384 b.startswith([b'h'])
Ezio Melottif2b3f782011-04-26 06:40:59 +0300385 exc = str(cm.exception)
Ezio Melottiba42fd52011-04-26 06:09:45 +0300386 self.assertIn('bytes', exc)
387 self.assertIn('tuple', exc)
Christian Heimes510711d2008-01-30 11:57:58 +0000388
389 def test_endswith(self):
390 b = self.type2test(b'hello')
391 self.assertFalse(bytearray().endswith(b"anything"))
392 self.assertTrue(b.endswith(b"hello"))
393 self.assertTrue(b.endswith(b"llo"))
394 self.assertTrue(b.endswith(b"o"))
395 self.assertFalse(b.endswith(b"whello"))
396 self.assertFalse(b.endswith(b"no"))
Ezio Melottif2b3f782011-04-26 06:40:59 +0300397 with self.assertRaises(TypeError) as cm:
Ezio Melottiba42fd52011-04-26 06:09:45 +0300398 b.endswith([b'o'])
Ezio Melottif2b3f782011-04-26 06:40:59 +0300399 exc = str(cm.exception)
Ezio Melottiba42fd52011-04-26 06:09:45 +0300400 self.assertIn('bytes', exc)
401 self.assertIn('tuple', exc)
Christian Heimes510711d2008-01-30 11:57:58 +0000402
403 def test_find(self):
404 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200405 i = 105
406 w = 119
407
Christian Heimes510711d2008-01-30 11:57:58 +0000408 self.assertEqual(b.find(b'ss'), 2)
Christian Heimes510711d2008-01-30 11:57:58 +0000409 self.assertEqual(b.find(b'w'), -1)
410 self.assertEqual(b.find(b'mississippian'), -1)
411
Antoine Pitrouac65d962011-10-20 23:54:17 +0200412 self.assertEqual(b.find(i), 1)
413 self.assertEqual(b.find(w), -1)
414
415 self.assertEqual(b.find(b'ss', 3), 5)
416 self.assertEqual(b.find(b'ss', 1, 7), 2)
417 self.assertEqual(b.find(b'ss', 1, 3), -1)
418
419 self.assertEqual(b.find(i, 6), 7)
420 self.assertEqual(b.find(i, 1, 3), 1)
421 self.assertEqual(b.find(w, 1, 3), -1)
422
Victor Stinnerf8eac002011-12-18 01:17:41 +0100423 for index in (-1, 256, sys.maxsize + 1):
424 self.assertRaisesRegex(
425 ValueError, r'byte must be in range\(0, 256\)',
426 b.find, index)
427
Christian Heimes510711d2008-01-30 11:57:58 +0000428 def test_rfind(self):
429 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200430 i = 105
431 w = 119
432
Christian Heimes510711d2008-01-30 11:57:58 +0000433 self.assertEqual(b.rfind(b'ss'), 5)
Christian Heimes510711d2008-01-30 11:57:58 +0000434 self.assertEqual(b.rfind(b'w'), -1)
435 self.assertEqual(b.rfind(b'mississippian'), -1)
436
Antoine Pitrouac65d962011-10-20 23:54:17 +0200437 self.assertEqual(b.rfind(i), 10)
438 self.assertEqual(b.rfind(w), -1)
439
440 self.assertEqual(b.rfind(b'ss', 3), 5)
441 self.assertEqual(b.rfind(b'ss', 0, 6), 2)
442
443 self.assertEqual(b.rfind(i, 1, 3), 1)
444 self.assertEqual(b.rfind(i, 3, 9), 7)
445 self.assertEqual(b.rfind(w, 1, 3), -1)
446
Christian Heimes510711d2008-01-30 11:57:58 +0000447 def test_index(self):
Antoine Pitrouac65d962011-10-20 23:54:17 +0200448 b = self.type2test(b'mississippi')
449 i = 105
450 w = 119
451
452 self.assertEqual(b.index(b'ss'), 2)
453 self.assertRaises(ValueError, b.index, b'w')
454 self.assertRaises(ValueError, b.index, b'mississippian')
455
456 self.assertEqual(b.index(i), 1)
457 self.assertRaises(ValueError, b.index, w)
458
459 self.assertEqual(b.index(b'ss', 3), 5)
460 self.assertEqual(b.index(b'ss', 1, 7), 2)
461 self.assertRaises(ValueError, b.index, b'ss', 1, 3)
462
463 self.assertEqual(b.index(i, 6), 7)
464 self.assertEqual(b.index(i, 1, 3), 1)
465 self.assertRaises(ValueError, b.index, w, 1, 3)
Christian Heimes510711d2008-01-30 11:57:58 +0000466
467 def test_rindex(self):
Antoine Pitrouac65d962011-10-20 23:54:17 +0200468 b = self.type2test(b'mississippi')
469 i = 105
470 w = 119
471
472 self.assertEqual(b.rindex(b'ss'), 5)
473 self.assertRaises(ValueError, b.rindex, b'w')
474 self.assertRaises(ValueError, b.rindex, b'mississippian')
475
476 self.assertEqual(b.rindex(i), 10)
477 self.assertRaises(ValueError, b.rindex, w)
478
479 self.assertEqual(b.rindex(b'ss', 3), 5)
480 self.assertEqual(b.rindex(b'ss', 0, 6), 2)
481
482 self.assertEqual(b.rindex(i, 1, 3), 1)
483 self.assertEqual(b.rindex(i, 3, 9), 7)
484 self.assertRaises(ValueError, b.rindex, w, 1, 3)
Christian Heimes510711d2008-01-30 11:57:58 +0000485
Ethan Furmanb95b5612015-01-23 20:05:18 -0800486 def test_mod(self):
487 b = b'hello, %b!'
488 orig = b
489 b = b % b'world'
490 self.assertEqual(b, b'hello, world!')
491 self.assertEqual(orig, b'hello, %b!')
492 self.assertFalse(b is orig)
493 b = b'%s / 100 = %d%%'
494 a = b % (b'seventy-nine', 79)
Serhiy Storchaka4e1942b2015-01-26 09:28:11 +0200495 self.assertEqual(a, b'seventy-nine / 100 = 79%')
Ethan Furmanb95b5612015-01-23 20:05:18 -0800496
497 def test_imod(self):
498 b = b'hello, %b!'
499 orig = b
500 b %= b'world'
501 self.assertEqual(b, b'hello, world!')
502 self.assertEqual(orig, b'hello, %b!')
503 self.assertFalse(b is orig)
504 b = b'%s / 100 = %d%%'
505 b %= (b'seventy-nine', 79)
Serhiy Storchaka4e1942b2015-01-26 09:28:11 +0200506 self.assertEqual(b, b'seventy-nine / 100 = 79%')
Ethan Furmanb95b5612015-01-23 20:05:18 -0800507
Christian Heimes510711d2008-01-30 11:57:58 +0000508 def test_replace(self):
509 b = self.type2test(b'mississippi')
510 self.assertEqual(b.replace(b'i', b'a'), b'massassappa')
511 self.assertEqual(b.replace(b'ss', b'x'), b'mixixippi')
512
513 def test_split(self):
514 b = self.type2test(b'mississippi')
515 self.assertEqual(b.split(b'i'), [b'm', b'ss', b'ss', b'pp', b''])
516 self.assertEqual(b.split(b'ss'), [b'mi', b'i', b'ippi'])
517 self.assertEqual(b.split(b'w'), [b])
Ezio Melotticda6b6d2012-02-26 09:39:55 +0200518 # with keyword args
519 b = self.type2test(b'a|b|c|d')
520 self.assertEqual(b.split(sep=b'|'), [b'a', b'b', b'c', b'd'])
521 self.assertEqual(b.split(b'|', maxsplit=1), [b'a', b'b|c|d'])
522 self.assertEqual(b.split(sep=b'|', maxsplit=1), [b'a', b'b|c|d'])
523 self.assertEqual(b.split(maxsplit=1, sep=b'|'), [b'a', b'b|c|d'])
524 b = self.type2test(b'a b c d')
525 self.assertEqual(b.split(maxsplit=1), [b'a', b'b c d'])
Christian Heimes510711d2008-01-30 11:57:58 +0000526
527 def test_split_whitespace(self):
528 for b in (b' arf barf ', b'arf\tbarf', b'arf\nbarf', b'arf\rbarf',
529 b'arf\fbarf', b'arf\vbarf'):
530 b = self.type2test(b)
531 self.assertEqual(b.split(), [b'arf', b'barf'])
532 self.assertEqual(b.split(None), [b'arf', b'barf'])
533 self.assertEqual(b.split(None, 2), [b'arf', b'barf'])
534 for b in (b'a\x1Cb', b'a\x1Db', b'a\x1Eb', b'a\x1Fb'):
535 b = self.type2test(b)
536 self.assertEqual(b.split(), [b])
537 self.assertEqual(self.type2test(b' a bb c ').split(None, 0), [b'a bb c '])
538 self.assertEqual(self.type2test(b' a bb c ').split(None, 1), [b'a', b'bb c '])
539 self.assertEqual(self.type2test(b' a bb c ').split(None, 2), [b'a', b'bb', b'c '])
540 self.assertEqual(self.type2test(b' a bb c ').split(None, 3), [b'a', b'bb', b'c'])
541
542 def test_split_string_error(self):
543 self.assertRaises(TypeError, self.type2test(b'a b').split, ' ')
544
Antoine Pitrouf8453022010-01-12 22:05:42 +0000545 def test_split_unicodewhitespace(self):
546 b = self.type2test(b"\x09\x0A\x0B\x0C\x0D\x1C\x1D\x1E\x1F")
547 self.assertEqual(b.split(), [b'\x1c\x1d\x1e\x1f'])
548
Christian Heimes510711d2008-01-30 11:57:58 +0000549 def test_rsplit(self):
550 b = self.type2test(b'mississippi')
551 self.assertEqual(b.rsplit(b'i'), [b'm', b'ss', b'ss', b'pp', b''])
552 self.assertEqual(b.rsplit(b'ss'), [b'mi', b'i', b'ippi'])
553 self.assertEqual(b.rsplit(b'w'), [b])
Ezio Melotticda6b6d2012-02-26 09:39:55 +0200554 # with keyword args
555 b = self.type2test(b'a|b|c|d')
556 self.assertEqual(b.rsplit(sep=b'|'), [b'a', b'b', b'c', b'd'])
557 self.assertEqual(b.rsplit(b'|', maxsplit=1), [b'a|b|c', b'd'])
558 self.assertEqual(b.rsplit(sep=b'|', maxsplit=1), [b'a|b|c', b'd'])
559 self.assertEqual(b.rsplit(maxsplit=1, sep=b'|'), [b'a|b|c', b'd'])
560 b = self.type2test(b'a b c d')
561 self.assertEqual(b.rsplit(maxsplit=1), [b'a b c', b'd'])
Christian Heimes510711d2008-01-30 11:57:58 +0000562
563 def test_rsplit_whitespace(self):
564 for b in (b' arf barf ', b'arf\tbarf', b'arf\nbarf', b'arf\rbarf',
565 b'arf\fbarf', b'arf\vbarf'):
566 b = self.type2test(b)
567 self.assertEqual(b.rsplit(), [b'arf', b'barf'])
568 self.assertEqual(b.rsplit(None), [b'arf', b'barf'])
569 self.assertEqual(b.rsplit(None, 2), [b'arf', b'barf'])
570 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 0), [b' a bb c'])
571 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 1), [b' a bb', b'c'])
572 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 2), [b' a', b'bb', b'c'])
573 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 3), [b'a', b'bb', b'c'])
574
575 def test_rsplit_string_error(self):
576 self.assertRaises(TypeError, self.type2test(b'a b').rsplit, ' ')
577
578 def test_rsplit_unicodewhitespace(self):
579 b = self.type2test(b"\x09\x0A\x0B\x0C\x0D\x1C\x1D\x1E\x1F")
Christian Heimes510711d2008-01-30 11:57:58 +0000580 self.assertEqual(b.rsplit(), [b'\x1c\x1d\x1e\x1f'])
581
582 def test_partition(self):
583 b = self.type2test(b'mississippi')
584 self.assertEqual(b.partition(b'ss'), (b'mi', b'ss', b'issippi'))
Antoine Pitrouf8453022010-01-12 22:05:42 +0000585 self.assertEqual(b.partition(b'w'), (b'mississippi', b'', b''))
Christian Heimes510711d2008-01-30 11:57:58 +0000586
587 def test_rpartition(self):
588 b = self.type2test(b'mississippi')
589 self.assertEqual(b.rpartition(b'ss'), (b'missi', b'ss', b'ippi'))
590 self.assertEqual(b.rpartition(b'i'), (b'mississipp', b'i', b''))
Antoine Pitrouf8453022010-01-12 22:05:42 +0000591 self.assertEqual(b.rpartition(b'w'), (b'', b'', b'mississippi'))
Christian Heimes510711d2008-01-30 11:57:58 +0000592
593 def test_pickling(self):
Hirokazu Yamamotod0d0b652008-10-23 00:38:15 +0000594 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
Christian Heimes510711d2008-01-30 11:57:58 +0000595 for b in b"", b"a", b"abc", b"\xffab\x80", b"\0\0\377\0\0":
596 b = self.type2test(b)
597 ps = pickle.dumps(b, proto)
598 q = pickle.loads(ps)
599 self.assertEqual(b, q)
600
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000601 def test_iterator_pickling(self):
Serhiy Storchakabad12572014-12-15 14:03:42 +0200602 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
603 for b in b"", b"a", b"abc", b"\xffab\x80", b"\0\0\377\0\0":
604 it = itorg = iter(self.type2test(b))
605 data = list(self.type2test(b))
606 d = pickle.dumps(it, proto)
607 it = pickle.loads(d)
608 self.assertEqual(type(itorg), type(it))
609 self.assertEqual(list(it), data)
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000610
Serhiy Storchakabad12572014-12-15 14:03:42 +0200611 it = pickle.loads(d)
Serhiy Storchakaaabafe72016-03-06 14:10:24 +0200612 if not b:
Serhiy Storchakabad12572014-12-15 14:03:42 +0200613 continue
Serhiy Storchakaaabafe72016-03-06 14:10:24 +0200614 next(it)
Serhiy Storchakabad12572014-12-15 14:03:42 +0200615 d = pickle.dumps(it, proto)
616 it = pickle.loads(d)
617 self.assertEqual(list(it), data[1:])
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000618
Christian Heimes510711d2008-01-30 11:57:58 +0000619 def test_strip(self):
620 b = self.type2test(b'mississippi')
621 self.assertEqual(b.strip(b'i'), b'mississipp')
622 self.assertEqual(b.strip(b'm'), b'ississippi')
623 self.assertEqual(b.strip(b'pi'), b'mississ')
624 self.assertEqual(b.strip(b'im'), b'ssissipp')
625 self.assertEqual(b.strip(b'pim'), b'ssiss')
626 self.assertEqual(b.strip(b), b'')
627
628 def test_lstrip(self):
629 b = self.type2test(b'mississippi')
630 self.assertEqual(b.lstrip(b'i'), b'mississippi')
631 self.assertEqual(b.lstrip(b'm'), b'ississippi')
632 self.assertEqual(b.lstrip(b'pi'), b'mississippi')
633 self.assertEqual(b.lstrip(b'im'), b'ssissippi')
634 self.assertEqual(b.lstrip(b'pim'), b'ssissippi')
635
636 def test_rstrip(self):
637 b = self.type2test(b'mississippi')
638 self.assertEqual(b.rstrip(b'i'), b'mississipp')
639 self.assertEqual(b.rstrip(b'm'), b'mississippi')
640 self.assertEqual(b.rstrip(b'pi'), b'mississ')
641 self.assertEqual(b.rstrip(b'im'), b'mississipp')
642 self.assertEqual(b.rstrip(b'pim'), b'mississ')
643
644 def test_strip_whitespace(self):
645 b = self.type2test(b' \t\n\r\f\vabc \t\n\r\f\v')
646 self.assertEqual(b.strip(), b'abc')
647 self.assertEqual(b.lstrip(), b'abc \t\n\r\f\v')
648 self.assertEqual(b.rstrip(), b' \t\n\r\f\vabc')
649
650 def test_strip_bytearray(self):
651 self.assertEqual(self.type2test(b'abc').strip(memoryview(b'ac')), b'b')
652 self.assertEqual(self.type2test(b'abc').lstrip(memoryview(b'ac')), b'bc')
653 self.assertEqual(self.type2test(b'abc').rstrip(memoryview(b'ac')), b'ab')
654
655 def test_strip_string_error(self):
656 self.assertRaises(TypeError, self.type2test(b'abc').strip, 'b')
657 self.assertRaises(TypeError, self.type2test(b'abc').lstrip, 'b')
658 self.assertRaises(TypeError, self.type2test(b'abc').rstrip, 'b')
659
Eli Bendersky906b88f2011-07-29 07:05:08 +0300660 def test_center(self):
661 # Fill character can be either bytes or bytearray (issue 12380)
662 b = self.type2test(b'abc')
663 for fill_type in (bytes, bytearray):
664 self.assertEqual(b.center(7, fill_type(b'-')),
665 self.type2test(b'--abc--'))
666
667 def test_ljust(self):
668 # Fill character can be either bytes or bytearray (issue 12380)
669 b = self.type2test(b'abc')
670 for fill_type in (bytes, bytearray):
671 self.assertEqual(b.ljust(7, fill_type(b'-')),
672 self.type2test(b'abc----'))
673
674 def test_rjust(self):
675 # Fill character can be either bytes or bytearray (issue 12380)
676 b = self.type2test(b'abc')
677 for fill_type in (bytes, bytearray):
678 self.assertEqual(b.rjust(7, fill_type(b'-')),
679 self.type2test(b'----abc'))
680
Christian Heimes510711d2008-01-30 11:57:58 +0000681 def test_ord(self):
682 b = self.type2test(b'\0A\x7f\x80\xff')
683 self.assertEqual([ord(b[i:i+1]) for i in range(len(b))],
684 [0, 65, 127, 128, 255])
685
Georg Brandlabc38772009-04-12 15:51:51 +0000686 def test_maketrans(self):
687 transtable = b'\000\001\002\003\004\005\006\007\010\011\012\013\014\015\016\017\020\021\022\023\024\025\026\027\030\031\032\033\034\035\036\037 !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`xyzdefghijklmnopqrstuvwxyz{|}~\177\200\201\202\203\204\205\206\207\210\211\212\213\214\215\216\217\220\221\222\223\224\225\226\227\230\231\232\233\234\235\236\237\240\241\242\243\244\245\246\247\250\251\252\253\254\255\256\257\260\261\262\263\264\265\266\267\270\271\272\273\274\275\276\277\300\301\302\303\304\305\306\307\310\311\312\313\314\315\316\317\320\321\322\323\324\325\326\327\330\331\332\333\334\335\336\337\340\341\342\343\344\345\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\372\373\374\375\376\377'
Georg Brandlabc38772009-04-12 15:51:51 +0000688 self.assertEqual(self.type2test.maketrans(b'abc', b'xyz'), transtable)
Antoine Pitrou403ce782009-10-14 17:14:16 +0000689 transtable = b'\000\001\002\003\004\005\006\007\010\011\012\013\014\015\016\017\020\021\022\023\024\025\026\027\030\031\032\033\034\035\036\037 !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~\177\200\201\202\203\204\205\206\207\210\211\212\213\214\215\216\217\220\221\222\223\224\225\226\227\230\231\232\233\234\235\236\237\240\241\242\243\244\245\246\247\250\251\252\253\254\255\256\257\260\261\262\263\264\265\266\267\270\271\272\273\274\275\276\277\300\301\302\303\304\305\306\307\310\311\312\313\314\315\316\317\320\321\322\323\324\325\326\327\330\331\332\333\334\335\336\337\340\341\342\343\344\345\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\372\373\374xyz'
690 self.assertEqual(self.type2test.maketrans(b'\375\376\377', b'xyz'), transtable)
Georg Brandlabc38772009-04-12 15:51:51 +0000691 self.assertRaises(ValueError, self.type2test.maketrans, b'abc', b'xyzq')
692 self.assertRaises(TypeError, self.type2test.maketrans, 'abc', 'def')
693
Jesus Ceaac451502011-04-20 17:09:23 +0200694 def test_none_arguments(self):
695 # issue 11828
696 b = self.type2test(b'hello')
697 l = self.type2test(b'l')
698 h = self.type2test(b'h')
699 x = self.type2test(b'x')
700 o = self.type2test(b'o')
701
702 self.assertEqual(2, b.find(l, None))
703 self.assertEqual(3, b.find(l, -2, None))
704 self.assertEqual(2, b.find(l, None, -2))
705 self.assertEqual(0, b.find(h, None, None))
706
707 self.assertEqual(3, b.rfind(l, None))
708 self.assertEqual(3, b.rfind(l, -2, None))
709 self.assertEqual(2, b.rfind(l, None, -2))
710 self.assertEqual(0, b.rfind(h, None, None))
711
712 self.assertEqual(2, b.index(l, None))
713 self.assertEqual(3, b.index(l, -2, None))
714 self.assertEqual(2, b.index(l, None, -2))
715 self.assertEqual(0, b.index(h, None, None))
716
717 self.assertEqual(3, b.rindex(l, None))
718 self.assertEqual(3, b.rindex(l, -2, None))
719 self.assertEqual(2, b.rindex(l, None, -2))
720 self.assertEqual(0, b.rindex(h, None, None))
721
722 self.assertEqual(2, b.count(l, None))
723 self.assertEqual(1, b.count(l, -2, None))
724 self.assertEqual(1, b.count(l, None, -2))
725 self.assertEqual(0, b.count(x, None, None))
726
727 self.assertEqual(True, b.endswith(o, None))
728 self.assertEqual(True, b.endswith(o, -2, None))
729 self.assertEqual(True, b.endswith(l, None, -2))
730 self.assertEqual(False, b.endswith(x, None, None))
731
732 self.assertEqual(True, b.startswith(h, None))
733 self.assertEqual(True, b.startswith(l, -2, None))
734 self.assertEqual(True, b.startswith(h, None, -2))
735 self.assertEqual(False, b.startswith(x, None, None))
736
Antoine Pitrouac65d962011-10-20 23:54:17 +0200737 def test_integer_arguments_out_of_byte_range(self):
738 b = self.type2test(b'hello')
739
740 for method in (b.count, b.find, b.index, b.rfind, b.rindex):
741 self.assertRaises(ValueError, method, -1)
742 self.assertRaises(ValueError, method, 256)
743 self.assertRaises(ValueError, method, 9999)
744
Jesus Ceaac451502011-04-20 17:09:23 +0200745 def test_find_etc_raise_correct_error_messages(self):
746 # issue 11828
747 b = self.type2test(b'hello')
748 x = self.type2test(b'x')
Ezio Melottiaf928422011-04-20 21:56:21 +0300749 self.assertRaisesRegex(TypeError, r'\bfind\b', b.find,
Jesus Ceaac451502011-04-20 17:09:23 +0200750 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300751 self.assertRaisesRegex(TypeError, r'\brfind\b', b.rfind,
Jesus Ceaac451502011-04-20 17:09:23 +0200752 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300753 self.assertRaisesRegex(TypeError, r'\bindex\b', b.index,
Jesus Ceaac451502011-04-20 17:09:23 +0200754 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300755 self.assertRaisesRegex(TypeError, r'\brindex\b', b.rindex,
Jesus Ceaac451502011-04-20 17:09:23 +0200756 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300757 self.assertRaisesRegex(TypeError, r'\bcount\b', b.count,
Jesus Ceaac451502011-04-20 17:09:23 +0200758 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300759 self.assertRaisesRegex(TypeError, r'\bstartswith\b', b.startswith,
Jesus Ceaac451502011-04-20 17:09:23 +0200760 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300761 self.assertRaisesRegex(TypeError, r'\bendswith\b', b.endswith,
Jesus Ceaac451502011-04-20 17:09:23 +0200762 x, None, None, None)
763
Christian Heimes510711d2008-01-30 11:57:58 +0000764
Ezio Melotti0dceb562013-01-10 07:43:26 +0200765class BytesTest(BaseBytesTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +0000766 type2test = bytes
767
Terry Jan Reedyffff1442014-08-02 01:30:37 -0400768 def test_getitem_error(self):
769 msg = "byte indices must be integers or slices"
770 with self.assertRaisesRegex(TypeError, msg):
771 b'python'['a']
772
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000773 def test_buffer_is_readonly(self):
Victor Stinner76119642014-07-28 22:07:07 +0200774 fd = os.open(__file__, os.O_RDONLY)
Antoine Pitrou47d305d2008-08-16 23:28:44 +0000775 with open(fd, "rb", buffering=0) as f:
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000776 self.assertRaises(TypeError, f.readinto, b"")
777
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000778 def test_custom(self):
779 class A:
780 def __bytes__(self):
781 return b'abc'
782 self.assertEqual(bytes(A()), b'abc')
783 class A: pass
784 self.assertRaises(TypeError, bytes, A())
785 class A:
786 def __bytes__(self):
787 return None
788 self.assertRaises(TypeError, bytes, A())
Benjamin Peterson5ff3f732012-12-19 15:27:41 -0600789 class A:
790 def __bytes__(self):
791 return b'a'
792 def __index__(self):
793 return 42
794 self.assertEqual(bytes(A()), b'a')
Serhiy Storchaka5aac3ed2015-12-20 16:36:34 +0200795 # Issue #25766
796 class A(str):
797 def __bytes__(self):
798 return b'abc'
799 self.assertEqual(bytes(A('\u20ac')), b'abc')
800 self.assertEqual(bytes(A('\u20ac'), 'iso8859-15'), b'\xa4')
Serhiy Storchaka15095802015-11-25 15:47:01 +0200801 # Issue #24731
802 class A:
803 def __bytes__(self):
804 return OtherBytesSubclass(b'abc')
805 self.assertEqual(bytes(A()), b'abc')
806 self.assertIs(type(bytes(A())), OtherBytesSubclass)
807 self.assertEqual(BytesSubclass(A()), b'abc')
808 self.assertIs(type(BytesSubclass(A())), BytesSubclass)
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000809
Victor Stinner29e762c2011-01-05 03:33:28 +0000810 # Test PyBytes_FromFormat()
811 def test_from_format(self):
Victor Stinner7ab986d2015-10-14 02:55:12 +0200812 ctypes = test.support.import_module('ctypes')
Victor Stinner03dab782015-10-14 00:21:35 +0200813 _testcapi = test.support.import_module('_testcapi')
814 from ctypes import pythonapi, py_object
815 from ctypes import (
816 c_int, c_uint,
817 c_long, c_ulong,
818 c_size_t, c_ssize_t,
819 c_char_p)
820
Victor Stinner29e762c2011-01-05 03:33:28 +0000821 PyBytes_FromFormat = pythonapi.PyBytes_FromFormat
822 PyBytes_FromFormat.restype = py_object
823
Victor Stinner03dab782015-10-14 00:21:35 +0200824 # basic tests
Victor Stinner29e762c2011-01-05 03:33:28 +0000825 self.assertEqual(PyBytes_FromFormat(b'format'),
826 b'format')
Victor Stinner03dab782015-10-14 00:21:35 +0200827 self.assertEqual(PyBytes_FromFormat(b'Hello %s !', b'world'),
828 b'Hello world !')
Victor Stinner29e762c2011-01-05 03:33:28 +0000829
Victor Stinner03dab782015-10-14 00:21:35 +0200830 # test formatters
831 self.assertEqual(PyBytes_FromFormat(b'c=%c', c_int(0)),
832 b'c=\0')
833 self.assertEqual(PyBytes_FromFormat(b'c=%c', c_int(ord('@'))),
834 b'c=@')
835 self.assertEqual(PyBytes_FromFormat(b'c=%c', c_int(255)),
836 b'c=\xff')
837 self.assertEqual(PyBytes_FromFormat(b'd=%d ld=%ld zd=%zd',
838 c_int(1), c_long(2),
839 c_size_t(3)),
840 b'd=1 ld=2 zd=3')
841 self.assertEqual(PyBytes_FromFormat(b'd=%d ld=%ld zd=%zd',
842 c_int(-1), c_long(-2),
843 c_size_t(-3)),
844 b'd=-1 ld=-2 zd=-3')
845 self.assertEqual(PyBytes_FromFormat(b'u=%u lu=%lu zu=%zu',
846 c_uint(123), c_ulong(456),
847 c_size_t(789)),
848 b'u=123 lu=456 zu=789')
849 self.assertEqual(PyBytes_FromFormat(b'i=%i', c_int(123)),
850 b'i=123')
851 self.assertEqual(PyBytes_FromFormat(b'i=%i', c_int(-123)),
852 b'i=-123')
853 self.assertEqual(PyBytes_FromFormat(b'x=%x', c_int(0xabc)),
854 b'x=abc')
Victor Stinner83ff8a62015-10-14 15:28:59 +0200855
856 sizeof_ptr = ctypes.sizeof(c_char_p)
857
858 if os.name == 'nt':
859 # Windows (MSCRT)
860 ptr_format = '0x%0{}X'.format(2 * sizeof_ptr)
861 def ptr_formatter(ptr):
862 return (ptr_format % ptr)
863 else:
864 # UNIX (glibc)
865 def ptr_formatter(ptr):
866 return '%#x' % ptr
867
Victor Stinner7ab986d2015-10-14 02:55:12 +0200868 ptr = 0xabcdef
Victor Stinner83ff8a62015-10-14 15:28:59 +0200869 self.assertEqual(PyBytes_FromFormat(b'ptr=%p', c_char_p(ptr)),
870 ('ptr=' + ptr_formatter(ptr)).encode('ascii'))
Victor Stinner03dab782015-10-14 00:21:35 +0200871 self.assertEqual(PyBytes_FromFormat(b's=%s', c_char_p(b'cstr')),
872 b's=cstr')
873
874 # test minimum and maximum integer values
875 size_max = c_size_t(-1).value
876 for formatstr, ctypes_type, value, py_formatter in (
877 (b'%d', c_int, _testcapi.INT_MIN, str),
878 (b'%d', c_int, _testcapi.INT_MAX, str),
879 (b'%ld', c_long, _testcapi.LONG_MIN, str),
880 (b'%ld', c_long, _testcapi.LONG_MAX, str),
881 (b'%lu', c_ulong, _testcapi.ULONG_MAX, str),
882 (b'%zd', c_ssize_t, _testcapi.PY_SSIZE_T_MIN, str),
883 (b'%zd', c_ssize_t, _testcapi.PY_SSIZE_T_MAX, str),
884 (b'%zu', c_size_t, size_max, str),
Victor Stinner83ff8a62015-10-14 15:28:59 +0200885 (b'%p', c_char_p, size_max, ptr_formatter),
Victor Stinner03dab782015-10-14 00:21:35 +0200886 ):
887 self.assertEqual(PyBytes_FromFormat(formatstr, ctypes_type(value)),
888 py_formatter(value).encode('ascii')),
889
890 # width and precision (width is currently ignored)
891 self.assertEqual(PyBytes_FromFormat(b'%5s', b'a'),
892 b'a')
893 self.assertEqual(PyBytes_FromFormat(b'%.3s', b'abcdef'),
894 b'abc')
895
896 # '%%' formatter
897 self.assertEqual(PyBytes_FromFormat(b'%%'),
898 b'%')
899 self.assertEqual(PyBytes_FromFormat(b'[%%]'),
900 b'[%]')
901 self.assertEqual(PyBytes_FromFormat(b'%%%c', c_int(ord('_'))),
902 b'%_')
903 self.assertEqual(PyBytes_FromFormat(b'%%s'),
904 b'%s')
905
906 # Invalid formats and partial formatting
Victor Stinner29e762c2011-01-05 03:33:28 +0000907 self.assertEqual(PyBytes_FromFormat(b'%'), b'%')
Victor Stinner03dab782015-10-14 00:21:35 +0200908 self.assertEqual(PyBytes_FromFormat(b'x=%i y=%', c_int(2), c_int(3)),
909 b'x=2 y=%')
Victor Stinner29e762c2011-01-05 03:33:28 +0000910
Victor Stinner03dab782015-10-14 00:21:35 +0200911 # Issue #19969: %c must raise OverflowError for values
912 # not in the range [0; 255]
Victor Stinnerc9362cf2013-12-13 12:14:44 +0100913 self.assertRaises(OverflowError,
914 PyBytes_FromFormat, b'%c', c_int(-1))
915 self.assertRaises(OverflowError,
916 PyBytes_FromFormat, b'%c', c_int(256))
917
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000918
Ezio Melotti0dceb562013-01-10 07:43:26 +0200919class ByteArrayTest(BaseBytesTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +0000920 type2test = bytearray
Guido van Rossumebea9be2007-04-09 00:49:13 +0000921
Terry Jan Reedyffff1442014-08-02 01:30:37 -0400922 def test_getitem_error(self):
923 msg = "bytearray indices must be integers or slices"
924 with self.assertRaisesRegex(TypeError, msg):
925 bytearray(b'python')['a']
926
927 def test_setitem_error(self):
928 msg = "bytearray indices must be integers or slices"
929 with self.assertRaisesRegex(TypeError, msg):
930 b = bytearray(b'python')
931 b['a'] = "python"
932
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000933 def test_nohash(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000934 self.assertRaises(TypeError, hash, bytearray())
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000935
Guido van Rossum254348e2007-11-21 19:29:53 +0000936 def test_bytearray_api(self):
Guido van Rossum75d6f1a2007-05-24 17:52:00 +0000937 short_sample = b"Hello world\n"
Guido van Rossum98297ee2007-11-06 21:34:58 +0000938 sample = short_sample + b"\0"*(20 - len(short_sample))
Guido van Rossumd624f182006-04-24 13:47:05 +0000939 tfn = tempfile.mktemp()
940 try:
941 # Prepare
942 with open(tfn, "wb") as f:
943 f.write(short_sample)
944 # Test readinto
945 with open(tfn, "rb") as f:
Guido van Rossum254348e2007-11-21 19:29:53 +0000946 b = bytearray(20)
Guido van Rossumd624f182006-04-24 13:47:05 +0000947 n = f.readinto(b)
948 self.assertEqual(n, len(short_sample))
Guido van Rossumc1f779c2007-07-03 08:25:58 +0000949 self.assertEqual(list(b), list(sample))
Guido van Rossumd624f182006-04-24 13:47:05 +0000950 # Test writing in binary mode
951 with open(tfn, "wb") as f:
952 f.write(b)
953 with open(tfn, "rb") as f:
954 self.assertEqual(f.read(), sample)
Guido van Rossum13633bb2007-04-13 18:42:35 +0000955 # Text mode is ambiguous; don't test
Guido van Rossumd624f182006-04-24 13:47:05 +0000956 finally:
957 try:
958 os.remove(tfn)
Andrew Svetlov8b33dd82012-12-24 19:58:48 +0200959 except OSError:
Guido van Rossumd624f182006-04-24 13:47:05 +0000960 pass
961
Neal Norwitz6968b052007-02-27 19:02:19 +0000962 def test_reverse(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000963 b = bytearray(b'hello')
Neal Norwitz6968b052007-02-27 19:02:19 +0000964 self.assertEqual(b.reverse(), None)
965 self.assertEqual(b, b'olleh')
Guido van Rossum254348e2007-11-21 19:29:53 +0000966 b = bytearray(b'hello1') # test even number of items
Neal Norwitz6968b052007-02-27 19:02:19 +0000967 b.reverse()
968 self.assertEqual(b, b'1olleh')
Guido van Rossum254348e2007-11-21 19:29:53 +0000969 b = bytearray()
Neal Norwitz6968b052007-02-27 19:02:19 +0000970 b.reverse()
971 self.assertFalse(b)
972
Eli Bendersky4db28d32011-03-03 18:21:02 +0000973 def test_clear(self):
974 b = bytearray(b'python')
975 b.clear()
976 self.assertEqual(b, b'')
977
978 b = bytearray(b'')
979 b.clear()
980 self.assertEqual(b, b'')
981
982 b = bytearray(b'')
983 b.append(ord('r'))
984 b.clear()
985 b.append(ord('p'))
986 self.assertEqual(b, b'p')
987
988 def test_copy(self):
989 b = bytearray(b'abc')
990 bb = b.copy()
991 self.assertEqual(bb, b'abc')
992
993 b = bytearray(b'')
994 bb = b.copy()
995 self.assertEqual(bb, b'')
996
997 # test that it's indeed a copy and not a reference
998 b = bytearray(b'abc')
999 bb = b.copy()
1000 self.assertEqual(b, bb)
1001 self.assertIsNot(b, bb)
1002 bb.append(ord('d'))
1003 self.assertEqual(bb, b'abcd')
1004 self.assertEqual(b, b'abc')
1005
Guido van Rossumd624f182006-04-24 13:47:05 +00001006 def test_regexps(self):
1007 def by(s):
Guido van Rossum254348e2007-11-21 19:29:53 +00001008 return bytearray(map(ord, s))
Guido van Rossumd624f182006-04-24 13:47:05 +00001009 b = by("Hello, world")
Antoine Pitroufd036452008-08-19 17:56:33 +00001010 self.assertEqual(re.findall(br"\w+", b), [by("Hello"), by("world")])
Guido van Rossumd624f182006-04-24 13:47:05 +00001011
1012 def test_setitem(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001013 b = bytearray([1, 2, 3])
Guido van Rossumd624f182006-04-24 13:47:05 +00001014 b[1] = 100
Guido van Rossum254348e2007-11-21 19:29:53 +00001015 self.assertEqual(b, bytearray([1, 100, 3]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001016 b[-1] = 200
Guido van Rossum254348e2007-11-21 19:29:53 +00001017 self.assertEqual(b, bytearray([1, 100, 200]))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001018 b[0] = Indexable(10)
Guido van Rossum254348e2007-11-21 19:29:53 +00001019 self.assertEqual(b, bytearray([10, 100, 200]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001020 try:
1021 b[3] = 0
1022 self.fail("Didn't raise IndexError")
1023 except IndexError:
1024 pass
1025 try:
1026 b[-10] = 0
1027 self.fail("Didn't raise IndexError")
1028 except IndexError:
1029 pass
1030 try:
1031 b[0] = 256
1032 self.fail("Didn't raise ValueError")
1033 except ValueError:
1034 pass
1035 try:
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001036 b[0] = Indexable(-1)
Guido van Rossumd624f182006-04-24 13:47:05 +00001037 self.fail("Didn't raise ValueError")
1038 except ValueError:
1039 pass
1040 try:
1041 b[0] = None
1042 self.fail("Didn't raise TypeError")
1043 except TypeError:
1044 pass
1045
1046 def test_delitem(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001047 b = bytearray(range(10))
Guido van Rossumd624f182006-04-24 13:47:05 +00001048 del b[0]
Guido van Rossum254348e2007-11-21 19:29:53 +00001049 self.assertEqual(b, bytearray(range(1, 10)))
Guido van Rossumd624f182006-04-24 13:47:05 +00001050 del b[-1]
Guido van Rossum254348e2007-11-21 19:29:53 +00001051 self.assertEqual(b, bytearray(range(1, 9)))
Guido van Rossumd624f182006-04-24 13:47:05 +00001052 del b[4]
Guido van Rossum254348e2007-11-21 19:29:53 +00001053 self.assertEqual(b, bytearray([1, 2, 3, 4, 6, 7, 8]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001054
1055 def test_setslice(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001056 b = bytearray(range(10))
Guido van Rossumd624f182006-04-24 13:47:05 +00001057 self.assertEqual(list(b), list(range(10)))
1058
Guido van Rossum254348e2007-11-21 19:29:53 +00001059 b[0:5] = bytearray([1, 1, 1, 1, 1])
1060 self.assertEqual(b, bytearray([1, 1, 1, 1, 1, 5, 6, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001061
1062 del b[0:-5]
Guido van Rossum254348e2007-11-21 19:29:53 +00001063 self.assertEqual(b, bytearray([5, 6, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001064
Guido van Rossum254348e2007-11-21 19:29:53 +00001065 b[0:0] = bytearray([0, 1, 2, 3, 4])
1066 self.assertEqual(b, bytearray(range(10)))
Guido van Rossumd624f182006-04-24 13:47:05 +00001067
Guido van Rossum254348e2007-11-21 19:29:53 +00001068 b[-7:-3] = bytearray([100, 101])
1069 self.assertEqual(b, bytearray([0, 1, 2, 100, 101, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001070
1071 b[3:5] = [3, 4, 5, 6]
Guido van Rossum254348e2007-11-21 19:29:53 +00001072 self.assertEqual(b, bytearray(range(10)))
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001073
Thomas Wouters9a6e62b2006-08-23 23:20:29 +00001074 b[3:0] = [42, 42, 42]
Guido van Rossum254348e2007-11-21 19:29:53 +00001075 self.assertEqual(b, bytearray([0, 1, 2, 42, 42, 42, 3, 4, 5, 6, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +00001076
Ezio Melottic64bcbe2012-11-03 21:19:06 +02001077 b[3:] = b'foo'
1078 self.assertEqual(b, bytearray([0, 1, 2, 102, 111, 111]))
1079
1080 b[:3] = memoryview(b'foo')
1081 self.assertEqual(b, bytearray([102, 111, 111, 102, 111, 111]))
1082
1083 b[3:4] = []
1084 self.assertEqual(b, bytearray([102, 111, 111, 111, 111]))
1085
1086 for elem in [5, -5, 0, int(10e20), 'str', 2.3,
1087 ['a', 'b'], [b'a', b'b'], [[]]]:
1088 with self.assertRaises(TypeError):
1089 b[3:4] = elem
1090
1091 for elem in [[254, 255, 256], [-256, 9000]]:
1092 with self.assertRaises(ValueError):
1093 b[3:4] = elem
1094
Antoine Pitrou5df8a8a2013-10-05 21:12:18 +02001095 def test_setslice_extend(self):
1096 # Exercise the resizing logic (see issue #19087)
1097 b = bytearray(range(100))
1098 self.assertEqual(list(b), list(range(100)))
1099 del b[:10]
1100 self.assertEqual(list(b), list(range(10, 100)))
1101 b.extend(range(100, 110))
1102 self.assertEqual(list(b), list(range(10, 110)))
1103
Antoine Pitrou25454112015-05-19 20:52:27 +02001104 def test_fifo_overrun(self):
1105 # Test for issue #23985, a buffer overrun when implementing a FIFO
1106 # Build Python in pydebug mode for best results.
1107 b = bytearray(10)
1108 b.pop() # Defeat expanding buffer off-by-one quirk
1109 del b[:1] # Advance start pointer without reallocating
1110 b += bytes(2) # Append exactly the number of deleted bytes
1111 del b # Free memory buffer, allowing pydebug verification
1112
1113 def test_del_expand(self):
1114 # Reducing the size should not expand the buffer (issue #23985)
1115 b = bytearray(10)
1116 size = sys.getsizeof(b)
1117 del b[:1]
1118 self.assertLessEqual(sys.getsizeof(b), size)
1119
Thomas Wouters376446d2006-12-19 08:30:14 +00001120 def test_extended_set_del_slice(self):
Mark Dickinsonbc099642010-01-29 17:27:24 +00001121 indices = (0, None, 1, 3, 19, 300, 1<<333, -1, -2, -31, -300)
Thomas Wouters376446d2006-12-19 08:30:14 +00001122 for start in indices:
1123 for stop in indices:
1124 # Skip invalid step 0
1125 for step in indices[1:]:
1126 L = list(range(255))
Guido van Rossum254348e2007-11-21 19:29:53 +00001127 b = bytearray(L)
Thomas Wouters376446d2006-12-19 08:30:14 +00001128 # Make sure we have a slice of exactly the right length,
1129 # but with different data.
1130 data = L[start:stop:step]
1131 data.reverse()
1132 L[start:stop:step] = data
1133 b[start:stop:step] = data
Ezio Melottib3aedd42010-11-20 19:04:17 +00001134 self.assertEqual(b, bytearray(L))
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001135
Thomas Wouters376446d2006-12-19 08:30:14 +00001136 del L[start:stop:step]
1137 del b[start:stop:step]
Ezio Melottib3aedd42010-11-20 19:04:17 +00001138 self.assertEqual(b, bytearray(L))
Thomas Wouters376446d2006-12-19 08:30:14 +00001139
Guido van Rossumd624f182006-04-24 13:47:05 +00001140 def test_setslice_trap(self):
1141 # This test verifies that we correctly handle assigning self
1142 # to a slice of self (the old Lambert Meertens trap).
Guido van Rossum254348e2007-11-21 19:29:53 +00001143 b = bytearray(range(256))
Guido van Rossumd624f182006-04-24 13:47:05 +00001144 b[8:] = b
Guido van Rossum254348e2007-11-21 19:29:53 +00001145 self.assertEqual(b, bytearray(list(range(8)) + list(range(256))))
Guido van Rossumd624f182006-04-24 13:47:05 +00001146
Ethan Furmanb95b5612015-01-23 20:05:18 -08001147 def test_mod(self):
1148 b = bytearray(b'hello, %b!')
1149 orig = b
1150 b = b % b'world'
1151 self.assertEqual(b, b'hello, world!')
1152 self.assertEqual(orig, bytearray(b'hello, %b!'))
1153 self.assertFalse(b is orig)
1154 b = bytearray(b'%s / 100 = %d%%')
1155 a = b % (b'seventy-nine', 79)
Serhiy Storchaka4e1942b2015-01-26 09:28:11 +02001156 self.assertEqual(a, bytearray(b'seventy-nine / 100 = 79%'))
Ethan Furmanb95b5612015-01-23 20:05:18 -08001157
1158 def test_imod(self):
1159 b = bytearray(b'hello, %b!')
1160 orig = b
1161 b %= b'world'
1162 self.assertEqual(b, b'hello, world!')
1163 self.assertEqual(orig, bytearray(b'hello, %b!'))
1164 self.assertFalse(b is orig)
1165 b = bytearray(b'%s / 100 = %d%%')
1166 b %= (b'seventy-nine', 79)
Serhiy Storchaka4e1942b2015-01-26 09:28:11 +02001167 self.assertEqual(b, bytearray(b'seventy-nine / 100 = 79%'))
Ethan Furmanb95b5612015-01-23 20:05:18 -08001168
Guido van Rossum13e57212006-04-27 22:54:26 +00001169 def test_iconcat(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001170 b = bytearray(b"abc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001171 b1 = b
Guido van Rossum9c627722007-08-27 18:31:48 +00001172 b += b"def"
1173 self.assertEqual(b, b"abcdef")
Guido van Rossum13e57212006-04-27 22:54:26 +00001174 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001175 self.assertTrue(b is b1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001176 b += b"xyz"
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001177 self.assertEqual(b, b"abcdefxyz")
1178 try:
Guido van Rossumef87d6e2007-05-02 19:09:54 +00001179 b += ""
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001180 except TypeError:
1181 pass
1182 else:
1183 self.fail("bytes += unicode didn't raise TypeError")
Guido van Rossum13e57212006-04-27 22:54:26 +00001184
1185 def test_irepeat(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001186 b = bytearray(b"abc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001187 b1 = b
1188 b *= 3
Guido van Rossum9c627722007-08-27 18:31:48 +00001189 self.assertEqual(b, b"abcabcabc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001190 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001191 self.assertTrue(b is b1)
Guido van Rossum13e57212006-04-27 22:54:26 +00001192
1193 def test_irepeat_1char(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001194 b = bytearray(b"x")
Guido van Rossum13e57212006-04-27 22:54:26 +00001195 b1 = b
1196 b *= 100
Guido van Rossum98297ee2007-11-06 21:34:58 +00001197 self.assertEqual(b, b"x"*100)
Guido van Rossum13e57212006-04-27 22:54:26 +00001198 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001199 self.assertTrue(b is b1)
Guido van Rossum13e57212006-04-27 22:54:26 +00001200
Guido van Rossum20188312006-05-05 15:15:40 +00001201 def test_alloc(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001202 b = bytearray()
Guido van Rossum20188312006-05-05 15:15:40 +00001203 alloc = b.__alloc__()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001204 self.assertTrue(alloc >= 0)
Guido van Rossum20188312006-05-05 15:15:40 +00001205 seq = [alloc]
1206 for i in range(100):
Guido van Rossum9c627722007-08-27 18:31:48 +00001207 b += b"x"
Guido van Rossum20188312006-05-05 15:15:40 +00001208 alloc = b.__alloc__()
Serhiy Storchaka7b6e3b92015-06-29 21:14:06 +03001209 self.assertGreater(alloc, len(b)) # including trailing null byte
Guido van Rossum20188312006-05-05 15:15:40 +00001210 if alloc not in seq:
1211 seq.append(alloc)
Guido van Rossum20188312006-05-05 15:15:40 +00001212
Serhiy Storchaka7b6e3b92015-06-29 21:14:06 +03001213 def test_init_alloc(self):
1214 b = bytearray()
1215 def g():
1216 for i in range(1, 100):
1217 yield i
1218 a = list(b)
1219 self.assertEqual(a, list(range(1, len(a)+1)))
1220 self.assertEqual(len(b), len(a))
1221 self.assertLessEqual(len(b), i)
1222 alloc = b.__alloc__()
1223 self.assertGreater(alloc, len(b)) # including trailing null byte
1224 b.__init__(g())
1225 self.assertEqual(list(b), list(range(1, 100)))
1226 self.assertEqual(len(b), 99)
1227 alloc = b.__alloc__()
1228 self.assertGreater(alloc, len(b))
1229
Neal Norwitz6968b052007-02-27 19:02:19 +00001230 def test_extend(self):
1231 orig = b'hello'
Guido van Rossum254348e2007-11-21 19:29:53 +00001232 a = bytearray(orig)
Neal Norwitz6968b052007-02-27 19:02:19 +00001233 a.extend(a)
1234 self.assertEqual(a, orig + orig)
1235 self.assertEqual(a[5:], orig)
Alexandre Vassalotti09121e82007-12-04 05:51:13 +00001236 a = bytearray(b'')
1237 # Test iterators that don't have a __length_hint__
1238 a.extend(map(int, orig * 25))
1239 a.extend(int(x) for x in orig * 25)
1240 self.assertEqual(a, orig * 50)
1241 self.assertEqual(a[-5:], orig)
1242 a = bytearray(b'')
1243 a.extend(iter(map(int, orig * 50)))
1244 self.assertEqual(a, orig * 50)
1245 self.assertEqual(a[-5:], orig)
1246 a = bytearray(b'')
1247 a.extend(list(map(int, orig * 50)))
1248 self.assertEqual(a, orig * 50)
1249 self.assertEqual(a[-5:], orig)
1250 a = bytearray(b'')
1251 self.assertRaises(ValueError, a.extend, [0, 1, 2, 256])
1252 self.assertRaises(ValueError, a.extend, [0, 1, 2, -1])
1253 self.assertEqual(len(a), 0)
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001254 a = bytearray(b'')
1255 a.extend([Indexable(ord('a'))])
1256 self.assertEqual(a, b'a')
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001257
Neal Norwitz6968b052007-02-27 19:02:19 +00001258 def test_remove(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001259 b = bytearray(b'hello')
Neal Norwitz6968b052007-02-27 19:02:19 +00001260 b.remove(ord('l'))
1261 self.assertEqual(b, b'helo')
1262 b.remove(ord('l'))
1263 self.assertEqual(b, b'heo')
1264 self.assertRaises(ValueError, lambda: b.remove(ord('l')))
1265 self.assertRaises(ValueError, lambda: b.remove(400))
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001266 self.assertRaises(TypeError, lambda: b.remove('e'))
Neal Norwitz6968b052007-02-27 19:02:19 +00001267 # remove first and last
1268 b.remove(ord('o'))
1269 b.remove(ord('h'))
1270 self.assertEqual(b, b'e')
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001271 self.assertRaises(TypeError, lambda: b.remove(b'e'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001272 b.remove(Indexable(ord('e')))
1273 self.assertEqual(b, b'')
Neal Norwitz6968b052007-02-27 19:02:19 +00001274
1275 def test_pop(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001276 b = bytearray(b'world')
Neal Norwitz6968b052007-02-27 19:02:19 +00001277 self.assertEqual(b.pop(), ord('d'))
1278 self.assertEqual(b.pop(0), ord('w'))
1279 self.assertEqual(b.pop(-2), ord('r'))
1280 self.assertRaises(IndexError, lambda: b.pop(10))
Eli Bendersky1bc4f192011-03-04 04:55:25 +00001281 self.assertRaises(IndexError, lambda: bytearray().pop())
Mark Dickinson54a3db92009-09-06 10:19:23 +00001282 # test for issue #6846
1283 self.assertEqual(bytearray(b'\xff').pop(), 0xff)
Neal Norwitz6968b052007-02-27 19:02:19 +00001284
1285 def test_nosort(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001286 self.assertRaises(AttributeError, lambda: bytearray().sort())
Neal Norwitz6968b052007-02-27 19:02:19 +00001287
Neal Norwitz6968b052007-02-27 19:02:19 +00001288 def test_append(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001289 b = bytearray(b'hell')
Neal Norwitz6968b052007-02-27 19:02:19 +00001290 b.append(ord('o'))
1291 self.assertEqual(b, b'hello')
1292 self.assertEqual(b.append(100), None)
Guido van Rossum254348e2007-11-21 19:29:53 +00001293 b = bytearray()
Neal Norwitz6968b052007-02-27 19:02:19 +00001294 b.append(ord('A'))
1295 self.assertEqual(len(b), 1)
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001296 self.assertRaises(TypeError, lambda: b.append(b'o'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001297 b = bytearray()
1298 b.append(Indexable(ord('A')))
1299 self.assertEqual(b, b'A')
Neal Norwitz6968b052007-02-27 19:02:19 +00001300
1301 def test_insert(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001302 b = bytearray(b'msssspp')
Neal Norwitz6968b052007-02-27 19:02:19 +00001303 b.insert(1, ord('i'))
1304 b.insert(4, ord('i'))
1305 b.insert(-2, ord('i'))
1306 b.insert(1000, ord('i'))
1307 self.assertEqual(b, b'mississippi')
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001308 self.assertRaises(TypeError, lambda: b.insert(0, b'1'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001309 b = bytearray()
1310 b.insert(0, Indexable(ord('A')))
1311 self.assertEqual(b, b'A')
Neal Norwitz6968b052007-02-27 19:02:19 +00001312
Benjamin Peterson0f3641c2008-11-19 22:05:52 +00001313 def test_copied(self):
1314 # Issue 4348. Make sure that operations that don't mutate the array
1315 # copy the bytes.
1316 b = bytearray(b'abc')
Amaury Forgeot d'Arcb0c29162008-11-22 22:18:04 +00001317 self.assertFalse(b is b.replace(b'abc', b'cde', 0))
Benjamin Peterson0f3641c2008-11-19 22:05:52 +00001318
1319 t = bytearray([i for i in range(256)])
1320 x = bytearray(b'')
1321 self.assertFalse(x is x.translate(t))
1322
Guido van Rossum254348e2007-11-21 19:29:53 +00001323 def test_partition_bytearray_doesnt_share_nullstring(self):
1324 a, b, c = bytearray(b"x").partition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001325 self.assertEqual(b, b"")
1326 self.assertEqual(c, b"")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001327 self.assertTrue(b is not c)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001328 b += b"!"
1329 self.assertEqual(c, b"")
Guido van Rossum254348e2007-11-21 19:29:53 +00001330 a, b, c = bytearray(b"x").partition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001331 self.assertEqual(b, b"")
1332 self.assertEqual(c, b"")
1333 # Same for rpartition
Guido van Rossum254348e2007-11-21 19:29:53 +00001334 b, c, a = bytearray(b"x").rpartition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001335 self.assertEqual(b, b"")
1336 self.assertEqual(c, b"")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001337 self.assertTrue(b is not c)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001338 b += b"!"
1339 self.assertEqual(c, b"")
Guido van Rossum254348e2007-11-21 19:29:53 +00001340 c, b, a = bytearray(b"x").rpartition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001341 self.assertEqual(b, b"")
1342 self.assertEqual(c, b"")
1343
Antoine Pitrou5504e892008-12-06 21:27:53 +00001344 def test_resize_forbidden(self):
1345 # #4509: can't resize a bytearray when there are buffer exports, even
1346 # if it wouldn't reallocate the underlying buffer.
1347 # Furthermore, no destructive changes to the buffer may be applied
1348 # before raising the error.
1349 b = bytearray(range(10))
1350 v = memoryview(b)
1351 def resize(n):
1352 b[1:-1] = range(n + 1, 2*n - 1)
1353 resize(10)
1354 orig = b[:]
1355 self.assertRaises(BufferError, resize, 11)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001356 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001357 self.assertRaises(BufferError, resize, 9)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001358 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001359 self.assertRaises(BufferError, resize, 0)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001360 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001361 # Other operations implying resize
1362 self.assertRaises(BufferError, b.pop, 0)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001363 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001364 self.assertRaises(BufferError, b.remove, b[1])
Ezio Melottib3aedd42010-11-20 19:04:17 +00001365 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001366 def delitem():
1367 del b[1]
1368 self.assertRaises(BufferError, delitem)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001369 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001370 # deleting a non-contiguous slice
1371 def delslice():
1372 b[1:-1:2] = b""
1373 self.assertRaises(BufferError, delslice)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001374 self.assertEqual(b, orig)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001375
Stefan Krah650c1e82015-02-03 21:43:23 +01001376 @test.support.cpython_only
1377 def test_obsolete_write_lock(self):
1378 from _testcapi import getbuffer_with_null_view
1379 self.assertRaises(BufferError, getbuffer_with_null_view, bytearray())
Antoine Pitroufc8d6f42010-01-17 12:38:54 +00001380
Serhiy Storchakaaabafe72016-03-06 14:10:24 +02001381 def test_iterator_pickling2(self):
1382 orig = bytearray(b'abc')
1383 data = list(b'qwerty')
1384 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
1385 # initial iterator
1386 itorig = iter(orig)
1387 d = pickle.dumps((itorig, orig), proto)
1388 it, b = pickle.loads(d)
1389 b[:] = data
1390 self.assertEqual(type(it), type(itorig))
1391 self.assertEqual(list(it), data)
1392
1393 # running iterator
1394 next(itorig)
1395 d = pickle.dumps((itorig, orig), proto)
1396 it, b = pickle.loads(d)
1397 b[:] = data
1398 self.assertEqual(type(it), type(itorig))
1399 self.assertEqual(list(it), data[1:])
1400
1401 # empty iterator
1402 for i in range(1, len(orig)):
1403 next(itorig)
1404 d = pickle.dumps((itorig, orig), proto)
1405 it, b = pickle.loads(d)
1406 b[:] = data
1407 self.assertEqual(type(it), type(itorig))
1408 self.assertEqual(list(it), data[len(orig):])
1409
1410 # exhausted iterator
1411 self.assertRaises(StopIteration, next, itorig)
1412 d = pickle.dumps((itorig, orig), proto)
1413 it, b = pickle.loads(d)
1414 b[:] = data
1415 self.assertEqual(list(it), [])
1416
1417
Christian Heimes510711d2008-01-30 11:57:58 +00001418class AssortedBytesTest(unittest.TestCase):
1419 #
1420 # Test various combinations of bytes and bytearray
1421 #
1422
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001423 @check_bytes_warnings
Christian Heimes510711d2008-01-30 11:57:58 +00001424 def test_repr_str(self):
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001425 for f in str, repr:
1426 self.assertEqual(f(bytearray()), "bytearray(b'')")
1427 self.assertEqual(f(bytearray([0])), "bytearray(b'\\x00')")
1428 self.assertEqual(f(bytearray([0, 1, 254, 255])),
1429 "bytearray(b'\\x00\\x01\\xfe\\xff')")
1430 self.assertEqual(f(b"abc"), "b'abc'")
1431 self.assertEqual(f(b"'"), '''b"'"''') # '''
1432 self.assertEqual(f(b"'\""), r"""b'\'"'""") # '
Christian Heimes510711d2008-01-30 11:57:58 +00001433
1434 def test_compare_bytes_to_bytearray(self):
1435 self.assertEqual(b"abc" == bytes(b"abc"), True)
1436 self.assertEqual(b"ab" != bytes(b"abc"), True)
1437 self.assertEqual(b"ab" <= bytes(b"abc"), True)
1438 self.assertEqual(b"ab" < bytes(b"abc"), True)
1439 self.assertEqual(b"abc" >= bytes(b"ab"), True)
1440 self.assertEqual(b"abc" > bytes(b"ab"), True)
1441
1442 self.assertEqual(b"abc" != bytes(b"abc"), False)
1443 self.assertEqual(b"ab" == bytes(b"abc"), False)
1444 self.assertEqual(b"ab" > bytes(b"abc"), False)
1445 self.assertEqual(b"ab" >= bytes(b"abc"), False)
1446 self.assertEqual(b"abc" < bytes(b"ab"), False)
1447 self.assertEqual(b"abc" <= bytes(b"ab"), False)
1448
1449 self.assertEqual(bytes(b"abc") == b"abc", True)
1450 self.assertEqual(bytes(b"ab") != b"abc", True)
1451 self.assertEqual(bytes(b"ab") <= b"abc", True)
1452 self.assertEqual(bytes(b"ab") < b"abc", True)
1453 self.assertEqual(bytes(b"abc") >= b"ab", True)
1454 self.assertEqual(bytes(b"abc") > b"ab", True)
1455
1456 self.assertEqual(bytes(b"abc") != b"abc", False)
1457 self.assertEqual(bytes(b"ab") == b"abc", False)
1458 self.assertEqual(bytes(b"ab") > b"abc", False)
1459 self.assertEqual(bytes(b"ab") >= b"abc", False)
1460 self.assertEqual(bytes(b"abc") < b"ab", False)
1461 self.assertEqual(bytes(b"abc") <= b"ab", False)
1462
Stefan Krah6e572b82013-01-26 13:06:36 +01001463 @test.support.requires_docstrings
Christian Heimes510711d2008-01-30 11:57:58 +00001464 def test_doc(self):
Florent Xicluna9b86b9a2010-03-19 19:00:44 +00001465 self.assertIsNotNone(bytearray.__doc__)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001466 self.assertTrue(bytearray.__doc__.startswith("bytearray("), bytearray.__doc__)
Florent Xicluna9b86b9a2010-03-19 19:00:44 +00001467 self.assertIsNotNone(bytes.__doc__)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001468 self.assertTrue(bytes.__doc__.startswith("bytes("), bytes.__doc__)
Christian Heimes510711d2008-01-30 11:57:58 +00001469
1470 def test_from_bytearray(self):
1471 sample = bytes(b"Hello world\n\x80\x81\xfe\xff")
1472 buf = memoryview(sample)
1473 b = bytearray(buf)
1474 self.assertEqual(b, bytearray(sample))
1475
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001476 @check_bytes_warnings
Christian Heimes510711d2008-01-30 11:57:58 +00001477 def test_to_str(self):
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001478 self.assertEqual(str(b''), "b''")
1479 self.assertEqual(str(b'x'), "b'x'")
1480 self.assertEqual(str(b'\x80'), "b'\\x80'")
1481 self.assertEqual(str(bytearray(b'')), "bytearray(b'')")
1482 self.assertEqual(str(bytearray(b'x')), "bytearray(b'x')")
1483 self.assertEqual(str(bytearray(b'\x80')), "bytearray(b'\\x80')")
Christian Heimes510711d2008-01-30 11:57:58 +00001484
1485 def test_literal(self):
1486 tests = [
1487 (b"Wonderful spam", "Wonderful spam"),
1488 (br"Wonderful spam too", "Wonderful spam too"),
1489 (b"\xaa\x00\000\200", "\xaa\x00\000\200"),
1490 (br"\xaa\x00\000\200", r"\xaa\x00\000\200"),
1491 ]
1492 for b, s in tests:
1493 self.assertEqual(b, bytearray(s, 'latin-1'))
1494 for c in range(128, 256):
1495 self.assertRaises(SyntaxError, eval,
1496 'b"%s"' % chr(c))
1497
1498 def test_translate(self):
1499 b = b'hello'
Georg Brandlccc47b62008-12-28 11:44:14 +00001500 ba = bytearray(b)
Christian Heimes510711d2008-01-30 11:57:58 +00001501 rosetta = bytearray(range(0, 256))
1502 rosetta[ord('o')] = ord('e')
1503 c = b.translate(rosetta, b'l')
1504 self.assertEqual(b, b'hello')
1505 self.assertEqual(c, b'hee')
Georg Brandlccc47b62008-12-28 11:44:14 +00001506 c = ba.translate(rosetta, b'l')
1507 self.assertEqual(ba, b'hello')
1508 self.assertEqual(c, b'hee')
1509 c = b.translate(None, b'e')
1510 self.assertEqual(c, b'hllo')
1511 c = ba.translate(None, b'e')
1512 self.assertEqual(c, b'hllo')
1513 self.assertRaises(TypeError, b.translate, None, None)
1514 self.assertRaises(TypeError, ba.translate, None, None)
Christian Heimes510711d2008-01-30 11:57:58 +00001515
1516 def test_split_bytearray(self):
1517 self.assertEqual(b'a b'.split(memoryview(b' ')), [b'a', b'b'])
1518
1519 def test_rsplit_bytearray(self):
1520 self.assertEqual(b'a b'.rsplit(memoryview(b' ')), [b'a', b'b'])
1521
Georg Brandleb2c9642008-05-30 12:05:02 +00001522 def test_return_self(self):
1523 # bytearray.replace must always return a new bytearray
1524 b = bytearray()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001525 self.assertFalse(b.replace(b'', b'') is b)
Georg Brandleb2c9642008-05-30 12:05:02 +00001526
Serhiy Storchaka1dd49822015-03-20 16:54:57 +02001527 @unittest.skipUnless(sys.flags.bytes_warning,
1528 "BytesWarning is needed for this test: use -bb option")
Barry Warsaw9e9dcd62008-10-17 01:50:37 +00001529 def test_compare(self):
Serhiy Storchaka1dd49822015-03-20 16:54:57 +02001530 def bytes_warning():
1531 return test.support.check_warnings(('', BytesWarning))
1532 with bytes_warning():
1533 b'' == ''
1534 with bytes_warning():
1535 '' == b''
1536 with bytes_warning():
1537 b'' != ''
1538 with bytes_warning():
1539 '' != b''
1540 with bytes_warning():
1541 bytearray(b'') == ''
1542 with bytes_warning():
1543 '' == bytearray(b'')
1544 with bytes_warning():
1545 bytearray(b'') != ''
1546 with bytes_warning():
1547 '' != bytearray(b'')
1548 with bytes_warning():
1549 b'\0' == 0
1550 with bytes_warning():
1551 0 == b'\0'
1552 with bytes_warning():
1553 b'\0' != 0
1554 with bytes_warning():
1555 0 != b'\0'
Barry Warsaw9e9dcd62008-10-17 01:50:37 +00001556
Guido van Rossumd624f182006-04-24 13:47:05 +00001557 # Optimizations:
Guido van Rossume06b6b82006-04-23 07:43:54 +00001558 # __iter__? (optimization)
Guido van Rossumd624f182006-04-24 13:47:05 +00001559 # __reversed__? (optimization)
1560
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001561 # XXX More string methods? (Those that don't use character properties)
1562
Neal Norwitz6968b052007-02-27 19:02:19 +00001563 # There are tests in string_tests.py that are more
1564 # comprehensive for things like split, partition, etc.
1565 # Unfortunately they are all bundled with tests that
1566 # are not appropriate for bytes
Guido van Rossume06b6b82006-04-23 07:43:54 +00001567
Guido van Rossum254348e2007-11-21 19:29:53 +00001568 # I've started porting some of those into bytearray_tests.py, we should port
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001569 # the rest that make sense (the code can be cleaned up to use modern
1570 # unittest methods at the same time).
1571
Guido van Rossum254348e2007-11-21 19:29:53 +00001572class BytearrayPEP3137Test(unittest.TestCase,
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001573 test.buffer_tests.MixinBytesBufferCommonTests):
1574 def marshal(self, x):
Guido van Rossum254348e2007-11-21 19:29:53 +00001575 return bytearray(x)
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001576
1577 def test_returns_new_copy(self):
1578 val = self.marshal(b'1234')
1579 # On immutable types these MAY return a reference to themselves
Guido van Rossum254348e2007-11-21 19:29:53 +00001580 # but on mutable types like bytearray they MUST return a new copy.
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001581 for methname in ('zfill', 'rjust', 'ljust', 'center'):
1582 method = getattr(val, methname)
1583 newval = method(3)
1584 self.assertEqual(val, newval)
1585 self.assertTrue(val is not newval,
1586 methname+' returned self on a mutable object')
Antoine Pitroucbaa62502010-01-13 15:03:39 +00001587 for expr in ('val.split()[0]', 'val.rsplit()[0]',
1588 'val.partition(b".")[0]', 'val.rpartition(b".")[2]',
1589 'val.splitlines()[0]', 'val.replace(b"", b"")'):
1590 newval = eval(expr)
1591 self.assertEqual(val, newval)
1592 self.assertTrue(val is not newval,
1593 expr+' returned val on a mutable object')
Antoine Pitroucfc22b42012-10-16 21:07:23 +02001594 sep = self.marshal(b'')
1595 newval = sep.join([val])
1596 self.assertEqual(val, newval)
1597 self.assertIsNot(val, newval)
1598
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001599
Christian Heimes510711d2008-01-30 11:57:58 +00001600class FixedStringTest(test.string_tests.BaseTest):
Guido van Rossum9c627722007-08-27 18:31:48 +00001601 def fixtype(self, obj):
1602 if isinstance(obj, str):
1603 return obj.encode("utf-8")
1604 return super().fixtype(obj)
1605
Ezio Melotti0dceb562013-01-10 07:43:26 +02001606class ByteArrayAsStringTest(FixedStringTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +00001607 type2test = bytearray
Antoine Pitrouac65d962011-10-20 23:54:17 +02001608 contains_bytes = True
Christian Heimes510711d2008-01-30 11:57:58 +00001609
Ezio Melotti0dceb562013-01-10 07:43:26 +02001610class BytesAsStringTest(FixedStringTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +00001611 type2test = bytes
Antoine Pitrouac65d962011-10-20 23:54:17 +02001612 contains_bytes = True
Christian Heimes510711d2008-01-30 11:57:58 +00001613
Georg Brandlc7885542007-03-06 19:16:20 +00001614
Ezio Melotti0dceb562013-01-10 07:43:26 +02001615class SubclassTest:
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001616
1617 def test_basic(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001618 self.assertTrue(issubclass(self.subclass2test, self.type2test))
Ezio Melottie9615932010-01-24 19:26:24 +00001619 self.assertIsInstance(self.subclass2test(), self.type2test)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001620
1621 a, b = b"abcd", b"efgh"
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001622 _a, _b = self.subclass2test(a), self.subclass2test(b)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001623
1624 # test comparison operators with subclass instances
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001625 self.assertTrue(_a == _a)
1626 self.assertTrue(_a != _b)
1627 self.assertTrue(_a < _b)
1628 self.assertTrue(_a <= _b)
1629 self.assertTrue(_b >= _a)
1630 self.assertTrue(_b > _a)
1631 self.assertTrue(_a is not a)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001632
1633 # test concat of subclass instances
1634 self.assertEqual(a + b, _a + _b)
1635 self.assertEqual(a + b, a + _b)
1636 self.assertEqual(a + b, _a + b)
1637
1638 # test repeat
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001639 self.assertTrue(a*5 == _a*5)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001640
1641 def test_join(self):
1642 # Make sure join returns a NEW object for single item sequences
1643 # involving a subclass.
1644 # Make sure that it is of the appropriate type.
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001645 s1 = self.subclass2test(b"abcd")
1646 s2 = self.type2test().join([s1])
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001647 self.assertTrue(s1 is not s2)
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001648 self.assertTrue(type(s2) is self.type2test, type(s2))
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001649
1650 # Test reverse, calling join on subclass
1651 s3 = s1.join([b"abcd"])
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001652 self.assertTrue(type(s3) is self.type2test)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001653
1654 def test_pickle(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001655 a = self.subclass2test(b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001656 a.x = 10
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001657 a.y = self.subclass2test(b"efgh")
Hirokazu Yamamotod0d0b652008-10-23 00:38:15 +00001658 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001659 b = pickle.loads(pickle.dumps(a, proto))
1660 self.assertNotEqual(id(a), id(b))
1661 self.assertEqual(a, b)
1662 self.assertEqual(a.x, b.x)
1663 self.assertEqual(a.y, b.y)
1664 self.assertEqual(type(a), type(b))
1665 self.assertEqual(type(a.y), type(b.y))
1666
1667 def test_copy(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001668 a = self.subclass2test(b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001669 a.x = 10
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001670 a.y = self.subclass2test(b"efgh")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001671 for copy_method in (copy.copy, copy.deepcopy):
1672 b = copy_method(a)
1673 self.assertNotEqual(id(a), id(b))
1674 self.assertEqual(a, b)
1675 self.assertEqual(a.x, b.x)
1676 self.assertEqual(a.y, b.y)
1677 self.assertEqual(type(a), type(b))
1678 self.assertEqual(type(a.y), type(b.y))
1679
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001680
1681class ByteArraySubclass(bytearray):
1682 pass
1683
1684class BytesSubclass(bytes):
1685 pass
1686
Serhiy Storchaka15095802015-11-25 15:47:01 +02001687class OtherBytesSubclass(bytes):
1688 pass
1689
Ezio Melotti0dceb562013-01-10 07:43:26 +02001690class ByteArraySubclassTest(SubclassTest, unittest.TestCase):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001691 type2test = bytearray
1692 subclass2test = ByteArraySubclass
1693
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001694 def test_init_override(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001695 class subclass(bytearray):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001696 def __init__(me, newarg=1, *args, **kwargs):
1697 bytearray.__init__(me, *args, **kwargs)
1698 x = subclass(4, b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001699 x = subclass(4, source=b"abcd")
1700 self.assertEqual(x, b"abcd")
1701 x = subclass(newarg=4, source=b"abcd")
1702 self.assertEqual(x, b"abcd")
1703
1704
Ezio Melotti0dceb562013-01-10 07:43:26 +02001705class BytesSubclassTest(SubclassTest, unittest.TestCase):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001706 type2test = bytes
1707 subclass2test = BytesSubclass
1708
1709
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001710if __name__ == "__main__":
Ezio Melotti0dceb562013-01-10 07:43:26 +02001711 unittest.main()