blob: 0a73fcbb910a56e00e424ee5171984dc54027c49 [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
304 def test_join(self):
305 self.assertEqual(self.type2test(b"").join([]), b"")
306 self.assertEqual(self.type2test(b"").join([b""]), b"")
307 for lst in [[b"abc"], [b"a", b"bc"], [b"ab", b"c"], [b"a", b"b", b"c"]]:
308 lst = list(map(self.type2test, lst))
309 self.assertEqual(self.type2test(b"").join(lst), b"abc")
310 self.assertEqual(self.type2test(b"").join(tuple(lst)), b"abc")
311 self.assertEqual(self.type2test(b"").join(iter(lst)), b"abc")
Antoine Pitroucfc22b42012-10-16 21:07:23 +0200312 dot_join = self.type2test(b".:").join
313 self.assertEqual(dot_join([b"ab", b"cd"]), b"ab.:cd")
314 self.assertEqual(dot_join([memoryview(b"ab"), b"cd"]), b"ab.:cd")
315 self.assertEqual(dot_join([b"ab", memoryview(b"cd")]), b"ab.:cd")
316 self.assertEqual(dot_join([bytearray(b"ab"), b"cd"]), b"ab.:cd")
317 self.assertEqual(dot_join([b"ab", bytearray(b"cd")]), b"ab.:cd")
318 # Stress it with many items
319 seq = [b"abc"] * 1000
320 expected = b"abc" + b".:abc" * 999
321 self.assertEqual(dot_join(seq), expected)
Benjamin Petersonc31f12d2014-09-28 12:56:42 -0400322 self.assertRaises(TypeError, self.type2test(b" ").join, None)
Antoine Pitroucfc22b42012-10-16 21:07:23 +0200323 # Error handling and cleanup when some item in the middle of the
324 # sequence has the wrong type.
325 with self.assertRaises(TypeError):
326 dot_join([bytearray(b"ab"), "cd", b"ef"])
327 with self.assertRaises(TypeError):
328 dot_join([memoryview(b"ab"), "cd", b"ef"])
Christian Heimes510711d2008-01-30 11:57:58 +0000329
Christian Heimes510711d2008-01-30 11:57:58 +0000330 def test_count(self):
331 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200332 i = 105
333 p = 112
334 w = 119
335
Christian Heimes510711d2008-01-30 11:57:58 +0000336 self.assertEqual(b.count(b'i'), 4)
337 self.assertEqual(b.count(b'ss'), 2)
338 self.assertEqual(b.count(b'w'), 0)
339
Antoine Pitrouac65d962011-10-20 23:54:17 +0200340 self.assertEqual(b.count(i), 4)
341 self.assertEqual(b.count(w), 0)
342
343 self.assertEqual(b.count(b'i', 6), 2)
344 self.assertEqual(b.count(b'p', 6), 2)
345 self.assertEqual(b.count(b'i', 1, 3), 1)
346 self.assertEqual(b.count(b'p', 7, 9), 1)
347
348 self.assertEqual(b.count(i, 6), 2)
349 self.assertEqual(b.count(p, 6), 2)
350 self.assertEqual(b.count(i, 1, 3), 1)
351 self.assertEqual(b.count(p, 7, 9), 1)
352
Christian Heimes510711d2008-01-30 11:57:58 +0000353 def test_startswith(self):
354 b = self.type2test(b'hello')
355 self.assertFalse(self.type2test().startswith(b"anything"))
356 self.assertTrue(b.startswith(b"hello"))
357 self.assertTrue(b.startswith(b"hel"))
358 self.assertTrue(b.startswith(b"h"))
359 self.assertFalse(b.startswith(b"hellow"))
360 self.assertFalse(b.startswith(b"ha"))
Ezio Melottif2b3f782011-04-26 06:40:59 +0300361 with self.assertRaises(TypeError) as cm:
Ezio Melottiba42fd52011-04-26 06:09:45 +0300362 b.startswith([b'h'])
Ezio Melottif2b3f782011-04-26 06:40:59 +0300363 exc = str(cm.exception)
Ezio Melottiba42fd52011-04-26 06:09:45 +0300364 self.assertIn('bytes', exc)
365 self.assertIn('tuple', exc)
Christian Heimes510711d2008-01-30 11:57:58 +0000366
367 def test_endswith(self):
368 b = self.type2test(b'hello')
369 self.assertFalse(bytearray().endswith(b"anything"))
370 self.assertTrue(b.endswith(b"hello"))
371 self.assertTrue(b.endswith(b"llo"))
372 self.assertTrue(b.endswith(b"o"))
373 self.assertFalse(b.endswith(b"whello"))
374 self.assertFalse(b.endswith(b"no"))
Ezio Melottif2b3f782011-04-26 06:40:59 +0300375 with self.assertRaises(TypeError) as cm:
Ezio Melottiba42fd52011-04-26 06:09:45 +0300376 b.endswith([b'o'])
Ezio Melottif2b3f782011-04-26 06:40:59 +0300377 exc = str(cm.exception)
Ezio Melottiba42fd52011-04-26 06:09:45 +0300378 self.assertIn('bytes', exc)
379 self.assertIn('tuple', exc)
Christian Heimes510711d2008-01-30 11:57:58 +0000380
381 def test_find(self):
382 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200383 i = 105
384 w = 119
385
Christian Heimes510711d2008-01-30 11:57:58 +0000386 self.assertEqual(b.find(b'ss'), 2)
Christian Heimes510711d2008-01-30 11:57:58 +0000387 self.assertEqual(b.find(b'w'), -1)
388 self.assertEqual(b.find(b'mississippian'), -1)
389
Antoine Pitrouac65d962011-10-20 23:54:17 +0200390 self.assertEqual(b.find(i), 1)
391 self.assertEqual(b.find(w), -1)
392
393 self.assertEqual(b.find(b'ss', 3), 5)
394 self.assertEqual(b.find(b'ss', 1, 7), 2)
395 self.assertEqual(b.find(b'ss', 1, 3), -1)
396
397 self.assertEqual(b.find(i, 6), 7)
398 self.assertEqual(b.find(i, 1, 3), 1)
399 self.assertEqual(b.find(w, 1, 3), -1)
400
Victor Stinnerf8eac002011-12-18 01:17:41 +0100401 for index in (-1, 256, sys.maxsize + 1):
402 self.assertRaisesRegex(
403 ValueError, r'byte must be in range\(0, 256\)',
404 b.find, index)
405
Christian Heimes510711d2008-01-30 11:57:58 +0000406 def test_rfind(self):
407 b = self.type2test(b'mississippi')
Antoine Pitrouac65d962011-10-20 23:54:17 +0200408 i = 105
409 w = 119
410
Christian Heimes510711d2008-01-30 11:57:58 +0000411 self.assertEqual(b.rfind(b'ss'), 5)
Christian Heimes510711d2008-01-30 11:57:58 +0000412 self.assertEqual(b.rfind(b'w'), -1)
413 self.assertEqual(b.rfind(b'mississippian'), -1)
414
Antoine Pitrouac65d962011-10-20 23:54:17 +0200415 self.assertEqual(b.rfind(i), 10)
416 self.assertEqual(b.rfind(w), -1)
417
418 self.assertEqual(b.rfind(b'ss', 3), 5)
419 self.assertEqual(b.rfind(b'ss', 0, 6), 2)
420
421 self.assertEqual(b.rfind(i, 1, 3), 1)
422 self.assertEqual(b.rfind(i, 3, 9), 7)
423 self.assertEqual(b.rfind(w, 1, 3), -1)
424
Christian Heimes510711d2008-01-30 11:57:58 +0000425 def test_index(self):
Antoine Pitrouac65d962011-10-20 23:54:17 +0200426 b = self.type2test(b'mississippi')
427 i = 105
428 w = 119
429
430 self.assertEqual(b.index(b'ss'), 2)
431 self.assertRaises(ValueError, b.index, b'w')
432 self.assertRaises(ValueError, b.index, b'mississippian')
433
434 self.assertEqual(b.index(i), 1)
435 self.assertRaises(ValueError, b.index, w)
436
437 self.assertEqual(b.index(b'ss', 3), 5)
438 self.assertEqual(b.index(b'ss', 1, 7), 2)
439 self.assertRaises(ValueError, b.index, b'ss', 1, 3)
440
441 self.assertEqual(b.index(i, 6), 7)
442 self.assertEqual(b.index(i, 1, 3), 1)
443 self.assertRaises(ValueError, b.index, w, 1, 3)
Christian Heimes510711d2008-01-30 11:57:58 +0000444
445 def test_rindex(self):
Antoine Pitrouac65d962011-10-20 23:54:17 +0200446 b = self.type2test(b'mississippi')
447 i = 105
448 w = 119
449
450 self.assertEqual(b.rindex(b'ss'), 5)
451 self.assertRaises(ValueError, b.rindex, b'w')
452 self.assertRaises(ValueError, b.rindex, b'mississippian')
453
454 self.assertEqual(b.rindex(i), 10)
455 self.assertRaises(ValueError, b.rindex, w)
456
457 self.assertEqual(b.rindex(b'ss', 3), 5)
458 self.assertEqual(b.rindex(b'ss', 0, 6), 2)
459
460 self.assertEqual(b.rindex(i, 1, 3), 1)
461 self.assertEqual(b.rindex(i, 3, 9), 7)
462 self.assertRaises(ValueError, b.rindex, w, 1, 3)
Christian Heimes510711d2008-01-30 11:57:58 +0000463
464 def test_replace(self):
465 b = self.type2test(b'mississippi')
466 self.assertEqual(b.replace(b'i', b'a'), b'massassappa')
467 self.assertEqual(b.replace(b'ss', b'x'), b'mixixippi')
468
469 def test_split(self):
470 b = self.type2test(b'mississippi')
471 self.assertEqual(b.split(b'i'), [b'm', b'ss', b'ss', b'pp', b''])
472 self.assertEqual(b.split(b'ss'), [b'mi', b'i', b'ippi'])
473 self.assertEqual(b.split(b'w'), [b])
Ezio Melotticda6b6d2012-02-26 09:39:55 +0200474 # with keyword args
475 b = self.type2test(b'a|b|c|d')
476 self.assertEqual(b.split(sep=b'|'), [b'a', b'b', b'c', b'd'])
477 self.assertEqual(b.split(b'|', maxsplit=1), [b'a', b'b|c|d'])
478 self.assertEqual(b.split(sep=b'|', maxsplit=1), [b'a', b'b|c|d'])
479 self.assertEqual(b.split(maxsplit=1, sep=b'|'), [b'a', b'b|c|d'])
480 b = self.type2test(b'a b c d')
481 self.assertEqual(b.split(maxsplit=1), [b'a', b'b c d'])
Christian Heimes510711d2008-01-30 11:57:58 +0000482
483 def test_split_whitespace(self):
484 for b in (b' arf barf ', b'arf\tbarf', b'arf\nbarf', b'arf\rbarf',
485 b'arf\fbarf', b'arf\vbarf'):
486 b = self.type2test(b)
487 self.assertEqual(b.split(), [b'arf', b'barf'])
488 self.assertEqual(b.split(None), [b'arf', b'barf'])
489 self.assertEqual(b.split(None, 2), [b'arf', b'barf'])
490 for b in (b'a\x1Cb', b'a\x1Db', b'a\x1Eb', b'a\x1Fb'):
491 b = self.type2test(b)
492 self.assertEqual(b.split(), [b])
493 self.assertEqual(self.type2test(b' a bb c ').split(None, 0), [b'a bb c '])
494 self.assertEqual(self.type2test(b' a bb c ').split(None, 1), [b'a', b'bb c '])
495 self.assertEqual(self.type2test(b' a bb c ').split(None, 2), [b'a', b'bb', b'c '])
496 self.assertEqual(self.type2test(b' a bb c ').split(None, 3), [b'a', b'bb', b'c'])
497
498 def test_split_string_error(self):
499 self.assertRaises(TypeError, self.type2test(b'a b').split, ' ')
500
Antoine Pitrouf8453022010-01-12 22:05:42 +0000501 def test_split_unicodewhitespace(self):
502 b = self.type2test(b"\x09\x0A\x0B\x0C\x0D\x1C\x1D\x1E\x1F")
503 self.assertEqual(b.split(), [b'\x1c\x1d\x1e\x1f'])
504
Christian Heimes510711d2008-01-30 11:57:58 +0000505 def test_rsplit(self):
506 b = self.type2test(b'mississippi')
507 self.assertEqual(b.rsplit(b'i'), [b'm', b'ss', b'ss', b'pp', b''])
508 self.assertEqual(b.rsplit(b'ss'), [b'mi', b'i', b'ippi'])
509 self.assertEqual(b.rsplit(b'w'), [b])
Ezio Melotticda6b6d2012-02-26 09:39:55 +0200510 # with keyword args
511 b = self.type2test(b'a|b|c|d')
512 self.assertEqual(b.rsplit(sep=b'|'), [b'a', b'b', b'c', b'd'])
513 self.assertEqual(b.rsplit(b'|', maxsplit=1), [b'a|b|c', b'd'])
514 self.assertEqual(b.rsplit(sep=b'|', maxsplit=1), [b'a|b|c', b'd'])
515 self.assertEqual(b.rsplit(maxsplit=1, sep=b'|'), [b'a|b|c', b'd'])
516 b = self.type2test(b'a b c d')
517 self.assertEqual(b.rsplit(maxsplit=1), [b'a b c', b'd'])
Christian Heimes510711d2008-01-30 11:57:58 +0000518
519 def test_rsplit_whitespace(self):
520 for b in (b' arf barf ', b'arf\tbarf', b'arf\nbarf', b'arf\rbarf',
521 b'arf\fbarf', b'arf\vbarf'):
522 b = self.type2test(b)
523 self.assertEqual(b.rsplit(), [b'arf', b'barf'])
524 self.assertEqual(b.rsplit(None), [b'arf', b'barf'])
525 self.assertEqual(b.rsplit(None, 2), [b'arf', b'barf'])
526 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 0), [b' a bb c'])
527 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 1), [b' a bb', b'c'])
528 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 2), [b' a', b'bb', b'c'])
529 self.assertEqual(self.type2test(b' a bb c ').rsplit(None, 3), [b'a', b'bb', b'c'])
530
531 def test_rsplit_string_error(self):
532 self.assertRaises(TypeError, self.type2test(b'a b').rsplit, ' ')
533
534 def test_rsplit_unicodewhitespace(self):
535 b = self.type2test(b"\x09\x0A\x0B\x0C\x0D\x1C\x1D\x1E\x1F")
Christian Heimes510711d2008-01-30 11:57:58 +0000536 self.assertEqual(b.rsplit(), [b'\x1c\x1d\x1e\x1f'])
537
538 def test_partition(self):
539 b = self.type2test(b'mississippi')
540 self.assertEqual(b.partition(b'ss'), (b'mi', b'ss', b'issippi'))
Antoine Pitrouf8453022010-01-12 22:05:42 +0000541 self.assertEqual(b.partition(b'w'), (b'mississippi', b'', b''))
Christian Heimes510711d2008-01-30 11:57:58 +0000542
543 def test_rpartition(self):
544 b = self.type2test(b'mississippi')
545 self.assertEqual(b.rpartition(b'ss'), (b'missi', b'ss', b'ippi'))
546 self.assertEqual(b.rpartition(b'i'), (b'mississipp', b'i', b''))
Antoine Pitrouf8453022010-01-12 22:05:42 +0000547 self.assertEqual(b.rpartition(b'w'), (b'', b'', b'mississippi'))
Christian Heimes510711d2008-01-30 11:57:58 +0000548
549 def test_pickling(self):
Hirokazu Yamamotod0d0b652008-10-23 00:38:15 +0000550 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
Christian Heimes510711d2008-01-30 11:57:58 +0000551 for b in b"", b"a", b"abc", b"\xffab\x80", b"\0\0\377\0\0":
552 b = self.type2test(b)
553 ps = pickle.dumps(b, proto)
554 q = pickle.loads(ps)
555 self.assertEqual(b, q)
556
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000557 def test_iterator_pickling(self):
Serhiy Storchakabad12572014-12-15 14:03:42 +0200558 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
559 for b in b"", b"a", b"abc", b"\xffab\x80", b"\0\0\377\0\0":
560 it = itorg = iter(self.type2test(b))
561 data = list(self.type2test(b))
562 d = pickle.dumps(it, proto)
563 it = pickle.loads(d)
564 self.assertEqual(type(itorg), type(it))
565 self.assertEqual(list(it), data)
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000566
Serhiy Storchakabad12572014-12-15 14:03:42 +0200567 it = pickle.loads(d)
568 try:
569 next(it)
570 except StopIteration:
571 continue
572 d = pickle.dumps(it, proto)
573 it = pickle.loads(d)
574 self.assertEqual(list(it), data[1:])
Kristján Valur Jónsson31668b82012-04-03 10:49:41 +0000575
Christian Heimes510711d2008-01-30 11:57:58 +0000576 def test_strip(self):
577 b = self.type2test(b'mississippi')
578 self.assertEqual(b.strip(b'i'), b'mississipp')
579 self.assertEqual(b.strip(b'm'), b'ississippi')
580 self.assertEqual(b.strip(b'pi'), b'mississ')
581 self.assertEqual(b.strip(b'im'), b'ssissipp')
582 self.assertEqual(b.strip(b'pim'), b'ssiss')
583 self.assertEqual(b.strip(b), b'')
584
585 def test_lstrip(self):
586 b = self.type2test(b'mississippi')
587 self.assertEqual(b.lstrip(b'i'), b'mississippi')
588 self.assertEqual(b.lstrip(b'm'), b'ississippi')
589 self.assertEqual(b.lstrip(b'pi'), b'mississippi')
590 self.assertEqual(b.lstrip(b'im'), b'ssissippi')
591 self.assertEqual(b.lstrip(b'pim'), b'ssissippi')
592
593 def test_rstrip(self):
594 b = self.type2test(b'mississippi')
595 self.assertEqual(b.rstrip(b'i'), b'mississipp')
596 self.assertEqual(b.rstrip(b'm'), b'mississippi')
597 self.assertEqual(b.rstrip(b'pi'), b'mississ')
598 self.assertEqual(b.rstrip(b'im'), b'mississipp')
599 self.assertEqual(b.rstrip(b'pim'), b'mississ')
600
601 def test_strip_whitespace(self):
602 b = self.type2test(b' \t\n\r\f\vabc \t\n\r\f\v')
603 self.assertEqual(b.strip(), b'abc')
604 self.assertEqual(b.lstrip(), b'abc \t\n\r\f\v')
605 self.assertEqual(b.rstrip(), b' \t\n\r\f\vabc')
606
607 def test_strip_bytearray(self):
608 self.assertEqual(self.type2test(b'abc').strip(memoryview(b'ac')), b'b')
609 self.assertEqual(self.type2test(b'abc').lstrip(memoryview(b'ac')), b'bc')
610 self.assertEqual(self.type2test(b'abc').rstrip(memoryview(b'ac')), b'ab')
611
612 def test_strip_string_error(self):
613 self.assertRaises(TypeError, self.type2test(b'abc').strip, 'b')
614 self.assertRaises(TypeError, self.type2test(b'abc').lstrip, 'b')
615 self.assertRaises(TypeError, self.type2test(b'abc').rstrip, 'b')
616
Eli Bendersky906b88f2011-07-29 07:05:08 +0300617 def test_center(self):
618 # Fill character can be either bytes or bytearray (issue 12380)
619 b = self.type2test(b'abc')
620 for fill_type in (bytes, bytearray):
621 self.assertEqual(b.center(7, fill_type(b'-')),
622 self.type2test(b'--abc--'))
623
624 def test_ljust(self):
625 # Fill character can be either bytes or bytearray (issue 12380)
626 b = self.type2test(b'abc')
627 for fill_type in (bytes, bytearray):
628 self.assertEqual(b.ljust(7, fill_type(b'-')),
629 self.type2test(b'abc----'))
630
631 def test_rjust(self):
632 # Fill character can be either bytes or bytearray (issue 12380)
633 b = self.type2test(b'abc')
634 for fill_type in (bytes, bytearray):
635 self.assertEqual(b.rjust(7, fill_type(b'-')),
636 self.type2test(b'----abc'))
637
Christian Heimes510711d2008-01-30 11:57:58 +0000638 def test_ord(self):
639 b = self.type2test(b'\0A\x7f\x80\xff')
640 self.assertEqual([ord(b[i:i+1]) for i in range(len(b))],
641 [0, 65, 127, 128, 255])
642
Georg Brandlabc38772009-04-12 15:51:51 +0000643 def test_maketrans(self):
644 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 +0000645 self.assertEqual(self.type2test.maketrans(b'abc', b'xyz'), transtable)
Antoine Pitrou403ce782009-10-14 17:14:16 +0000646 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'
647 self.assertEqual(self.type2test.maketrans(b'\375\376\377', b'xyz'), transtable)
Georg Brandlabc38772009-04-12 15:51:51 +0000648 self.assertRaises(ValueError, self.type2test.maketrans, b'abc', b'xyzq')
649 self.assertRaises(TypeError, self.type2test.maketrans, 'abc', 'def')
650
Jesus Ceaac451502011-04-20 17:09:23 +0200651 def test_none_arguments(self):
652 # issue 11828
653 b = self.type2test(b'hello')
654 l = self.type2test(b'l')
655 h = self.type2test(b'h')
656 x = self.type2test(b'x')
657 o = self.type2test(b'o')
658
659 self.assertEqual(2, b.find(l, None))
660 self.assertEqual(3, b.find(l, -2, None))
661 self.assertEqual(2, b.find(l, None, -2))
662 self.assertEqual(0, b.find(h, None, None))
663
664 self.assertEqual(3, b.rfind(l, None))
665 self.assertEqual(3, b.rfind(l, -2, None))
666 self.assertEqual(2, b.rfind(l, None, -2))
667 self.assertEqual(0, b.rfind(h, None, None))
668
669 self.assertEqual(2, b.index(l, None))
670 self.assertEqual(3, b.index(l, -2, None))
671 self.assertEqual(2, b.index(l, None, -2))
672 self.assertEqual(0, b.index(h, None, None))
673
674 self.assertEqual(3, b.rindex(l, None))
675 self.assertEqual(3, b.rindex(l, -2, None))
676 self.assertEqual(2, b.rindex(l, None, -2))
677 self.assertEqual(0, b.rindex(h, None, None))
678
679 self.assertEqual(2, b.count(l, None))
680 self.assertEqual(1, b.count(l, -2, None))
681 self.assertEqual(1, b.count(l, None, -2))
682 self.assertEqual(0, b.count(x, None, None))
683
684 self.assertEqual(True, b.endswith(o, None))
685 self.assertEqual(True, b.endswith(o, -2, None))
686 self.assertEqual(True, b.endswith(l, None, -2))
687 self.assertEqual(False, b.endswith(x, None, None))
688
689 self.assertEqual(True, b.startswith(h, None))
690 self.assertEqual(True, b.startswith(l, -2, None))
691 self.assertEqual(True, b.startswith(h, None, -2))
692 self.assertEqual(False, b.startswith(x, None, None))
693
Antoine Pitrouac65d962011-10-20 23:54:17 +0200694 def test_integer_arguments_out_of_byte_range(self):
695 b = self.type2test(b'hello')
696
697 for method in (b.count, b.find, b.index, b.rfind, b.rindex):
698 self.assertRaises(ValueError, method, -1)
699 self.assertRaises(ValueError, method, 256)
700 self.assertRaises(ValueError, method, 9999)
701
Jesus Ceaac451502011-04-20 17:09:23 +0200702 def test_find_etc_raise_correct_error_messages(self):
703 # issue 11828
704 b = self.type2test(b'hello')
705 x = self.type2test(b'x')
Ezio Melottiaf928422011-04-20 21:56:21 +0300706 self.assertRaisesRegex(TypeError, r'\bfind\b', b.find,
Jesus Ceaac451502011-04-20 17:09:23 +0200707 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300708 self.assertRaisesRegex(TypeError, r'\brfind\b', b.rfind,
Jesus Ceaac451502011-04-20 17:09:23 +0200709 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300710 self.assertRaisesRegex(TypeError, r'\bindex\b', b.index,
Jesus Ceaac451502011-04-20 17:09:23 +0200711 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300712 self.assertRaisesRegex(TypeError, r'\brindex\b', b.rindex,
Jesus Ceaac451502011-04-20 17:09:23 +0200713 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300714 self.assertRaisesRegex(TypeError, r'\bcount\b', b.count,
Jesus Ceaac451502011-04-20 17:09:23 +0200715 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300716 self.assertRaisesRegex(TypeError, r'\bstartswith\b', b.startswith,
Jesus Ceaac451502011-04-20 17:09:23 +0200717 x, None, None, None)
Ezio Melottiaf928422011-04-20 21:56:21 +0300718 self.assertRaisesRegex(TypeError, r'\bendswith\b', b.endswith,
Jesus Ceaac451502011-04-20 17:09:23 +0200719 x, None, None, None)
720
Christian Heimes510711d2008-01-30 11:57:58 +0000721
Ezio Melotti0dceb562013-01-10 07:43:26 +0200722class BytesTest(BaseBytesTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +0000723 type2test = bytes
724
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000725 def test_buffer_is_readonly(self):
Victor Stinner76119642014-07-28 22:07:07 +0200726 fd = os.open(__file__, os.O_RDONLY)
Antoine Pitrou47d305d2008-08-16 23:28:44 +0000727 with open(fd, "rb", buffering=0) as f:
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000728 self.assertRaises(TypeError, f.readinto, b"")
729
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000730 def test_custom(self):
731 class A:
732 def __bytes__(self):
733 return b'abc'
734 self.assertEqual(bytes(A()), b'abc')
735 class A: pass
736 self.assertRaises(TypeError, bytes, A())
737 class A:
738 def __bytes__(self):
739 return None
740 self.assertRaises(TypeError, bytes, A())
Benjamin Peterson5ff3f732012-12-19 15:27:41 -0600741 class A:
742 def __bytes__(self):
743 return b'a'
744 def __index__(self):
745 return 42
746 self.assertEqual(bytes(A()), b'a')
Serhiy Storchaka15095802015-11-25 15:47:01 +0200747 # Issue #24731
748 class A:
749 def __bytes__(self):
750 return OtherBytesSubclass(b'abc')
751 self.assertEqual(bytes(A()), b'abc')
752 self.assertIs(type(bytes(A())), OtherBytesSubclass)
753 self.assertEqual(BytesSubclass(A()), b'abc')
754 self.assertIs(type(BytesSubclass(A())), BytesSubclass)
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000755
Victor Stinner29e762c2011-01-05 03:33:28 +0000756 # Test PyBytes_FromFormat()
757 def test_from_format(self):
758 test.support.import_module('ctypes')
759 from ctypes import pythonapi, py_object, c_int, c_char_p
760 PyBytes_FromFormat = pythonapi.PyBytes_FromFormat
761 PyBytes_FromFormat.restype = py_object
762
763 self.assertEqual(PyBytes_FromFormat(b'format'),
764 b'format')
765
766 self.assertEqual(PyBytes_FromFormat(b'%'), b'%')
767 self.assertEqual(PyBytes_FromFormat(b'%%'), b'%')
768 self.assertEqual(PyBytes_FromFormat(b'%%s'), b'%s')
769 self.assertEqual(PyBytes_FromFormat(b'[%%]'), b'[%]')
770 self.assertEqual(PyBytes_FromFormat(b'%%%c', c_int(ord('_'))), b'%_')
771
772 self.assertEqual(PyBytes_FromFormat(b'c:%c', c_int(255)),
773 b'c:\xff')
774 self.assertEqual(PyBytes_FromFormat(b's:%s', c_char_p(b'cstr')),
775 b's:cstr')
776
Victor Stinnerc9362cf2013-12-13 12:14:44 +0100777 # Issue #19969
778 self.assertRaises(OverflowError,
779 PyBytes_FromFormat, b'%c', c_int(-1))
780 self.assertRaises(OverflowError,
781 PyBytes_FromFormat, b'%c', c_int(256))
782
Antoine Pitrou2f89aa62008-08-02 21:02:48 +0000783
Ezio Melotti0dceb562013-01-10 07:43:26 +0200784class ByteArrayTest(BaseBytesTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +0000785 type2test = bytearray
Guido van Rossumebea9be2007-04-09 00:49:13 +0000786
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000787 def test_nohash(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000788 self.assertRaises(TypeError, hash, bytearray())
Guido van Rossum4dfe8a12006-04-22 23:28:04 +0000789
Guido van Rossum254348e2007-11-21 19:29:53 +0000790 def test_bytearray_api(self):
Guido van Rossum75d6f1a2007-05-24 17:52:00 +0000791 short_sample = b"Hello world\n"
Guido van Rossum98297ee2007-11-06 21:34:58 +0000792 sample = short_sample + b"\0"*(20 - len(short_sample))
Guido van Rossumd624f182006-04-24 13:47:05 +0000793 tfn = tempfile.mktemp()
794 try:
795 # Prepare
796 with open(tfn, "wb") as f:
797 f.write(short_sample)
798 # Test readinto
799 with open(tfn, "rb") as f:
Guido van Rossum254348e2007-11-21 19:29:53 +0000800 b = bytearray(20)
Guido van Rossumd624f182006-04-24 13:47:05 +0000801 n = f.readinto(b)
802 self.assertEqual(n, len(short_sample))
Guido van Rossumc1f779c2007-07-03 08:25:58 +0000803 self.assertEqual(list(b), list(sample))
Guido van Rossumd624f182006-04-24 13:47:05 +0000804 # Test writing in binary mode
805 with open(tfn, "wb") as f:
806 f.write(b)
807 with open(tfn, "rb") as f:
808 self.assertEqual(f.read(), sample)
Guido van Rossum13633bb2007-04-13 18:42:35 +0000809 # Text mode is ambiguous; don't test
Guido van Rossumd624f182006-04-24 13:47:05 +0000810 finally:
811 try:
812 os.remove(tfn)
Andrew Svetlov8b33dd82012-12-24 19:58:48 +0200813 except OSError:
Guido van Rossumd624f182006-04-24 13:47:05 +0000814 pass
815
Neal Norwitz6968b052007-02-27 19:02:19 +0000816 def test_reverse(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000817 b = bytearray(b'hello')
Neal Norwitz6968b052007-02-27 19:02:19 +0000818 self.assertEqual(b.reverse(), None)
819 self.assertEqual(b, b'olleh')
Guido van Rossum254348e2007-11-21 19:29:53 +0000820 b = bytearray(b'hello1') # test even number of items
Neal Norwitz6968b052007-02-27 19:02:19 +0000821 b.reverse()
822 self.assertEqual(b, b'1olleh')
Guido van Rossum254348e2007-11-21 19:29:53 +0000823 b = bytearray()
Neal Norwitz6968b052007-02-27 19:02:19 +0000824 b.reverse()
825 self.assertFalse(b)
826
Eli Bendersky4db28d32011-03-03 18:21:02 +0000827 def test_clear(self):
828 b = bytearray(b'python')
829 b.clear()
830 self.assertEqual(b, b'')
831
832 b = bytearray(b'')
833 b.clear()
834 self.assertEqual(b, b'')
835
836 b = bytearray(b'')
837 b.append(ord('r'))
838 b.clear()
839 b.append(ord('p'))
840 self.assertEqual(b, b'p')
841
842 def test_copy(self):
843 b = bytearray(b'abc')
844 bb = b.copy()
845 self.assertEqual(bb, b'abc')
846
847 b = bytearray(b'')
848 bb = b.copy()
849 self.assertEqual(bb, b'')
850
851 # test that it's indeed a copy and not a reference
852 b = bytearray(b'abc')
853 bb = b.copy()
854 self.assertEqual(b, bb)
855 self.assertIsNot(b, bb)
856 bb.append(ord('d'))
857 self.assertEqual(bb, b'abcd')
858 self.assertEqual(b, b'abc')
859
Guido van Rossumd624f182006-04-24 13:47:05 +0000860 def test_regexps(self):
861 def by(s):
Guido van Rossum254348e2007-11-21 19:29:53 +0000862 return bytearray(map(ord, s))
Guido van Rossumd624f182006-04-24 13:47:05 +0000863 b = by("Hello, world")
Antoine Pitroufd036452008-08-19 17:56:33 +0000864 self.assertEqual(re.findall(br"\w+", b), [by("Hello"), by("world")])
Guido van Rossumd624f182006-04-24 13:47:05 +0000865
866 def test_setitem(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000867 b = bytearray([1, 2, 3])
Guido van Rossumd624f182006-04-24 13:47:05 +0000868 b[1] = 100
Guido van Rossum254348e2007-11-21 19:29:53 +0000869 self.assertEqual(b, bytearray([1, 100, 3]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000870 b[-1] = 200
Guido van Rossum254348e2007-11-21 19:29:53 +0000871 self.assertEqual(b, bytearray([1, 100, 200]))
Georg Brandl9a54d7c2008-07-16 23:15:30 +0000872 b[0] = Indexable(10)
Guido van Rossum254348e2007-11-21 19:29:53 +0000873 self.assertEqual(b, bytearray([10, 100, 200]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000874 try:
875 b[3] = 0
876 self.fail("Didn't raise IndexError")
877 except IndexError:
878 pass
879 try:
880 b[-10] = 0
881 self.fail("Didn't raise IndexError")
882 except IndexError:
883 pass
884 try:
885 b[0] = 256
886 self.fail("Didn't raise ValueError")
887 except ValueError:
888 pass
889 try:
Georg Brandl9a54d7c2008-07-16 23:15:30 +0000890 b[0] = Indexable(-1)
Guido van Rossumd624f182006-04-24 13:47:05 +0000891 self.fail("Didn't raise ValueError")
892 except ValueError:
893 pass
894 try:
895 b[0] = None
896 self.fail("Didn't raise TypeError")
897 except TypeError:
898 pass
899
900 def test_delitem(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000901 b = bytearray(range(10))
Guido van Rossumd624f182006-04-24 13:47:05 +0000902 del b[0]
Guido van Rossum254348e2007-11-21 19:29:53 +0000903 self.assertEqual(b, bytearray(range(1, 10)))
Guido van Rossumd624f182006-04-24 13:47:05 +0000904 del b[-1]
Guido van Rossum254348e2007-11-21 19:29:53 +0000905 self.assertEqual(b, bytearray(range(1, 9)))
Guido van Rossumd624f182006-04-24 13:47:05 +0000906 del b[4]
Guido van Rossum254348e2007-11-21 19:29:53 +0000907 self.assertEqual(b, bytearray([1, 2, 3, 4, 6, 7, 8]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000908
909 def test_setslice(self):
Guido van Rossum254348e2007-11-21 19:29:53 +0000910 b = bytearray(range(10))
Guido van Rossumd624f182006-04-24 13:47:05 +0000911 self.assertEqual(list(b), list(range(10)))
912
Guido van Rossum254348e2007-11-21 19:29:53 +0000913 b[0:5] = bytearray([1, 1, 1, 1, 1])
914 self.assertEqual(b, bytearray([1, 1, 1, 1, 1, 5, 6, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000915
916 del b[0:-5]
Guido van Rossum254348e2007-11-21 19:29:53 +0000917 self.assertEqual(b, bytearray([5, 6, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000918
Guido van Rossum254348e2007-11-21 19:29:53 +0000919 b[0:0] = bytearray([0, 1, 2, 3, 4])
920 self.assertEqual(b, bytearray(range(10)))
Guido van Rossumd624f182006-04-24 13:47:05 +0000921
Guido van Rossum254348e2007-11-21 19:29:53 +0000922 b[-7:-3] = bytearray([100, 101])
923 self.assertEqual(b, bytearray([0, 1, 2, 100, 101, 7, 8, 9]))
Guido van Rossumd624f182006-04-24 13:47:05 +0000924
925 b[3:5] = [3, 4, 5, 6]
Guido van Rossum254348e2007-11-21 19:29:53 +0000926 self.assertEqual(b, bytearray(range(10)))
Guido van Rossumad7d8d12007-04-13 01:39:34 +0000927
Thomas Wouters9a6e62b2006-08-23 23:20:29 +0000928 b[3:0] = [42, 42, 42]
Guido van Rossum254348e2007-11-21 19:29:53 +0000929 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 +0000930
Ezio Melottic64bcbe2012-11-03 21:19:06 +0200931 b[3:] = b'foo'
932 self.assertEqual(b, bytearray([0, 1, 2, 102, 111, 111]))
933
934 b[:3] = memoryview(b'foo')
935 self.assertEqual(b, bytearray([102, 111, 111, 102, 111, 111]))
936
937 b[3:4] = []
938 self.assertEqual(b, bytearray([102, 111, 111, 111, 111]))
939
940 for elem in [5, -5, 0, int(10e20), 'str', 2.3,
941 ['a', 'b'], [b'a', b'b'], [[]]]:
942 with self.assertRaises(TypeError):
943 b[3:4] = elem
944
945 for elem in [[254, 255, 256], [-256, 9000]]:
946 with self.assertRaises(ValueError):
947 b[3:4] = elem
948
Antoine Pitrou5df8a8a2013-10-05 21:12:18 +0200949 def test_setslice_extend(self):
950 # Exercise the resizing logic (see issue #19087)
951 b = bytearray(range(100))
952 self.assertEqual(list(b), list(range(100)))
953 del b[:10]
954 self.assertEqual(list(b), list(range(10, 100)))
955 b.extend(range(100, 110))
956 self.assertEqual(list(b), list(range(10, 110)))
957
Antoine Pitrou25454112015-05-19 20:52:27 +0200958 def test_fifo_overrun(self):
959 # Test for issue #23985, a buffer overrun when implementing a FIFO
960 # Build Python in pydebug mode for best results.
961 b = bytearray(10)
962 b.pop() # Defeat expanding buffer off-by-one quirk
963 del b[:1] # Advance start pointer without reallocating
964 b += bytes(2) # Append exactly the number of deleted bytes
965 del b # Free memory buffer, allowing pydebug verification
966
967 def test_del_expand(self):
968 # Reducing the size should not expand the buffer (issue #23985)
969 b = bytearray(10)
970 size = sys.getsizeof(b)
971 del b[:1]
972 self.assertLessEqual(sys.getsizeof(b), size)
973
Thomas Wouters376446d2006-12-19 08:30:14 +0000974 def test_extended_set_del_slice(self):
Mark Dickinsonbc099642010-01-29 17:27:24 +0000975 indices = (0, None, 1, 3, 19, 300, 1<<333, -1, -2, -31, -300)
Thomas Wouters376446d2006-12-19 08:30:14 +0000976 for start in indices:
977 for stop in indices:
978 # Skip invalid step 0
979 for step in indices[1:]:
980 L = list(range(255))
Guido van Rossum254348e2007-11-21 19:29:53 +0000981 b = bytearray(L)
Thomas Wouters376446d2006-12-19 08:30:14 +0000982 # Make sure we have a slice of exactly the right length,
983 # but with different data.
984 data = L[start:stop:step]
985 data.reverse()
986 L[start:stop:step] = data
987 b[start:stop:step] = data
Ezio Melottib3aedd42010-11-20 19:04:17 +0000988 self.assertEqual(b, bytearray(L))
Guido van Rossumad7d8d12007-04-13 01:39:34 +0000989
Thomas Wouters376446d2006-12-19 08:30:14 +0000990 del L[start:stop:step]
991 del b[start:stop:step]
Ezio Melottib3aedd42010-11-20 19:04:17 +0000992 self.assertEqual(b, bytearray(L))
Thomas Wouters376446d2006-12-19 08:30:14 +0000993
Guido van Rossumd624f182006-04-24 13:47:05 +0000994 def test_setslice_trap(self):
995 # This test verifies that we correctly handle assigning self
996 # to a slice of self (the old Lambert Meertens trap).
Guido van Rossum254348e2007-11-21 19:29:53 +0000997 b = bytearray(range(256))
Guido van Rossumd624f182006-04-24 13:47:05 +0000998 b[8:] = b
Guido van Rossum254348e2007-11-21 19:29:53 +0000999 self.assertEqual(b, bytearray(list(range(8)) + list(range(256))))
Guido van Rossumd624f182006-04-24 13:47:05 +00001000
Guido van Rossum13e57212006-04-27 22:54:26 +00001001 def test_iconcat(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001002 b = bytearray(b"abc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001003 b1 = b
Guido van Rossum9c627722007-08-27 18:31:48 +00001004 b += b"def"
1005 self.assertEqual(b, b"abcdef")
Guido van Rossum13e57212006-04-27 22:54:26 +00001006 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001007 self.assertTrue(b is b1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001008 b += b"xyz"
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001009 self.assertEqual(b, b"abcdefxyz")
1010 try:
Guido van Rossumef87d6e2007-05-02 19:09:54 +00001011 b += ""
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001012 except TypeError:
1013 pass
1014 else:
1015 self.fail("bytes += unicode didn't raise TypeError")
Guido van Rossum13e57212006-04-27 22:54:26 +00001016
1017 def test_irepeat(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001018 b = bytearray(b"abc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001019 b1 = b
1020 b *= 3
Guido van Rossum9c627722007-08-27 18:31:48 +00001021 self.assertEqual(b, b"abcabcabc")
Guido van Rossum13e57212006-04-27 22:54:26 +00001022 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001023 self.assertTrue(b is b1)
Guido van Rossum13e57212006-04-27 22:54:26 +00001024
1025 def test_irepeat_1char(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001026 b = bytearray(b"x")
Guido van Rossum13e57212006-04-27 22:54:26 +00001027 b1 = b
1028 b *= 100
Guido van Rossum98297ee2007-11-06 21:34:58 +00001029 self.assertEqual(b, b"x"*100)
Guido van Rossum13e57212006-04-27 22:54:26 +00001030 self.assertEqual(b, b1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001031 self.assertTrue(b is b1)
Guido van Rossum13e57212006-04-27 22:54:26 +00001032
Guido van Rossum20188312006-05-05 15:15:40 +00001033 def test_alloc(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001034 b = bytearray()
Guido van Rossum20188312006-05-05 15:15:40 +00001035 alloc = b.__alloc__()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001036 self.assertTrue(alloc >= 0)
Guido van Rossum20188312006-05-05 15:15:40 +00001037 seq = [alloc]
1038 for i in range(100):
Guido van Rossum9c627722007-08-27 18:31:48 +00001039 b += b"x"
Guido van Rossum20188312006-05-05 15:15:40 +00001040 alloc = b.__alloc__()
Serhiy Storchaka7b6e3b92015-06-29 21:14:06 +03001041 self.assertGreater(alloc, len(b)) # including trailing null byte
Guido van Rossum20188312006-05-05 15:15:40 +00001042 if alloc not in seq:
1043 seq.append(alloc)
Guido van Rossum20188312006-05-05 15:15:40 +00001044
Serhiy Storchaka7b6e3b92015-06-29 21:14:06 +03001045 def test_init_alloc(self):
1046 b = bytearray()
1047 def g():
1048 for i in range(1, 100):
1049 yield i
1050 a = list(b)
1051 self.assertEqual(a, list(range(1, len(a)+1)))
1052 self.assertEqual(len(b), len(a))
1053 self.assertLessEqual(len(b), i)
1054 alloc = b.__alloc__()
1055 self.assertGreater(alloc, len(b)) # including trailing null byte
1056 b.__init__(g())
1057 self.assertEqual(list(b), list(range(1, 100)))
1058 self.assertEqual(len(b), 99)
1059 alloc = b.__alloc__()
1060 self.assertGreater(alloc, len(b))
1061
Neal Norwitz6968b052007-02-27 19:02:19 +00001062 def test_extend(self):
1063 orig = b'hello'
Guido van Rossum254348e2007-11-21 19:29:53 +00001064 a = bytearray(orig)
Neal Norwitz6968b052007-02-27 19:02:19 +00001065 a.extend(a)
1066 self.assertEqual(a, orig + orig)
1067 self.assertEqual(a[5:], orig)
Alexandre Vassalotti09121e82007-12-04 05:51:13 +00001068 a = bytearray(b'')
1069 # Test iterators that don't have a __length_hint__
1070 a.extend(map(int, orig * 25))
1071 a.extend(int(x) for x in orig * 25)
1072 self.assertEqual(a, orig * 50)
1073 self.assertEqual(a[-5:], orig)
1074 a = bytearray(b'')
1075 a.extend(iter(map(int, orig * 50)))
1076 self.assertEqual(a, orig * 50)
1077 self.assertEqual(a[-5:], orig)
1078 a = bytearray(b'')
1079 a.extend(list(map(int, orig * 50)))
1080 self.assertEqual(a, orig * 50)
1081 self.assertEqual(a[-5:], orig)
1082 a = bytearray(b'')
1083 self.assertRaises(ValueError, a.extend, [0, 1, 2, 256])
1084 self.assertRaises(ValueError, a.extend, [0, 1, 2, -1])
1085 self.assertEqual(len(a), 0)
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001086 a = bytearray(b'')
1087 a.extend([Indexable(ord('a'))])
1088 self.assertEqual(a, b'a')
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001089
Neal Norwitz6968b052007-02-27 19:02:19 +00001090 def test_remove(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001091 b = bytearray(b'hello')
Neal Norwitz6968b052007-02-27 19:02:19 +00001092 b.remove(ord('l'))
1093 self.assertEqual(b, b'helo')
1094 b.remove(ord('l'))
1095 self.assertEqual(b, b'heo')
1096 self.assertRaises(ValueError, lambda: b.remove(ord('l')))
1097 self.assertRaises(ValueError, lambda: b.remove(400))
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001098 self.assertRaises(TypeError, lambda: b.remove('e'))
Neal Norwitz6968b052007-02-27 19:02:19 +00001099 # remove first and last
1100 b.remove(ord('o'))
1101 b.remove(ord('h'))
1102 self.assertEqual(b, b'e')
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001103 self.assertRaises(TypeError, lambda: b.remove(b'e'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001104 b.remove(Indexable(ord('e')))
1105 self.assertEqual(b, b'')
Neal Norwitz6968b052007-02-27 19:02:19 +00001106
1107 def test_pop(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001108 b = bytearray(b'world')
Neal Norwitz6968b052007-02-27 19:02:19 +00001109 self.assertEqual(b.pop(), ord('d'))
1110 self.assertEqual(b.pop(0), ord('w'))
1111 self.assertEqual(b.pop(-2), ord('r'))
1112 self.assertRaises(IndexError, lambda: b.pop(10))
Eli Bendersky1bc4f192011-03-04 04:55:25 +00001113 self.assertRaises(IndexError, lambda: bytearray().pop())
Mark Dickinson54a3db92009-09-06 10:19:23 +00001114 # test for issue #6846
1115 self.assertEqual(bytearray(b'\xff').pop(), 0xff)
Neal Norwitz6968b052007-02-27 19:02:19 +00001116
1117 def test_nosort(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001118 self.assertRaises(AttributeError, lambda: bytearray().sort())
Neal Norwitz6968b052007-02-27 19:02:19 +00001119
Neal Norwitz6968b052007-02-27 19:02:19 +00001120 def test_append(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001121 b = bytearray(b'hell')
Neal Norwitz6968b052007-02-27 19:02:19 +00001122 b.append(ord('o'))
1123 self.assertEqual(b, b'hello')
1124 self.assertEqual(b.append(100), None)
Guido van Rossum254348e2007-11-21 19:29:53 +00001125 b = bytearray()
Neal Norwitz6968b052007-02-27 19:02:19 +00001126 b.append(ord('A'))
1127 self.assertEqual(len(b), 1)
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001128 self.assertRaises(TypeError, lambda: b.append(b'o'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001129 b = bytearray()
1130 b.append(Indexable(ord('A')))
1131 self.assertEqual(b, b'A')
Neal Norwitz6968b052007-02-27 19:02:19 +00001132
1133 def test_insert(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001134 b = bytearray(b'msssspp')
Neal Norwitz6968b052007-02-27 19:02:19 +00001135 b.insert(1, ord('i'))
1136 b.insert(4, ord('i'))
1137 b.insert(-2, ord('i'))
1138 b.insert(1000, ord('i'))
1139 self.assertEqual(b, b'mississippi')
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001140 self.assertRaises(TypeError, lambda: b.insert(0, b'1'))
Georg Brandl9a54d7c2008-07-16 23:15:30 +00001141 b = bytearray()
1142 b.insert(0, Indexable(ord('A')))
1143 self.assertEqual(b, b'A')
Neal Norwitz6968b052007-02-27 19:02:19 +00001144
Benjamin Peterson0f3641c2008-11-19 22:05:52 +00001145 def test_copied(self):
1146 # Issue 4348. Make sure that operations that don't mutate the array
1147 # copy the bytes.
1148 b = bytearray(b'abc')
Amaury Forgeot d'Arcb0c29162008-11-22 22:18:04 +00001149 self.assertFalse(b is b.replace(b'abc', b'cde', 0))
Benjamin Peterson0f3641c2008-11-19 22:05:52 +00001150
1151 t = bytearray([i for i in range(256)])
1152 x = bytearray(b'')
1153 self.assertFalse(x is x.translate(t))
1154
Guido van Rossum254348e2007-11-21 19:29:53 +00001155 def test_partition_bytearray_doesnt_share_nullstring(self):
1156 a, b, c = bytearray(b"x").partition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001157 self.assertEqual(b, b"")
1158 self.assertEqual(c, b"")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001159 self.assertTrue(b is not c)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001160 b += b"!"
1161 self.assertEqual(c, b"")
Guido van Rossum254348e2007-11-21 19:29:53 +00001162 a, b, c = bytearray(b"x").partition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001163 self.assertEqual(b, b"")
1164 self.assertEqual(c, b"")
1165 # Same for rpartition
Guido van Rossum254348e2007-11-21 19:29:53 +00001166 b, c, a = bytearray(b"x").rpartition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001167 self.assertEqual(b, b"")
1168 self.assertEqual(c, b"")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001169 self.assertTrue(b is not c)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001170 b += b"!"
1171 self.assertEqual(c, b"")
Guido van Rossum254348e2007-11-21 19:29:53 +00001172 c, b, a = bytearray(b"x").rpartition(b"y")
Guido van Rossum98297ee2007-11-06 21:34:58 +00001173 self.assertEqual(b, b"")
1174 self.assertEqual(c, b"")
1175
Antoine Pitrou5504e892008-12-06 21:27:53 +00001176 def test_resize_forbidden(self):
1177 # #4509: can't resize a bytearray when there are buffer exports, even
1178 # if it wouldn't reallocate the underlying buffer.
1179 # Furthermore, no destructive changes to the buffer may be applied
1180 # before raising the error.
1181 b = bytearray(range(10))
1182 v = memoryview(b)
1183 def resize(n):
1184 b[1:-1] = range(n + 1, 2*n - 1)
1185 resize(10)
1186 orig = b[:]
1187 self.assertRaises(BufferError, resize, 11)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001188 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001189 self.assertRaises(BufferError, resize, 9)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001190 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001191 self.assertRaises(BufferError, resize, 0)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001192 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001193 # Other operations implying resize
1194 self.assertRaises(BufferError, b.pop, 0)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001195 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001196 self.assertRaises(BufferError, b.remove, b[1])
Ezio Melottib3aedd42010-11-20 19:04:17 +00001197 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001198 def delitem():
1199 del b[1]
1200 self.assertRaises(BufferError, delitem)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001201 self.assertEqual(b, orig)
Antoine Pitrou5504e892008-12-06 21:27:53 +00001202 # deleting a non-contiguous slice
1203 def delslice():
1204 b[1:-1:2] = b""
1205 self.assertRaises(BufferError, delslice)
Ezio Melottib3aedd42010-11-20 19:04:17 +00001206 self.assertEqual(b, orig)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001207
Antoine Pitroufc8d6f42010-01-17 12:38:54 +00001208
Christian Heimes510711d2008-01-30 11:57:58 +00001209class AssortedBytesTest(unittest.TestCase):
1210 #
1211 # Test various combinations of bytes and bytearray
1212 #
1213
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001214 @check_bytes_warnings
Christian Heimes510711d2008-01-30 11:57:58 +00001215 def test_repr_str(self):
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001216 for f in str, repr:
1217 self.assertEqual(f(bytearray()), "bytearray(b'')")
1218 self.assertEqual(f(bytearray([0])), "bytearray(b'\\x00')")
1219 self.assertEqual(f(bytearray([0, 1, 254, 255])),
1220 "bytearray(b'\\x00\\x01\\xfe\\xff')")
1221 self.assertEqual(f(b"abc"), "b'abc'")
1222 self.assertEqual(f(b"'"), '''b"'"''') # '''
1223 self.assertEqual(f(b"'\""), r"""b'\'"'""") # '
Christian Heimes510711d2008-01-30 11:57:58 +00001224
1225 def test_compare_bytes_to_bytearray(self):
1226 self.assertEqual(b"abc" == bytes(b"abc"), True)
1227 self.assertEqual(b"ab" != bytes(b"abc"), True)
1228 self.assertEqual(b"ab" <= bytes(b"abc"), True)
1229 self.assertEqual(b"ab" < bytes(b"abc"), True)
1230 self.assertEqual(b"abc" >= bytes(b"ab"), True)
1231 self.assertEqual(b"abc" > bytes(b"ab"), True)
1232
1233 self.assertEqual(b"abc" != bytes(b"abc"), False)
1234 self.assertEqual(b"ab" == bytes(b"abc"), False)
1235 self.assertEqual(b"ab" > bytes(b"abc"), False)
1236 self.assertEqual(b"ab" >= bytes(b"abc"), False)
1237 self.assertEqual(b"abc" < bytes(b"ab"), False)
1238 self.assertEqual(b"abc" <= bytes(b"ab"), False)
1239
1240 self.assertEqual(bytes(b"abc") == b"abc", True)
1241 self.assertEqual(bytes(b"ab") != b"abc", True)
1242 self.assertEqual(bytes(b"ab") <= b"abc", True)
1243 self.assertEqual(bytes(b"ab") < b"abc", True)
1244 self.assertEqual(bytes(b"abc") >= b"ab", True)
1245 self.assertEqual(bytes(b"abc") > b"ab", True)
1246
1247 self.assertEqual(bytes(b"abc") != b"abc", False)
1248 self.assertEqual(bytes(b"ab") == b"abc", False)
1249 self.assertEqual(bytes(b"ab") > b"abc", False)
1250 self.assertEqual(bytes(b"ab") >= b"abc", False)
1251 self.assertEqual(bytes(b"abc") < b"ab", False)
1252 self.assertEqual(bytes(b"abc") <= b"ab", False)
1253
Stefan Krah6e572b82013-01-26 13:06:36 +01001254 @test.support.requires_docstrings
Christian Heimes510711d2008-01-30 11:57:58 +00001255 def test_doc(self):
Florent Xicluna9b86b9a2010-03-19 19:00:44 +00001256 self.assertIsNotNone(bytearray.__doc__)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001257 self.assertTrue(bytearray.__doc__.startswith("bytearray("), bytearray.__doc__)
Florent Xicluna9b86b9a2010-03-19 19:00:44 +00001258 self.assertIsNotNone(bytes.__doc__)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001259 self.assertTrue(bytes.__doc__.startswith("bytes("), bytes.__doc__)
Christian Heimes510711d2008-01-30 11:57:58 +00001260
1261 def test_from_bytearray(self):
1262 sample = bytes(b"Hello world\n\x80\x81\xfe\xff")
1263 buf = memoryview(sample)
1264 b = bytearray(buf)
1265 self.assertEqual(b, bytearray(sample))
1266
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001267 @check_bytes_warnings
Christian Heimes510711d2008-01-30 11:57:58 +00001268 def test_to_str(self):
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001269 self.assertEqual(str(b''), "b''")
1270 self.assertEqual(str(b'x'), "b'x'")
1271 self.assertEqual(str(b'\x80'), "b'\\x80'")
1272 self.assertEqual(str(bytearray(b'')), "bytearray(b'')")
1273 self.assertEqual(str(bytearray(b'x')), "bytearray(b'x')")
1274 self.assertEqual(str(bytearray(b'\x80')), "bytearray(b'\\x80')")
Christian Heimes510711d2008-01-30 11:57:58 +00001275
1276 def test_literal(self):
1277 tests = [
1278 (b"Wonderful spam", "Wonderful spam"),
1279 (br"Wonderful spam too", "Wonderful spam too"),
1280 (b"\xaa\x00\000\200", "\xaa\x00\000\200"),
1281 (br"\xaa\x00\000\200", r"\xaa\x00\000\200"),
1282 ]
1283 for b, s in tests:
1284 self.assertEqual(b, bytearray(s, 'latin-1'))
1285 for c in range(128, 256):
1286 self.assertRaises(SyntaxError, eval,
1287 'b"%s"' % chr(c))
1288
1289 def test_translate(self):
1290 b = b'hello'
Georg Brandlccc47b62008-12-28 11:44:14 +00001291 ba = bytearray(b)
Christian Heimes510711d2008-01-30 11:57:58 +00001292 rosetta = bytearray(range(0, 256))
1293 rosetta[ord('o')] = ord('e')
1294 c = b.translate(rosetta, b'l')
1295 self.assertEqual(b, b'hello')
1296 self.assertEqual(c, b'hee')
Georg Brandlccc47b62008-12-28 11:44:14 +00001297 c = ba.translate(rosetta, b'l')
1298 self.assertEqual(ba, b'hello')
1299 self.assertEqual(c, b'hee')
1300 c = b.translate(None, b'e')
1301 self.assertEqual(c, b'hllo')
1302 c = ba.translate(None, b'e')
1303 self.assertEqual(c, b'hllo')
1304 self.assertRaises(TypeError, b.translate, None, None)
1305 self.assertRaises(TypeError, ba.translate, None, None)
Christian Heimes510711d2008-01-30 11:57:58 +00001306
1307 def test_split_bytearray(self):
1308 self.assertEqual(b'a b'.split(memoryview(b' ')), [b'a', b'b'])
1309
1310 def test_rsplit_bytearray(self):
1311 self.assertEqual(b'a b'.rsplit(memoryview(b' ')), [b'a', b'b'])
1312
Georg Brandleb2c9642008-05-30 12:05:02 +00001313 def test_return_self(self):
1314 # bytearray.replace must always return a new bytearray
1315 b = bytearray()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001316 self.assertFalse(b.replace(b'', b'') is b)
Georg Brandleb2c9642008-05-30 12:05:02 +00001317
Barry Warsaw9e9dcd62008-10-17 01:50:37 +00001318 def test_compare(self):
1319 if sys.flags.bytes_warning:
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001320 def bytes_warning():
1321 return test.support.check_warnings(('', BytesWarning))
1322 with bytes_warning():
1323 b'' == ''
1324 with bytes_warning():
1325 b'' != ''
1326 with bytes_warning():
1327 bytearray(b'') == ''
1328 with bytes_warning():
1329 bytearray(b'') != ''
Barry Warsaw9e9dcd62008-10-17 01:50:37 +00001330 else:
Florent Xiclunaedf5f0d2010-09-03 20:00:37 +00001331 self.skipTest("BytesWarning is needed for this test: use -bb option")
Barry Warsaw9e9dcd62008-10-17 01:50:37 +00001332
Guido van Rossumd624f182006-04-24 13:47:05 +00001333 # Optimizations:
Guido van Rossume06b6b82006-04-23 07:43:54 +00001334 # __iter__? (optimization)
Guido van Rossumd624f182006-04-24 13:47:05 +00001335 # __reversed__? (optimization)
1336
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001337 # XXX More string methods? (Those that don't use character properties)
1338
Neal Norwitz6968b052007-02-27 19:02:19 +00001339 # There are tests in string_tests.py that are more
1340 # comprehensive for things like split, partition, etc.
1341 # Unfortunately they are all bundled with tests that
1342 # are not appropriate for bytes
Guido van Rossume06b6b82006-04-23 07:43:54 +00001343
Guido van Rossum254348e2007-11-21 19:29:53 +00001344 # I've started porting some of those into bytearray_tests.py, we should port
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001345 # the rest that make sense (the code can be cleaned up to use modern
1346 # unittest methods at the same time).
1347
Guido van Rossum254348e2007-11-21 19:29:53 +00001348class BytearrayPEP3137Test(unittest.TestCase,
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001349 test.buffer_tests.MixinBytesBufferCommonTests):
1350 def marshal(self, x):
Guido van Rossum254348e2007-11-21 19:29:53 +00001351 return bytearray(x)
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001352
1353 def test_returns_new_copy(self):
1354 val = self.marshal(b'1234')
1355 # On immutable types these MAY return a reference to themselves
Guido van Rossum254348e2007-11-21 19:29:53 +00001356 # but on mutable types like bytearray they MUST return a new copy.
Gregory P. Smith60d241f2007-10-16 06:31:30 +00001357 for methname in ('zfill', 'rjust', 'ljust', 'center'):
1358 method = getattr(val, methname)
1359 newval = method(3)
1360 self.assertEqual(val, newval)
1361 self.assertTrue(val is not newval,
1362 methname+' returned self on a mutable object')
Antoine Pitroucbaa62502010-01-13 15:03:39 +00001363 for expr in ('val.split()[0]', 'val.rsplit()[0]',
1364 'val.partition(b".")[0]', 'val.rpartition(b".")[2]',
1365 'val.splitlines()[0]', 'val.replace(b"", b"")'):
1366 newval = eval(expr)
1367 self.assertEqual(val, newval)
1368 self.assertTrue(val is not newval,
1369 expr+' returned val on a mutable object')
Antoine Pitroucfc22b42012-10-16 21:07:23 +02001370 sep = self.marshal(b'')
1371 newval = sep.join([val])
1372 self.assertEqual(val, newval)
1373 self.assertIsNot(val, newval)
1374
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001375
Christian Heimes510711d2008-01-30 11:57:58 +00001376class FixedStringTest(test.string_tests.BaseTest):
Georg Brandlc7885542007-03-06 19:16:20 +00001377
Guido van Rossum9c627722007-08-27 18:31:48 +00001378 def fixtype(self, obj):
1379 if isinstance(obj, str):
1380 return obj.encode("utf-8")
1381 return super().fixtype(obj)
1382
Georg Brandlc7885542007-03-06 19:16:20 +00001383 # Currently the bytes containment testing uses a single integer
1384 # value. This may not be the final design, but until then the
1385 # bytes section with in a bytes containment not valid
1386 def test_contains(self):
1387 pass
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001388 def test_expandtabs(self):
1389 pass
1390 def test_upper(self):
1391 pass
1392 def test_lower(self):
1393 pass
Georg Brandlc7885542007-03-06 19:16:20 +00001394
Ezio Melotti0dceb562013-01-10 07:43:26 +02001395class ByteArrayAsStringTest(FixedStringTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +00001396 type2test = bytearray
Antoine Pitrouac65d962011-10-20 23:54:17 +02001397 contains_bytes = True
Christian Heimes510711d2008-01-30 11:57:58 +00001398
Ezio Melotti0dceb562013-01-10 07:43:26 +02001399class BytesAsStringTest(FixedStringTest, unittest.TestCase):
Christian Heimes510711d2008-01-30 11:57:58 +00001400 type2test = bytes
Antoine Pitrouac65d962011-10-20 23:54:17 +02001401 contains_bytes = True
Christian Heimes510711d2008-01-30 11:57:58 +00001402
Georg Brandlc7885542007-03-06 19:16:20 +00001403
Ezio Melotti0dceb562013-01-10 07:43:26 +02001404class SubclassTest:
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001405
1406 def test_basic(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001407 self.assertTrue(issubclass(self.subclass2test, self.type2test))
Ezio Melottie9615932010-01-24 19:26:24 +00001408 self.assertIsInstance(self.subclass2test(), self.type2test)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001409
1410 a, b = b"abcd", b"efgh"
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001411 _a, _b = self.subclass2test(a), self.subclass2test(b)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001412
1413 # test comparison operators with subclass instances
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001414 self.assertTrue(_a == _a)
1415 self.assertTrue(_a != _b)
1416 self.assertTrue(_a < _b)
1417 self.assertTrue(_a <= _b)
1418 self.assertTrue(_b >= _a)
1419 self.assertTrue(_b > _a)
1420 self.assertTrue(_a is not a)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001421
1422 # test concat of subclass instances
1423 self.assertEqual(a + b, _a + _b)
1424 self.assertEqual(a + b, a + _b)
1425 self.assertEqual(a + b, _a + b)
1426
1427 # test repeat
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001428 self.assertTrue(a*5 == _a*5)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001429
1430 def test_join(self):
1431 # Make sure join returns a NEW object for single item sequences
1432 # involving a subclass.
1433 # Make sure that it is of the appropriate type.
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001434 s1 = self.subclass2test(b"abcd")
1435 s2 = self.type2test().join([s1])
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001436 self.assertTrue(s1 is not s2)
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001437 self.assertTrue(type(s2) is self.type2test, type(s2))
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001438
1439 # Test reverse, calling join on subclass
1440 s3 = s1.join([b"abcd"])
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001441 self.assertTrue(type(s3) is self.type2test)
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001442
1443 def test_pickle(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001444 a = self.subclass2test(b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001445 a.x = 10
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001446 a.y = self.subclass2test(b"efgh")
Hirokazu Yamamotod0d0b652008-10-23 00:38:15 +00001447 for proto in range(pickle.HIGHEST_PROTOCOL + 1):
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001448 b = pickle.loads(pickle.dumps(a, proto))
1449 self.assertNotEqual(id(a), id(b))
1450 self.assertEqual(a, b)
1451 self.assertEqual(a.x, b.x)
1452 self.assertEqual(a.y, b.y)
1453 self.assertEqual(type(a), type(b))
1454 self.assertEqual(type(a.y), type(b.y))
1455
1456 def test_copy(self):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001457 a = self.subclass2test(b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001458 a.x = 10
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001459 a.y = self.subclass2test(b"efgh")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001460 for copy_method in (copy.copy, copy.deepcopy):
1461 b = copy_method(a)
1462 self.assertNotEqual(id(a), id(b))
1463 self.assertEqual(a, b)
1464 self.assertEqual(a.x, b.x)
1465 self.assertEqual(a.y, b.y)
1466 self.assertEqual(type(a), type(b))
1467 self.assertEqual(type(a.y), type(b.y))
1468
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001469
1470class ByteArraySubclass(bytearray):
1471 pass
1472
1473class BytesSubclass(bytes):
1474 pass
1475
Serhiy Storchaka15095802015-11-25 15:47:01 +02001476class OtherBytesSubclass(bytes):
1477 pass
1478
Ezio Melotti0dceb562013-01-10 07:43:26 +02001479class ByteArraySubclassTest(SubclassTest, unittest.TestCase):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001480 type2test = bytearray
1481 subclass2test = ByteArraySubclass
1482
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001483 def test_init_override(self):
Guido van Rossum254348e2007-11-21 19:29:53 +00001484 class subclass(bytearray):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001485 def __init__(me, newarg=1, *args, **kwargs):
1486 bytearray.__init__(me, *args, **kwargs)
1487 x = subclass(4, b"abcd")
Guido van Rossuma6c04be2007-11-03 00:24:24 +00001488 x = subclass(4, source=b"abcd")
1489 self.assertEqual(x, b"abcd")
1490 x = subclass(newarg=4, source=b"abcd")
1491 self.assertEqual(x, b"abcd")
1492
1493
Ezio Melotti0dceb562013-01-10 07:43:26 +02001494class BytesSubclassTest(SubclassTest, unittest.TestCase):
Alexandre Vassalotti41f58a72010-01-12 01:23:09 +00001495 type2test = bytes
1496 subclass2test = BytesSubclass
1497
1498
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001499if __name__ == "__main__":
Ezio Melotti0dceb562013-01-10 07:43:26 +02001500 unittest.main()